Skip to main content
Last updated: January 27, 2026
95 dimensions
60 metrics
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.
Supported destinations:
Google Sheets
Looker Studio

​
Dimensions

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

​
Account

Account ID
The identifier for the selected account/s.

Field Name: account.id
Type: dimension
Account Name
The name of the selected account/s.

Field Name: account.name
Type: dimension

​
Campaign

Campaign ID
Identifier for the campaign.

Field Name: campaign.id
Type: dimension
Campaign Name
Name of the campaign.

Field Name: campaign.name
Type: dimension
Frequency Cap
Frequency cap set for the campaign.

Field Name: campaign.frequency_cap
Type: dimension
Funding Instrument ID
Identifier for the funding instrument associated with the campaign.

Field Name: campaign.funding_instrument_id
Type: dimension
Currency
Currency used for the campaign, associated to it’s funding instrument.

Field Name: campaign.currency
Type: dimension
Created At
Timestamp when the campaign was created.

Field Name: campaign.updated_at
Type: dimension
Updated At
Timestamp when the campaign was last updated.

Field Name: campaign.created_at
Type: dimension

​
Campaign Status

Servable
Indicates if the campaign is servable or not.

Field Name: campaign.servable
Type: dimension
Effective Status
Effective status of the campaign.

Field Name: campaign.effective_status
Type: dimension
Entity Status
Status of the campaign entity.

Field Name: campaign.entity_status
Type: dimension
Reasons Not Servable
Reasons why the campaign is not servable.

Field Name: campaign.reasons_not_servable
Type: dimension
Duration (days)
Duration of the campaign in days.

Field Name: campaign.duration_in_days
Type: dimension
Standard Delivery
Indicates if the campaign uses standard delivery.

Field Name: campaign.standard_delivery
Type: dimension
Deleted
Indicates if the campaign is deleted.

Field Name: campaign.deleted
Type: dimension

​
Campaign Budget

Daily Budget
Daily budget amount in campaign’s currency.

Field Name: campaign.daily_budget_amount_local_micro
Type: dimension
Total Budget
Total budget amount in campaign’s currency..

Field Name: campaign.total_budget_amount_local_micro
Type: dimension
Budget Optimization
Type of budget optimization configured for the campaign: CAMPAIGN, LINE_ITEM.

Field Name: campaign.budget_optimization
Type: dimension

​
Ad Group

Ad Group ID
Unique identifier for the ad group (line item).

Field Name: line_item.id
Type: dimension
Ad Group Name
Name of the ad group.

Field Name: line_item.name
Type: dimension
Campaign ID (Ad Group)
The campaign ID this ad group belongs to.

Field Name: line_item.campaign_id
Type: dimension
Objective
The optimization objective for the ad group.

Field Name: line_item.objective
Type: dimension
Product Type
The product type of the ad group (PROMOTED_TWEETS, etc.).

Field Name: line_item.product_type
Type: dimension
Placements
Where ads will be shown (ALL_ON_TWITTER, TWITTER_TIMELINE, etc.).

Field Name: line_item.placements
Type: dimension
Goal
The goal for the ad group optimization.

Field Name: line_item.goal
Type: dimension
Currency
Currency used for the ad group.

Field Name: line_item.currency
Type: dimension
Frequency Cap
Maximum impressions per user in the duration period.

Field Name: line_item.frequency_cap
Type: dimension
Frequency Cap Duration
Duration in days for the frequency cap.

Field Name: line_item.duration_in_days
Type: dimension
Auto Tweet Promotion
Whether automatic tweet promotion is enabled.

Field Name: line_item.automatic_tweet_promotion
Type: dimension
Advertiser Domain
The advertiser domain for the ad group.

Field Name: line_item.advertiser_domain
Type: dimension
Advertiser User ID
The advertiser user ID.

Field Name: line_item.advertiser_user_id
Type: dimension
Ad Group Created At
When the ad group was created.

Field Name: line_item.created_at
Type: dimension
Ad Group Updated At
When the ad group was last updated.

