Last updated: July 31, 2026
85 dimensions
56 metrics
Supported destinations:
Google Sheets
Looker Studio
Claude
BigQuery
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.idType: dimension |
Account Name | The name of the selected account/s. Field Name: account.nameType: dimension |
Campaign
Campaign ID | Identifier for the campaign. Field Name: campaign.idType: dimension |
Campaign Name | Name of the campaign. Field Name: campaign.nameType: dimension |
Frequency Cap | Frequency cap set for the campaign. Field Name: campaign.frequency_capType: dimension |
Funding Instrument ID | Identifier for the funding instrument associated with the campaign. Field Name: campaign.funding_instrument_idType: dimension |
Currency | Currency used for the campaign, associated to it’s funding instrument. Field Name: campaign.currencyType: dimension |
Created At | Timestamp when the campaign was created. Field Name: campaign.updated_atType: dimension |
Updated At | Timestamp when the campaign was last updated. Field Name: campaign.created_atType: dimension |
Campaign Status
Servable | Indicates if the campaign is servable or not. Field Name: campaign.servableType: dimension |
Effective Status | Effective status of the campaign. Field Name: campaign.effective_statusType: dimension |
Entity Status | Status of the campaign entity. Field Name: campaign.entity_statusType: dimension |
Reasons Not Servable | Reasons why the campaign is not servable. Field Name: campaign.reasons_not_servableType: dimension |
Duration (days) | Duration of the campaign in days. Field Name: campaign.duration_in_daysType: dimension |
Standard Delivery | Indicates if the campaign uses standard delivery. Field Name: campaign.standard_deliveryType: dimension |
Deleted | Indicates if the campaign is deleted. Field Name: campaign.deletedType: dimension |
Campaign Budget
Daily Budget | Daily budget amount in campaign’s currency. Field Name: campaign.daily_budget_amount_local_microType: dimension |
Total Budget | Total budget amount in campaign’s currency.. Field Name: campaign.total_budget_amount_local_microType: dimension |
Budget Optimization | Type of budget optimization configured for the campaign: CAMPAIGN, LINE_ITEM. Field Name: campaign.budget_optimizationType: dimension |
Ad Group
Ad Group ID | Unique identifier for the ad group (line item). Field Name: line_item.idType: dimension |
Ad Group Name | Name of the ad group. Field Name: line_item.nameType: dimension |
Campaign ID (Ad Group) | The campaign ID this ad group belongs to. Field Name: line_item.campaign_idType: dimension |
Objective | The optimization objective for the ad group. Field Name: line_item.objectiveType: dimension |
Product Type | The product type of the ad group (PROMOTED_TWEETS, etc.). Field Name: line_item.product_typeType: dimension |
Placements | Where ads will be shown (ALL_ON_TWITTER, TWITTER_TIMELINE, etc.). Field Name: line_item.placementsType: dimension |
Goal | The goal for the ad group optimization. Field Name: line_item.goalType: dimension |
Currency | Currency used for the ad group. Field Name: line_item.currencyType: dimension |
Frequency Cap | Maximum impressions per user in the duration period. Field Name: line_item.frequency_capType: dimension |
Frequency Cap Duration | Duration in days for the frequency cap. Field Name: line_item.duration_in_daysType: dimension |
Auto Tweet Promotion | Whether automatic tweet promotion is enabled. Field Name: line_item.automatic_tweet_promotionType: dimension |
Advertiser Domain | The advertiser domain for the ad group. Field Name: line_item.advertiser_domainType: dimension |
Advertiser User ID | The advertiser user ID. Field Name: line_item.advertiser_user_idType: dimension |
Ad Group Created At | When the ad group was created. Field Name: line_item.created_atType: dimension |
Ad Group Updated At | When the ad group was last updated. Field Name: line_item.updated_atType: dimension |
Funding Instrument ID | The funding instrument associated with the ad group. Field Name: line_item.funding_instrument_idType: dimension |
Primary Web Event Tag | Primary web event tag for conversion tracking. Field Name: line_item.primary_web_event_tagType: dimension |
Android App Store ID | Android app store identifier for app install campaigns. Field Name: line_item.android_app_store_identifierType: dimension |
iOS App Store ID | iOS app store identifier for app install campaigns. Field Name: line_item.ios_app_store_identifierType: dimension |
Categories | IAB categories for the ad group. Field Name: line_item.categoriesType: dimension |
Creative Source | Source of creatives (MANUAL, AUTO, etc.). Field Name: line_item.creative_sourceType: dimension |
Ad Group Status
Ad Group Status | Status of the ad group entity (ACTIVE, PAUSED, etc.). Field Name: line_item.entity_statusType: dimension |
Standard Delivery | Whether standard delivery is enabled. Field Name: line_item.standard_deliveryType: dimension |
Ad Group Start Time | When the ad group starts running. Field Name: line_item.start_timeType: dimension |
Ad Group End Time | When the ad group stops running. Field Name: line_item.end_timeType: dimension |
Ad Group Deleted | Whether the ad group is deleted. Field Name: line_item.deletedType: dimension |
Ad Group Bidding
Bid Strategy | The bidding strategy (AUTO, TARGET, MAX). Field Name: line_item.bid_strategyType: dimension |
Bid Amount | The bid amount in the ad group currency. Field Name: line_item.bid_amount_local_microType: dimension |
Target CPA | Target cost per action. Field Name: line_item.target_cpa_local_microType: dimension |
Pay By | What you pay for (IMPRESSION, APP_CLICK, etc.). Field Name: line_item.pay_byType: dimension |
Ad Group Budget
Ad Group Daily Budget | Daily budget amount for the ad group. Field Name: line_item.daily_budget_amount_local_microType: dimension |
Ad Group Total Budget | Total budget amount for the ad group. Field Name: line_item.total_budget_amount_local_microType: dimension |
Promoted Tweet
Promoted Tweet ID | Unique identifier for the promoted tweet. Field Name: promoted_tweet.idType: dimension |
Tweet ID | The underlying tweet ID being promoted. Field Name: promoted_tweet.tweet_idType: dimension |
Ad Group ID (Promoted Tweet) | The ad group this promoted tweet belongs to. Field Name: promoted_tweet.line_item_idType: dimension |
Promoted Tweet Status | Status of the promoted tweet (ACTIVE, PAUSED, etc.). Field Name: promoted_tweet.entity_statusType: dimension |
Approval Status | Approval status of the promoted tweet (ACCEPTED, REJECTED). Field Name: promoted_tweet.approval_statusType: dimension |
Promoted Tweet Created At | When the promoted tweet was created. Field Name: promoted_tweet.created_atType: dimension |
Promoted Tweet Updated At | When the promoted tweet was last updated. Field Name: promoted_tweet.updated_atType: dimension |
Promoted Tweet Deleted | Whether the promoted tweet is deleted. Field Name: promoted_tweet.deletedType: dimension |
Tweet Content
Ad Name | Name given to the ad/tweet when created (max 80 characters). Useful for identifying ads. Field Name: tweet.nameType: dimension |
Creative
Promoted Tweet Card ID | Unique identifier for the card creative. Field Name: card.idType: dimension |
Promoted Tweet Card Name | Name of the card creative. Field Name: card.nameType: dimension |
Promoted Tweet Card URI | Internal URI reference for the card. Field Name: card.uriType: dimension |
Promoted Tweet Card Type | Type of card (e.g., IMAGE_WEBSITE, VIDEO_WEBSITE, IMAGE_APP). Field Name: card.typeType: dimension |
Creative Media
Promoted Tweet Card Image URL | URL of the image or video thumbnail in the card. Field Name: card.media_urlType: dimension |
Promoted Tweet Card Media Type | Type of media in the card (image or video). Field Name: card.media_typeType: dimension |
Promoted Tweet Card Media Width | Width of the card media in pixels. Field Name: card.media_widthType: dimension |
Promoted Tweet Card Media Height | Height of the card media in pixels. Field Name: card.media_heightType: dimension |
Creative Video
Promoted Tweet Card Video Poster URL | Poster/thumbnail image URL for video cards. Field Name: card.video_poster_urlType: dimension |
Promoted Tweet Card Video Duration | Duration of the video in milliseconds. Field Name: card.video_durationType: dimension |
Promoted Tweet Card Video Aspect Ratio | Aspect ratio of the video (e.g., “16:9”, “1:1”). Field Name: card.video_aspect_ratioType: dimension |
Creative Carousel
Promoted Tweet Card Carousel Image 1 URL | URL of the first carousel image. Field Name: card.carousel_image_1_urlType: dimension |
Promoted Tweet Card Carousel Image 2 URL | URL of the second carousel image. Field Name: card.carousel_image_2_urlType: dimension |
Promoted Tweet Card Carousel Image 3 URL | URL of the third carousel image. Field Name: card.carousel_image_3_urlType: dimension |
Promoted Tweet Card Carousel Image 4 URL | URL of the fourth carousel image. Field Name: card.carousel_image_4_urlType: dimension |
Promoted Tweet Card Carousel Image 5 URL | URL of the fifth carousel image. Field Name: card.carousel_image_5_urlType: dimension |
Creative Destination
Promoted Tweet Card Destination Type | Type of destination (WEBSITE or APP). Field Name: card.destination_typeType: dimension |
Promoted Tweet Card Destination URL | Full destination URL or app deep link. Field Name: card.destination_urlType: dimension |
Promoted Tweet Card Display URL | Shortened display URL (hostname only). Field Name: card.display_urlType: dimension |
Creative App
Promoted Tweet Card App Store ID | App store identifier for app install cards. Field Name: card.app_store_idType: dimension |
Promoted Tweet Card App Country Code | Country code for the app store. Field Name: card.app_country_codeType: dimension |
Creative Details
Promoted Tweet Card Button Label | Call-to-action button text on the card. Field Name: card.button_labelType: dimension |
Promoted Tweet Card Title | Title/headline of the card. Field Name: card.titleType: dimension |
Promoted Tweet Card Created At | When the card was created. Field Name: card.created_atType: dimension |
Promoted Tweet Card Updated At | When the card was last updated. Field Name: card.updated_atType: 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_microType: metric |
Impressions | Number of times the ad was shown to users (promoted impressions only). Field Name: impressionsType: metric |
Clicks | Clicks on the ad, including favorites and other engagements (promoted only). Field Name: clicksType: metric |
Url Clicks | Clicks on the link or Website Card in the ad (promoted only, including earned). Field Name: url_clicksType: metric |
App Clicks | App install or app open attempts from the ad (promoted only). Field Name: app_clicksType: metric |
Total Audience Reach | Unique users reached by the ad campaign (promoted only). Requires a campaign-level dimension. Field Name: total_audience_reachType: metric |
Average Frequency | Average times a user saw ads from the campaign (promoted only). Requires a campaign-level dimension. Field Name: average_frequencyType: metric |
Engagement
Likes | Likes attributed to the ad campaign (promoted only). Field Name: likesType: metric |
Retweets | Retweets attributed to the ad campaign (promoted only). Field Name: retweetsType: metric |
Follows | Follows attributed to the ad campaign (promoted only). Field Name: followsType: metric |
Unfollows | Unfollows attributed to the ad campaign (promoted only). Field Name: unfollowsType: metric |
Engagements | Total engagements (likes, retweets, replies, clicks) attributed to the ad campaign (promoted only). Field Name: engagementsType: metric |
Tweets send | Tweets sent attributed to the ad campaign (promoted only). Field Name: tweets_sendType: metric |
Replies | Replies attributed to the ad campaign (promoted only). Field Name: repliesType: metric |
Cards and Carousels
Card Engagements | Card engagements attributed to the ad campaign (promoted only). Field Name: card_engagementsType: metric |
Poll Card Vote | Poll Card votes attributed to the ad campaign (promoted only). Field Name: poll_card_voteType: metric |
Carousel Swipes | Swipes on Carousel images or videos attributed to the ad (promoted only). Field Name: carousel_swipesType: metric |
Video
Video Views | Views where at least 3 seconds were played while 100% in view (promoted only). Field Name: video_total_viewsType: metric |
Video Content Starts | Times video content started playing (promoted only). Field Name: video_content_startsType: metric |
Video Views (25%) | Views where at least 25% of the video was viewed (promoted only). Field Name: video_views_25Type: metric |
Video Views (50%) | Views where at least 50% of the video was viewed (promoted only). Field Name: video_views_50Type: metric |
Video Views (75%) | Views where at least 75% of the video was viewed (promoted only). Field Name: video_views_75Type: metric |
Video Views (100%) | Views where 100% of the video was viewed (promoted only). Field Name: video_views_100Type: metric |
Video CTA Clicks | Clicks on the call-to-action button in a video ad (promoted only). Field Name: video_cta_clicksType: metric |
Video 6s Views | Views where at least 6 seconds of the video was viewed (promoted only). Field Name: video_6s_viewsType: metric |
Video 15s Views | Views where at least 15 seconds or 95% of the video was viewed (promoted only). Field Name: video_15s_viewsType: metric |
Media
Media Views | Views on media content from the ad (promoted only). Field Name: media_viewsType: metric |
Media Engagements | Engagements on media content from the ad (promoted only). Field Name: media_engagementsType: metric |
Mobile Conversions
Mobile Conversion Purchases | Total number of mobile app purchase conversions. Field Name: mobile_conversion_purchasesType: metric |
Mobile Conversion Spent Credits | Total number of mobile app spent credits conversions. Field Name: mobile_conversion_spent_creditsType: metric |
Mobile Conversion Installs | Total number of mobile app install conversions. Field Name: mobile_conversion_installsType: metric |
Mobile Conversion Content Views | Total number of mobile app content view conversions. Field Name: mobile_conversion_content_viewsType: metric |
Mobile Conversion Add to Wishlists | Total number of mobile app add to wishlist conversions. Field Name: mobile_conversion_add_to_wishlistsType: metric |
Mobile Conversion Checkouts Initiated | Total number of mobile app checkout initiated conversions. Field Name: mobile_conversion_checkouts_initiatedType: metric |
Mobile Conversion Reservations | Total number of mobile app reservation conversions. Field Name: mobile_conversion_reservationsType: metric |
Mobile Conversion Tutorials Completed | Total number of mobile app tutorial completed conversions. Field Name: mobile_conversion_tutorials_completedType: metric |
Mobile Conversion Achievements Unlocked | Total number of mobile app achievement unlocked conversions. Field Name: mobile_conversion_achievements_unlockedType: metric |
Mobile Conversion Searches | Total number of mobile app search conversions. Field Name: mobile_conversion_searchesType: metric |
Mobile Conversion Add to Carts | Total number of mobile app add to cart conversions. Field Name: mobile_conversion_add_to_cartsType: metric |
Mobile Conversion Payment Info Additions | Total number of mobile app payment info addition conversions. Field Name: mobile_conversion_payment_info_additionsType: metric |
Mobile Conversion Re-engages | Total number of mobile app re-engagement conversions. Field Name: mobile_conversion_re_engagesType: metric |
Mobile Conversion Shares | Total number of mobile app share conversions. Field Name: mobile_conversion_sharesType: metric |
Mobile Conversion Rates | Total number of mobile app rate conversions. Field Name: mobile_conversion_ratesType: metric |
Mobile Conversion Logins | Total number of mobile app login conversions. Field Name: mobile_conversion_loginsType: metric |
Mobile Conversion Updates | Total number of mobile app update conversions. Field Name: mobile_conversion_updatesType: metric |
Mobile Conversion Levels Achieved | Total number of mobile app level achieved conversions. Field Name: mobile_conversion_levels_achievedType: metric |
Mobile Conversion Invites | Total number of mobile app invite conversions. Field Name: mobile_conversion_invitesType: metric |
Mobile Conversion Key Page Views | Total number of mobile app key page view conversions. Field Name: mobile_conversion_key_page_viewsType: metric |
Mobile Conversion Downloads | Total number of mobile app download conversions. Field Name: mobile_conversion_downloadsType: metric |
Mobile Conversion Sign Ups | Total number of mobile app sign up conversions. Field Name: mobile_conversion_sign_upsType: metric |
Mobile Conversion Site Visits | Total number of mobile app site visit conversions. Field Name: mobile_conversion_site_visitsType: metric |
Web Conversions
Web Conversion Purchases | Total number of web purchase conversions. Field Name: conversion_purchasesType: metric |
Web Conversion Sign Ups | Total number of web sign up conversions. Field Name: conversion_sign_upsType: metric |
Web Conversion Site Visits | Total number of web site visit conversions. Field Name: conversion_site_visitsType: metric |
Web Conversion Downloads | Total number of web download conversions. Field Name: conversion_downloadsType: metric |
Web Conversion Custom | Total number of web custom conversions. Field Name: conversion_customType: metric |
Related
Fields Catalog
Browse all platforms
Meta Ads Fields
Meta Ads metrics & dimensions
Google Ads Fields
Google Ads metrics & dimensions
TikTok Ads Fields
TikTok Ads metrics & dimensions