Skip to content
KlarvynKlarvyn Help Center

Connect ChatGPT Ads

Connecting ChatGPT Ads brings your campaign spend from OpenAI’s ad platform into Klarvyn — next to the leads and revenue those campaigns actually drove — and can send conversions back so ChatGPT Ads optimizes on real results. ChatGPT Ads uses an API key instead of a login; each key covers one ad account.

  1. In OpenAI’s ads manager, open ads.openai.com → Settings → General. Under API Keys, click Create New Key and copy it (it starts with sk-svc-).

  2. In Klarvyn, go to Settings → Integrations, open ChatGPT Ads and click Connect ChatGPT Ads account. Paste the key into Ads API key and click Connect. The ad account is read from the key — no account ID needed.

  3. Add the tracking parameters to your ads so Klarvyn can credit the exact campaign, ad group and ad. Copy the string from Link Builder → Paid ads → ChatGPT Ads (or Settings → URL parameters):

    kv_adid={ad_id}&kv_oai_cid={campaign_id}&kv_oai_agid={ad_group_id}

    Paste it into each ad’s Tracking parameters field in ads.openai.com.

  4. (Optional) To send conversions, open the ChatGPT Ads page’s Settings tab and fill in Conversions API: the Pixel ID and Conversions API key from a data source you create in ads.openai.com → Conversions.

What it enables

Section titled “What it enables”
  • Spend in your reports — per-day campaign spend, synced every 30 minutes while active and back-filled for the last few days on every run. Import older history (up to 37 months) from the Accounts tab.
  • Click attribution — OpenAI adds its own click id (oppref) to every ad click, so visits from ChatGPT Ads are recognised as paid; the tracking parameters from step 3 add the campaign, ad group and ad.
  • Conversions back to ChatGPT Ads — in Events & Audiences → Conversions, add the platform ChatGPT Ads and map events like Order Created, Lead Created, Appointment Scheduled or Subscription Created.

Good to know

Section titled “Good to know”
  • Two different keys. The Ads API key connects the account; the separate Conversions API key (plus Pixel ID) is only for sending conversions. Without both, conversions are skipped and logged.
  • Spend is campaign-level — ChatGPT Ads doesn’t report spend per ad group or ad, so Creatives won’t show ad-level cost for it.
  • Several ad accounts? Each needs its own key. The Conversions API settings apply to all connected ChatGPT Ads accounts.
  • Conversions need advertising consent and either the oppref click id or the contact’s email.
  • Not yet supported: audience sync.
  • Rotated your key? Reconnect and paste the new one.