OpenAI Conversions API: server side tracking
send ChatGPT Ads conversions server side with the OpenAI Conversions API, pass oppref, and stop double counting with one shared event ID.
last updated 5 November 2026
the OpenAI Conversions API sends ChatGPT Ads conversion events from your server instead of the browser. it uses a Conversions API key from the Conversions section of Ads Manager, reports to the same Pixel ID as the pixel, and catches the events browsers lose: ad blockers, browser privacy changes and people who close the tab before the pixel fires. it is more work than the pixel, and it is the version worth pushing any serious advertiser toward, because browser side tracking loses more events every year.
Pixel, API or both
there are four ways to send conversions, all to the same Pixel ID, and you can run more than one:
- the OpenAI pixel, the
oaiqsnippet in the browser. fastest to install. set up in the pixel chapter. - the Conversions API, server side, covered here.
- the image tag, a no-JavaScript fallback for places that cannot run a script.
- a measurement partner: Adjust, Airbridge, AppsFlyer, Branch, Kochava, Singular or Tenjin. you enter the Pixel ID and Conversions API key in the partner and it forwards events. for apps this is now the main route.
the setup worth having is the pixel and the API together: the pixel for speed and coverage, the API for the events browsers lose. the one risk is counting the same purchase twice, and that has a clean fix.
Setup, step by step
- create a Conversions API key in the Conversions section of Ads Manager, the same place your Pixel ID lives.
- send each server side conversion to that same Pixel ID, so both sources land in one place.
- keep the
opprefvalue from the landing page URL with the sign-up or order record, so your server has it to send. include it in every Conversions API call where you have it. an event that does not carryopprefhas to be matched on weaker signals. - give every conversion one event ID, built from something stable such as your order ID, and send that same ID with the pixel event and with the API event.
- send a
valuewith purchases, the same value the pixel sends. - fire a real test conversion through both paths and confirm it shows up in Ads Manager once, not twice.
Deduplication is one shared ID
when the pixel and the API both report the same conversion with the same event ID, OpenAI keeps one and drops the other. that only works if the two IDs actually match. build the ID from something both sides already know, your order ID or sign-up ID, rather than generating a random number in the browser and another on the server. two different random numbers will never match, and every conversion gets counted twice.
double counting is worse than it sounds under the Conversions objective. delivery optimises toward the signals you send, so inflated conversions do not just flatter the dashboard, they teach the system the wrong thing about who converts.
Why server side tracking matters more for OpenAI ads
two reasons, both from how the platform works. first, the pixel depends on the browser, and the browser is where events go missing. second, the Conversions objective treats your signals as the truth: missing, wrong or delayed events degrade delivery, not just reporting. server side tracking is the part of the setup that keeps those signals arriving when the browser fails.
When the API and Ads Manager still disagree with your analytics
they will, and a difference does not by itself mean an error. attribution windows, time zones, consent and cookie conditions, deduplication rules and modelled conversions all differ between tools. what to do about that is in the measurement checklist.
the full tracking write-up, with sources from OpenAI’s own documentation, is in ChatGPT Ads tracking: OAIQ pixel and OpenAI Conversions API.
next in this playbook: choosing a ChatGPT Ads objective, once your events are arriving.
server side tracking is one leg of the ChatGPT Ads playbook. if you want a second pair of eyes on your Conversions API setup, the breakdown call is free. Let’s talk Growth.
this page is part of the ChatGPT Ads playbook.
More in this playbook
What ChatGPT Ads are and who can run them
OpenAI's ads inside ChatGPT, explained: where they appear, who sees them, how the targeting works, and what you need before a first campaign.
ChatGPT AdsOpenAI pixel (OAIQ) setup for ChatGPT Ads
install the OpenAI pixel, the oaiq snippet, add measure calls for real conversions, keep oppref alive through redirects, and test before you spend.
ChatGPT AdsChoosing a ChatGPT Ads objective
Views, Clicks or Conversions: what each ChatGPT Ads objective is for, why to start on Clicks, and how app installs work with no install objective.
ChatGPT AdsChatGPT Ads attribution: measurement checklist
the checks to run before and after you spend on ChatGPT Ads: events, oppref, deduplication, MMP setup, and why Ads Manager and analytics disagree.