About

Heading

ChatGPT Ads Insights API — OpenAI dev docs, 2026-07-01

6

metrics are all the ChatGPT Ads Insights (Reporting) API returns — impressions, clicks, spend, ctr, cpc, and cpm. ROAS, conversions, and revenue are not columns in it. Conversions live separately in the pixel and Conversions API, which is the first thing to understand before you wire up measurement.

Source: OpenAI Ads Insights API reference; retrieved 2026-07-01

The OpenAI-Native Measurement Stack, at a Glance

Measurement for ChatGPT Ads is not bolted onto Google or Meta — it is OpenAI’s own. Everything lives under Ads Manager at ads.openai.com, organized as ad account → campaign → ad group → ad, and the whole measurement layer is made of four surfaces you meet in the order the work happens: the Insights (Reporting) API for performance data, the JavaScript pixel (oaiq) for browser-side events, the Conversions API (CAPI) for server-side events, and the broader Advertiser API for managing campaigns, ad groups, ads, ad accounts, insights, and file uploads. You set all of this up when you advertise on ChatGPT; for the full picture of what ChatGPT ads are, start with the overview pillar.

That native shape is both a strength and a limitation. It is a strength because it is first-party end to end — the pixel, the conversion events, and the reporting all come from one system, with no data-loss handoff between vendors. It is a limitation because there is no first-party GA4, Google Ads, or Meta connector: third-party Google Tag Manager templates, reporting connectors, and the Singular mobile-measurement partner bridge the OpenAI-native stack to the tools you already run, but OpenAI itself does not publish those integrations. MB Adv Agency runs the paid-media programs — Google Ads conversion tracking, server-side tagging, the Meta pixel — that a new channel like ChatGPT Ads slots into, so the mental model transfers cleanly even though the plumbing is new: a reporting API, a browser pixel, and a server-side conversions endpoint are exactly the three pieces we instrument on every mature paid channel.

One honest framing before the mechanics. Demand for this topic is curiosity-led, not implementation-led. The head term “chatgpt ads” draws about 3,600 US searches a month (Ahrefs, KD 42, CPC $8.00), while the product-mechanic terms are tiny — “chatgpt ads manager” sits near 150 and “chatgpt ads api” near 10. The job of a measurement page for a five-month-old product is therefore to be the correct, cited answer for the small, high-intent audience actively wiring up tracking — not to chase volume, and not to invent the certainty that thinner pages fake.

How Much Are People Searching for ChatGPT Ads? (US, Ahrefs)

US monthly search volume for the ChatGPT-Ads vocabulary (Ahrefs Keywords Explorer, 12-month average, retrieved 2026-07-01). The head term “chatgpt ads” (3,600/mo) dwarfs the product-mechanic terms — “chatgpt ads manager” (150) and “chatgpt ads api” (10) are tiny — so demand is curiosity-led, not implementation-led. Source: Ahrefs, retrieved 2026-07-01. Not mbadv client data.

Key Takeaways

  • Measurement runs on an OpenAI-native stack — the Insights (Reporting) API, the oaiq JavaScript pixel, the Conversions API, and the broader Advertiser API, all under Ads Manager at ads.openai.com.
  • The Insights API returns six metrics — impressions, clicks, spend, ctr, cpc, and cpm. ROAS, conversions, and revenue were not columns in reporting at launch.
  • Conversions are tracked with the pixel and the Conversions API. Run both and give each event a shared id so the browser and server events deduplicate into one counted conversion.
  • There is no published attribution window. The only 7-day figure in the docs is a Conversions API ingestion limit — the deadline to submit an event, not a rule for which ad gets credit.
  • There is no native GA4, Google Ads, or Meta integration. Singular is the only mobile-measurement partner with a published integration (May 21, 2026); third-party GTM templates and connectors bridge the rest.

Reporting With the Insights API: Metrics, Dimensions, Freshness

The Insights (Reporting) API is the layer that answers “how are the ads performing.” It returns six metrics verbatim — impressions, clicks, spend, ctr, cpc, and cpm — and you request them at one of four levels: ad_account, campaign, ad_group, or ad. You can add a single optional breakdown at a time — product (with fields like feed_id, item_id, title, price, and availability), country, or device — and bucket the result hourly, daily, monthly, or none, over date ranges expressed as unix_range, hour_range, or date_range (bounded within five years and not in the future). Reporting is hourly-fresh.

