We're excited to announce that ChatGPT Ads is now a supported data source on ReportGarden. You can connect your ChatGPT Ads account and pull live performance data into your reports, right alongside all your other ad platforms.
Here's everything you need to know to get connected.
What You'll Need
Before you start, make sure you have:
A ChatGPT Ads account with active campaigns
An API key generated from your ChatGPT Ads account
Admin or Manager access to your ReportGarden workspace
Don't have your API key yet? Here's how to generate one.
Step 1: Get Your ChatGPT Ads API Key
Log in to ChatGPT Ads at ads.chatgpt.com using your account credentials.
Open Account Settings by clicking your profile icon in the top-right corner and selecting Settings.
Navigate to API Access, found under "API Access" or "Developer Settings" in the Settings menu.
Generate a new key by clicking Generate New Key (or Create API Key).
Copy your key and store it somewhere safe - you won't be able to view it again once you close the window.
Keep your API key private. Don't share it publicly or store it anywhere unsecured.
Step 2: Link ChatGPT Ads to ReportGarden
In ReportGarden, go to Accounts in the left-hand navigation, then click Link Accounts in the top-right corner.
2. Scroll through the list of integrations and select ChatGPT Ads (Beta).
** Reach out to [email protected] if it is not enabled for your team.
3. Paste your API key into the API Key field. Double-check there are no extra spaces before or after the key.
4. Click Save or Connect. ReportGarden will verify the key, and you'll see a green "Account Successfully Connected" status once it's linked.
That's it - your ChatGPT Ads data is now flowing into ReportGarden.
Metrics and Dimensions Supported
Metrics:
Metric Name | Definition |
Impressions | Number of times your ad was shown to users in ChatGPT |
Clicks | Number of times users clicked on your ad |
Spend | Total amount spent delivering ads during the reporting period |
CTR (%) | Click-through rate: (Clicks ÷ Impressions) × 100 |
Average CPC | Average cost per click: Spend ÷ Clicks |
Average CPM | Average cost per 1,000 impressions: (Spend ÷ Impressions) × 1,000 |
Dimensions:
Dimension | Definition |
Overview | Aggregated performance across the entire ad account or reporting scope |
Campaign | Metrics grouped by campaign — the highest level of organization, containing one or more ad groups |
Ad Group | Metrics grouped by ad group — a subdivision within a campaign with specific targeting/delivery settings |
Ads | Metrics for individual ads, so you can compare creative performance |
FAQ
Why can't I connect my ChatGPT Ads account?
Double-check that your API key was copied correctly with no extra spaces, that it's still active, and that you have the right permissions in your ChatGPT Ads account. If it still doesn't work, try generating a new key and reconnecting.
Why isn't my data showing up in reports?
First confirm your account is connected and that your campaigns have data within the selected date range. If the connection looks fine but data is still missing, try refreshing the connection or reach out to ReportGarden Support.
Can I reconnect or replace my API key later?
Yes. If your key is rotated, expires, or is revoked, just reconnect the account in ReportGarden with a new key — your reports and data sync will pick up right where they left off.
Why can't I see ad previews?
Ad previews aren't supported yet.