Field Name: line_item.updated_at
Type: dimension
Funding Instrument ID
The funding instrument associated with the ad group.

Field Name: line_item.funding_instrument_id
Type: dimension
Primary Web Event Tag
Primary web event tag for conversion tracking.

Field Name: line_item.primary_web_event_tag
Type: dimension
Android App Store ID
Android app store identifier for app install campaigns.

Field Name: line_item.android_app_store_identifier
Type: dimension
iOS App Store ID
iOS app store identifier for app install campaigns.

Field Name: line_item.ios_app_store_identifier
Type: dimension
Categories
IAB categories for the ad group.

Field Name: line_item.categories
Type: dimension
Creative Source
Source of creatives (MANUAL, AUTO, etc.).

Field Name: line_item.creative_source
Type: dimension

​
Ad Group Status

Ad Group Status
Status of the ad group entity (ACTIVE, PAUSED, etc.).

Field Name: line_item.entity_status
Type: dimension
Standard Delivery
Whether standard delivery is enabled.

Field Name: line_item.standard_delivery
Type: dimension
Ad Group Start Time
When the ad group starts running.

Field Name: line_item.start_time
Type: dimension
Ad Group End Time
When the ad group stops running.

Field Name: line_item.end_time
Type: dimension
Ad Group Deleted
Whether the ad group is deleted.

Field Name: line_item.deleted
Type: dimension

​
Ad Group Bidding

Bid Strategy
The bidding strategy (AUTO, TARGET, MAX).

Field Name: line_item.bid_strategy
Type: dimension
Bid Amount
The bid amount in the ad group currency.

Field Name: line_item.bid_amount_local_micro
Type: dimension
Target CPA
Target cost per action.

Field Name: line_item.target_cpa_local_micro
Type: dimension
Pay By
What you pay for (IMPRESSION, APP_CLICK, etc.).

Field Name: line_item.pay_by
Type: dimension

​
Ad Group Budget

Ad Group Daily Budget
Daily budget amount for the ad group.

Field Name: line_item.daily_budget_amount_local_micro
Type: dimension
Ad Group Total Budget
Total budget amount for the ad group.

Field Name: line_item.total_budget_amount_local_micro
Type: dimension
Promoted Tweet ID
Unique identifier for the promoted tweet.

Field Name: promoted_tweet.id
Type: dimension
Tweet ID
The underlying tweet ID being promoted.

Field Name: promoted_tweet.tweet_id
Type: dimension
Ad Group ID (Promoted Tweet)
The ad group this promoted tweet belongs to.

Field Name: promoted_tweet.line_item_id
Type: dimension
Promoted Tweet Status
Status of the promoted tweet (ACTIVE, PAUSED, etc.).

Field Name: promoted_tweet.entity_status
Type: dimension
Approval Status
Approval status of the promoted tweet (ACCEPTED, REJECTED).

Field Name: promoted_tweet.approval_status
Type: dimension
Promoted Tweet Created At
When the promoted tweet was created.

Field Name: promoted_tweet.created_at
Type: dimension
Promoted Tweet Updated At
When the promoted tweet was last updated.

Field Name: promoted_tweet.updated_at
Type: dimension
Promoted Tweet Deleted
Whether the promoted tweet is deleted.

Field Name: promoted_tweet.deleted
Type: dimension

​
Tweet Content

Ad Name
Name given to the ad/tweet when created (max 80 characters). Useful for identifying ads.

Field Name: tweet.name
Type: dimension
Promoted Tweet Text
The text content of the promoted tweet.

Field Name: tweet.text
Type: dimension
Promoted Tweet URL
Direct URL to the promoted tweet on X.

Field Name: tweet.url
Type: dimension
Promoted Tweet Author Name
Display name of the promoted tweet author.

Field Name: tweet.author_name
Type: dimension
Promoted Tweet Author Username
Username (@handle) of the promoted tweet author.

