Skip to main content
Last updated: November 3, 2025
19 dimensions
56 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

​
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
Total number of impressions.

Field Name: impressions
Type: metric
Clicks
Total number of clicks, including favorites and other engagements

Field Name: clicks
Type: metric
Url Clicks
Total clicks on the link or Website Card in an ad, including earned.

Field Name: url_clicks
Type: metric
App Clicks
Number of app install or app open attempts.

Field Name: app_clicks
Type: metric
Total Audience Reach
The total number of unique users reached by the campaign. This metric requires a campaign-level dimension to be selected.

Field Name: total_audience_reach
Type: metric
Average Frequency
The average number of times a user saw ads from the campaign. This metric requires a campaign-level dimension to be selected.

Field Name: average_frequency
Type: metric

​
Engagement
Likes
Total number of likes.

Field Name: likes
Type: metric
Retweets
Total number of retweets.

Field Name: retweets
Type: metric
Follows
Total number of follows.

Field Name: follows
Type: metric
Unfollows
Total number of unfollows.

Field Name: unfollows
Type: metric
Engagements
Total number of engagements.

Field Name: engagements
Type: metric
Tweets send
Total number of tweets sent.

Field Name: tweets_send
Type: metric
Replies
Total number of replies.

Field Name: replies
Type: metric

​
Cards and Carousels
Card Engagements
Total number of card engagements.

Field Name: card_engagements
Type: metric
Poll Card Vote
Total number of votes on Poll Cards.

Field Name: poll_card_vote
Type: metric
Carousel Swipes
Total swipes on Carousel images or videos.

Field Name: carousel_swipes
Type: metric

​
Video
Video Views
Total number of views where at least 3 seconds were played while 100% in view

Field Name: video_total_views
Type: metric
Video Content Starts
Total number of times video content starts playing.

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

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

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

Field Name: video_views_75
Type: metric
Video Views (100%)
Total number of views where at least 100% of the video was viewed.

Field Name: video_views_100
Type: metric
Video CTA Clicks
Total number of clicks on the call-to-action button in a video ad.

Field Name: video_cta_clicks
Type: metric
Video 6s Views
Total number of views where at least 6 seconds of the video was viewed

Field Name: video_6s_views
Type: metric
Video 15s Views
Total number of views where at least 15 seconds of the video or for 95% of the total duration was viewed

Field Name: video_15s_views
Type: metric

​
Media
Media Views
Total number of views on media content.

Field Name: media_views
Type: metric
Media Engagements
Total number of engagements on media content.

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