Ira Bodnar··Updated ·11 min read

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

Uber Eats logoadidas logoDuolingo logoMGM Resorts logoWharton logoLendingClub logoNorton logoEventbrite logoHuel logoTogether AI logoghd logoHack The Box logo

ChatGPT Ads dashboard at a glance

4 panels, read top to bottom once a week.

  1. 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?

  2. 2EfficiencyLast 7 days vs prior 7

    Metrics: CTR, CPC, CPM

    Question it answers: Are clicks and reach getting dearer?

  3. 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?

  4. 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?

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.

  1. Impressions

    Plain definition
    Times your ad was shown in ChatGPT
    API field
    impressions
    How to read it
    Reach
  2. Clicks

    Plain definition
    Clicks on your ad
    API field
    clicks
    How to read it
    Traffic from ChatGPT
  3. 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
  4. 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
  5. CPC (cost per click)

    Plain definition
    Spend divided by clicks
    API field
    cpc
    How to read it
    Watch the weekly trend
  6. 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
  7. 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
  8. Click-through conversions

    Plain definition
    Conversions from eligible clicks
    API field
    click_through_conversions
    How to read it
    The stricter number
  9. 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
  10. 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
  11. 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
  12. 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

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. 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. 2. Efficiency

    Tiles or chart
    CTR, CPC, CPM
    Date range
    Last 7 days
    Compare with
    Previous 7 days
  3. 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. 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

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.

Request shape: delivery insights for one campaign (from the Insights reference)
GET /campaigns/{campaign_id}/insights time_ranges[] one JSON time range of full days fields[] impressions, clicks, spend, ctr, cpc, cpm segments[] optional: country | device | platform | product

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:

Prompt: Ryze AI chat
For my OpenAI Ads account [account name], read only: change nothing. 1. Delivery and spend: impressions, clicks and spend for the last 7 days vs the 7 before, daily. 2. Efficiency: CTR, CPC and CPM. 3. Outcomes: conversions split into click-through and view-through, attributed sales, CPA and ROAS, by campaign. 4. Where it ran: the same by ad group, highest spend first. End with the 3 biggest changes.

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. 1. Spend

    Check
    Spend against plan, week over week
    Panel
    1
    Act when
    Spend moved more than your threshold
  2. 2. Efficiency

    Check
    CTR, CPC, CPM trend
    Panel
    2
    Act when
    CPC rose while CTR fell
  3. 3. Outcomes

    Check
    Conversions, attributed sales, CPA, ROAS
    Panel
    3
    Act when
    CPA rose or ROAS fell for 2 weeks
  4. 4. Conversion type

    Check
    Click-through against view-through share
    Panel
    3
    Act when
    Results lean on view-through conversions
  5. 5. Cause

    Check
    Campaign, platform, device or country behind the move
    Panel
    4
    Act when
    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. 1 account, a quick check

    Use
    OpenAI Ads Manager
    Why
    The source of truth, no setup
  2. A fixed report in your own BI tool

    Use
    Ads API
    Why
    Full control of fields and joins, you build and maintain it
  3. 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
  4. You already work in Claude or ChatGPT

    Use
    Ryze AI connector
    Why
    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.

Frequently asked questions

What should a ChatGPT Ads dashboard include?
Impressions, clicks and spend, then CTR, CPC and CPM, then conversions, attributed sales, CPA and ROAS, plus a breakdown by campaign, platform, device and country. Compare the last 7 days with the 7 before.
Does ChatGPT Ads have a built-in dashboard?
OpenAI runs Ads Manager at ads.openai.com, where you create the account and API key. We could not open it without a sign-in, so check its reporting views yourself. OpenAI's reporting guide describes the metrics and breakdowns.
Which API fields feed a ChatGPT Ads dashboard?
impressions, clicks, spend, ctr, cpc and cpm from the delivery insights endpoints, and conversions, click_through_conversions, view_through_conversions and order_created_attributed_sales from POST /v1/conversions/insights.
How do I calculate ROAS for ChatGPT Ads?
Divide attributed purchase value by spend, the definition in OpenAI's reporting guide. Use order_created_attributed_sales for the value, and read the spend unit in the response first.
Show 8 more questions
What attribution window do ChatGPT Ads use?
The reporting guide gives a default 30-day click window and 1-day view window. You can set the click window to 7, 14 or 30 days and the view window to 0 or 1 day.
How fresh is the data?
Per the reporting guide, impressions and clicks arrive within minutes, spend, CPC and CPM later, and conversions need at least a day.
Can I use a Looker or Data Studio dashboard for ChatGPT Ads?
We found no ready-made OpenAI Ads connector in OpenAI's docs. You can pull the Ads API into a sheet or warehouse and connect that, or use a third-party connector you have checked.
Can Ryze AI show ChatGPT Ads results?
Yes. Connect OpenAI Ads with an API key and ask for insights by account, campaign, ad group or ad in chat. OpenAI Ads results also show on the Ryze AI Ads Performance dashboard.
Which key does Ryze AI need for OpenAI Ads?
An OpenAI Ads key from ads.openai.com (Settings, General, Account Info, Create New Key). It starts with sk-svcacct-. A regular OpenAI platform key starting with sk-proj- is rejected.
Can Ryze AI change my ChatGPT Ads campaigns?
Yes. It can create and update campaigns, ad groups and ads, activate or pause them, and archive them. Archiving is the irreversible final state. Set Tool approvals to Approve write & delete if you want a check first.
Can I connect several OpenAI Ads accounts?
Yes. Use View, then Add one more account in Ryze AI, with a separate key for each. Name the account in your prompt, since there is no default-account picker.
How much does it cost?
Ryze AI Paid Ads is $89 a month with a 7-day free trial. Connecting the connector is free; the tools need an active plan or trial.

Related guides

Ryze AI: ChatGPT Ads results

7-day free trial, $89 a month flat

Start free trial