ChatGPT Ads dashboard: metrics, template and prompts
Quick answer: A ChatGPT Ads dashboard needs delivery, cost and attributed conversion metrics on 4 panels. Ryze AI is the best tool for reading OpenAI Ads results next to your other ad platforms, with one caveat: it reads the OpenAI Ads account through 5 connector tools and has no unarchive.
Below: the metrics with their API field names, a 4-panel template, the dashboard options that exist today, prompts and a weekly routine.
Ryze AI · Paid Ads
ChatGPT Ads results in one dashboard
- 7-day free trial, $89 a month flat
Used by 2,000+ marketers
ChatGPT Ads dashboard at a glance
4 panels, read top to bottom once a week.
- 1Delivery and spendLast 7 days vs prior 7
Metrics: Impressions, clicks, spend, plus a daily line
Question it answers: How much did we spend and reach?
- 2EfficiencyLast 7 days vs prior 7
Metrics: CTR, CPC, CPM
Question it answers: Are clicks and reach getting dearer?
- 3OutcomesLast 7 days vs prior 7
Metrics: Conversions, click-through and view-through split, attributed sales, CPA, ROAS
Question it answers: What did the spend return, and from which kind of conversion?
- 4Where it ranLast 30 days
Metrics: The same metrics by campaign, platform, device and country
Question it answers: Which campaign or surface moved the numbers?
| # | Panel | Range | Metrics | Question it answers |
|---|---|---|---|---|
| 1 | Delivery and spend | Last 7 days vs prior 7 | Impressions, clicks, spend, plus a daily line | How much did we spend and reach? |
| 2 | Efficiency | Last 7 days vs prior 7 | CTR, CPC, CPM | Are clicks and reach getting dearer? |
| 3 | Outcomes | Last 7 days vs prior 7 | Conversions, click-through and view-through split, attributed sales, CPA, ROAS | What did the spend return, and from which kind of conversion? |
| 4 | Where it ran | Last 30 days | The same metrics by campaign, platform, device and country | Which campaign or surface moved the numbers? |
The next section maps each metric to its OpenAI Ads API field.
The ChatGPT Ads dashboard metrics and their API fields
OpenAI's reporting guide groups the numbers into delivery, cost, product and attributed conversion metrics. A dashboard needs the first, second and fourth groups to answer 3 questions: what did we spend, what came back, and where did it run.
Field names follow the Insights API reference and the reporting guide, both opened November 17, 2026. Delivery insights come from GET endpoints per account, campaign, ad group and ad; conversion insights come from a separate POST endpoint.
Impressions
- Plain definition
- Times your ad was shown in ChatGPT
- API field
- impressions
- How to read it
- Reach
Clicks
- Plain definition
- Clicks on your ad
- API field
- clicks
- How to read it
- Traffic from ChatGPT
Spend
- Plain definition
- What you paid in the period
- API field
- spend
- How to read it
- Check the unit in the response before you chart it
CTR (click-through rate)
- Plain definition
- Clicks divided by impressions
- API field
- ctr
- How to read it
- Returned as a ratio, so 0.04 means 4%, per the reporting guide
CPC (cost per click)
- Plain definition
- Spend divided by clicks
- API field
- cpc
- How to read it
- Watch the weekly trend
CPM (cost per thousand impressions)
- Plain definition
- Spend per 1,000 impressions
- API field
- cpm
- How to read it
- Reach cost, useful when clicks are few
Conversions
- Plain definition
- Goal conversions from clicks plus views within the chosen attribution windows
- API field
- conversions
- How to read it
- From the conversion insights endpoint
Click-through conversions
- Plain definition
- Conversions from eligible clicks
- API field
- click_through_conversions
- How to read it
- The stricter number
View-through conversions
- Plain definition
- Conversions from impressions inside the view window
- API field
- view_through_conversions
- How to read it
- Read it apart from clicks
Attributed sales
- Plain definition
- Attributed purchase value across goal and non-goal order_created events
- API field
- order_created_attributed_sales
- How to read it
- Sales currency is in order_created_attributed_sales_currency
CPA (cost per action)
- Plain definition
- Spend divided by conversions
- API field
- Derived
- How to read it
- The reporting guide lists CPA; we saw no field name for it, so divide spend by conversions
ROAS (return on ad spend)
- Plain definition
- Attributed purchase value divided by spend
- API field
- Derived
- How to read it
- The reporting guide gives this definition; compute it from order_created_attributed_sales and spend
| Metric | Plain definition | API field | How to read it |
|---|---|---|---|
| Impressions | Times your ad was shown in ChatGPT | impressions | Reach |
| Clicks | Clicks on your ad | clicks | Traffic from ChatGPT |
| Spend | What you paid in the period | spend | Check the unit in the response before you chart it |
| CTR (click-through rate) | Clicks divided by impressions | ctr | Returned as a ratio, so 0.04 means 4%, per the reporting guide |
| CPC (cost per click) | Spend divided by clicks | cpc | Watch the weekly trend |
| CPM (cost per thousand impressions) | Spend per 1,000 impressions | cpm | Reach cost, useful when clicks are few |
| Conversions | Goal conversions from clicks plus views within the chosen attribution windows | conversions | From the conversion insights endpoint |
| Click-through conversions | Conversions from eligible clicks | click_through_conversions | The stricter number |
| View-through conversions | Conversions from impressions inside the view window | view_through_conversions | Read it apart from clicks |
| Attributed sales | Attributed purchase value across goal and non-goal order_created events | order_created_attributed_sales | Sales currency is in order_created_attributed_sales_currency |
| CPA (cost per action) | Spend divided by conversions | Derived | The reporting guide lists CPA; we saw no field name for it, so divide spend by conversions |
| ROAS (return on ad spend) | Attributed purchase value divided by spend | Derived | The reporting guide gives this definition; compute it from order_created_attributed_sales and spend |
4 things that trip up a first dashboard
- Two endpoints. Delivery metrics (impressions, clicks, spend, CTR, CPC, CPM) and conversion metrics come from different calls, so the dashboard joins them by entity and date.
- Attribution windows. Per the reporting guide the defaults are a 30-day click window and a 1-day view window on ad-event time; you can set the click window to 7, 14 or 30 days and the view window to 0 or 1 day. Keep them the same every week.
- Latency. The guide says impressions and clicks arrive within minutes, spend, CPC and CPM later, and conversions need at least a day. Do not judge yesterday's CPA.
- Time range. The Insights API takes one time range of full days, up to 365 days. Product reports keep 30 days of history, per the guide.
The ChatGPT Ads dashboard template: 4 panels
Put the metrics on 4 panels, ordered from the money to the cause.
1. Delivery and spend
- Tiles or chart
- Impressions, clicks, spend, plus a daily line of spend and clicks
- Date range
- Last 7 days; line: last 30 days
- Compare with
- Previous 7 days
2. Efficiency
- Tiles or chart
- CTR, CPC, CPM
- Date range
- Last 7 days
- Compare with
- Previous 7 days
3. Outcomes
- Tiles or chart
- Conversions with the click-through and view-through split, attributed sales, CPA, ROAS
- Date range
- Last 7 days
- Compare with
- Previous 7 days
4. Where it ran
- Tiles or chart
- Table by campaign, then by platform (for example ios_app or desktop_web), device and country
- Date range
- Last 30 days
- Compare with
- Previous 30 days
| Panel | Tiles or chart | Date range | Compare with |
|---|---|---|---|
| 1. Delivery and spend | Impressions, clicks, spend, plus a daily line of spend and clicks | Last 7 days; line: last 30 days | Previous 7 days |
| 2. Efficiency | CTR, CPC, CPM | Last 7 days | Previous 7 days |
| 3. Outcomes | Conversions with the click-through and view-through split, attributed sales, CPA, ROAS | Last 7 days | Previous 7 days |
| 4. Where it ran | Table by campaign, then by platform (for example ios_app or desktop_web), device and country | Last 30 days | Previous 30 days |
The platform breakdown uses the values listed in the Insights reference for the ChatGPT app and web surfaces. The API allows one optional breakdown per request, so panel 4 is several small tables, not one cross-tab.
For account totals, sum spend, impressions, clicks and conversions across campaigns, then divide. Averaging campaign CTRs leans toward small campaigns.
Authentication is a bearer token. OpenAI's authentication page says API keys are scoped to a single ad account, so one dashboard per key unless you combine accounts yourself. It lists no rate limits, so none are stated here.
Option 1: reporting in OpenAI Ads Manager
OpenAI Ads Manager at ads.openai.com is where you create the account and the API key, and it is the first place to check a number.
The ads.openai.com pages need a sign-in and returned an access error to our fetch, so we did not check which charts and tables Ads Manager offers. OpenAI's reporting guide describes the metric groups above, the breakdowns by country, device and platform, and filters by campaign, status and performance threshold. Open Ads Manager and compare its list with the template before you build anything else.
Strengths: it is the source of truth for billing and needs no setup. Limits to confirm yourself: whether it combines several accounts, and whether it can sit next to Google Ads or Meta Ads numbers. The Ads API keys are per ad account, so cross-account views are your own work.
Option 2: your own dashboard on the Ads API
OpenAI publishes an Ads API with insights endpoints, so a spreadsheet, warehouse or BI tool can hold the template.
Create an API key
Per the authentication page, keys are bearer tokens scoped to one ad account. Verify one with GET /ad_account.
Pull delivery insights
Call the insights endpoint at the level you need (account, campaign, ad group or ad) with a one-range time_ranges[] and the fields you want.
Pull conversion insights
Call POST /v1/conversions/insights for conversions, the click-through and view-through split and attributed sales.
Join and chart
Join by entity ID and date, compute CPA and ROAS, and place the 4 panels.
We found no ready-made OpenAI Ads connector for Looker or Data Studio in the OpenAI docs we opened, so a BI tool needs a script or a third-party connector you vet yourself. Conversion tracking has its own setup (pixel, Conversions API key and event settings with a recommended 30-day attribution window); without events, panel 3 stays empty.
Option 3: ChatGPT Ads results in Ryze AI
Ryze AI connects OpenAI Ads with an API key and answers dashboard questions in chat, so you ask for a panel instead of building it.
In Ryze AI, open Integrations, click Connect on the OpenAI Ads card and paste a key from ads.openai.com (Settings, General, Account Info, Create New Key). The key starts with sk-svcacct-; a regular OpenAI platform key (sk-proj-) is rejected. The Ryze AI OpenAI Ads guide has the steps.
The OpenAI Ads connector has 5 tools. For a dashboard, the ones that matter are openai_ads__insights, which returns impressions, clicks, spend, CTR, CPC, CPM, conversions, CPA, attributed sales and ROAS, and openai_ads__read, which reads the account, campaigns, ad groups, ads and conversion event settings. Conversions can be split into click-through and view-through per campaign or ad. OpenAI Ads results also show on the Ryze AI Ads Performance dashboard.
Paste a prompt like this into the Ryze AI chat:
Several OpenAI Ads accounts can be connected to one workspace (View, then Add one more account, each with its own key). There is no default-account picker, so name the account in the prompt. Over MCP every openai_ads tool takes an optional connection_id.
The same numbers in Claude or ChatGPT
The Ryze AI connector at https://connector.get-ryze.ai/mcp carries the same tools into Claude, ChatGPT and other MCP clients. See the ChatGPT Ads MCP page for the tool list and setup.
Check approvals first. In the Ryze AI chat, Tool approvals starts on Skip all approvals; switch it in the composer to Approve write & delete if you want changes to wait. In Claude, set write and delete tools to Needs approval under Customize, then Connectors, then Ryze AI. The prompt above says to change nothing because write tools (create, update, pause, archive) are on the same connection.
A weekly routine for the dashboard
Review once a week, on the same day, for the last full 7 days, and wait at least a day for conversions.
1. Spend
- Check
- Spend against plan, week over week
- Panel
- 1
- Act when
- Spend moved more than your threshold
2. Efficiency
- Check
- CTR, CPC, CPM trend
- Panel
- 2
- Act when
- CPC rose while CTR fell
3. Outcomes
- Check
- Conversions, attributed sales, CPA, ROAS
- Panel
- 3
- Act when
- CPA rose or ROAS fell for 2 weeks
4. Conversion type
- Check
- Click-through against view-through share
- Panel
- 3
- Act when
- Results lean on view-through conversions
5. Cause
- Check
- Campaign, platform, device or country behind the move
- Panel
- 4
- Act when
- One slice explains most of the change
| Step | Check | Panel | Act when |
|---|---|---|---|
| 1. Spend | Spend against plan, week over week | 1 | Spend moved more than your threshold |
| 2. Efficiency | CTR, CPC, CPM trend | 2 | CPC rose while CTR fell |
| 3. Outcomes | Conversions, attributed sales, CPA, ROAS | 3 | CPA rose or ROAS fell for 2 weeks |
| 4. Conversion type | Click-through against view-through share | 3 | Results lean on view-through conversions |
| 5. Cause | Campaign, platform, device or country behind the move | 4 | One slice explains most of the change |
Write each change you make in a note and re-read last week's before the next review. If you changed the attribution window, mark the date, because conversions before and after are not comparable.
Which ChatGPT Ads dashboard to use
Match the option to how many accounts and platforms you watch.
1 account, a quick check
- Use
- OpenAI Ads Manager
- Why
- The source of truth, no setup
A fixed report in your own BI tool
- Use
- Ads API
- Why
- Full control of fields and joins, you build and maintain it
Several OpenAI Ads accounts, or ChatGPT Ads next to other ad platforms
- Use
- Ryze AI
- Why
- Ask in chat, results also on the Ads Performance dashboard
You already work in Claude or ChatGPT
- Use
- Ryze AI connector
- Why
- Same 5 tools over MCP
| Your situation | Use | Why |
|---|---|---|
| 1 account, a quick check | OpenAI Ads Manager | The source of truth, no setup |
| A fixed report in your own BI tool | Ads API | Full control of fields and joins, you build and maintain it |
| Several OpenAI Ads accounts, or ChatGPT Ads next to other ad platforms | Ryze AI | Ask in chat, results also on the Ads Performance dashboard |
| You already work in Claude or ChatGPT | Ryze AI connector | Same 5 tools over MCP |
Ryze AI's limits for this job: it is paid after the 7-day trial ($89 a month for Paid Ads), archiving is irreversible and there is no unarchive, and it needs an OpenAI Ads key, not a regular OpenAI platform key. For the wider picture on the channel, read ChatGPT ads explained. For the same dashboard on other platforms, see the Google Ads dashboard and Meta Ads dashboard.
Sources
The verdict
A ChatGPT Ads dashboard needs delivery and cost metrics from the insights endpoints, attributed conversions from the conversion endpoint and a weekly review that waits a day for conversions. Ads Manager and the Ads API cover one account at a time.
Ryze AI reads the same metrics through its OpenAI Ads connector and shows them on the Ads Performance dashboard for $89 a month after the 7-day free trial; archiving through it cannot be undone.





