How do I track conversions from ChatGPT ads?
TofuAnswer by the Tofu team · checked

Use OpenAI's Measurement Pixel on your site and its Conversions API on your server, with one shared event ID so each lead counts once. Then create a conversion event setting for that event, such as lead_created, and attach it to your campaigns. Check arrivals with OpenAI's recent-events endpoint, which labels browser events pixel_sdk and server events server_to_server. Allow at least a day before conversions show in reports, and attach the setting before launch: goal reporting counts only from when you attach it.
Ask Tofu next
Pick a question and Tofu Ads Agent answers it in chat.
- How do I pass the oppref click ID from my landing page into my CRM?
- Set up the OpenAI Measurement Pixel in Google Tag Manager with Consent Mode
- Why do ChatGPT Ads Manager and my CRM show different lead counts?
- Which conversion event should my demo request form send to ChatGPT ads?
- Should I run a ChatGPT ads Conversions campaign or a Clicks campaign?
As of November 2026.
Before you start
- Access to conversion setup. You create a Pixel ID and a Conversions API key in the conversions tab of Ads Manager. OpenAI says pixel and key creation must be enabled for the ad account; if those API endpoints return
404withNot found, contact your OpenAI partner representative. - A developer who can edit your site's
<head>(or your tag manager) and your form handler. - One standard event per action. OpenAI's list includes
lead_created,appointment_scheduled,registration_completedandtrial_started. Our page on whether ChatGPT ads are worth testing for B2B covers which fits a form or a demo.
Step 1: Create a Pixel ID
In Ads Manager, open the conversions tab and create a Pixel ID. Search Engine Roundtable places the tab under Tools > Conversions; OpenAI's help page on it couldn't be read to confirm the path.
Every setup needs a Pixel ID, even a server-only one. When you use both the Pixel and the Conversions API on one website, reuse the same data source. Through the API, creating a pixel returns pixel_id (for sending events) and id (for picking the source in Step 5).
Step 2: Install the Measurement Pixel
Paste OpenAI's snippet near the top of the <head> on every page where a conversion can happen. It loads oaiq.min.js from bzrcdn.openai.com and calls oaiq("init", { pixelId: "..." }). Add debug: true to the init call while you test; it logs Pixel activity to the browser console.
When the form succeeds, send the event with your own event ID:
oaiq("measure", "lead_created", { type: "customer_action" }, { event_id: "lead_8F2K19" });
Three things to set up now:
- Consent. Call
oaiq("consent", false)before init, thenoaiq("consent", true)once the visitor agrees. Events blocked while consent was false are not replayed. - Content Security Policy. If your site has one, allow
https://bzrcdn.openai.cominscript-srcandconnect-src, andhttps://bzr.openai.cominconnect-srcandimg-src. - The click ID. The Pixel reads
oppreffrom the landing page URL and stores it in a first-party__opprefcookie for 30 days. It also sets an__obrefbrowser reference cookie for 365 days. The Pixel sets them only while consent is granted, andoaiq("consent", false)removes both. Both are on your domain, so a booking step on another company's site won't see them; fire the event on your own thank-you page or from your server.
Google Tag Manager. OpenAI's developer docs don't cover it, but OpenAI publishes a GTM web tag template on GitHub (openai/ads-measurement-pixel-gtm-template) that you import under Templates; its README says it isn't in the Community Template Gallery yet. Stape, a third party, also publishes open-source templates: "OpenAI Ads Pixel by Stape" for web containers (in the GTM Template Gallery, with Google Consent Mode support) and a Conversions API tag for server-side containers. Or paste OpenAI's snippet into a Custom HTML tag.
Step 3: Send the same lead from your server
Create a Conversions API key in the same conversions tab. It is separate from your Advertiser API key; keep both on your server. Then post events to https://bzr.openai.com/v1/events?pid=<PIXEL-ID> with the key as a Bearer token:
{
"events": [{
"id": "lead_8F2K19",
"type": "lead_created",
"timestamp_ms": 1794153600000,
"action_source": "web",
"source_url": "https://www.example.com/demo/thanks",
"oppref": "<value from the landing URL or __oppref cookie>",
"user": {
"obref": "<value of the __obref cookie>",
"emails_sha256": ["<SHA-256 of the trimmed, lowercased email>"],
"ip_address": "203.0.113.1",
"user_agent": "Mozilla/5.0 ..."
},
"data": { "type": "customer_action" }
}]
}
What OpenAI requires and recommends:
opprefis on you. The Conversions API doesn't capture it. Pass it through your form, for example in a hidden field, and send it unchanged. OpenAI's tracking template example addsclick_id={oppref}to landing URLs, so your CRM can also capture it from the URL.obrefgoes insideuser. Read the__obrefcookie in the browser, send it to your server and pass it without hashing. Stop if the visitor withdraws consent.- Hash personal data. Trim and lowercase emails, then send the SHA-256 hash as 64 lowercase hex characters. Each list holds at most three values. Send IP address and user agent unhashed.
- Timing.
timestamp_msmust be within the last 7 days and no more than 10 minutes in the future. Our B2B page covers what that limit means for later pipeline stages. - Send every lead, not only those with an
oppref. OpenAI says this lets view-through conversions count. - Test first. Add
"validate_only": trueat the top level to check a request without saving it. A batch holds up to 1,000 events, and one bad event fails the whole batch, so validate before you send in bulk.
Step 4: Use one event ID in both places
OpenAI matches duplicates on three things: the Pixel ID, the event name and the event ID (event_id in the Pixel, id in the API). For custom events, custom_event_name must match too. OpenAI keeps the first event it receives and ignores later copies.
So generate the ID once, when the form submits, and hand the same value to the Pixel and to your server. Reuse it if your server retries.
Step 5: Define the conversion and attach it to campaigns
Sending events doesn't make them conversions; a conversion event setting picks one event from one source. Through the API, create it with event_type: "lead_created", attribution_window_days: 30 (the value OpenAI's reference says to use) and source_ids set to the source's id, not its pixel_id. OpenAI's help page on the Ads Manager screens for this step couldn't be read.
Then attach the setting to each campaign in conversion_event_setting_ids. That field replaces the whole list, so include any settings you already had. Clicks and impressions campaigns can track conversions without changing their objective. A conversion-optimized campaign needs exactly one active standard event setting, and you can't change it after the campaign is created.
Step 6: Check that events arrive
- In the browser. With
debug: true, submit a test lead and watch the console. The Network tab should show a request tobzr.openai.com. - In the recent-events sample. Call
GET https://api.ads.openai.com/v1/conversions/eventswith yourpidandlimit=50. It returns a sample from roughly the last 15 minutes. Check the event type, the source and the channel:pixel_sdkfor the browser,server_to_serverfor your server. With both set up, look for your test lead under each channel. Validate-only requests don't appear here. - In Event Quality Score. According to Search Engine Roundtable (September 16, 2026), Ads Manager shows a 1 to 10 setup score for eligible Pixel and Conversions API sources under Tools > Conversions, with user-data coverage and recommendations. OpenAI's help article on event quality couldn't be read to confirm the details.
- In reports, a day later. OpenAI says conversions update through daily processing, so allow at least one day.
Step 7: Compare numbers on the same settings
OpenAI's reporting API defaults to a 30-day click window, a 1-day view window and "ad-event time," which dates each conversion by the click or view, not by the day the lead came in. Your CRM dates leads by when they arrive. To compare, pick the same dates, set the view window to 0 and, in the API, set attribution_time_basis to conversion_time. OpenAI says to use the same dates, time basis and windows when you compare the API with Ads Manager. Search Engine Roundtable reported on September 16, 2026 that Ads Manager lets you choose a 7, 14 or 30-day click window and a 0 or 1-day view window.
OpenAI's pages disagree on one point. Its Reporting page and September 30, 2026 changelog say the API's conversions total counts click-throughs plus view-throughs; its Pixel and Conversions API pages say Ads Manager shows view-throughs separately, with Conversions staying click-through only. Check which your report uses before comparing it with Google or LinkedIn.
Common problems
| Problem | Why it happens | Fix |
|---|---|---|
Pixel or API key creation returns 404 | Conversion setup isn't enabled for the account | Contact your OpenAI partner representative |
| Server events rejected | Timestamp older than 7 days, source_url missing on a web event, more than three values in a user list, or an amount without a currency | Fix the field and test with validate_only |
| Leads counted twice | Different event IDs, names or Pixel IDs on each side | Generate one ID per lead and reuse it |
| Server leads rarely match an ad | oppref and obref aren't passed | Forward both, plus a hashed email |
| Pixel never loads | Your Content Security Policy blocks OpenAI's domains | Add the sources from Step 2 |
| Conversions missing for earlier days | Goal reporting counts only from when the setting was attached | Attach settings before launch |
Sources (12)
- Conversion Tracking - Ads (OpenAI Developers), checked November 8, 2026
- Measurement Pixel - Ads (OpenAI Developers), checked November 8, 2026
- Conversions API - Ads (OpenAI Developers), checked November 8, 2026
- Conversion Setup - Ads (OpenAI Developers), checked November 8, 2026
- Supported Events - Ads (OpenAI Developers), checked November 8, 2026
- Reporting - Ads (OpenAI Developers), checked November 8, 2026
- Overview and changelog - Ads (OpenAI Developers), checked November 8, 2026
- Campaign Management - Ads (OpenAI Developers), checked November 8, 2026
- OpenAI ChatGPT Ads For Sponsored Agents (Search Engine Roundtable, September 16, 2026), checked November 8, 2026
- ads-measurement-pixel-gtm-template (OpenAI on GitHub), checked November 8, 2026
- OpenAI Ads Pixel for Google Tag Manager Web (Stape Community), checked November 8, 2026
- OpenAI Ads Conversion API Tag for Google Tag Manager Server-Side (Stape Community), checked November 8, 2026