Metrics

ChatGPT Ads metrics via API

Your customer connects their ChatGPT Ads account and your product queries 25 metrics through the same endpoint as every other platform. Each metric has an id (reference_key) that goes in the request.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "comparison_start": "2026-09-01",
  "comparison_end": "2026-09-30",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "chatgpt_ads:impressions",
      "component": "number_v1",
      "metrics": [
        "impressions"
      ]
    }
  ]
}
Example: "Impressions" in October, compared to September.

More ChatGPT Ads request examples

The same endpoint for every kind of metric. The metrics and dimensions of each item come from the platform catalog (GET /api/metrics/{integration_slug}).

Chart

Impressions and Clicks per Day

Daily evolution of the impressions and clicks of your ads during the selected period.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "chatgpt_ads:impressions_clicks_per_day",
      "component": "chart_v1",
      "metrics": [
        "impressions",
        "clicks"
      ],
      "dimensions": [
        "date"
      ]
    }
  ]
}

Table

Top Campaigns

Performance of your campaigns during the selected period.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "chatgpt_ads:campaigns_table",
      "component": "datatable_v1",
      "metrics": [
        "impressions",
        "clicks",
        "spend",
        "ctr",
        "cpc",
        "conversions",
        "cpa"
      ],
      "dimensions": [
        "campaign"
      ]
    }
  ]
}

Number

Clicks

Number of clicks your ads received during the selected period.

POST /api/metrics/get-data
Authorization: Bearer <merchant token>
x-customer-token: <customer token>

{
  "customer_integration": "<connection uuid>",
  "start": "2026-10-01",
  "end": "2026-10-31",
  "metrics": [
    {
      "id": "m1",
      "reference_key": "chatgpt_ads:clicks",
      "component": "number_v1",
      "metrics": [
        "clicks"
      ]
    }
  ]
}

Numbers

11 metrics

  • Impressions

    Number of times your ads were shown in ChatGPT during the selected period.

    chatgpt_ads:impressions
  • Clicks

    Number of clicks your ads received during the selected period.

    chatgpt_ads:clicks
  • Amount spent

    Total amount spent by your ads during the selected period, in the ad account's currency.

    chatgpt_ads:spend
  • CTR

    The Click Through Rate (CTR) represents the number of total clicks that your ads received divided by the number of time it was shown (impressions).

    chatgpt_ads:ctr
  • CPC

    Cost per Click (CPC) shows how much, on average, each link click costs you. It is calculated by dividing Cost/Number of Clicks. CPC is a metric used in the online advertising industry for benchmarking ad efficiency and performance.

    chatgpt_ads:cpc
  • CPM

    Cost per Mille (CPM) is the average cost for 1,000 impressions. It is calculated by dividing Spent Amount/(Number of Impressions x 1000). CPM is a common metric used by the online advertising industry to gauge the cost-effectiveness of an ad campaign. It's often used to compare performance among different ad publishers and campaigns.

    chatgpt_ads:cpm
  • Conversions

    Click-through conversions for the conversion events configured on your campaigns, reported on the date the conversion happened. Conversion tracking must be set up on the ad account.

    chatgpt_ads:conversions
  • Cost per Conversion

    Average amount spent per conversion during the selected period.

    chatgpt_ads:cpa
  • Conversion Rate

    Post-click conversion rate: conversions divided by clicks during the selected period.

    chatgpt_ads:conversion_rate
  • Attributed Sales

    Value of the purchase events (order created) attributed to your ads, in the ad account's currency. Depends on purchase events being sent through the advertiser's conversion tracking.

    chatgpt_ads:attributed_sales
  • ROAS

    Return on ad spend: attributed purchase value divided by the amount spent. A value of 4 means four units of attributed sales per unit spent.

    chatgpt_ads:roas

Charts

11 metrics

  • Impressions and Clicks per Day

    Daily evolution of the impressions and clicks of your ads during the selected period.

    chatgpt_ads:impressions_clicks_per_day
  • Amount Spent per Day

    Daily evolution of the amount spent by your ads during the selected period.

    chatgpt_ads:spend_per_day
  • CTR per Day

    Daily evolution of the Click Through Rate (CTR) of your ads during the selected period.

    chatgpt_ads:ctr_per_day
  • CPC and CPM per Day

    Daily evolution of the average cost per click (CPC) and cost per one thousand impressions (CPM) during the selected period.

    chatgpt_ads:cpc_cpm_per_day
  • Conversions per Day

    Daily evolution of the click-through conversions of your campaigns, reported on the date the conversion happened.

    chatgpt_ads:conversions_per_day
  • Attributed Sales per Day

    Daily evolution of the purchase value attributed to your ads during the selected period.

    chatgpt_ads:attributed_sales_per_day
  • Impressions and Clicks by Country

    Impressions and clicks of your ads split by the country where they were delivered.

    chatgpt_ads:performance_per_country
  • Amount Spent by Country

    Amount spent by your ads split by the country where they were delivered.

    chatgpt_ads:spend_per_country
  • Clicks by Device

    This graph displays the number of clicks on your ads, grouped by the device that the person was using.

    chatgpt_ads:clicks_per_device
  • Impressions and Clicks by Platform

    Impressions and clicks of your ads split by ChatGPT platform: iOS app, Android app or web browser.

    chatgpt_ads:performance_per_platform
  • Amount Spent by Platform

    Amount spent by your ads split by ChatGPT platform: iOS app, Android app or web browser.

    chatgpt_ads:spend_per_platform

Tables

3 metrics

  • Top Campaigns

    Performance of your campaigns during the selected period.

    chatgpt_ads:campaigns_table
  • Top Ad Groups

    Performance of your ad groups during the selected period.

    chatgpt_ads:ad_groups_table
  • Top Ads

    Performance of your ads during the selected period, identified by the ad title shown in ChatGPT.

    chatgpt_ads:ads_table

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.