Skip to content
Code samples below use example values.

ChatGPT Ads

ChatGPT Ads are sponsored placements that can appear alongside ChatGPT's answers, sold self-serve through OpenAI's own ad platform at ads.openai.com since May 2026. Today, Adsidian connects a client's ad account and delivers verified conversions to it through Prism. Campaign and spend syncing, in-dashboard campaign creation, and write-back of changes are arriving in stages on top of that same connection — this page will grow to cover them as they land.

Before you start

  • An ad account at ads.openai.com, with its brand review approved. Part of that review is a brand icon of at least 128×128 pixels set on the account — an account without one can't serve ads yet.
  • An API key, issued from the ad account's Settings tab. OpenAI issues one key per ad account. Treat it like a password: anyone with it can act on the account through the API.

Connecting

This is a per-client setup, done from the client's Prism setup in the Adsidian dashboard.

  1. Paste the API key. Adsidian looks up the account and shows its name, currency, and timezone so you can confirm it's the right one.
  2. Brand icon. Adsidian tries to set the account's brand icon from the client's own site icon automatically. If OpenAI hasn't enabled brand updates for the account yet, this step will tell you so — upload the icon directly in Ads Manager instead, and ask your OpenAI rep to enable partner API access at openai.com/advertisers so future accounts don't need the manual step.
  3. Conversions. Choose Provision for me to have Adsidian create the pixel and conversion events on the account automatically, or paste the Pixel ID and Conversions API key yourself from Ads Manager's Conversions tab. Either way, the Conversions API key is shown only once at creation — copy it when you generate it.
  4. Send a test event. Confirms the credentials actually work before anything goes live.
  5. Enable. Turns on conversion delivery for the account.

What Prism sends

Once enabled, Prism delivers server-side conversion events to ChatGPT Ads the same way it does for Meta, Google, and Reddit. Prism's event names are mapped to OpenAI's:

Prism eventChatGPT Ads event
PageViewpage_viewed
ViewContentcontents_viewed
AddToCartitems_added
InitiateCheckoutcheckout_started
Purchaseorder_created
Leadlead_created
CompleteRegistrationregistration_completed
Scheduleappointment_scheduled
Subscribesubscription_created
StartTrialtrial_started
anything elsesent as a custom event under its own name

A few things worth knowing about what goes into each event:

  • Purchases carry full value — amount, currency, and line items (product, quantity, price) are included, not just that a purchase happened.
  • Click reference is captured on landing. Like gclid or rdt_cid for other platforms, Prism captures ChatGPT's click reference (oppref) from the URL the moment a visitor arrives from a ChatGPT ad, with no separate setup step.
  • Only hashed identifiers are sent — email, phone, and other identifying fields are hashed before they leave the browser.
  • IP address is sent only when IP anonymisation is off for the client, mirroring how Prism handles Meta CAPI.
  • Consent gating applies unchanged — an event is only sent if the visitor's consent state allows it, same as every other destination Prism delivers to.

Limits worth knowing

  • Budgets are lifetime, not daily. ChatGPT Ads campaigns carry a lifetime budget only — there's no per-campaign daily budget the way Meta and Google support.
  • Ads are image cards, not video. Title is capped at 50 characters, body text at 100, and there's no video ad format.
  • Review is fast. Every ad is reviewed by OpenAI, typically clearing in minutes rather than hours.
  • Custom events can't be optimisation goals. Only OpenAI's standard event types (like order_created or lead_created) can be chosen as what a campaign optimises toward.
  • Conversion-optimised bidding needs OpenAI's sign-off. Bidding toward a conversion event only becomes available once OpenAI enables it on the account — ask your OpenAI rep if it isn't showing up.

Troubleshooting

SymptomLikely cause / fix
"Invalid API key"The key was mistyped, revoked, or regenerated in Ads Manager. Generate a fresh key from the account's Settings tab and paste it in again.
"Partner enablement required" (brand icon step)OpenAI hasn't turned on partner API access for this account yet. Upload the icon manually in Ads Manager, and ask your OpenAI rep to enable it at openai.com/advertisers.
"Conversions not configured"The pixel and Conversions API key haven't been saved yet — finish the wizard's conversions step, either provisioning automatically or pasting both values from Ads Manager.
Test event failsThe wizard shows OpenAI's response verbatim — read it first, it usually names the exact field or credential that's wrong.
Not sure if conversions are actually arrivingCheck delivery status in Prism Review or the diagnostics view — both show whether recent events reached ChatGPT Ads successfully.

Next

Adsidian Prism — first-party server-side tracking.