The load-bearing detail is what the list does not contain. There are six metrics here, and none of them is ROAS, conversions, or revenue — those columns were not exposed in the Insights API at launch. That is deliberate to say plainly, because it is the single most common thing people get wrong about ChatGPT Ads reporting: efficiency numbers do not arrive pre-computed the way a mature Google Ads column set delivers them. Conversions are counted elsewhere — in the conversions tab, through the pixel and Conversions API covered below — and you reconstruct efficiency yourself. Which metrics actually matter, and how to frame them into a KPI set, maps onto the same metrics and KPIs discipline you already apply on paid search.

Table 1 — OpenAI Ads Insights (Reporting) API: metrics and dimensions (developers.openai.com/ads/api-reference/insights, retrieved 2026-07-01). ROAS, conversions, and revenue columns are NOT in the Insights API. Not mbadv client data.
ElementValues (verbatim from the dev doc)
Metricsimpressions, clicks, spend, ctr, cpc, cpm
Report levelsad_account, campaign, ad_group, ad
Optional breakdown (one at a time)product (feed_id, item_id, title, price, availability), country, device
Time bucketshourly, daily, monthly, none
Date rangesunix_range, hour_range, date_range (within 5 years, not in the future)
Not availableROAS, conversions, revenue columns — not exposed in reporting at launch

Source: OpenAI Ads Insights API reference, retrieved 2026-07-01.

The JavaScript Pixel (oaiq) and Standard Events

Browser-side conversion tracking runs on a global called oaiq. You create a Pixel ID in the conversions tab of Ads Manager, initialize the pixel with oaiq("init", { pixelId }), and record events with oaiq("measure", …). It ships ten standard events — page_viewed, contents_viewed, items_added, checkout_started, order_created, lead_created, registration_completed, appointment_scheduled, subscription_created, and trial_started — plus custom events via custom and a required custom_event_name. If you know the Meta pixel and conversion tracking, oaiq will feel familiar: name a standard event, fire it on the matching page.

The pixel can attach hashed first-party data for stronger matching — email_sha256 and external_id_sha256 (sent as lowercase, 64-character SHA-256 hexadecimal strings), plus country, city, and zip_code — and it stores oppref in a first-party __oppref cookie so later page views reuse it. Treating that hashed PII and the cookie correctly is a privacy question in its own right; the consent and data-handling depth is covered in ChatGPT ads privacy and data. On the delivery side, firing the pixel cleanly is the same craft as our server-side tracking work on other channels.

Table 2 — OpenAI Ads JavaScript pixel (oaiq) standard events (developers.openai.com/ads/measurement-pixel, retrieved 2026-07-01). Custom events are supported via custom plus a custom_event_name. Not mbadv client data.
Standard eventTypical use
page_viewedAny page load
contents_viewedProduct or content view
items_addedAdd to cart
checkout_startedCheckout begun
order_createdPurchase completed
lead_createdLead-gen form submit
registration_completedAccount or signup created
appointment_scheduledBooking made
subscription_createdSubscription started
trial_startedFree trial started

Source: OpenAI Ads measurement pixel, retrieved 2026-07-01.

The Conversions API (CAPI): Server-Side Events and Deduplication

The Conversions API is the server-to-server complement to the pixel. You send events to POST https://bzr.openai.com/v1/events, authenticated with a Bearer token. Each event needs a unique id, a type (a standard event name or custom), and a timestamp_ms in milliseconds. The action_source tells OpenAI where the conversion happened — one of web, mobile_app, offline, physical_store, phone_call, email, or other — and a single request batches up to 1,000 events. Server-side tagging in GTM is how most teams will actually deliver these events, and it is the same pattern as our server-side tracking engagements.

The rule that matters most sits on the timestamp. An event’s timestamp_ms “must be within the last 7 days and no more than 10 minutes ahead.” That is an ingestion window — the deadline for submitting an event so OpenAI will accept it — and it is explicitly not an attribution window. Deduplication closes the loop: send the browser event and the server event with the same value for the API id and the pixel event_id (and the same Pixel ID), and OpenAI counts one conversion rather than two. The Google Ads equivalent — conversion tracking and attribution — is the closest analog if you are translating from a paid-search setup.

