How it works
ChatGPT Ads adds a click reference calledoppref to your landing page every time someone clicks one of your ads. When Cometly records a conversion, it looks for the ChatGPT ad click that drove it and sends the event to OpenAI with that click reference, along with hashed email, phone and name so OpenAI can match it.
- A visitor clicks your ChatGPT ad and converts on your site.
- Cometly attributes the conversion to that ad.
- Cometly sends the mapped event to OpenAI’s Conversions API server-to-server, using the pixel of the ad account that ran the ad.
Before you start
- An active ChatGPT Ads account connected in Cometly (Integrations > Ad Platforms > ChatGPT Ads). See ChatGPT Ads integration.
- A web data source (pixel) on each ad account, created in ChatGPT Ads Manager under the Conversions tab. If you don’t see the Conversions tab, ask your OpenAI ads representative to enable conversion tracking for your account.
-
Cometly’s URL parameters on your ChatGPT campaigns, so conversions can be attributed to the right ad:
Set up the ChatGPT Ads Conversion API
For most spaces (a space is your workspace in Cometly, with its own settings, integrations and data), setup is two clicks: pick a data-sharing mode and click Save. Cometly finds your pixel, creates the Conversions API key and maps your standard events. The steps below explain what happens and the few cases that need a decision from you.Open the Conversion API settings
Choose a data-sharing mode
- Turn off data sharing: no events are sent to ChatGPT Ads.
- Send only attributed events (recommended): send only events that Cometly can attribute to a ChatGPT ad click.
- Send all events: send all events, including unattributed ones, which OpenAI matches on hashed email, phone and name.
Check the pixel and key for each ad account
- Pixel: Cometly lists the account’s web data sources by name, with each Pixel ID underneath. If the account has one pixel, Cometly selects and stores it for you. If it has several, choose the one your site uses.
- Conversions API key: created for you when you click Save. If you’d rather use a key you created in ChatGPT Ads Manager, paste it into the field instead.
- Default account: the account that receives events Cometly can’t attribute to a specific ChatGPT ad. With a single account, it is already selected. With several, select Use this account for unattributed events on one of them.
- Pixel and key saved: the account is ready.
- Key created when you save: clicking Save finishes it.
- Click Save to store your changes: you’ve picked or pasted something that isn’t stored yet.
Check the event map
Save
Check it worked
After you click Save, the ChatGPT Ads row on the Conversion API tab shows an Active badge instead of Inactive, and each ad account under Pixel and Conversions API key per ad account reads Pixel and key saved. From then on, Cometly sends new mapped conversions to ChatGPT Ads.Event mapping rules
- One map covers the whole space. Every connected ChatGPT Ads account uses the same event map.
- Multiple Cometly events can map to the same OpenAI event type.
- Only mapped events are sent. If a Cometly event isn’t mapped, it is never sent to ChatGPT Ads.
- Pick a standard event where one fits. Send purchases as Order created and leads as Lead created, and use Custom event only for anything else.
Good to know
- Once active, Cometly sends mapped conversions to ChatGPT Ads going forward. It does not backfill past events.
- OpenAI only accepts events from the last 7 days. A conversion recorded later than that, such as a deal closed in your CRM weeks after the click, is not sent.
- Each conversion is sent to the pixel of the ad account whose ad drove it. Events Cometly can’t attribute go to your default account when you choose Send all events.
- If you also run OpenAI’s own pixel and it tracks the same event, don’t map that event here too. OpenAI only removes duplicates that share an event ID, and the pixel’s IDs won’t match Cometly’s, so the conversion would be counted twice.
Troubleshooting
No conversions showing up in ChatGPT Ads
No conversions showing up in ChatGPT Ads
- Confirm your data-sharing mode isn’t set to Turn off data sharing.
- Confirm the Cometly event is mapped to an OpenAI event type. Unmapped events are never sent.
- Confirm the ad account shows Pixel and key saved.
- Confirm your campaigns carry Cometly’s URL parameters so conversions can be attributed.
The pixel field says the list isn't available, or shows no pixels
The pixel field says the list isn't available, or shows no pixels
Saving says OpenAI has not enabled Conversions API key creation for this ad account
Saving says OpenAI has not enabled Conversions API key creation for this ad account
An account shows Choose a pixel or Not set up yet
An account shows Choose a pixel or Not set up yet
Events show: Authentication failed, check the Conversion API key
Events show: Authentication failed, check the Conversion API key
Some events show: no source url
Some events show: no source url
No active ChatGPT Ads accounts in this space
No active ChatGPT Ads accounts in this space
My custom event isn't showing in ChatGPT Ads
My custom event isn't showing in ChatGPT Ads
Frequently asked questions
Should I wait before turning on the ChatGPT Ads Conversion API?
Yes, if your event tracking is new. Cometly recommends waiting at least 7 days after you set up event tracking, so you can verify that your events are accurate before they are sent to an ad platform. The Conversion API tab shows a banner that tells you when your event data is ready.What data does Cometly send to ChatGPT Ads?
Cometly sends the mapped event and, for purchases, the order amount and currency. To help OpenAI match the conversion, it also sends the ChatGPT click reference when there is one, plus hashed email, phone and name, and the visitor’s IP address, browser user agent, country and postal code when Cometly has them.Does Cometly create a ChatGPT Ads pixel for me?
No. Cometly reads the pixels (web data sources) that already exist on your ad account and creates the Conversions API key, but it never creates a pixel. A second pixel would split your conversions across two data sources, so create one in the Conversions tab of ChatGPT Ads Manager and select it in Cometly.Next steps
- Connect or manage your ChatGPT Ads account
- Exclude an event from the Conversion API after an opt-out
- Confirm Cometly received an event in the Events Log
- Learn how events work in Cometly
- Set up the Conversion API for another ad platform