> ## 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.

# X Ads Metrics & Dimensions

> Complete reference for X Ads dimensions and metrics

<Info>
  **Last updated:** July 31, 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"
}}
  >
    85 dimensions
  </div>

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

This reference covers all available dimensions and metrics for X 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"
}}
  >
    Looker Studio
  </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 X Ads data.

### Account

|                                                                                |                                                                                                             |
| ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Account ID</div>   | The identifier for the selected account/s.<br /><br />**Field Name:** `account.id`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Account Name</div> | The name of the selected account/s.<br /><br />**Field Name:** `account.name`<br />**Type:** dimension      |

### Campaign

|                                                                                         |                                                                                                                                                          |
| --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Campaign ID</div>           | Identifier for the campaign.<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"}}>Frequency Cap</div>         | Frequency cap set for the campaign.<br /><br />**Field Name:** `campaign.frequency_cap`<br />**Type:** dimension                                         |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Funding Instrument ID</div> | Identifier for the funding instrument associated with the campaign.<br /><br />**Field Name:** `campaign.funding_instrument_id`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Currency</div>              | Currency used for the campaign, associated to it's funding instrument.<br /><br />**Field Name:** `campaign.currency`<br />**Type:** dimension           |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Created At</div>            | Timestamp when the campaign was created.<br /><br />**Field Name:** `campaign.updated_at`<br />**Type:** dimension                                       |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Updated At</div>            | Timestamp when the campaign was last updated.<br /><br />**Field Name:** `campaign.created_at`<br />**Type:** dimension                                  |

### Campaign Status

|                                                                                        |                                                                                                                                    |
| -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Servable</div>             | Indicates if the campaign is servable or not.<br /><br />**Field Name:** `campaign.servable`<br />**Type:** dimension              |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Effective Status</div>     | Effective status of the campaign.<br /><br />**Field Name:** `campaign.effective_status`<br />**Type:** dimension                  |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Entity Status</div>        | Status of the campaign entity.<br /><br />**Field Name:** `campaign.entity_status`<br />**Type:** dimension                        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Reasons Not Servable</div> | Reasons why the campaign is not servable.<br /><br />**Field Name:** `campaign.reasons_not_servable`<br />**Type:** dimension      |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Duration (days)</div>      | Duration of the campaign in days.<br /><br />**Field Name:** `campaign.duration_in_days`<br />**Type:** dimension                  |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Standard Delivery</div>    | Indicates if the campaign uses standard delivery.<br /><br />**Field Name:** `campaign.standard_delivery`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Deleted</div>              | Indicates if the campaign is deleted.<br /><br />**Field Name:** `campaign.deleted`<br />**Type:** dimension                       |

### Campaign Budget

|                                                                                       |                                                                                                                                                                   |
| ------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Daily Budget</div>        | Daily budget amount in campaign's currency.<br /><br />**Field Name:** `campaign.daily_budget_amount_local_micro`<br />**Type:** dimension                        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total Budget</div>        | Total budget amount in campaign's currency..<br /><br />**Field Name:** `campaign.total_budget_amount_local_micro`<br />**Type:** dimension                       |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Budget Optimization</div> | Type of budget optimization configured for the campaign: CAMPAIGN, LINE\_ITEM.<br /><br />**Field Name:** `campaign.budget_optimization`<br />**Type:** dimension |

### Ad Group