Table 3 — Browser pixel vs server-side Conversions API for ChatGPT Ads (developers.openai.com/ads/measurement-pixel + /ads/conversions-api, retrieved 2026-07-01). Run both with a shared event id to deduplicate. Not mbadv client data.
DimensionJavaScript pixel (oaiq)Conversions API (CAPI)
Where it runsIn the browserServer-to-server
Transportoaiq("measure", …)POST https://bzr.openai.com/v1/events
AuthPixel ID (from the conversions tab)Bearer token
TimingReal-time on the pageEvent timestamp_ms within the last 7 days (ingestion)
BatchPer eventUp to 1,000 events per batch
DedupShared event_idShared id (same value, same Pixel ID)

Source: OpenAI Ads Conversions API, retrieved 2026-07-01.

Bar chart: US monthly search volume - 'chatgpt ads' 3,600 leads, then 'openai ads' 1,000, 'chatgpt advertising' 600, 'chatgpt ads manager' 150, 'chatgpt ads api' 10. Source: Ahrefs, retrieved 2026-07-01.

Instrument it like any new channel

Wire ChatGPT Ads Measurement Into Your Existing Stack

MB Adv Agency runs the paid-media programs — Google Ads, Meta, and the broader paid mix — that a new channel like ChatGPT Ads slots into. The pixel-and-CAPI plumbing is the same craft as our server-side tracking and GA4 audit work, and for software companies leaning on both, see our SaaS PPC services.

Talk to our team →

Attribution: What OpenAI Has Published (and What It Hasn’t)

Here is the honest center of the page: OpenAI has not published an attribution window for ChatGPT Ads. The only “7 days” anywhere in the documentation is the Conversions API ingestion constraint — an event’s timestamp_ms must be within the last 7 days (and no more than 10 minutes in the future) to be accepted. That governs when OpenAI will ingest a conversion event. It says nothing about which ad receives credit for a conversion, or over what look-back period.

Keeping the two ideas separate is the whole discipline. Ingestion is the deadline to submit an event so it is accepted. Attribution is the rule for which ad gets credit for a conversion and over what window. OpenAI publishes the former and not the latter, so any specific “7-day click” or “28-day” attribution figure you see quoted elsewhere is unverified — do not treat it as OpenAI-published. CPA bidding, turned on for select advertisers on May 28, 2026, is built on the conversion pixel and optimizes to conversions internally; that is not the same as OpenAI exposing an attribution model or a ROAS column to advertisers. How CPC and CPM are report metrics here versus how ads are actually charged is covered in how much ChatGPT ads cost, and the cross-channel view of crediting conversions lives in conversion tracking and attribution.

GA4, MMPs, and the OpenAI-Native Stack

The integrations reality is simple to state: there is no native GA4, Google Ads, or Meta integration. The stack is OpenAI-native, and third-party tools normalize into or out of it — Google Tag Manager templates to fire the pixel, connectors such as Supermetrics to pull reporting, and the Singular mobile-measurement partner’s bidirectional integration (shipped May 21, 2026) for app and mobile measurement. GA4’s own conversions and key events model is the reference point for how a native event taxonomy usually looks, and if you rely on GA4 for cross-channel reporting, a GA4 audit is where that reconciliation lives.

Be precise about the mobile-measurement boundary. Singular is the only MMP with a published ChatGPT Ads integration; there is no published AppsFlyer, Adjust, or Kochava integration as of 2026-07-01 — that is unknown, not confirmed-unavailable, and the honest word is “not yet.” For web conversions you use the pixel and Conversions API directly, the same way you would run the Meta pixel and conversion tracking on a social campaign.

What’s Not Available Yet

Advertisers deciding whether the channel is measurable enough to trust budget to deserve the gaps in one place. As of 2026-07-01: (a) no published attribution window — only the 7-day CAPI ingestion limit; (b) no ROAS, conversion, or revenue columns in the Insights API — they were not exposed in reporting at launch; (c) no native GA4, Google Ads, or Meta integration; (d) no view-through or demographic reporting; and (e) no MMP beyond Singular with a published integration.

The right way to read that list is “young but real,” not “vaporware.” The measurement primitives — a reporting API, a browser pixel, a server-side Conversions API, and clean deduplication — are genuinely shipped and documented. What is missing is the reporting polish: attribution models, ROAS columns, and first-party connectors. MB Adv Agency would measure this the way we measure any new channel with a thin native reporting layer — instrument the pixel and CAPI cleanly, deduplicate properly, and reconcile in our own reporting rather than expecting a turnkey ROAS column on day one. For how this measurement stack compares against Google and social, see ChatGPT ads vs Google and social ads.

Frequently Asked Questions

How do you track ChatGPT ads conversions?