Field Name: tweet.author_username
Type: dimension
Promoted Tweet Author Profile Image URL
Profile image URL of the promoted tweet author.

Field Name: tweet.author_profile_image_url
Type: dimension
Promoted Tweet Hashtags
Comma-separated list of hashtags in the promoted tweet.

Field Name: tweet.hashtags
Type: dimension
Promoted Tweet User Mentions
Comma-separated list of @mentions in the promoted tweet.

Field Name: tweet.user_mentions
Type: dimension
Promoted Tweet Symbols
Comma-separated list of $cashtags in the promoted tweet.

Field Name: tweet.symbols
Type: dimension
Promoted Tweet Language
Language code of the promoted tweet (e.g., “en”, “es”).

Field Name: tweet.language
Type: dimension
Promoted Tweet Source
Source application used to post the promoted tweet.

Field Name: tweet.source
Type: dimension

​
Creative

Promoted Tweet Card ID
Unique identifier for the card creative.

Field Name: card.id
Type: dimension
Promoted Tweet Card Name
Name of the card creative.

Field Name: card.name
Type: dimension
Promoted Tweet Card URI
Internal URI reference for the card.

Field Name: card.uri
Type: dimension
Promoted Tweet Card Type
Type of card (e.g., IMAGE_WEBSITE, VIDEO_WEBSITE, IMAGE_APP).

Field Name: card.type
Type: dimension

​
Creative Media

Promoted Tweet Card Image URL
URL of the image or video thumbnail in the card.

Field Name: card.media_url
Type: dimension
Promoted Tweet Card Media Type
Type of media in the card (image or video).

Field Name: card.media_type
Type: dimension
Promoted Tweet Card Media Width
Width of the card media in pixels.

Field Name: card.media_width
Type: dimension
Promoted Tweet Card Media Height
Height of the card media in pixels.

Field Name: card.media_height
Type: dimension

​
Creative Video

Promoted Tweet Card Video Poster URL
Poster/thumbnail image URL for video cards.

Field Name: card.video_poster_url
Type: dimension
Promoted Tweet Card Video Duration
Duration of the video in milliseconds.

Field Name: card.video_duration
Type: dimension
Promoted Tweet Card Video Aspect Ratio
Aspect ratio of the video (e.g., “16:9”, “1:1”).

Field Name: card.video_aspect_ratio
Type: dimension
Promoted Tweet Card Carousel Image 1 URL
URL of the first carousel image.

Field Name: card.carousel_image_1_url
Type: dimension
Promoted Tweet Card Carousel Image 2 URL
URL of the second carousel image.

Field Name: card.carousel_image_2_url
Type: dimension
Promoted Tweet Card Carousel Image 3 URL
URL of the third carousel image.

Field Name: card.carousel_image_3_url
Type: dimension
Promoted Tweet Card Carousel Image 4 URL
URL of the fourth carousel image.

Field Name: card.carousel_image_4_url
Type: dimension
Promoted Tweet Card Carousel Image 5 URL
URL of the fifth carousel image.

Field Name: card.carousel_image_5_url
Type: dimension

​
Creative Destination

Promoted Tweet Card Destination Type
Type of destination (WEBSITE or APP).

Field Name: card.destination_type
Type: dimension
Promoted Tweet Card Destination URL
Full destination URL or app deep link.

Field Name: card.destination_url
Type: dimension
Promoted Tweet Card Display URL
Shortened display URL (hostname only).

Field Name: card.display_url
Type: dimension

​
Creative App

Promoted Tweet Card App Store ID
App store identifier for app install cards.

Field Name: card.app_store_id
Type: dimension
Promoted Tweet Card App Country Code
Country code for the app store.

Field Name: card.app_country_code
Type: dimension

​
Creative Details

Promoted Tweet Card Button Label
Call-to-action button text on the card.

Field Name: card.button_label
Type: dimension
Promoted Tweet Card Title
Title/headline of the card.

Field Name: card.title
Type: dimension
Promoted Tweet Card Created At
When the card was created.

