OpenAI Ads Conversion Tracking: Complete WordPress Setup Guide (2026)
OpenAI Ads (formerly ChatGPT Ads) is rapidly growing as an advertising platform. But unlike Google Ads or Meta, setting up conversion tracking for OpenAI Ads requires a different approach. This guide walks you through every step, from installing the tracking pixel to debugging events in real time.
Why OpenAI Ads Conversion Tracking Matters
OpenAI Ads is a performance advertising platform that lets you reach users across ChatGPT and other OpenAI surfaces. As more advertisers shift budget to OpenAI Ads, the need for accurate conversion tracking has become critical. Without proper tracking, you cannot measure return on ad spend (ROAS), optimize bids, or scale winning campaigns.
OpenAI Ads uses the oaiq tracking pixel, similar to how Meta uses the Facebook pixel and Google uses gtag. The pixel fires on key events like page views, purchases, leads, and custom conversions. These events are sent to OpenAI's servers and linked back to your ad campaigns.
The challenge? OpenAI's tracking ecosystem is still evolving. There is no native WordPress plugin, no built-in WooCommerce integration, and limited documentation. That's exactly why open-source tools like Ridoway Pixel exist.
Two Tracking Methods: Browser Pixel vs Conversions API
OpenAI Ads supports two distinct tracking methods, and you should use both for maximum accuracy:
Browser Pixel (Client-Side)
A JavaScript snippet placed on your website that fires events directly from the user's browser. Easy to set up but can be blocked by ad blockers or lost if users navigate away before the event fires.
Conversions API (Server-Side)
Events are sent directly from your web server to OpenAI's servers. Reliable, ad-blocker-proof, and essential for accurate attribution. Recommended by OpenAI for all advertisers.
Using both methods together is called deduplication. When both the browser pixel and CAPI send the same event, OpenAI automatically deduplicates them so you never double-count a conversion. Ridoway Pixel handles deduplication out of the box.
Installing Ridoway Pixel (The Easy Way)
The fastest way to add OpenAI Ads conversion tracking to WordPress is with the Ridoway Pixel plugin. It is free, open-source, and handles both browser pixel and Conversions API with zero configuration.
Step-by-Step Installation
- 1Download the plugin from the WordPress plugin repository or install directly from your WordPress admin panel.
- 2Activate the plugin and navigate to Settings → Ridoway Pixel.
- 3Enter your OpenAI Ads Pixel ID (found in your OpenAI Ads dashboard under Settings → Pixel).
- 4Choose your tracking methods: Browser Pixel, Conversions API, or both (recommended).
- 5Save changes. The plugin automatically injects the pixel on all pages and fires events for purchases, leads, and custom conversions.
Total setup time: approximately 5 minutes. No coding required.
Manual Setup Without a Plugin
If you prefer to add the pixel manually, insert the following code just before the closing </head> tag in your theme:
<!-- OpenAI Ads Pixel -->
<script>
window.oaiq = window.oaiq || [];
function oaiq(){oaiq.push(arguments);}
oaiq("init", "YOUR_PIXEL_ID");
oaiq("track", "PageView");
</script>
<script src="https://bzr.openai.com/pixel.js" async defer></script>Replace YOUR_PIXEL_ID with your actual pixel ID. For purchase tracking, add the following on your order confirmation page:
oaiq("track", "Purchase", {
value: 29.99,
currency: "USD",
content_ids: ["prod_123"],
content_type: "product",
});WooCommerce Integration
With Ridoway Pixel, WooCommerce tracking is a single toggle. The plugin automatically fires:
- ViewContent on product pages
- AddToCart when items are added to the cart
- InitiateCheckout when the user starts checkout
- Purchase with dynamic value and currency on order confirmation
- Auto-deduplication between browser pixel and CAPI
No custom code, no WooCommerce hooks to write, no template overrides. Just toggle WooCommerce integration on in the plugin settings.
Contact Form 7 & WPForms Tracking
Form submissions are one of the most common conversion events for B2B advertisers. Ridoway Pixel integrates with both Contact Form 7 and WPForms so you can track form leads as OpenAI Ads conversions:
Contact Form 7
Automatically fires a Lead event when a CF7 form is submitted successfully. No shortcode modifications needed.
WPForms
Fires a Lead event on successful WPForms submission. Works with all form types including multi-page forms.
Debugging with ChatGPT Pixel Helper
Once your pixel is installed, you need to verify that events are firing correctly. That is where the ChatGPT Pixel Helper Chrome extension comes in. It is a free debugging tool built specifically for the OpenAI Ads pixel ecosystem.
The extension provides:
- Real-time event capture: Every oaiq call is logged as it happens on the page.
- Beacon inspection: View the full payload of each beacon sent to bzr.openai.com, including headers and body.
- Cookie state verification: Check if the oaiq cookie is set correctly with the right parameters.
- Console integration: Events are also logged to the browser console for advanced debugging.
- Multi-event support: Tracks PageView, Purchase, Lead, AddToCart, and custom events.
Install the ChatGPT Pixel Helper from the Chrome Web Store. Once installed, navigate to any page with the OpenAI Ads pixel and click the extension icon to see all captured events.
Server-Side Tracking with Conversions API
The Conversions API (CAPI) is OpenAI's server-side tracking solution. Unlike the browser pixel, CAPI events are sent directly from your server, which means they cannot be blocked by ad blockers or browser privacy settings.
Ridoway Pixel handles CAPI automatically. When you enable CAPI in the plugin settings, events are sent from your WordPress server to OpenAI's CAPI endpoint in addition to the browser pixel. The plugin includes built-in deduplication using event IDs, so OpenAI recognizes when the same event arrives from both channels and counts it only once.
For custom server-side implementations, OpenAI provides a REST API endpoint. You send a POST request with the event data to OpenAI's CAPI endpoint. The request must include your pixel ID and access token for authentication.
Frequently Asked Questions
Do I need both browser pixel and CAPI?
OpenAI recommends using both together. The browser pixel captures real-time events, while CAPI provides a reliable backup. With deduplication, you never double-count.
Is Ridoway Pixel really free?
Yes. Ridoway Pixel is 100% free and open-source. There are no premium tiers, no hidden fees, and no data collection. We do not sell your data or charge for features.
Can I track custom events?
Yes. Ridoway Pixel supports custom events via WordPress hooks. You can fire any OpenAI Ads event type from your theme or other plugins.
Does Ridoway Pixel work with other page builders?
Yes. The plugin works with any WordPress theme including Elementor, Divi, Gutenberg, and classic themes. It injects the pixel on all pages automatically.
How do I verify my pixel is working?
Install the ChatGPT Pixel Helper Chrome extension. It shows you every event firing on the page in real time, including the event type, parameters, and server response.
What happens when OpenAI updates their pixel?
Ridoway Pixel is actively maintained and updated when OpenAI makes changes to the pixel or CAPI endpoint. Updates are delivered automatically through the WordPress plugin system.
Ready to track your OpenAI Ads conversions?
Install the Ridoway Pixel plugin and start tracking conversions in 5 minutes. No credit card required.