X (formerly Twitter) remains one of the most influential real-time communication platforms, offering advertisers the ability to reach users during live events, trending conversations, and daily content consumption. Understanding the full landscape of X Ads dimensions and metrics is essential for anyone running paid campaigns on the platform.

This guide provides a complete reference of every dimension and metric available in X Ads as of 2026. We've organized them by level — campaign, line item (ad group), and creative — with practical context on when and how to use each one. Whether you're building custom dashboards, pulling data through the X Ads API, or optimizing campaigns in the X Ads Manager, this reference covers everything you need.

What Are X Ads Dimensions vs Metrics?

Before diving into the full reference, it's important to understand the fundamental difference between dimensions and metrics — two concepts that serve different purposes in advertising data analysis.

Dimensions are descriptive attributes that define what you're looking at. They are the labels, categories, and identifiers that let you organize and filter your data. Examples include campaign name, line item ID, tweet text, audience segment, and geographic location. Dimensions answer the question: "How do I want to slice this data?"

Metrics are quantitative measurements that tell you how things performed. They are the numbers: impressions, engagements, clicks, spend, conversions, engagement rate, CPC. Metrics answer the question: "What happened with my ads?"

Breakdowns are a special type of dimension that you can apply across any metric to segment performance. For example, you can break down your conversion metrics by device type to understand mobile vs. desktop behavior, or by location to see which regions drive the best results.

How Is X Ads Data Structured?

X Ads follows a three-level hierarchy: Campaign > Line Item > Promoted Tweet/Creative. Campaigns set the objective, funding source, and high-level budget. Line items (equivalent to ad groups) define targeting, bid type, bid amount, placements, and schedule. Promoted tweets contain the actual creative content — text, images, videos, and cards. Metrics can be queried at any level, with creative-level data rolling up to line item and campaign totals.

The X Ads API returns dimensions as object fields and metrics through the stats and analytics endpoints. Most metrics are available at all levels, while some dimensions are level-specific (e.g., targeting parameters only exist at the line item level). X's reporting system supports date range filtering, granularity settings (day, total), and placement-level breakdowns.

Campaign-Level Dimensions

Campaign-level dimensions define the top-level structure of your X advertising. These fields identify the campaign, its objective, budget configuration, funding source, and operational status. Use these dimensions to organize reporting by campaign and understand the strategic setup behind your results.

DimensionAPI FieldDescription
Campaign IDidUnique identifier for the campaign
Campaign NamenameThe name of the campaign as set by the advertiser
ObjectiveobjectiveCampaign goal: REACH, ENGAGEMENTS, VIDEO_VIEWS, WEBSITE_CLICKS, CONVERSIONS, APP_INSTALLS, FOLLOWERS, or PRE_ROLL_VIEWS
Campaign Statusentity_statusCurrent status: ACTIVE, PAUSED, DRAFT, or EXPIRED
ServableservableWhether the campaign is eligible to serve ads (accounts for all parent-level checks)
Daily Budgetdaily_budget_amount_local_microDaily budget in microcurrency (divide by 1,000,000 for actual amount)
Total Budgettotal_budget_amount_local_microTotal campaign budget across its entire flight in microcurrency
Funding Instrument IDfunding_instrument_idPayment method linked to the campaign (credit card, insertion order)
CurrencycurrencyAccount currency code (USD, EUR, GBP, etc.)
Start Timestart_timeCampaign start date/time in ISO 8601 format
End Timeend_timeCampaign end date/time (null if no end date set)
Standard Deliverystandard_deliveryWhether the campaign uses standard (paced) delivery or accelerated delivery
Frequency Capfrequency_capMaximum impressions per user within a specified time window
Created Atcreated_atTimestamp when the campaign was first created
Updated Atupdated_atTimestamp of the last modification to the campaign

Ad Group (Line Item) Dimensions