Field Name: card.created_at
Type: dimension
Promoted Tweet Card Updated At
When the card was last updated.

Field Name: card.updated_at
Type: dimension

​
Metrics

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

​
Most Used

Spend
Total spend in the campaign’s currency.

Field Name: billed_charge_local_micro
Type: metric
Impressions
Number of times the ad was shown to users (promoted impressions only).

Field Name: impressions
Type: metric
Clicks
Clicks on the ad, including favorites and other engagements (promoted only).

Field Name: clicks
Type: metric
Url Clicks
Clicks on the link or Website Card in the ad (promoted only, including earned).

Field Name: url_clicks
Type: metric
App Clicks
App install or app open attempts from the ad (promoted only).

Field Name: app_clicks
Type: metric
Total Audience Reach
Unique users reached by the ad campaign (promoted only). Requires a campaign-level dimension.

Field Name: total_audience_reach
Type: metric
Average Frequency
Average times a user saw ads from the campaign (promoted only). Requires a campaign-level dimension.

Field Name: average_frequency
Type: metric

​
Engagement

Likes
Likes attributed to the ad campaign (promoted only).

Field Name: likes
Type: metric
Retweets
Retweets attributed to the ad campaign (promoted only).

Field Name: retweets
Type: metric
Follows
Follows attributed to the ad campaign (promoted only).

Field Name: follows
Type: metric
Unfollows
Unfollows attributed to the ad campaign (promoted only).

Field Name: unfollows
Type: metric
Engagements
Total engagements (likes, retweets, replies, clicks) attributed to the ad campaign (promoted only).

Field Name: engagements
Type: metric
Tweets send
Tweets sent attributed to the ad campaign (promoted only).

Field Name: tweets_send
Type: metric
Replies
Replies attributed to the ad campaign (promoted only).

Field Name: replies
Type: metric

​
Cards and Carousels

Card Engagements
Card engagements attributed to the ad campaign (promoted only).

Field Name: card_engagements
Type: metric
Poll Card Vote
Poll Card votes attributed to the ad campaign (promoted only).

Field Name: poll_card_vote
Type: metric
Carousel Swipes
Swipes on Carousel images or videos attributed to the ad (promoted only).

Field Name: carousel_swipes
Type: metric

​
Video

Video Views
Views where at least 3 seconds were played while 100% in view (promoted only).

Field Name: video_total_views
Type: metric
Video Content Starts
Times video content started playing (promoted only).

Field Name: video_content_starts
Type: metric
Video Views (25%)
Views where at least 25% of the video was viewed (promoted only).

Field Name: video_views_25
Type: metric
Video Views (50%)
Views where at least 50% of the video was viewed (promoted only).

Field Name: video_views_50
Type: metric
Video Views (75%)
Views where at least 75% of the video was viewed (promoted only).

Field Name: video_views_75
Type: metric
Video Views (100%)
Views where 100% of the video was viewed (promoted only).

Field Name: video_views_100
Type: metric
Video CTA Clicks
Clicks on the call-to-action button in a video ad (promoted only).

Field Name: video_cta_clicks
Type: metric
Video 6s Views
Views where at least 6 seconds of the video was viewed (promoted only).

Field Name: video_6s_views
Type: metric
Video 15s Views
Views where at least 15 seconds or 95% of the video was viewed (promoted only).

Field Name: video_15s_views
Type: metric

​
Media

Media Views
Views on media content from the ad (promoted only).

Field Name: media_views
Type: metric
Media Engagements
Engagements on media content from the ad (promoted only).

Field Name: media_engagements
Type: metric

​
Mobile Conversions

Mobile Conversion Purchases
Total number of mobile app purchase conversions.

Field Name: mobile_conversion_purchases
Type: metric
Mobile Conversion Spent Credits
Total number of mobile app spent credits conversions.

Field Name: mobile_conversion_spent_credits
Type: metric
Mobile Conversion Installs
Total number of mobile app install conversions.

