The OpenAI Ads connector imports daily campaign performance data, including impressions, clicks, conversions and spend, so you can report on it in Funnel.
Before you begin
You have a Funnel workspace with Admin or Editor access.
You have an active OpenAI Ads account.
You have an OpenAI Ads API key for each ad account you want to connect. You generate it in the OpenAI Ads dashboard. An OpenAI Platform API key or a Conversions API key won't work.
Connect OpenAI Ads to Funnel
In the left menu, go to Data > Connect > Data sources, and click + Connect data source.
On the Connect data source page, find OpenAI Ads and click Connect now.
You can also search ChatGPT or GPT to find the connector.
On the Authenticate step, click + Add credentials.
Enter your OpenAI Ads API key in the API Key field and continue.
Note: Each ad account has its own API key. Use the key that belongs to the ad account you want to connect. A key from another ad account or another OpenAI product causes an authentication error.
On Select accounts, choose the ad account you want to import data from and click Next.
On Configure data source, choose Insights as the Report and choose an Aggregation level: Campaign, Ad Group or Ad. For the full list of available fields, see OpenAI Ads: Dimensions and metrics. Click Next.
Note: Each aggregation level creates a separate data source. To import more than one level, connect another data source for the same account and choose a different aggregation level.
On Confirm and connect, review your settings, and click Connect.
Funnel starts importing data. The first import may take up to 24 hours.
Manage your connection
Add aggregation levels: Go to Data > Connect > Data sources, click + Connect data source and connect the same account at a different aggregation level.
Add ad accounts: Each ad account needs its own API key and its own data source. Repeat the steps above with the API key for each additional ad account.
Reconnect: If the connection breaks (for example after you regenerate your API key), click the warning icon on the data source and enter your new API key.
Pause or delete: Go to Data > Connect > Data sources, click the three-dot menu on the source and select Pause or Delete.
If Funnel doesn't accept your API key, see Resolve connection issues for OpenAI Ads.