Line items (X's equivalent of ad groups) control targeting, bidding, placements, and optimization settings. This is where you define who sees your ads, how much you pay, and where your promoted content appears. Line items are the most configuration-heavy level in the X Ads hierarchy.

DimensionAPI FieldDescription
Line Item IDidUnique identifier for the line item
Line Item NamenameName of the line item as defined by the advertiser
Line Item Statusentity_statusCurrent status: ACTIVE, PAUSED, or DRAFT
Bid Typebid_typeBidding approach: AUTO (automatic), MAX (maximum bid), or TARGET (target cost)
Bid Amountbid_amount_local_microBid amount in microcurrency for the selected bid type
OptimizationoptimizationDelivery optimization: DEFAULT, WEBSITE_CONVERSIONS, APP_INSTALLS, or ENGAGEMENTS
PlacementsplacementsWhere ads appear: ALL_ON_X, PUBLISHER_NETWORK, or X_PROFILE (selected placements)
Product Typeproduct_typeAd product: PROMOTED_TWEETS, PROMOTED_ACCOUNT, PROMOTED_TRENDS, IN_STREAM_VIDEO
Audience Targetingtargeting_criteriaTargeting rules including followers, interests, keywords, conversation topics, events
Tailored Audiencestailored_audiencesCustom audiences: website visitors, CRM lists, mobile app users, lookalikes
Age Targetingtargeting.age_rangeAge range targeting: 13-17, 18-24, 25-34, 35-49, 50-54, 55-64, 65+
Gender Targetingtargeting.genderGender targeting: MALE, FEMALE, or ANY
Location Targetingtargeting.locationsGeographic targeting by country, region, metro, city, or postal code
Language Targetingtargeting.languagesLanguages targeted (based on user interface language and tweet language)
Device Targetingtargeting.devicesDevice models and OS versions targeted
Keyword Targetingtargeting.keywordsKeywords users have tweeted, searched, or engaged with
Conversation Topicstargeting.conversation_topicsConversation topics users engage with (10,000+ available topics)
Events Targetingtargeting.eventsLive events on X that users are engaging with
Start Timestart_timeWhen the line item begins delivering
End Timeend_timeWhen the line item stops delivering

Creative/Tweet Dimensions

Creative dimensions describe the individual promoted tweets — their content, format, media assets, and card types. X supports several creative formats including promoted tweets with images, videos, carousels, and various card types. These dimensions are critical for creative analysis and understanding which content resonates with your target audience.

DimensionAPI FieldDescription
Tweet IDtweet_idUnique identifier for the promoted tweet
Promoted Tweet IDidUnique identifier for the promoted tweet association with a line item
Tweet Textfull_textThe full text content of the tweet (up to 280 characters)
Creative Typecreative_typeFormat: PROMOTED_TWEET, IMAGE_TWEET, VIDEO_TWEET, CAROUSEL, MOMENT
Card Typecard_typeCard format: WEBSITE_CARD, IMAGE_APP_DOWNLOAD, VIDEO_WEBSITE, VIDEO_APP_DOWNLOAD, IMAGE_CAROUSEL, VIDEO_CAROUSEL, IMAGE_MULTI_DEST, DM_CARD
Card URIcard_uriUnique identifier for the card creative attached to the tweet
Media URLmedia_urlURL of the image or video media attached to the tweet
Media Typemedia_typeType of media: IMAGE, VIDEO, GIF, or ANIMATED_GIF
Website URLwebsite_urlDestination URL for website cards
Website Titlewebsite_titleTitle text displayed on the website card
App IDapp_idApp store ID for app install cards
Approval Statusapproval_statusReview status: ACCEPTED, REJECTED, PENDING, or IN_REVIEW
Created Atcreated_atWhen the promoted tweet was first created

Core Performance Metrics

These are the fundamental metrics that measure how your X ads are delivered and interacted with. X's metric model centers around "engagements" — a broad category that encompasses all user interactions with your promoted content. Understanding the hierarchy of engagement metrics is key to accurate reporting.

MetricAPI FieldDescriptionFormula / Notes
ImpressionsimpressionsNumber of times your promoted tweet was served to usersCounts each time the tweet appears in a user's timeline, search, or profile
EngagementsengagementsTotal interactions: likes, retweets, replies, follows, clicks, and moreBroadest interaction metric — includes all user actions on the tweet
Engagement Rateengagement_rateEngagements as a percentage of impressions(Engagements ÷ Impressions) × 100
ClicksclicksAll click actions on the tweetIncludes URL clicks, profile clicks, hashtag clicks, detail expands, and media clicks
Link Clicksurl_clicksClicks on URLs within the tweet or cardUse this for measuring website traffic intent, not total clicks
CTR (Link)url_click_rateLink click-through rate(Link Clicks ÷ Impressions) × 100
CPC (Link)cost_per_url_clickAverage cost per link clickSpend ÷ Link Clicks
CPC (All)cost_per_clickAverage cost per click (all click types)Spend ÷ Clicks
CPMcpmCost per 1,000 impressions(Spend ÷ Impressions) × 1,000
CPEcost_per_engagementCost per engagement (all engagement types)Spend ÷ Engagements
Spendbilled_charge_local_microTotal amount spent in account currency (microcurrency)Divide by 1,000,000 for actual currency amount
ReachreachEstimated unique users who saw your promoted tweetAvailable for reach-objective campaigns
FrequencyfrequencyAverage times each user saw your promoted tweetImpressions ÷ Reach

Conversion Metrics

Conversion metrics measure the business outcomes driven by your X ads — website purchases, app installs, signups, and other valuable actions. These are tracked through the X Pixel (website events) and mobile measurement partners (app events). X supports configurable attribution windows for both click-through and view-through conversions.

MetricAPI FieldDescriptionNotes
Website Conversionsconversion_purchases_webPurchase conversion events on your websiteTracked via X Pixel Purchase event
Website Sign Upsconversion_sign_ups_webSign-up events on your websiteTracked via X Pixel SignUp event
Website Page Viewsconversion_site_visits_webPage view events on your websiteTracked via X Pixel PageView event
Add to Cartconversion_add_to_cart_webAdd-to-cart events on your websiteTracked via X Pixel AddToCart event
Downloadsconversion_downloads_webDownload events on your websiteTracked via X Pixel Download event
Custom Eventsconversion_custom_webAdvertiser-defined custom conversion eventsTracked via X Pixel Custom event
App Installsmobile_conversion_installsApp installation events from mobile measurement partnersRequires MMP integration (AppsFlyer, Adjust, Branch, etc.)
App Purchasesmobile_conversion_purchasesIn-app purchase eventsRevenue from app purchases attributed to your X ads
Cost Per Conversioncost_per_conversionAverage cost per conversion event (all types)Spend ÷ Total Conversions
Conversion Rateconversion_ratePercentage of clicks that resulted in a conversion(Conversions ÷ Clicks) × 100
Post-Click Conversionsconversion_post_clickConversions from users who clicked the adConfigurable window: 1, 7, 14, or 30 days post-click
Post-View Conversionsconversion_post_viewConversions from users who viewed but did not click the adConfigurable window: 1, 7, 14, or 30 days post-view

Engagement Metrics

Engagement metrics on X are exceptionally granular, reflecting the platform's conversation-driven nature. Users can interact with promoted tweets in many ways beyond clicking — liking, retweeting, replying, following, and exploring content in detail. These metrics help you understand how your content performs within the X conversation ecosystem.

MetricAPI FieldDescription
LikeslikesNumber of times users liked your promoted tweet
RetweetsretweetsNumber of times users retweeted (reposted) your promoted tweet
Quote Tweetsquote_tweetsNumber of times users quoted your promoted tweet with their own commentary
RepliesrepliesNumber of direct replies to your promoted tweet
FollowsfollowsNew followers gained as a result of your promoted tweet
Profile Clicksprofile_clicksClicks on your profile name, avatar, or username in the promoted tweet
URL Clicksurl_clicksClicks on URLs within the tweet text or card
Hashtag Clickshashtag_clicksClicks on hashtags within your promoted tweet
Detail Expandsdetail_expandsClicks to expand and view the full tweet and replies
Media Viewsmedia_viewsViews of images, GIFs, or video thumbnails in the tweet
Media Engagementsmedia_engagementsClicks to interact with media (expand image, play video, click carousel)
App Clicksapp_clicksClicks to the app store from app install cards
Email Tweetemail_tweetTimes users shared the promoted tweet via email
Cost Per Followcost_per_followAverage cost to acquire a new follower
Cost Per Likecost_per_likeAverage cost per like on your promoted tweet
Cost Per Retweetcost_per_retweetAverage cost per retweet of your promoted tweet

Video Metrics

Video metrics measure how users engage with video content in your promoted tweets. X provides detailed view and completion data across multiple thresholds, helping you understand viewing behavior from initial impressions through full completion. These metrics are essential for optimizing video creative strategy.

MetricAPI FieldDescriptionNotes
Video Viewsvideo_total_viewsTotal video views (2+ seconds at 50%+ viewability)X's standard view threshold: 2 seconds with 50% of the video in view
Video View Ratevideo_view_ratePercentage of impressions resulting in a video view(Video Views ÷ Impressions) × 100
3-Second Video Viewsvideo_views_3sVideo plays of at least 3 seconds at 100% viewabilityStricter than the 2-second threshold — requires full viewability
Video Watched 25%video_25_watchedTimes the video was watched through 25% of its durationFirst quartile completion — measures opening hook effectiveness
Video Watched 50%video_50_watchedTimes the video was watched through 50% of its durationMidpoint completion — indicates sustained viewer interest
Video Watched 75%video_75_watchedTimes the video was watched through 75% of its durationThird quartile — strong engagement signal
Video Watched 100%video_100_watchedTimes the video was watched to full completionComplete view — highest video engagement level
Completed Viewsvideo_completed_viewsTotal completed video plays (same as 100% watched)Duplicate of video_100_watched for convenience
Cost Per View (CPV)cost_per_video_viewAverage cost per video view (2-second threshold)Spend ÷ Video Views
Cost Per 3s Viewcost_per_3s_viewAverage cost per 3-second video viewSpend ÷ 3-Second Video Views
Cost Per Completed Viewcost_per_completed_viewAverage cost per fully completed video viewSpend ÷ Completed Views
Video Content Startsvideo_content_startsNumber of times the video began playing (any duration)Includes autoplay starts in the timeline

Audience Breakdowns

Audience breakdowns let you segment your metrics by various user attributes and behavioral dimensions. These breakdowns are essential for understanding which segments of your audience respond best to your ads and where to allocate budget for maximum impact.

Demographic Breakdowns

BreakdownAPI FieldDescription
AgeageAge range: 13-17, 18-24, 25-34, 35-49, 50-54, 55-64, 65+
GendergenderMale, Female, or Unspecified
LanguagelanguageUser interface language or detected tweet language

Geographic Breakdowns

BreakdownAPI FieldDescription
CountrycountryCountry by ISO code (US, GB, JP, etc.)
RegionregionState or region within a country
Metro AreametroMetropolitan area or designated market area
CitycityCity-level geographic breakdown

Device and Platform Breakdowns

BreakdownAPI FieldDescription
Device TypedeviceMobile, Desktop, or Tablet
PlatformplatformiOS, Android, Desktop Web, or Mobile Web
CarriercarrierMobile carrier (when available)

Interest and Behavioral Breakdowns

BreakdownAPI FieldDescription
InterestsinterestPerformance by interest category (Technology, Sports, Business, etc.)
Conversation Topicsconversation_topicPerformance by conversation topic users engage with on X
Follower Look-Alikesfollower_lookalikePerformance by users similar to specified account followers
KeywordkeywordPerformance by targeted keyword that triggered the ad

How to Use X Metrics for Campaign Optimization

Selecting the right metrics for your specific campaign objectives is essential for effective optimization on X. Here's a practical framework for each campaign type.

For reach and awareness campaigns

Focus on impressions, reach, frequency, CPM, and engagement rate. On X, a healthy engagement rate for promoted tweets is 1-3%. Monitor frequency to prevent ad fatigue — X's real-time feed environment means users can see the same promoted tweet multiple times in a single session.

For traffic campaigns

Prioritize link clicks (URL clicks), link CTR, and cost per link click. Do not confuse total engagements with traffic-driving clicks — likes, retweets, and detail expands do not send users to your website. Also monitor website page views via the X Pixel to measure actual landing page loads, which will be lower than link clicks due to bounces.

For conversion campaigns

Track cost per conversion, conversion rate, and post-click vs. post-view conversion ratios. Compare attribution windows (1-day, 7-day, 14-day, 30-day) to understand the typical conversion lag for your product. Break down by conversation topic and interest to find which audience segments convert at the best rates.

For video view campaigns

Use 3-second views (not the broader 2-second metric) for measuring genuine attention. Track the quartile completion dropoff (25% → 50% → 75% → 100%) to identify where viewers lose interest. A steep drop between 25% and 50% signals a weak middle section. Monitor CPV and cost per completed view to optimize for video efficiency.

For follower campaigns

Track follows, cost per follow, and the ratio of follows to profile clicks. If many users click your profile but don't follow, your profile may need optimization. Monitor retweets and likes as secondary signals — they indicate content quality and can drive organic follow growth beyond your paid campaign.

Common Mistakes When Analyzing X Ads Data

X's engagement-centric model creates specific pitfalls that advertisers coming from other platforms often encounter. Avoiding these mistakes will save you from flawed analyses and bad optimization decisions.

1. Conflating engagements with website traffic

The "engagements" metric on X includes likes, retweets, replies, follows, profile clicks, hashtag clicks, detail expands, and media views — most of which keep users on X rather than driving them to your website. When measuring traffic, always use URL clicks specifically. The gap between total engagements and URL clicks is typically 5-15x.

2. Ignoring the engagement rate benchmark

X's engagement rates are naturally higher than other platforms because the metric includes so many interaction types. A 2% engagement rate on X is not comparable to a 2% CTR on Meta — they measure fundamentally different things. Benchmark engagement rates for your industry on X specifically, not against cross-platform averages.

3. Undervaluing retweets and organic amplification

Retweets extend your paid reach at no additional cost. A promoted tweet that gets retweeted delivers free impressions to the retweeter's followers. Track the ratio of organic impressions (from retweets) to paid impressions to understand the amplification effect. High retweet rates can dramatically reduce your effective CPM.

4. Using 2-second video views as a quality metric

The default video view metric (2 seconds at 50% viewability) includes autoplay views from users scrolling past. For measuring genuine viewer interest, use 3-second views (100% viewability) or the 25% completion metric as your baseline. The completion rate funnel (25% → 50% → 75% → 100%) provides the most accurate picture of video engagement quality.

5. Averaging cost-per-result metrics across campaigns

CPE, CPC, CPV, and cost-per-conversion are all ratio metrics that cannot be accurately averaged across campaigns or line items. A campaign with $1.00 CPE on 10 engagements and another with $0.50 CPE on 1,000 engagements should not be averaged to $0.75 CPE. Sum total spend and total results, then divide for the accurate blended metric.

6. Not segmenting by placement

X Ads can deliver across the main timeline, search results, profile pages, and the X Audience Platform (publisher network). Performance varies dramatically across these placements. Timeline placements typically have higher engagement rates but also higher costs. Always break down by placement to understand where your budget delivers the best results, and consider excluding underperforming placements.