Field Name: mobile_conversion_installs
Type: metric
Mobile Conversion Content Views
Total number of mobile app content view conversions.

Field Name: mobile_conversion_content_views
Type: metric
Mobile Conversion Add to Wishlists
Total number of mobile app add to wishlist conversions.

Field Name: mobile_conversion_add_to_wishlists
Type: metric
Mobile Conversion Checkouts Initiated
Total number of mobile app checkout initiated conversions.

Field Name: mobile_conversion_checkouts_initiated
Type: metric
Mobile Conversion Reservations
Total number of mobile app reservation conversions.

Field Name: mobile_conversion_reservations
Type: metric
Mobile Conversion Tutorials Completed
Total number of mobile app tutorial completed conversions.

Field Name: mobile_conversion_tutorials_completed
Type: metric
Mobile Conversion Achievements Unlocked
Total number of mobile app achievement unlocked conversions.

Field Name: mobile_conversion_achievements_unlocked
Type: metric
Mobile Conversion Searches
Total number of mobile app search conversions.

Field Name: mobile_conversion_searches
Type: metric
Mobile Conversion Add to Carts
Total number of mobile app add to cart conversions.

Field Name: mobile_conversion_add_to_carts
Type: metric
Mobile Conversion Payment Info Additions
Total number of mobile app payment info addition conversions.

Field Name: mobile_conversion_payment_info_additions
Type: metric
Mobile Conversion Re-engages
Total number of mobile app re-engagement conversions.

Field Name: mobile_conversion_re_engages
Type: metric
Mobile Conversion Shares
Total number of mobile app share conversions.

Field Name: mobile_conversion_shares
Type: metric
Mobile Conversion Rates
Total number of mobile app rate conversions.

Field Name: mobile_conversion_rates
Type: metric
Mobile Conversion Logins
Total number of mobile app login conversions.

Field Name: mobile_conversion_logins
Type: metric
Mobile Conversion Updates
Total number of mobile app update conversions.

Field Name: mobile_conversion_updates
Type: metric
Mobile Conversion Levels Achieved
Total number of mobile app level achieved conversions.

Field Name: mobile_conversion_levels_achieved
Type: metric
Mobile Conversion Invites
Total number of mobile app invite conversions.

Field Name: mobile_conversion_invites
Type: metric
Mobile Conversion Key Page Views
Total number of mobile app key page view conversions.

Field Name: mobile_conversion_key_page_views
Type: metric
Mobile Conversion Downloads
Total number of mobile app download conversions.

Field Name: mobile_conversion_downloads
Type: metric
Mobile Conversion Sign Ups
Total number of mobile app sign up conversions.

Field Name: mobile_conversion_sign_ups
Type: metric
Mobile Conversion Site Visits
Total number of mobile app site visit conversions.

Field Name: mobile_conversion_site_visits
Type: metric

​
Web Conversions

Web Conversion Purchases
Total number of web purchase conversions.

Field Name: conversion_purchases
Type: metric
Web Conversion Sign Ups
Total number of web sign up conversions.

Field Name: conversion_sign_ups
Type: metric
Web Conversion Site Visits
Total number of web site visit conversions.

Field Name: conversion_site_visits
Type: metric
Web Conversion Downloads
Total number of web download conversions.

Field Name: conversion_downloads
Type: metric
Web Conversion Custom
Total number of web custom conversions.

Field Name: conversion_custom
Type: metric

​
Tweet Engagement

Promoted Tweet Likes
Total number of likes on the promoted tweet (organic + promoted combined).

Field Name: tweet.like_count
Type: metric
Promoted Tweet Retweets
Total number of retweets on the promoted tweet (organic + promoted combined).

Field Name: tweet.retweet_count
Type: metric
Promoted Tweet Replies
Total number of replies on the promoted tweet (organic + promoted combined).

Field Name: tweet.reply_count
Type: metric
Promoted Tweet Quotes
Total number of quote tweets on the promoted tweet (organic + promoted combined).

Field Name: tweet.quote_count
Type: metric