> AI agents: this is one page of nextanalytica's docs. The full index for agents: https://nextanalytica.app/llms.txt

# ChatGPT Ads

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

Updated: 2026-11-17

## 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.

## Tag your ads' links

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

```text
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.

Canonical address: https://nextanalytica.app/docs/sources/chatgpt-ads