|                                                                                          |                                                                                                                                                      |
| ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group ID</div>            | Unique identifier for the ad group (line item).<br /><br />**Field Name:** `line_item.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:** `line_item.name`<br />**Type:** dimension                                                           |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Campaign ID (Ad Group)</div> | The campaign ID this ad group belongs to.<br /><br />**Field Name:** `line_item.campaign_id`<br />**Type:** dimension                                |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Objective</div>              | The optimization objective for the ad group.<br /><br />**Field Name:** `line_item.objective`<br />**Type:** dimension                               |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Product Type</div>           | The product type of the ad group (PROMOTED\_TWEETS, etc.).<br /><br />**Field Name:** `line_item.product_type`<br />**Type:** dimension              |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Placements</div>             | Where ads will be shown (ALL\_ON\_TWITTER, TWITTER\_TIMELINE, etc.).<br /><br />**Field Name:** `line_item.placements`<br />**Type:** dimension      |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Goal</div>                   | The goal for the ad group optimization.<br /><br />**Field Name:** `line_item.goal`<br />**Type:** dimension                                         |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Currency</div>               | Currency used for the ad group.<br /><br />**Field Name:** `line_item.currency`<br />**Type:** dimension                                             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Frequency Cap</div>          | Maximum impressions per user in the duration period.<br /><br />**Field Name:** `line_item.frequency_cap`<br />**Type:** dimension                   |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Frequency Cap Duration</div> | Duration in days for the frequency cap.<br /><br />**Field Name:** `line_item.duration_in_days`<br />**Type:** dimension                             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Auto Tweet Promotion</div>   | Whether automatic tweet promotion is enabled.<br /><br />**Field Name:** `line_item.automatic_tweet_promotion`<br />**Type:** dimension              |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Advertiser Domain</div>      | The advertiser domain for the ad group.<br /><br />**Field Name:** `line_item.advertiser_domain`<br />**Type:** dimension                            |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Advertiser User ID</div>     | The advertiser user ID.<br /><br />**Field Name:** `line_item.advertiser_user_id`<br />**Type:** dimension                                           |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group Created At</div>    | When the ad group was created.<br /><br />**Field Name:** `line_item.created_at`<br />**Type:** dimension                                            |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group Updated At</div>    | When the ad group was last updated.<br /><br />**Field Name:** `line_item.updated_at`<br />**Type:** dimension                                       |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Funding Instrument ID</div>  | The funding instrument associated with the ad group.<br /><br />**Field Name:** `line_item.funding_instrument_id`<br />**Type:** dimension           |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Primary Web Event Tag</div>  | Primary web event tag for conversion tracking.<br /><br />**Field Name:** `line_item.primary_web_event_tag`<br />**Type:** dimension                 |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Android App Store ID</div>   | Android app store identifier for app install campaigns.<br /><br />**Field Name:** `line_item.android_app_store_identifier`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>iOS App Store ID</div>       | iOS app store identifier for app install campaigns.<br /><br />**Field Name:** `line_item.ios_app_store_identifier`<br />**Type:** dimension         |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Categories</div>             | IAB categories for the ad group.<br /><br />**Field Name:** `line_item.categories`<br />**Type:** dimension                                          |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Creative Source</div>        | Source of creatives (MANUAL, AUTO, etc.).<br /><br />**Field Name:** `line_item.creative_source`<br />**Type:** dimension                            |

### Ad Group Status

|                                                                                       |                                                                                                                                     |
| ------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group Status</div>     | Status of the ad group entity (ACTIVE, PAUSED, etc.).<br /><br />**Field Name:** `line_item.entity_status`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Standard Delivery</div>   | Whether standard delivery is enabled.<br /><br />**Field Name:** `line_item.standard_delivery`<br />**Type:** dimension             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group Start Time</div> | When the ad group starts running.<br /><br />**Field Name:** `line_item.start_time`<br />**Type:** dimension                        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group End Time</div>   | When the ad group stops running.<br /><br />**Field Name:** `line_item.end_time`<br />**Type:** dimension                           |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group Deleted</div>    | Whether the ad group is deleted.<br /><br />**Field Name:** `line_item.deleted`<br />**Type:** dimension                            |

### Ad Group Bidding

|                                                                                |                                                                                                                                 |
| ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Bid Strategy</div> | The bidding strategy (AUTO, TARGET, MAX).<br /><br />**Field Name:** `line_item.bid_strategy`<br />**Type:** dimension          |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Bid Amount</div>   | The bid amount in the ad group currency.<br /><br />**Field Name:** `line_item.bid_amount_local_micro`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Target CPA</div>   | Target cost per action.<br /><br />**Field Name:** `line_item.target_cpa_local_micro`<br />**Type:** dimension                  |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Pay By</div>       | What you pay for (IMPRESSION, APP\_CLICK, etc.).<br /><br />**Field Name:** `line_item.pay_by`<br />**Type:** dimension         |

### Ad Group Budget

|                                                                                         |                                                                                                                                       |
| --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group Daily Budget</div> | Daily budget amount for the ad group.<br /><br />**Field Name:** `line_item.daily_budget_amount_local_micro`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group Total Budget</div> | Total budget amount for the ad group.<br /><br />**Field Name:** `line_item.total_budget_amount_local_micro`<br />**Type:** dimension |

### Promoted Tweet

|                                                                                                |                                                                                                                                                  |
| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet ID</div>            | Unique identifier for the promoted tweet.<br /><br />**Field Name:** `promoted_tweet.id`<br />**Type:** dimension                                |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Tweet ID</div>                     | The underlying tweet ID being promoted.<br /><br />**Field Name:** `promoted_tweet.tweet_id`<br />**Type:** dimension                            |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Group ID (Promoted Tweet)</div> | The ad group this promoted tweet belongs to.<br /><br />**Field Name:** `promoted_tweet.line_item_id`<br />**Type:** dimension                   |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Status</div>        | Status of the promoted tweet (ACTIVE, PAUSED, etc.).<br /><br />**Field Name:** `promoted_tweet.entity_status`<br />**Type:** dimension          |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Approval Status</div>              | Approval status of the promoted tweet (ACCEPTED, REJECTED).<br /><br />**Field Name:** `promoted_tweet.approval_status`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Created At</div>    | When the promoted tweet was created.<br /><br />**Field Name:** `promoted_tweet.created_at`<br />**Type:** dimension                             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Updated At</div>    | When the promoted tweet was last updated.<br /><br />**Field Name:** `promoted_tweet.updated_at`<br />**Type:** dimension                        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Deleted</div>       | Whether the promoted tweet is deleted.<br /><br />**Field Name:** `promoted_tweet.deleted`<br />**Type:** dimension                              |

### Tweet Content

|                                                                           |                                                                                                                                                           |
| ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Ad Name</div> | Name given to the ad/tweet when created (max 80 characters). Useful for identifying ads.<br /><br />**Field Name:** `tweet.name`<br />**Type:** dimension |

### Creative

|                                                                                            |                                                                                                                                  |
| ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card ID</div>   | Unique identifier for the card creative.<br /><br />**Field Name:** `card.id`<br />**Type:** dimension                           |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Name</div> | Name of the card creative.<br /><br />**Field Name:** `card.name`<br />**Type:** dimension                                       |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card URI</div>  | Internal URI reference for the card.<br /><br />**Field Name:** `card.uri`<br />**Type:** dimension                              |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Type</div> | Type of card (e.g., IMAGE\_WEBSITE, VIDEO\_WEBSITE, IMAGE\_APP).<br /><br />**Field Name:** `card.type`<br />**Type:** dimension |

### Creative Media

|                                                                                                    |                                                                                                                       |
| -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Image URL</div>    | URL of the image or video thumbnail in the card.<br /><br />**Field Name:** `card.media_url`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Media Type</div>   | Type of media in the card (image or video).<br /><br />**Field Name:** `card.media_type`<br />**Type:** dimension     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Media Width</div>  | Width of the card media in pixels.<br /><br />**Field Name:** `card.media_width`<br />**Type:** dimension             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Media Height</div> | Height of the card media in pixels.<br /><br />**Field Name:** `card.media_height`<br />**Type:** dimension           |

### Creative Video

|                                                                                                          |                                                                                                                                |
| -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Video Poster URL</div>   | Poster/thumbnail image URL for video cards.<br /><br />**Field Name:** `card.video_poster_url`<br />**Type:** dimension        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Video Duration</div>     | Duration of the video in milliseconds.<br /><br />**Field Name:** `card.video_duration`<br />**Type:** dimension               |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Video Aspect Ratio</div> | Aspect ratio of the video (e.g., "16:9", "1:1").<br /><br />**Field Name:** `card.video_aspect_ratio`<br />**Type:** dimension |

### Creative Carousel

|                                                                                                            |                                                                                                                   |
| ---------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Carousel Image 1 URL</div> | URL of the first carousel image.<br /><br />**Field Name:** `card.carousel_image_1_url`<br />**Type:** dimension  |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Carousel Image 2 URL</div> | URL of the second carousel image.<br /><br />**Field Name:** `card.carousel_image_2_url`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Carousel Image 3 URL</div> | URL of the third carousel image.<br /><br />**Field Name:** `card.carousel_image_3_url`<br />**Type:** dimension  |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Carousel Image 4 URL</div> | URL of the fourth carousel image.<br /><br />**Field Name:** `card.carousel_image_4_url`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Carousel Image 5 URL</div> | URL of the fifth carousel image.<br /><br />**Field Name:** `card.carousel_image_5_url`<br />**Type:** dimension  |

### Creative Destination

|                                                                                                        |                                                                                                                   |
| ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Destination Type</div> | Type of destination (WEBSITE or APP).<br /><br />**Field Name:** `card.destination_type`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Destination URL</div>  | Full destination URL or app deep link.<br /><br />**Field Name:** `card.destination_url`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Display URL</div>      | Shortened display URL (hostname only).<br /><br />**Field Name:** `card.display_url`<br />**Type:** dimension     |

### Creative App

|                                                                                                        |                                                                                                                     |
| ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card App Store ID</div>     | App store identifier for app install cards.<br /><br />**Field Name:** `card.app_store_id`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card App Country Code</div> | Country code for the app store.<br /><br />**Field Name:** `card.app_country_code`<br />**Type:** dimension         |

### Creative Details

|                                                                                                    |                                                                                                                 |
| -------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Button Label</div> | Call-to-action button text on the card.<br /><br />**Field Name:** `card.button_label`<br />**Type:** dimension |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Title</div>        | Title/headline of the card.<br /><br />**Field Name:** `card.title`<br />**Type:** dimension                    |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Created At</div>   | When the card was created.<br /><br />**Field Name:** `card.created_at`<br />**Type:** dimension                |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Promoted Tweet Card Updated At</div>   | When the card was last updated.<br /><br />**Field Name:** `card.updated_at`<br />**Type:** dimension           |

## Metrics

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

### Most Used

|                                                                                        |                                                                                                                                                                           |
| -------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Spend</div>                | Total spend in the campaign's currency.<br /><br />**Field Name:** `billed_charge_local_micro`<br />**Type:** metric                                                      |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Impressions</div>          | Number of times the ad was shown to users (promoted impressions only).<br /><br />**Field Name:** `impressions`<br />**Type:** metric                                     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Clicks</div>               | Clicks on the ad, including favorites and other engagements (promoted only).<br /><br />**Field Name:** `clicks`<br />**Type:** metric                                    |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Url Clicks</div>           | Clicks on the link or Website Card in the ad (promoted only, including earned).<br /><br />**Field Name:** `url_clicks`<br />**Type:** metric                             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>App Clicks</div>           | App install or app open attempts from the ad (promoted only).<br /><br />**Field Name:** `app_clicks`<br />**Type:** metric                                               |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Total Audience Reach</div> | Unique users reached by the ad campaign (promoted only). Requires a campaign-level dimension.<br /><br />**Field Name:** `total_audience_reach`<br />**Type:** metric     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Average Frequency</div>    | Average times a user saw ads from the campaign (promoted only). Requires a campaign-level dimension.<br /><br />**Field Name:** `average_frequency`<br />**Type:** metric |

### Engagement

|                                                                               |                                                                                                                                                                    |
| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Likes</div>       | Likes attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `likes`<br />**Type:** metric                                                      |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Retweets</div>    | Retweets attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `retweets`<br />**Type:** metric                                                |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Follows</div>     | Follows attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `follows`<br />**Type:** metric                                                  |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Unfollows</div>   | Unfollows attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `unfollows`<br />**Type:** metric                                              |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Engagements</div> | Total engagements (likes, retweets, replies, clicks) attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `engagements`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Tweets send</div> | Tweets sent attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `tweets_send`<br />**Type:** metric                                          |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Replies</div>     | Replies attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `replies`<br />**Type:** metric                                                  |

### Cards and Carousels

|                                                                                    |                                                                                                                                              |
| ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Card Engagements</div> | Card engagements attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `card_engagements`<br />**Type:** metric          |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Poll Card Vote</div>   | Poll Card votes attributed to the ad campaign (promoted only).<br /><br />**Field Name:** `poll_card_vote`<br />**Type:** metric             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Carousel Swipes</div>  | Swipes on Carousel images or videos attributed to the ad (promoted only).<br /><br />**Field Name:** `carousel_swipes`<br />**Type:** metric |

### Video

|                                                                                        |                                                                                                                                                     |
| -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Views</div>          | Views where at least 3 seconds were played while 100% in view (promoted only).<br /><br />**Field Name:** `video_total_views`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Content Starts</div> | Times video content started playing (promoted only).<br /><br />**Field Name:** `video_content_starts`<br />**Type:** metric                        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Views (25%)</div>    | Views where at least 25% of the video was viewed (promoted only).<br /><br />**Field Name:** `video_views_25`<br />**Type:** metric                 |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Views (50%)</div>    | Views where at least 50% of the video was viewed (promoted only).<br /><br />**Field Name:** `video_views_50`<br />**Type:** metric                 |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Views (75%)</div>    | Views where at least 75% of the video was viewed (promoted only).<br /><br />**Field Name:** `video_views_75`<br />**Type:** metric                 |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video Views (100%)</div>   | Views where 100% of the video was viewed (promoted only).<br /><br />**Field Name:** `video_views_100`<br />**Type:** metric                        |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video CTA Clicks</div>     | Clicks on the call-to-action button in a video ad (promoted only).<br /><br />**Field Name:** `video_cta_clicks`<br />**Type:** metric              |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video 6s Views</div>       | Views where at least 6 seconds of the video was viewed (promoted only).<br /><br />**Field Name:** `video_6s_views`<br />**Type:** metric           |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Video 15s Views</div>      | Views where at least 15 seconds or 95% of the video was viewed (promoted only).<br /><br />**Field Name:** `video_15s_views`<br />**Type:** metric  |

### Media

|                                                                                     |                                                                                                                                |
| ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Media Views</div>       | Views on media content from the ad (promoted only).<br /><br />**Field Name:** `media_views`<br />**Type:** metric             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Media Engagements</div> | Engagements on media content from the ad (promoted only).<br /><br />**Field Name:** `media_engagements`<br />**Type:** metric |

### Mobile Conversions

|                                                                                                            |                                                                                                                                                           |
| ---------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Purchases</div>              | Total number of mobile app purchase conversions.<br /><br />**Field Name:** `mobile_conversion_purchases`<br />**Type:** metric                           |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Spent Credits</div>          | Total number of mobile app spent credits conversions.<br /><br />**Field Name:** `mobile_conversion_spent_credits`<br />**Type:** metric                  |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Installs</div>               | Total number of mobile app install conversions.<br /><br />**Field Name:** `mobile_conversion_installs`<br />**Type:** metric                             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Content Views</div>          | Total number of mobile app content view conversions.<br /><br />**Field Name:** `mobile_conversion_content_views`<br />**Type:** metric                   |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Add to Wishlists</div>       | Total number of mobile app add to wishlist conversions.<br /><br />**Field Name:** `mobile_conversion_add_to_wishlists`<br />**Type:** metric             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Checkouts Initiated</div>    | Total number of mobile app checkout initiated conversions.<br /><br />**Field Name:** `mobile_conversion_checkouts_initiated`<br />**Type:** metric       |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Reservations</div>           | Total number of mobile app reservation conversions.<br /><br />**Field Name:** `mobile_conversion_reservations`<br />**Type:** metric                     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Tutorials Completed</div>    | Total number of mobile app tutorial completed conversions.<br /><br />**Field Name:** `mobile_conversion_tutorials_completed`<br />**Type:** metric       |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Achievements Unlocked</div>  | Total number of mobile app achievement unlocked conversions.<br /><br />**Field Name:** `mobile_conversion_achievements_unlocked`<br />**Type:** metric   |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Searches</div>               | Total number of mobile app search conversions.<br /><br />**Field Name:** `mobile_conversion_searches`<br />**Type:** metric                              |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Add to Carts</div>           | Total number of mobile app add to cart conversions.<br /><br />**Field Name:** `mobile_conversion_add_to_carts`<br />**Type:** metric                     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Payment Info Additions</div> | Total number of mobile app payment info addition conversions.<br /><br />**Field Name:** `mobile_conversion_payment_info_additions`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Re-engages</div>             | Total number of mobile app re-engagement conversions.<br /><br />**Field Name:** `mobile_conversion_re_engages`<br />**Type:** metric                     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Shares</div>                 | Total number of mobile app share conversions.<br /><br />**Field Name:** `mobile_conversion_shares`<br />**Type:** metric                                 |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Rates</div>                  | Total number of mobile app rate conversions.<br /><br />**Field Name:** `mobile_conversion_rates`<br />**Type:** metric                                   |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Logins</div>                 | Total number of mobile app login conversions.<br /><br />**Field Name:** `mobile_conversion_logins`<br />**Type:** metric                                 |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Updates</div>                | Total number of mobile app update conversions.<br /><br />**Field Name:** `mobile_conversion_updates`<br />**Type:** metric                               |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Levels Achieved</div>        | Total number of mobile app level achieved conversions.<br /><br />**Field Name:** `mobile_conversion_levels_achieved`<br />**Type:** metric               |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Invites</div>                | Total number of mobile app invite conversions.<br /><br />**Field Name:** `mobile_conversion_invites`<br />**Type:** metric                               |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Key Page Views</div>         | Total number of mobile app key page view conversions.<br /><br />**Field Name:** `mobile_conversion_key_page_views`<br />**Type:** metric                 |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Downloads</div>              | Total number of mobile app download conversions.<br /><br />**Field Name:** `mobile_conversion_downloads`<br />**Type:** metric                           |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Sign Ups</div>               | Total number of mobile app sign up conversions.<br /><br />**Field Name:** `mobile_conversion_sign_ups`<br />**Type:** metric                             |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Mobile Conversion Site Visits</div>            | Total number of mobile app site visit conversions.<br /><br />**Field Name:** `mobile_conversion_site_visits`<br />**Type:** metric                       |

### Web Conversions

|                                                                                              |                                                                                                                       |
| -------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Web Conversion Purchases</div>   | Total number of web purchase conversions.<br /><br />**Field Name:** `conversion_purchases`<br />**Type:** metric     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Web Conversion Sign Ups</div>    | Total number of web sign up conversions.<br /><br />**Field Name:** `conversion_sign_ups`<br />**Type:** metric       |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Web Conversion Site Visits</div> | Total number of web site visit conversions.<br /><br />**Field Name:** `conversion_site_visits`<br />**Type:** metric |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Web Conversion Downloads</div>   | Total number of web download conversions.<br /><br />**Field Name:** `conversion_downloads`<br />**Type:** metric     |
| <div style={{width: "min(200px, 35vw)", minWidth: "120px"}}>Web Conversion Custom</div>      | Total number of web custom conversions.<br /><br />**Field Name:** `conversion_custom`<br />**Type:** metric          |

***

## Related

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

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

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

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