With OpenAI’s own conversion tools, set up in the conversions tab of Ads Manager. You install the JavaScript pixel (oaiq) on your site to fire standard events like order_created, lead_created, and checkout_started, and/or send the same events server-to-server through the Conversions API (a POST to https://bzr.openai.com/v1/events with a Bearer token). If you run both, give each event a shared id so the browser and server events deduplicate into one conversion. There is no native Google Ads, Meta, or GA4 connector — the stack is OpenAI-native, and third-party tools (Singular, Supermetrics, GTM templates) normalize into it.

Is there a ChatGPT ads pixel?

Yes. OpenAI publishes a JavaScript measurement pixel called oaiq, created in the conversions tab of Ads Manager. You initialize it with a Pixel ID (oaiq("init", { pixelId })) and record events with oaiq("measure", …). It supports ten standard events (page_viewed, contents_viewed, items_added, checkout_started, order_created, lead_created, registration_completed, appointment_scheduled, subscription_created, trial_started) plus custom events. It can attach hashed PII (email_sha256, external_id_sha256, sent as lowercase 64-character SHA-256 hex, plus country, city, and zip) and stores a first-party __oppref cookie.

What’s the attribution window for ChatGPT ads?

OpenAI has not published an attribution window. This is the single most common thing people get wrong about ChatGPT Ads measurement. The only “7 days” in the documentation is a Conversions API ingestion constraint — an event’s timestamp_ms must be within the last 7 days (and no more than 10 minutes ahead) to be accepted. That governs when OpenAI will ingest a conversion event, not how ads receive credit for conversions or over what look-back window. Treat any specific “7-day click / 28-day” attribution number you see elsewhere as unverified.

Does ChatGPT ads integrate with GA4?

No — there is no native GA4 integration. The measurement stack is OpenAI-native: its own Insights API, pixel, and Conversions API. You can bridge into or out of it with third-party tooling — a Google Tag Manager template to fire the pixel, connectors such as Supermetrics for reporting, or the Singular MMP integration (shipped May 21, 2026) for app measurement — but OpenAI does not publish a first-party GA4, Google Ads, or Meta connector.

What metrics does the ChatGPT ads Insights API report — does it show ROAS?

The Insights (Reporting) API returns impressions, clicks, spend, ctr, cpc, and cpm, reported at the ad_account, campaign, ad_group, or ad level, with optional breakdowns by product, country, or device, in hourly, daily, or monthly buckets. It does not return ROAS, conversions, or revenue columns — those were not exposed in reporting at launch. Conversions live in the conversions tab via the pixel and CAPI, and CPA bidding for select advertisers optimizes to them internally rather than surfacing a ROAS column.

Can I measure ChatGPT ad conversions with an MMP like AppsFlyer or Adjust?

Only Singular has a published, bidirectional ChatGPT Ads integration (shipped May 21, 2026), covering app and mobile measurement. There is no published AppsFlyer, Adjust, or Kochava integration as of 2026-07-01 — that is unknown, not confirmed unavailable. For web conversions you use the pixel and Conversions API directly.

Next in the ChatGPT Ads series

See How ChatGPT Ads Stack Up

You have the measurement mechanics — now put them in context. The comparison pillar sets the ChatGPT-native stack against Google and social, from reporting depth to attribution and integrations.

Read the comparison →

Methodology & Sources

This pillar grounds every product mechanic in OpenAI’s hard-primary developer docs, fetched 2026-07-01: the Insights metrics, the ten pixel standard events, the CAPI fields, the https://bzr.openai.com/v1/events endpoint, the action_source values, and the batch and deduplication rules are copied verbatim from the Insights API reference, the measurement pixel, and the Conversions API. The 7-day figure is the CAPI ingestion window, stated as such and never converted into an attribution claim, because OpenAI has published no attribution window. The absence of ROAS, conversion, and revenue columns is confirmed from the Insights API doc, not inferred. The self-serve Ads Manager, third-party-measurement promise, and CPA bidding are reported by Digiday and Search Engine Journal; the Singular integration by Singular; and CPA bidding by Digiday. Search-demand figures are Ahrefs Keywords Explorer (US, 12-month average, retrieved 2026-07-01). No mbadv client metrics appear in this article — MB Adv Agency has no ChatGPT-Ads service page, and its perspective here is qualitative. Reviewed by MB Adv Agency, July 2026.

Book a call!

Ready to stop guessing and start winning? Fill out the form — we’ll take it from here.

Submit
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.