Sign inGet started
Sources

ChatGPT Ads

View as MarkdownOpen in ChatGPTOpen in Claude
Connect your agent
Add to CursorAdd to VS Code

Read your ChatGPT Ads spend, impressions, clicks and conversions, by campaign and day. Read-only, never changes your ads.

Updated

What we read

  • Campaigns, ad groups and keywords
  • Spend, clicks, impressions and conversions, by day
  • Read-only: we never change your ads

How it connects

Open Sources > ChatGPT Ads in your project, paste your API key, and click Connect.

To find the key: in ChatGPT Ads Manager: Settings, API keys, create a key and copy it. We only read reports with it.

We check the key with the vendor at once. It is kept encrypted for this project, never shown again, and deleted when you disconnect.

Requirements

  • A ChatGPT Ads account in OpenAI's Ads Manager.
  • An Ads API key: in Ads Manager, Settings > API keys. One key reads one ad account.

What does it sync, and how often?

Spend, impressions, clicks and conversions by campaign and day, in the ad account's currency and days. We sync every hour and read the last 30 days again each time, since ad platforms restate recent days. We only read reports with the key; we never change your ads.

So visits from your ads count by campaign, set the account's tracking template to:

utm_source=chatgpt&utm_medium=cpc&utm_campaign={campaign_id}

OpenAI also adds its click id, oppref, to every ad click. The tag reads it, so these visits count as Paid search from ChatGPT even without the template.

Troubleshooting

"ChatGPT Ads didn't accept this key"

The key was mistyped, deleted, or belongs to another account. Make a new one in Settings > API keys and paste it.

"ChatGPT Ads refused our access: connect it again"

The key stopped working after it was connected. Paste a new key in the source's page.

Related
  • Sources overview: How nextanalytica copies data from the tools you already use, keeps it 30 days, and puts it next to your visits.
  • Google Search Console: Read the Google searches that show your site, with clicks, impressions and position by page and query, next to your visits, in your own agent.
  • Google Analytics 4: Read Google Analytics 4's sessions and key events, by day, source and campaign, next to the tag's visits.
  • Bing Webmaster Tools: Read the Bing searches that show your site, with clicks, impressions and position, by query and page.
  • Odoo: Read Odoo's sales orders and CRM leads, with the campaign Odoo recorded on each, so revenue meets the visits behind it.
Still have questions?
Was this page useful?