> ## Documentation Index
> Fetch the complete documentation index at: https://support.detrics.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ChatGPT Ads Metrics & Dimensions

> Complete reference for ChatGPT Ads (OpenAI Advertiser API) dimensions and metrics

<Info>
  **Last updated:** October 12, 2026
</Info>

<div style={{display: "flex", gap: "8px", marginBottom: "20px"}}>
  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    14 dimensions
  </div>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    10 metrics
  </div>
</div>

This reference covers all available dimensions and metrics for ChatGPT Ads data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.

<div style={{display: "flex", gap: "8px", marginBottom: "20px", alignItems: "center"}}>
  <span style={{fontSize: "14px", fontWeight: "500", color: "#6B7280"}}>Supported destinations:</span>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    Google Sheets
  </div>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    Claude
  </div>

  <div
    style={{
backgroundColor: "#f3f4f6",
color: "#374151",
padding: "4px 12px",
borderRadius: "16px",
fontSize: "14px",
fontWeight: "500"
}}
  >
    BigQuery
  </div>
</div>

## Dimensions

Dimensions are the attributes you can use to segment and group your ChatGPT Ads data.

### Account

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Account ID</div> | ChatGPT Ads ad account ID (adacct\_…)<br /><br />**Field Name:** `account_id`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Account Name</div> | ChatGPT Ads ad account name<br /><br />**Field Name:** `account_name`<br />**Type:** dimension |

### Campaign

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Campaign ID</div> | Unique identifier of the campaign (cmpn\_…)<br /><br />**Field Name:** `campaign_id`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Campaign Name</div> | Name of the campaign<br /><br />**Field Name:** `campaign_name`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Campaign Status</div> | Campaign status (active, paused, …)<br /><br />**Field Name:** `campaign_status`<br />**Type:** dimension |

### Ad Group

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group ID</div> | Unique identifier of the ad group (adgrp\_…)<br /><br />**Field Name:** `ad_group_id`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group Name</div> | Name of the ad group<br /><br />**Field Name:** `ad_group_name`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group Status</div> | Ad group status (active, paused, …)<br /><br />**Field Name:** `ad_group_status`<br />**Type:** dimension |

### Ad

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad ID</div> | Unique identifier of the ad (ad\_…)<br /><br />**Field Name:** `ad_id`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Name</div> | Name of the ad<br /><br />**Field Name:** `ad_name`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Status</div> | Ad status (active, paused, …)<br /><br />**Field Name:** `ad_status`<br />**Type:** dimension |

### Breakdowns

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Country</div> | ISO country code where the ad was delivered (e.g. US, ES). Only one breakdown (Country, Device or Platform) per query; not available with Sales & Attribution metrics<br /><br />**Field Name:** `country_name`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Device</div> | Device type that served the ad (desktop, mobile). Only one breakdown (Country, Device or Platform) per query; not available with Sales & Attribution metrics<br /><br />**Field Name:** `device_type`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Platform</div> | ChatGPT surface that served the ad: ios\_app, android\_app, desktop\_web, ios\_web, android\_web, web (historical). Only one breakdown per query; does not report Conversions or Sales & Attribution metrics<br /><br />**Field Name:** `platform`<br />**Type:** dimension |

## Metrics

Metrics are the numerical values you can measure and analyze from your ChatGPT Ads campaigns.

### Performance

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Impressions</div> | Number of ad impressions recorded<br /><br />**Field Name:** `impressions`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Clicks</div> | Number of ad clicks recorded<br /><br />**Field Name:** `clicks`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Spend</div> | Amount spent, in the ad account's currency. Spend finalizes later than impressions and clicks, so the most recent days may still be updating<br /><br />**Field Name:** `spend`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>CTR</div> | Click-through rate: clicks divided by impressions (0.04 = 4%)<br /><br />**Field Name:** `ctr`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>CPC</div> | Average cost per click, using finalized spend<br /><br />**Field Name:** `cpc`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>CPM</div> | Cost per thousand impressions, using finalized spend<br /><br />**Field Name:** `cpm`<br />**Type:** metric |

### Conversions

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Conversions</div> | Campaign goal conversions attributed to clicks (30-day window) plus views (1-day window). Not available with the Platform breakdown<br /><br />**Field Name:** `conversions`<br />**Type:** metric |

### Sales & Attribution

| | |
| - | - |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>CPA</div> | Cost per action: spend divided by conversions. Not available with Country, Device or Platform breakdowns<br /><br />**Field Name:** `cpa`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Attributed Sales</div> | Value of attributed purchase (order\_created) events in the ad account's currency. Not available with Country, Device or Platform breakdowns<br /><br />**Field Name:** `attributed_sales`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>ROAS</div> | Return on ad spend: attributed purchase value divided by spend (4 = four units of sales per unit spent). Not available with Country, Device or Platform breakdowns<br /><br />**Field Name:** `roas`<br />**Type:** metric |

***

## Related

<CardGroup cols={2}>
  <Card title="Fields Catalog" icon="book" href="/fields-catalog/index">
    Browse all platforms
  </Card>

  <Card title="Google Ads Fields" icon="chart-bar" href="/data-source/google-ads/fields">
    Google Ads metrics & dimensions
  </Card>

  <Card title="Meta Ads Fields" icon="chart-bar" href="/data-source/facebook-ads/fields">
    Meta Ads metrics & dimensions
  </Card>

  <Card title="TikTok Ads Fields" icon="chart-bar" href="/data-source/tiktok-ads/fields">
    TikTok Ads metrics & dimensions
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.