Complete reference for X Ads dimensions and metrics
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 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 |
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 |
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 |
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 |
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 |
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 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 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 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 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 |