Connect OpenAI Ads (ChatGPT)
Step-by-step guide to connect your OpenAI Ads account (ads in ChatGPT) with an API key, understand synchronization and how conversions are read.
Goal
By the end of this guide, your OpenAI Ads campaigns (ads in ChatGPT) will be synchronized in Metrikia with their performance metrics, ready to be matched with your CRM data for a real ROAS.
Prerequisites
- An active Metrikia account
- An OpenAI Ads account with an active ad account
- Access to that account's Settings in OpenAI Ads Manager
Step 1: Create an API key in OpenAI Ads Manager
- Sign in to OpenAI Ads Manager and open the ad account to connect
- Open Settings > Advertiser API key
- Create a key for this ad account and copy it
Good to know: one key gives access to a single ad account. Keep it somewhere safe and do not share it.
Step 2: Paste the key in Metrikia
- Go to /app/settings, section Integrations
- Open the OpenAI Ads card and click Connect
- Paste the API key in the dedicated field, then confirm
Step 3: Initial synchronization
The account appears among your connected ad sources and the first synchronization starts automatically. Campaigns, ad groups and ads show up within minutes, performance (spend, impressions, clicks) within the hour. Data is then synchronized automatically.
Several ad accounts
One key matches one account. To track several accounts, create one key per account in OpenAI Ads Manager, then connect one source per key by repeating step 2.
Conversions and revenue
Metrikia counts as conversions only the purchases (order_created) reported by OpenAI, and only for campaigns that measure purchases exclusively.
- A lead or trial campaign shows 0 platform conversions: this is expected. Your leads come from your forms and your CRM, as for your other channels.
- Revenue is the value of the purchases attributed by OpenAI.
- Conversions appear with a one day delay on OpenAI's side: the current day can show spend without conversions.
Troubleshooting
"API key invalid or revoked"
The key was deleted or regenerated in OpenAI Ads Manager. Create a new key and reconnect the source. Apart from this case, the key does not expire.
The account shows empty
An account with no campaign returns no data. This is not an error: data appears as soon as your first campaign runs.
My OpenAI leads do not show up
OpenAI Ads does not provide lead forms. Your leads come in through your forms and your CRM. To link each lead to the exact ad, set up the OpenAI Ads URL parameters (dedicated guide).
Next step
Set up the OpenAI Ads URL parameters to attribute each visit to the exact ad, then explore your performance in ADS.
To go further, check out our blog, the documentation or contact support.