X Ads (Twitter): Most-used fields
The table below gives information about most-used fields that you can import from X Ads (Twitter). Other fields might also be available in Adverity.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.
AccountDimension
Represents the advertising account under which campaigns and ads are managed.
Account IDDimension
A unique identifier for an X Ads account, used to manage and access campaign performance data and metadata. It is a base-36 encoded string.
CampaignDimension
The name of the advertising campaign.
Campaign ObjectiveDimension
The primary marketing goal for the campaign, such as app installs, website clicks, or awareness, which the ad group is optimized to achieve.
PlatformDimension
The platform where the ad was displayed or the user engaged with the ad.
Search KeywordDimension
Keywords used for targeting or to describe the audience for the campaign.
accountDimension
The name of the ad account.
account_idDimension
The unique identifier for the ad account.
account_id_uiDimension
The unique identifier for the advertising account, as displayed in the user interface.
account_nameDimension
The user-defined name of the ad account.
account_timezoneDimension
The timezone configured for the ad account.
ad_group_nameDimension
The name assigned to a specific ad group within a campaign.
ad_nameDimension
The name of the individual ad creative. The X Ads API may derive this from the post name, card name, or a generated ID if no specific name is provided.
advertiser_domainDimension
The website domain of the advertiser associated with the ad group.
advertiser_user_idDimension
The unique identifier for the advertiser's user account on the X Ads platform.
android_app_store_identifierDimension
The unique package name or identifier for an Android application, typically following a reverse domain name format (e.g., com.example.appname), used for app targeting in campaigns.
app_clicksMetric
The total number of clicks on an ad that led to an application.
approval_statusDimension
The approval status of the ad creative or campaign.
audience_expansionDimension
A targeting setting that allows the ad platform to automatically reach additional users similar to the defined target audience, potentially increasing reach and performance.
auto_created_conversion_landing_page_viewconversion_auto_created_conversion_landing_page_viewMetric
The number of automatically created landing page view conversions.
auto_created_conversion_sessionconversion_auto_created_conversion_sessionMetric
A conversion event automatically detected or created, indicating a user session that led to a conversion.
automatic_tweet_promotionDimension
A feature that automatically promotes tweets to a wider audience based on predefined settings, often used for content promotion campaigns.
average_frequencyMetric
The average number of times a person has seen ads related to a specific campaign.
bid_amount_local_microMetric
The bid amount for an ad in local currency, expressed in micro-units (e.g., 1,000,000 micro-units equals 1 unit of currency).
bid_strategyDimension
The bidding method used for the ad group, such as maximum bid, target bid, or automatic bidding, to optimize for specific goals.
billed_charge_local_microMetric
The amount billed for charges, in local currency micro units.
billed_engagementsMetric
The total number of engagements for which you were billed.
budget_optimizationDimension
Indicates if automated campaign budget optimization is enabled, allowing X to distribute the budget across ads and groups to maximize performance.
business_idDimension
The unique identifier for the business account associated with the ad campaign.
business_nameDimension
The name of the business associated with the advertising account.
campaignDimension
The name of the advertising campaign.
campaign_created_atDimension
The date when the campaign was created.
campaign_currencyDimension
The currency in which the campaign budget and costs are reported.
campaign_daily_budget_amount_local_microDimension
The maximum amount you're willing to spend on each campaign on average per day, in local currency micro units.
campaign_deletedDimension
A boolean flag indicating whether the campaign has been marked as deleted.
campaign_duration_in_daysDimension
The total duration of the campaign in days.
campaign_entity_statusDimension
The status of the campaign entity (e.g., ACTIVE, DRAFT, PAUSED).
campaign_frequency_capDimension
The frequency cap setting for the campaign, limiting how many times an ad is shown to a user.
campaign_funding_instrument_idDimension
The unique identifier of the funding instrument used for the campaign.
campaign_idDimension
The unique identifier for the advertising campaign.
campaign_id_uiDimension
The campaign ID converted to base-10 to match the UI value.
campaign_nameDimension
The name of the ad campaign.
campaign_reasons_not_servableDimension
A list of reasons why the campaign is currently not eligible to serve ads.
campaign_standard_deliveryDimension
A boolean flag indicating if the campaign uses standard ad delivery, distributing the budget evenly over the campaign's duration.
campaign_total_budget_amount_local_microMetric
The maximum amount you're willing to spend on each campaign for its duration, in local currency micro units.
campaign_updated_atDimension
The date and time when the campaign was last updated.
card_app_ctaDimension
The Call to Action (CTA) text displayed on an app card.
card_content_duration_secondsDimension
The duration, in seconds, of video content embedded within an ad card.
card_country_codeDimension
The country code associated with the card.
card_created_atDimension
The timestamp when the card was created.
card_deletedDimension
A boolean flag indicating whether the card has been marked as deleted.
card_engagementsMetric
Total number of engagements with the card.
card_first_ctaDimension
The text for the first Call to Action (CTA) button on the card.
card_first_cta_tweetDimension
The text of the first Call-to-Action (CTA) button displayed on a Twitter Card, designed to prompt user interaction directly from the tweet.
card_first_cta_welcome_message_idDimension
The unique identifier for the initial welcome message presented to users when they interact with the first Call-to-Action (CTA) button on a Direct Message Card.
card_fourth_ctaDimension
The text for the fourth Call to Action (CTA) button on the card.
card_fourth_cta_tweetDimension
The text of the fourth Call-to-Action (CTA) button displayed on a Twitter Card.
card_fourth_cta_welcome_message_idDimension
The unique identifier for a welcome message associated with the fourth Call-to-Action (CTA) button on a Twitter Card.
card_googleplay_app_idDimension
The Google Play Store application ID for an app card.
card_googleplay_deep_linkDimension
The deep link URL for the Google Play Store application, used to direct users to specific content within the app.
card_idDimension
The unique identifier for the card creative.
card_image_display_heightDimension
The display height of an image within the card, in pixels.
card_image_display_widthDimension
The display width of an image within the card, in pixels.
card_ios_app_store_identifierDimension
The Apple App Store identifier for an iOS app card.
card_ios_deep_linkDimension
The deep link URL for the iOS application, used to direct users to specific content within the app.
card_ipad_app_idDimension
The application ID specifically for an iPad app card.
card_ipad_deep_linkDimension
The deep link URL for the iPad application.
card_media_keyDimension
The unique key identifying the primary media asset used in the card.
card_media_urlDimension
The URL of the media associated with the card.
card_nameDimension
The name of the card used in the ad.
card_poll_duration_in_minutesDimension
The duration of the poll within the card, in minutes.
card_poll_end_timeDimension
The scheduled end date and time for the poll within the card.
card_poll_first_choiceDimension
The text for the first choice option in a poll card.
card_poll_fourth_choiceDimension
The text for the fourth choice option in a poll card.
card_poll_second_choiceDimension
The text for the second choice option in a poll card.
card_poll_start_timeDimension
The scheduled start date and time for the poll within the card.
card_poll_third_choiceDimension
The text for the third choice option in a poll card.
card_poster_media_keyDimension
The unique key identifying the poster image media asset used for a video card.
card_poster_media_urlDimension
The URL of the poster image media asset used for a video card.
card_recipient_user_idDimension
The unique identifier of the user who is the recipient of a Direct Message Card or a message initiated through an ad card.
card_second_ctaDimension
The text for the second Call to Action (CTA) button on the card.
card_second_cta_tweetDimension
The text of the second Call-to-Action (CTA) button displayed on a Twitter Card.
card_second_cta_welcome_message_idDimension
The unique identifier for a welcome message associated with the second Call-to-Action (CTA) button on a Twitter Card.
card_thank_you_textDimension
The thank you message text displayed after a user completes an action on the card.
card_thank_you_urlDimension
The URL where users are redirected after completing an action on the card, displaying a thank you message.
card_third_ctaDimension
The text for the third Call to Action (CTA) button on the card.
card_third_cta_tweetDimension
The text of the third Call-to-Action (CTA) button displayed on a Twitter Card.
card_third_cta_welcome_message_idDimension
The unique identifier for a welcome message associated with the third Call-to-Action (CTA) button on a Twitter Card.
card_titleDimension
The title of the card creative.
card_typeDimension
The type of card used in the ad (e.g., Image Card, Video Card, Website Card).
card_unlocked_image_media_keyDimension
A unique identifier or key for an image media asset associated with an ad card, specifically for 'unlocked' content. This relates to `media_id` dimension and MEDIA metrics.
card_unlocked_video_media_keyDimension
A unique identifier or key for a video media asset associated with an ad card, specifically for 'unlocked' content. This relates to `media_id` dimension and VIDEO metrics.
card_updated_atDimension
The timestamp when the card was last updated.
card_uriDimension
The Uniform Resource Identifier (URI) for the card creative.
card_urlDimension
The URL of the ad card creative itself.
card_video_heightDimension
The height of the video within the card, in pixels.
card_video_hls_urlDimension
The URL for the HLS (HTTP Live Streaming) manifest of the video within the card.
card_video_owner_idDimension
The unique identifier of the user account that owns the video associated with the card.
card_video_post_urlDimension
The URL of the post (Tweet) containing a video card.
card_video_poster_heightDimension
The height of the video poster image within the card, in pixels.
card_video_poster_urlDimension
The URL of the video poster image within the card.
card_video_poster_widthDimension
The width of the video poster image within the card, in pixels.
card_video_urlDimension
The URL of the video content within the card.
card_video_widthDimension
The width of the video within the card, in pixels.
card_website_dest_urlDimension
The final destination URL when a user clicks on a website card.
card_website_display_urlDimension
The public-facing URL displayed on an ad card. This corresponds to the `card_url` dimension, providing information about the destination of the ad.
card_website_shortened_urlDimension
A shortened version of the website URL used on the card.
card_website_titleDimension
The title of the website linked on the card.
card_website_urlDimension
The primary URL for the website linked on the card.
carousel_swipesMetric
The number of swipes on a carousel ad.
categoriesDimension
The category or genre of an application or content being advertised, often used for targeting or segmentation.
clicksMetric
Total clicks on links, hashtags, a Website Card, and other Tweet details in your ad, combined with likes and profile clicks.
conversion_add_to_carts.assistedDimension
Number of times a user added an item to their cart where an ad assisted in the conversion path.
conversion_add_to_carts.metricMetric
Total number of times a user added an item to their cart.
conversion_add_to_carts.order_quantityDimension
Total number of items added to carts as a result of conversion events.
conversion_add_to_carts.order_quantity_engagementDimension
Total number of items added to carts attributed to ad engagement.
conversion_add_to_carts.order_quantity_viewDimension
Total number of items added to carts attributed to an ad view (impression).
conversion_add_to_carts.post_engagementDimension
Total number of add to cart conversions that occurred after a user engaged with an ad.
conversion_add_to_carts.post_viewDimension
Total number of add to cart conversions that occurred after a user viewed an ad (impression).
conversion_add_to_carts.sale_amountDimension
Total revenue generated from items added to carts.
conversion_add_to_carts.sale_amount_engagementDimension
Total revenue from items added to carts attributed to ad engagement.
conversion_add_to_carts.sale_amount_viewDimension
Total revenue from items added to carts attributed to an ad view (impression).
conversion_add_to_wishlists.assistedDimension
Number of times a user added an item to their wishlist where an ad assisted in the conversion path.
conversion_add_to_wishlists.metricMetric
Total number of times a user added an item to their wishlist.
conversion_add_to_wishlists.order_quantityDimension
Total number of items added to wishlists as a result of conversion events.
conversion_add_to_wishlists.order_quantity_engagementDimension
Total number of items added to wishlists attributed to ad engagement.
conversion_add_to_wishlists.order_quantity_viewDimension
Total number of items added to wishlists attributed to an ad view (impression).
conversion_add_to_wishlists.post_engagementDimension
Total number of add to wishlist conversions that occurred after a user engaged with an ad.
conversion_add_to_wishlists.post_viewDimension
Total number of add to wishlist conversions that occurred after a user viewed an ad (impression).
conversion_add_to_wishlists.sale_amountDimension
Total revenue generated from items added to wishlists.
conversion_add_to_wishlists.sale_amount_engagementDimension
Total revenue from items added to wishlists attributed to ad engagement.
conversion_add_to_wishlists.sale_amount_viewDimension
Total revenue from items added to wishlists attributed to an ad view (impression).
conversion_auto_created_conversion_landing_page_viewMetric
The number of landing page views automatically attributed as conversions, indicating user interest after clicking an ad.
conversion_auto_created_conversion_landing_page_view.metricMetric
The metric value for automatically created landing page view conversions.
conversion_auto_created_conversion_landing_page_view.order_quantityMetric
The quantity of automatically tracked landing page view conversion events.
conversion_auto_created_conversion_landing_page_view.order_quantity_engagementMetric
The quantity of auto-created landing page view conversions attributed to ad engagement.
conversion_auto_created_conversion_landing_page_view.order_quantity_viewMetric
The quantity of auto-created landing page view conversions attributed to an ad view (impression).
conversion_auto_created_conversion_landing_page_view.post_engagementMetric
The number of post-engagement conversions resulting from an automatically created conversion landing page view.
conversion_auto_created_conversion_landing_page_view.post_viewMetric
The number of post-view conversions resulting from an automatically created conversion landing page view.
conversion_auto_created_conversion_landing_page_view.sale_amountMetric
The revenue generated from auto-created landing page view conversions.
conversion_auto_created_conversion_landing_page_view.sale_amount_engagementMetric
The revenue from auto-created landing page view conversions attributed to ad engagement.
conversion_auto_created_conversion_landing_page_view.sale_amount_viewMetric
The revenue from auto-created landing page view conversions attributed to an ad view (impression).
conversion_auto_created_conversion_sessionMetric
The count of conversion sessions that were automatically detected and created by the X Ads platform based on user behavior.
conversion_auto_created_conversion_session.metricMetric
The total count of automatically tracked session conversion events.
conversion_auto_created_conversion_session.order_quantityMetric
The total number of orders attributed to automatically detected conversion sessions by the X Ads platform.
conversion_auto_created_conversion_session.order_quantity_engagementMetric
The quantity of auto-created session conversions attributed to ad engagement.
conversion_auto_created_conversion_session.order_quantity_viewMetric
The quantity of auto-created session conversions attributed to an ad view (impression).
conversion_auto_created_conversion_session.post_engagementMetric
The count of auto-created session conversions that occurred after a user engaged with an ad.
conversion_auto_created_conversion_session.post_viewMetric
The count of auto-created session conversions that occurred after a user viewed an ad (impression).
conversion_auto_created_conversion_session.sale_amountMetric
The monetary value of a sale attributed to an automatically created conversion session, indicating the revenue generated from purchases.
conversion_auto_created_conversion_session.sale_amount_engagementMetric
The revenue from auto-created session conversions attributed to ad engagement.
conversion_auto_created_conversion_session.sale_amount_viewMetric
The revenue from auto-created session conversions attributed to an ad view (impression).
conversion_checkouts_initiated.assistedDimension
Number of times a user initiated a checkout where an ad assisted in the conversion path.
conversion_checkouts_initiated.metricMetric
Total number of initiated checkout conversion events.
conversion_checkouts_initiated.order_quantityDimension
Total number of items in initiated checkouts as a result of conversion events.
conversion_checkouts_initiated.order_quantity_engagementDimension
Total number of items in initiated checkouts attributed to ad engagement.
conversion_checkouts_initiated.order_quantity_viewDimension
Total number of items in initiated checkouts attributed to an ad view (impression).
conversion_checkouts_initiated.post_engagementDimension
Total number of initiated checkout conversions that occurred after a user engaged with an ad.
conversion_checkouts_initiated.post_viewDimension
Total number of initiated checkout conversions that occurred after a user viewed an ad (impression).
conversion_checkouts_initiated.sale_amountDimension
Total revenue value of initiated checkouts.
conversion_checkouts_initiated.sale_amount_engagementDimension
Total revenue value of initiated checkouts attributed to ad engagement.
conversion_checkouts_initiated.sale_amount_viewDimension
Total revenue value of initiated checkouts attributed to an ad view (impression).
conversion_content_views.assistedDimension
Number of content view conversions where an ad assisted in the conversion path.
conversion_content_views.metricMetric
Total number of content view conversion events.
conversion_content_views.order_quantityDimension
The total number of orders attributed to users who viewed specific content on or off the X platform.
conversion_content_views.order_quantity_engagementDimension
The number of orders attributed to users who engaged with content (e.g., clicked, liked, shared) after viewing it.
conversion_content_views.order_quantity_viewDimension
The number of orders attributed to users based on their view of content, often without additional engagement beyond the impression.
conversion_content_views.post_engagementDimension
Total number of content view conversions that occurred after a user engaged with an ad.
conversion_content_views.post_viewDimension
Total number of content view conversions that occurred after a user viewed an ad (impression).
conversion_content_views.sale_amountDimension
Total revenue generated from content view conversions.
conversion_content_views.sale_amount_engagementDimension
Total revenue from content view conversions attributed to ad engagement.
conversion_content_views.sale_amount_viewDimension
Total revenue from content view conversions attributed to an ad view (impression).
conversion_customMetric
The total count of custom conversions.
conversion_custom.order_quantityMetric
The order quantity for custom conversions.
conversion_custom.sale_amountMetric
The sale amount for custom conversions.
conversion_downloadsMetric
Total number of downloads generated from the ad.
conversion_downloads.assistedDimension
The number of assisted mobile application downloads attributed to an ad campaign. This metric indicates conversions where an ad played a role in the user journey but wasn't the final click or view.
conversion_downloads.metricMetric
The total count of download conversions attributed to ad interactions.
conversion_downloads.order_quantityMetric
The order quantity for download conversions.
conversion_downloads.order_quantity_engagementMetric
The number of download conversions attributed to user engagement with an ad.
conversion_downloads.order_quantity_viewMetric
The number of download conversions attributed to a user viewing an ad.
conversion_downloads.post_engagementMetric
The number of download conversions attributed to engagement with an ad post.
conversion_downloads.post_viewMetric
The number of download conversions attributed to a view of an ad post.
conversion_downloads.sale_amountMetric
The sale amount for download conversions.
conversion_downloads.sale_amount_engagementMetric
The total sales revenue generated from download conversions attributed to user engagement with an ad.
conversion_downloads.sale_amount_viewMetric
The total sales revenue generated from download conversions attributed to a user viewing an ad.
conversion_landing_page_views.assistedDimension
Number of landing page view conversions where an ad assisted in the conversion path.
conversion_landing_page_views.metricMetric
Total number of landing page view conversion events.
conversion_landing_page_views.order_quantityDimension
The total number of orders attributed to users who viewed a landing page associated with an X Ads campaign.
conversion_landing_page_views.order_quantity_engagementDimension
The number of orders attributed to users who engaged with a landing page (e.g., clicked on elements, scrolled) after viewing it.
conversion_landing_page_views.order_quantity_viewDimension
The number of items involved in a web conversion that occurred after a landing page view. This metric is captured via the X Ads Conversion API for web-based actions like purchases or sign-ups.
conversion_landing_page_views.post_engagementDimension
Total number of landing page view conversions that occurred after a user engaged with an ad.
conversion_landing_page_views.post_viewDimension
Total number of landing page view conversions that occurred after a user viewed an ad (impression).
conversion_landing_page_views.sale_amountDimension
Total revenue generated from landing page view conversions.
conversion_landing_page_views.sale_amount_engagementDimension
Total revenue from landing page view conversions attributed to ad engagement.
conversion_landing_page_views.sale_amount_viewDimension
Total revenue from landing page view conversions attributed to an ad view (impression).
conversion_payment_info_additions.assistedDimension
Number of times payment information was added where an ad assisted in the conversion path.
conversion_payment_info_additions.metricMetric
Total number of payment information addition conversion events.
conversion_payment_info_additions.order_quantityDimension
The total number of orders attributed to users who added payment information as a conversion event.
conversion_payment_info_additions.order_quantity_engagementDimension
The number of orders attributed to users who engaged with the payment information addition process.
conversion_payment_info_additions.order_quantity_viewDimension
The number of orders attributed to users based on their view of the payment information addition page or process.
conversion_payment_info_additions.post_engagementDimension
Total number of payment info addition conversions that occurred after a user engaged with an ad.
conversion_payment_info_additions.post_viewDimension
Total number of payment info addition conversions that occurred after a user viewed an ad (impression).
conversion_payment_info_additions.sale_amountDimension
Total revenue generated from payment info addition conversions.
conversion_payment_info_additions.sale_amount_engagementDimension
Total revenue from payment info addition conversions attributed to ad engagement.
conversion_payment_info_additions.sale_amount_viewDimension
Total revenue from payment info addition conversions attributed to an ad view (impression).
conversion_purchasesMetric
Total number of purchases. The sum of post view, post engagement, and assisted purchases for both your website and mobile app.
conversion_purchases.assistedMetric
The number of assisted purchase conversions.
conversion_purchases.metricMetric
The total count of purchase conversions attributed to ad interactions.
conversion_purchases.order_quantityMetric
The order quantity for purchase conversions.
conversion_purchases.order_quantity_engagementMetric
The number of purchase conversions attributed to user engagement with an ad.
conversion_purchases.order_quantity_viewMetric
The number of purchase conversions attributed to a user viewing an ad.
conversion_purchases.post_engagementMetric
Purchase conversions that occurred after an engagement with the ad.
conversion_purchases.post_viewMetric
Purchase conversions that occurred after viewing the ad.
conversion_purchases.sale_amountMetric
The sale amount for purchase conversions.
conversion_purchases.sale_amount_engagementMetric
The total sales revenue generated from purchase conversions attributed to user engagement with an ad.
conversion_purchases.sale_amount_viewMetric
The total sales revenue generated from purchase conversions attributed to a user viewing an ad.
conversion_searches.assistedDimension
Number of searches where an ad assisted in the conversion path.
conversion_searches.metricMetric
Total number of search conversion events.
conversion_searches.order_quantityDimension
The total number of orders attributed to users who performed a search on a connected platform as a conversion event.
conversion_searches.order_quantity_engagementDimension
The number of orders attributed to users who engaged with search results or subsequent actions after performing a search.
conversion_searches.order_quantity_viewDimension
The number of orders attributed to users based on their view of search results, without necessarily performing additional engagement.
conversion_searches.post_engagementDimension
Total number of search conversions that occurred after a user engaged with an ad.
conversion_searches.post_viewDimension
Total number of search conversions that occurred after a user viewed an ad (impression).
conversion_searches.sale_amountDimension
Total revenue generated from search conversions.
conversion_searches.sale_amount_engagementDimension
Total revenue from search conversions attributed to ad engagement.
conversion_searches.sale_amount_viewDimension
Total revenue from search conversions attributed to an ad view (impression).
conversion_sessions.assistedDimension
Number of sessions where an ad assisted in the conversion path.
conversion_sessions.metricMetric
Total number of session conversion events.
conversion_sessions.order_quantityDimension
The total number of orders attributed to conversion sessions, which are user sessions leading to a desired action.
conversion_sessions.order_quantity_engagementDimension
The number of orders attributed to users who engaged during a conversion session, indicating active interaction within the session.
conversion_sessions.order_quantity_viewDimension
The number of orders attributed to users based on their presence in a conversion session, often without explicit engagement beyond the session view.
conversion_sessions.post_engagementDimension
Total number of session conversions that occurred after a user engaged with an ad.
conversion_sessions.post_viewDimension
Total number of session conversions that occurred after a user viewed an ad (impression).
conversion_sessions.sale_amountDimension
Total revenue generated from session conversions.
conversion_sessions.sale_amount_engagementDimension
Total revenue from session conversions attributed to ad engagement.
conversion_sessions.sale_amount_viewDimension
Total revenue from session conversions attributed to an ad view (impression).
conversion_sign_upsMetric
Total number of sign ups. This is the sum of post views, post engagements and assisted sign ups for both website and mobile app.
conversion_sign_ups.assistedMetric
The number of assisted sign-up conversions.
conversion_sign_ups.metricMetric
The total count of sign-up conversions attributed to ad interactions.
conversion_sign_ups.order_quantityMetric
The order quantity for sign-up conversions.
conversion_sign_ups.order_quantity_engagementMetric
The number of sign-up conversions attributed to user engagement with an ad.
conversion_sign_ups.order_quantity_viewMetric
The number of sign-up conversions attributed to a user viewing an ad.
conversion_sign_ups.post_engagementDimension
Sign-up conversions that occurred after an engagement with the ad.
conversion_sign_ups.post_viewMetric
Sign-up conversions that occurred after viewing the ad.
conversion_sign_ups.sale_amountMetric
The sale amount for sign-up conversions.
conversion_sign_ups.sale_amount_engagementMetric
The total sales revenue generated from sign-up conversions attributed to user engagement with an ad.
conversion_sign_ups.sale_amount_viewMetric
The total sales revenue generated from sign-up conversions attributed to a user viewing an ad.
conversion_site_visitsMetric
The total count of site visit conversions.
conversion_site_visits.assistedDimension
The number of website visit conversion events that were assisted by an ad interaction. This indicates ad exposure contributing to a website visit that was not the final interaction.
conversion_site_visits.metricMetric
The total count of website visit conversions attributed to ad interactions.
conversion_site_visits.order_quantityMetric
The order quantity for site visit conversions.
conversion_site_visits.order_quantity_engagementMetric
The number of website visit conversions attributed to user engagement with an ad.
conversion_site_visits.order_quantity_viewMetric
The number of website visit conversions attributed to a user viewing an ad.
conversion_site_visits.post_engagementDimension
Site visit conversions that occurred after an engagement with the ad.
conversion_site_visits.post_viewMetric
Site visit conversions that occurred after viewing the ad.
conversion_site_visits.sale_amountMetric
The sale amount for site visit conversions.
conversion_site_visits.sale_amount_engagementMetric
The total sales revenue generated from website visit conversions attributed to user engagement with an ad.
conversion_site_visits.sale_amount_viewMetric
The total sales revenue generated from website visit conversions attributed to a user viewing an ad.
conversion_subscriptions.assistedDimension
Number of subscriptions where an ad assisted in the conversion path.
conversion_subscriptions.metricMetric
Total number of subscription conversion events.
conversion_subscriptions.order_quantityDimension
The total number of orders attributed to users who completed a subscription as a conversion event.
conversion_subscriptions.order_quantity_engagementDimension
The number of orders attributed to users who engaged with content or actions related to a subscription, after showing interest in subscribing.
conversion_subscriptions.order_quantity_viewDimension
The number of orders attributed to users based on their view of subscription-related content or offers.
conversion_subscriptions.post_engagementDimension
Total number of subscription conversions that occurred after a user engaged with an ad.
conversion_subscriptions.post_viewDimension
Total number of subscription conversions that occurred after a user viewed an ad (impression).
conversion_subscriptions.sale_amountDimension
Total revenue generated from subscription conversions.
conversion_subscriptions.sale_amount_engagementDimension
Total revenue from subscription conversions attributed to ad engagement.
conversion_subscriptions.sale_amount_viewDimension
Total revenue from subscription conversions attributed to an ad view (impression).
costsMetric
The total spend for the ad campaign.
country_codeDimension
The two-letter ISO country code representing the geographical location targeted by the ad campaign.
country_idDimension
The unique identifier for the country where the ad was shown or targeted.
country_nameDimension
The name of the country where the ad was shown or targeted.
created_atDimension
The timestamp when the record or entity was created.
creative_sourceDimension
Indicates the origin or type of the creative content used in an ad, such as an image, video, or a promoted tweet.
creative_typeDimension
The type of creative used in the ad, such as image, video, or text.
currencyDimension
The three-letter ISO 4217 currency code used for monetary values within the ad account or campaign (e.g., USD, EUR).
daily_budget_amount_local_microMetric
The daily budget amount for a campaign or line item, expressed in micro-units of the local currency. For example, 1,000,000 micro-units would equal 1 unit of the specified currency.
dateDimension
The date for which the data is reported, in 'YYYY-MM-DD' format.
deletedDimension
Indicates whether the entity (e.g., campaign, line item) has been deleted.
duration_in_daysMetric
The total duration of the campaign or line item, specified in number of days.
effective_statusDimension
The actual delivery status of an ad entity, which can be influenced by its own configured status as well as the status of its parent entities (e.g., campaign, ad group). This reflects whether an ad is currently active and eligible for delivery.
engagementsMetric
All clicks on your Tweet, including Retweets, replies, likes, poll votes, and hashtag clicks. This includes earned clicks that you're not billed for.
entities_expanded_urlsDimension
The fully expanded URLs associated with the ad entity, after any URL shorteners have been resolved.
entities_media_call_to_action_urlsDimension
URLs specifically designated as calls to action within an ad creative or media, prompting user interaction. These can be derived from fields like 'website_dest_url' or other URL fields associated with ad creatives.
entities_media_urlsDimension
A list of URLs for the media assets used in the advertisement.
entities_media_video_urlsDimension
URLs for video media assets associated with the ad entity.
entity_statusDimension
The configured status of an entity, such as a campaign or ad group, which determines its current operational state (e.g., ACTIVE, PAUSED, DRAFT).
followsMetric
Total number of followers generated from your Tweet, including earned follows from other locations like 'Who to follow'.
frequency_capMetric
A setting that limits the number of times an ad is shown to an individual user within a specified period to prevent ad fatigue and optimize campaign reach.
funding_instrument_descriptionDimension
A description of the funding instrument used for billing.
funding_instrument_idDimension
A reference to the funding instrument ID.
funding_instrument_typeDimension
The type of funding instrument (e.g., credit card, insertion order).
goalDimension
The specific marketing outcome that the ad group is optimized to achieve.
impressionsMetric
The number of times your ad is shown to users, including earned impressions.
ios_app_store_identifierDimension
The unique identifier (Adam ID or bundle ID) for an iOS application on the Apple App Store, used for app targeting in campaigns.
likesMetric
The number of people who liked your ad by clicking the heart button.
line_item_advertiser_domainDimension
The advertiser's domain associated with the line item.
line_item_advertiser_user_idMetric
The unique identifier of the advertiser's user account associated with the line item.
line_item_automatic_tweet_promotionDimension
A boolean flag indicating if the line item is set for automatic tweet promotion.
line_item_automatically_select_bidDimension
A boolean flag indicating if the bid amount for the line item is automatically selected by the system.
line_item_bid_amount_local_microDimension
The bid amount for the line item, expressed in local currency micro-units.
line_item_bid_strategyDimension
The bidding strategy used for the line item, such as lowest cost or target cost.
line_item_bid_typeDimension
The type of bid used for the line item, such as auto-bid or manual bid.
line_item_bid_unitDimension
The unit for which the bid is placed (e.g., per impression, per click).
line_item_campaign_idDimension
The unique identifier of the campaign to which the line item belongs.
line_item_categoriesDimension
The categories associated with the ad group.
line_item_charge_byDimension
The billing event for which the line item is charged (e.g., impression, engagement).
line_item_created_atDimension
The timestamp when the line item was created.
line_item_creative_sourceDimension
The source of the creative assets used within the line item.
line_item_currencyDimension
The currency used for all spend-related metrics and billing for the ad group.
line_item_deletedDimension
Indicates if the line item has been deleted.
line_item_end_timeDimension
The date when the ad group stopped serving.
line_item_entity_statusDimension
The status of the ad group (formerly called line item status), with possible values ACTIVE, DRAFT, or PAUSED.
line_item_goalDimension
The optimization setting used for this ad group.
line_item_idDimension
The unique ID for the ad group (formerly called line item id).
line_item_id_uiDimension
The ad group ID converted to base-10 to match the UI value.
line_item_nameDimension
The name of the ad group (formerly called line item).
line_item_optimizationDimension
The optimization goal or strategy applied to the line item (ad group) for ad delivery.
line_item_pay_byDimension
The billing event for the line item (e.g., impressions, engagements).
line_item_placementsDimension
The placements where the ad group is configured to run.
line_item_primary_web_event_tagDimension
The primary web event tag associated with the line item, used for tracking specific user actions on a website.
line_item_product_typeDimension
The type of product or ad format associated with the line item.
line_item_start_timeDimension
The date when the ad group began serving.
line_item_target_cpa_local_microDimension
The target Cost Per Acquisition (CPA) for the line item, in micro-currency units of the local currency.
line_item_total_budget_amount_local_microDimension
The maximum amount you are willing to spend on the ad group, for the duration of its flight length, in local currency micro units.
line_item_tracking_tagsDimension
Custom tags used for tracking and categorizing the line item's performance.
line_item_updated_atDimension
The timestamp when the line item was last updated.
link_clicksMetric
The total number of clicks on links within an ad or promoted content, leading users to a specified destination.
media_account_media_idDimension
The unique identifier for the media creative within the account.
media_approval_statusDimension
The approval status of the media creative, indicating whether it has been approved to run.
media_aspect_ratioDimension
The media_aspect_ratio indicates the proportional relationship between the width and height of an image or video attachment, derived from the 'width' and 'height' properties of media objects.
media_categoryDimension
The categorization of the media content used in the advertisement (e.g., image, video).
media_created_atDimension
The timestamp when the media creative was initially created.
media_deletedDimension
A boolean flag indicating whether the media creative has been marked as deleted.
media_descriptionDimension
The media_description provides descriptive text for media content, primarily used for accessibility purposes as alternative text for images, GIFs, or videos.
media_durationMetric
The duration of the media in seconds.
media_engagementsMetric
Total number of clicks on media across videos, Vines, GIFs, and images.
media_entity_statusDimension
The current operational status of the media asset (e.g., active, processing, rejected).
media_file_nameDimension
The file name of the media object.
media_idDimension
The unique ID of the media object.
media_keyDimension
A unique identifier for a media asset, such as an image or video, used in an ad.
media_landing_urlDimension
The landing URL associated with the media creative.
media_nameDimension
The name of the media object.
media_poster_media_keyMetric
The media key of the poster image for video media.
media_poster_media_urlDimension
The URL of the poster image for video media.
media_statusDimension
The moderation or approval status of the creative media (e.g., images, videos) used in an ad, indicating if it's approved, pending review, or rejected.
media_titleDimension
The title of the media asset.
media_typeDimension
The type of media used (e.g., image, video).
media_updated_atDimension
The timestamp when the media creative was last updated.
media_urlDimension
The URL to the media object.
media_viewsMetric
Total views (autoplay and click) of your media across videos, Vines, GIFs, and images. This includes views you are not billed for.
mobile_conversion_achievements_unlockedMetric
The total count of mobile conversions where users unlocked an achievement within the app. This metric can be broken down by various attribution types.
mobile_conversion_achievements_unlocked.assistedMetric
The number of mobile conversions for achievements unlocked that were assisted by an X ad, meaning the user engaged with an ad but the conversion wasn't directly attributed to a single ad click or view.
mobile_conversion_achievements_unlocked.order_quantityMetric
The total quantity of items or events associated with mobile conversions for achievements unlocked.
mobile_conversion_achievements_unlocked.post_engagementMetric
The number of mobile conversions for achievements unlocked that occurred after a user engaged with an X ad (e.g., liked, retweeted, clicked).
mobile_conversion_achievements_unlocked.post_viewMetric
The number of mobile conversions for achievements unlocked that occurred after a user viewed an X ad, without necessarily interacting with it.
mobile_conversion_achievements_unlocked.sale_amountMetric
The total monetary value generated from mobile conversions for achievements unlocked.
mobile_conversion_add_to_cartsMetric
Breakdown of mobile conversions of type ADD_TO_CART.
mobile_conversion_add_to_carts.assistedDimension
The number of assisted mobile add-to-cart conversions.
mobile_conversion_add_to_carts.order_quantityDimension
The order quantity for mobile add-to-cart conversions.
mobile_conversion_add_to_carts.post_engagementMetric
Mobile add-to-cart conversions that occurred after an engagement with the ad.
mobile_conversion_add_to_carts.post_viewMetric
Mobile add-to-cart conversions that occurred after viewing the ad.
mobile_conversion_add_to_carts.sale_amountDimension
The sale amount for mobile add-to-cart conversions.
mobile_conversion_add_to_wishlistsMetric
The total number of mobile app conversion events where a user adds an item to their wishlist.
mobile_conversion_add_to_wishlists.assistedMetric
The count of mobile app conversion events where a user adds an item to their wishlist, where an X ad played an assisting role in the conversion path.
mobile_conversion_add_to_wishlists.order_quantityMetric
The total quantity of items added to wishlists as part of mobile app conversion events.
mobile_conversion_add_to_wishlists.post_engagementMetric
The count of mobile app conversion events where a user adds an item to their wishlist, attributed to a prior engagement with an X ad.
mobile_conversion_add_to_wishlists.post_viewMetric
The count of mobile app conversion events where a user adds an item to their wishlist, attributed to a prior view (impression) of an X ad.
mobile_conversion_add_to_wishlists.sale_amountMetric
The total revenue or monetary value generated from mobile app conversion events where users add items to their wishlists.
mobile_conversion_checkouts_initiatedMetric
The total number of initiated checkouts attributed to mobile conversions.
mobile_conversion_checkouts_initiated.assistedMetric
The number of initiated checkouts where a mobile conversion assisted in the conversion path.
mobile_conversion_checkouts_initiated.order_quantityMetric
The total quantity of items in orders where checkouts were initiated as a mobile conversion.
mobile_conversion_checkouts_initiated.post_engagementMetric
The number of initiated checkouts resulting from a mobile conversion after an engagement with an ad.
mobile_conversion_checkouts_initiated.post_viewMetric
The number of initiated checkouts resulting from a mobile conversion after viewing an ad.
mobile_conversion_checkouts_initiated.sale_amountMetric
The revenue generated from initiated checkouts attributed to mobile conversions.
mobile_conversion_content_viewsMetric
The number of times content was viewed within a mobile application after ad interaction.
mobile_conversion_content_views.assistedDimension
The number of assisted mobile conversions where content was viewed.
mobile_conversion_content_views.order_quantityDimension
The total quantity of items ordered in mobile conversions where content was viewed.
mobile_conversion_content_views.post_engagementDimension
The number of mobile conversions where content was viewed, attributed to post-engagement actions.
mobile_conversion_content_views.post_viewDimension
The number of mobile conversions where content was viewed, attributed to post-view actions.
mobile_conversion_content_views.sale_amountDimension
The total revenue from mobile conversions where content was viewed.
mobile_conversion_downloadsDimension
The number of mobile application downloads attributed as conversions.
mobile_conversion_downloads.assistedDimension
This field represents the number of mobile app downloads that were assisted by an X Ad campaign. An assisted download indicates that an ad played a role in the user's path to download the app, even if it wasn't the final interaction. This metric belongs to the 'Mobile Conversion' group of metrics.
mobile_conversion_downloads.order_quantityMetric
The order quantity for mobile download conversions.
mobile_conversion_downloads.post_engagementMetric
Mobile download conversions that occurred after an engagement with the ad.
mobile_conversion_downloads.post_viewMetric
Mobile download conversions that occurred after viewing the ad.
mobile_conversion_downloads.sale_amountMetric
The sale amount for mobile download conversions.
mobile_conversion_installsMetric
Breakdown of mobile conversions of type INSTALL.
mobile_conversion_installs.assistedMetric
The number of assisted mobile install conversions.
mobile_conversion_installs.order_quantityMetric
The order quantity for mobile install conversions.
mobile_conversion_installs.post_engagementMetric
Mobile install conversions that occurred after an engagement with the ad.
mobile_conversion_installs.post_viewMetric
Mobile install conversions that occurred after viewing the ad.
mobile_conversion_installs.sale_amountMetric
The sale amount for mobile install conversions.
mobile_conversion_installs.skanDimension
Mobile app install conversions attributed via Apple's SKAdNetwork framework, providing privacy-preserving install metrics.
mobile_conversion_invitesMetric
The total number of invites attributed to mobile conversions.
mobile_conversion_invites.assistedDimension
The number of invites where a mobile conversion assisted in the conversion path.
mobile_conversion_invites.order_quantityDimension
The total quantity of items in orders where invites were generated as a mobile conversion.
mobile_conversion_invites.post_engagementDimension
The number of invites resulting from a mobile conversion after an engagement with an ad.
mobile_conversion_invites.post_viewDimension
The number of invites resulting from a mobile conversion after viewing an ad.
mobile_conversion_invites.sale_amountDimension
The revenue generated from invites attributed to mobile conversions.
mobile_conversion_key_page_viewsMetric
The total number of key page view conversions on mobile devices.
mobile_conversion_key_page_views.post_engagementDimension
The number of mobile key page view conversions attributed to engagement with an ad post.
mobile_conversion_key_page_views.post_viewDimension
The number of mobile key page view conversions attributed to a view of an ad post.
mobile_conversion_lifetime_value_add_to_cartsMetric
The total lifetime value generated from add-to-cart conversions on mobile.
mobile_conversion_lifetime_value_add_to_carts.metricMetric
Total number of mobile add-to-cart events contributing to lifetime value.
mobile_conversion_lifetime_value_add_to_carts.order_quantityDimension
The total quantity of items added to carts in mobile apps that contribute to lifetime value.
mobile_conversion_lifetime_value_add_to_carts.sale_amountDimension
The total revenue generated from mobile add-to-cart events that contribute to lifetime value.
mobile_conversion_lifetime_value_content_views.metricMetric
The total count of content view conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_content_views.order_quantityDimension
The quantity of content view conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_content_views.sale_amountDimension
The sales amount from content view conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_logins.metricMetric
The total count of login conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_logins.order_quantityDimension
The quantity of login conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_logins.sale_amountDimension
The sales amount from login conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_purchasesMetric
The total lifetime value generated from purchase conversions on mobile.
mobile_conversion_lifetime_value_purchases.metricMetric
The total count of purchase conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_purchases.order_quantityDimension
The quantity of purchase conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_purchases.sale_amountDimension
The sales amount from purchase conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_ratesMetric
The total lifetime value generated from rating or review conversions on mobile.
mobile_conversion_lifetime_value_rates.metricMetric
The total count of rating or review conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_rates.order_quantityDimension
The quantity of rating or review conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_rates.sale_amountDimension
The sales amount from rating or review conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_searches.metricMetric
The total count of search conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_searches.order_quantityDimension
The quantity of search conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_searches.sale_amountDimension
The sales amount from search conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_sharesMetric
The total value of shares attributed to mobile conversions over the lifetime of a user.
mobile_conversion_lifetime_value_shares.metricDimension
Represents the lifetime value metric associated with mobile conversions of the type 'share'. This metric provides insights into the value generated from users who share content after engaging with an ad.
mobile_conversion_lifetime_value_shares.order_quantityDimension
The total quantity of items in orders associated with lifetime value shares from mobile conversions.
mobile_conversion_lifetime_value_shares.sale_amountDimension
The revenue generated from lifetime value shares attributed to mobile conversions.
mobile_conversion_lifetime_value_sign_upsMetric
The total value of sign-ups attributed to mobile conversions over the lifetime of a user.
mobile_conversion_lifetime_value_sign_ups.metricDimension
Represents the lifetime value metric associated with mobile conversions of the type 'sign-up'. This metric indicates the value generated from new user registrations after engaging with an ad.
mobile_conversion_lifetime_value_sign_ups.order_quantityDimension
The total quantity of items in orders associated with lifetime value sign-ups from mobile conversions.
mobile_conversion_lifetime_value_sign_ups.sale_amountDimension
The revenue generated from lifetime value sign-ups attributed to mobile conversions.
mobile_conversion_loginsMetric
Breakdown of mobile conversions of type LOGIN.
mobile_conversion_logins.assistedDimension
The number of assisted mobile login conversions.
mobile_conversion_logins.order_quantityDimension
The order quantity for mobile login conversions.
mobile_conversion_logins.post_engagementDimension
Mobile login conversions that occurred after an engagement with the ad.
mobile_conversion_logins.post_viewDimension
Mobile login conversions that occurred after viewing the ad.
mobile_conversion_logins.sale_amountDimension
The sale amount for mobile login conversions.
mobile_conversion_payment_info_additionsMetric
The total count of mobile conversions where users added payment information within the app. This metric can be broken down by various attribution types.
mobile_conversion_payment_info_additions.assistedDimension
The number of mobile conversions for payment info additions that were assisted by an X ad.
mobile_conversion_payment_info_additions.order_quantityDimension
The total quantity of items or events associated with mobile conversions for payment info additions.
mobile_conversion_payment_info_additions.post_engagementDimension
The number of mobile conversions for payment info additions that occurred after a user engaged with an X ad.
mobile_conversion_payment_info_additions.post_viewDimension
The number of mobile conversions for payment info additions that occurred after a user viewed an X ad.
mobile_conversion_payment_info_additions.sale_amountDimension
The total monetary value generated from mobile conversions for payment info additions.
mobile_conversion_purchasesMetric
The number of app purchases attributed to the ads.
mobile_conversion_purchases.assistedDimension
The number of assisted mobile purchase conversions.
mobile_conversion_purchases.order_quantityDimension
The order quantity for mobile purchase conversions.
mobile_conversion_purchases.post_engagementMetric
Mobile purchase conversions that occurred after an engagement with the ad.
mobile_conversion_purchases.post_viewDimension
Mobile purchase conversions that occurred after viewing the ad.
mobile_conversion_purchases.sale_amountMetric
The sale amount for mobile purchase conversions.
mobile_conversion_purchases.skanDimension
Mobile purchase conversions attributed via Apple's SKAdNetwork framework, providing privacy-preserving purchase metrics.
mobile_conversion_ratesMetric
The rate at which mobile conversion events occur, calculated as conversions divided by impressions or clicks.
mobile_conversion_rates.assistedDimension
The assisted conversion rate for mobile conversions.
mobile_conversion_rates.order_quantityDimension
The conversion rate based on order quantity for mobile conversions.
mobile_conversion_rates.post_engagementDimension
The mobile conversion rate attributed to post-engagement actions.
mobile_conversion_rates.post_viewDimension
The mobile conversion rate attributed to post-view actions.
mobile_conversion_rates.sale_amountDimension
The mobile conversion rate based on sale amount.
mobile_conversion_re_engagesMetric
The total number of re-engagements attributed to mobile conversions.
mobile_conversion_re_engages.assistedMetric
The number of re-engagements where a mobile conversion assisted in the conversion path.
mobile_conversion_re_engages.order_quantityMetric
The total quantity of items in orders where re-engagements were generated as a mobile conversion.
mobile_conversion_re_engages.post_engagementMetric
The number of re-engagements resulting from a mobile conversion after an engagement with an ad.
mobile_conversion_re_engages.post_viewMetric
The number of re-engagements resulting from a mobile conversion after viewing an ad.
mobile_conversion_re_engages.sale_amountMetric
The revenue generated from re-engagements attributed to mobile conversions.
mobile_conversion_re_installs.assistedDimension
Number of mobile app re-installs where an ad assisted in the conversion path.
mobile_conversion_re_installs.order_quantityDimension
Total number of mobile app re-installs.
mobile_conversion_re_installs.post_engagementDimension
Total number of mobile app re-install conversions that occurred after a user engaged with an ad.
mobile_conversion_re_installs.post_viewDimension
Total number of mobile app re-install conversions that occurred after a user viewed an ad (impression).
mobile_conversion_re_installs.sale_amountDimension
Total revenue generated from mobile app re-install conversions.
mobile_conversion_re_installs.skanDimension
The count of mobile app re-installs attributed via Apple's SKAdNetwork framework.
mobile_conversion_reservationsMetric
The total number of reservations attributed to mobile conversions.
mobile_conversion_reservations.assistedMetric
The number of reservations where a mobile conversion assisted in the conversion path.
mobile_conversion_reservations.order_quantityMetric
The total quantity of items in orders where reservations were generated as a mobile conversion.
mobile_conversion_reservations.post_engagementMetric
The number of reservations resulting from a mobile conversion after an engagement with an ad.
mobile_conversion_reservations.post_viewMetric
The number of reservations resulting from a mobile conversion after viewing an ad.
mobile_conversion_reservations.sale_amountMetric
The revenue generated from reservations attributed to mobile conversions.
mobile_conversion_searchesMetric
The total number of searches attributed to mobile conversions.
mobile_conversion_searches.assistedDimension
The number of searches where a mobile conversion assisted in the conversion path.
mobile_conversion_searches.order_quantityDimension
The total quantity of items in orders where searches were performed as a mobile conversion.
mobile_conversion_searches.post_engagementDimension
The number of searches resulting from a mobile conversion after an engagement with an ad.
mobile_conversion_searches.post_viewDimension
The number of searches resulting from a mobile conversion after viewing an ad.
mobile_conversion_searches.sale_amountDimension
The revenue generated from searches attributed to mobile conversions.
mobile_conversion_sharesMetric
Breakdown of mobile conversions of type SHARE.
mobile_conversion_shares.assistedDimension
The number of assisted mobile share conversions.
mobile_conversion_shares.order_quantityDimension
The order quantity for mobile share conversions.
mobile_conversion_shares.post_engagementDimension
Mobile share conversions that occurred after an engagement with the ad.
mobile_conversion_shares.post_viewDimension
Mobile share conversions that occurred after viewing the ad.
mobile_conversion_shares.sale_amountDimension
The sale amount for mobile share conversions.
mobile_conversion_sign_upsMetric
The number of new user sign-ups or registrations occurring within a mobile application after ad interaction.
mobile_conversion_sign_ups.assistedDimension
The number of assisted mobile sign-up conversions.
mobile_conversion_sign_ups.order_quantityDimension
The order quantity for mobile sign-up conversions.
mobile_conversion_sign_ups.post_engagementDimension
Mobile sign-up conversions that occurred after an engagement with the ad.
mobile_conversion_sign_ups.post_viewDimension
Mobile sign-up conversions that occurred after viewing the ad.
mobile_conversion_sign_ups.sale_amountDimension
The sale amount for mobile sign-up conversions.
mobile_conversion_site_visitsMetric
The number of website visits initiated by users interacting with mobile advertisements.
mobile_conversion_site_visits.order_quantityDimension
The order quantity for mobile site visit conversions.
mobile_conversion_site_visits.post_engagementDimension
Mobile site visit conversions that occurred after an engagement with the ad.
mobile_conversion_site_visits.post_viewDimension
Mobile site visit conversions that occurred after viewing the ad.
mobile_conversion_site_visits.sale_amountDimension
The sale amount for mobile site visit conversions.
mobile_conversion_spent_creditsMetric
The total count of mobile conversions where users spent in-app credits. This metric can be broken down by various attribution types.
mobile_conversion_spent_credits.assistedDimension
The number of mobile conversions for spent credits that were assisted by an X ad.
mobile_conversion_spent_credits.order_quantityDimension
The total quantity of items or events associated with mobile conversions for spent credits.
mobile_conversion_spent_credits.post_engagementDimension
The number of mobile conversions for spent credits that occurred after a user engaged with an X ad.
mobile_conversion_spent_credits.post_viewDimension
The number of mobile conversions for spent credits that occurred after a user viewed an X ad.
mobile_conversion_spent_credits.sale_amountDimension
The total monetary value generated from mobile conversions for spent credits.
mobile_conversion_tutorials_completedMetric
The total count of mobile conversions where users completed a tutorial within the app. This metric can be broken down by various attribution types.
mobile_conversion_tutorials_completed.assistedDimension
The number of mobile conversions for tutorials completed that were assisted by an X ad.
mobile_conversion_tutorials_completed.order_quantityDimension
The total quantity of items or events associated with mobile conversions for tutorials completed.
mobile_conversion_tutorials_completed.post_engagementDimension
The number of mobile conversions for tutorials completed that occurred after a user engaged with an X ad.
mobile_conversion_tutorials_completed.post_viewDimension
The number of mobile conversions for tutorials completed that occurred after a user viewed an X ad.
mobile_conversion_tutorials_completed.sale_amountDimension
The total monetary value generated from mobile conversions for tutorials completed.
mobile_conversion_updatesMetric
The number of in-app updates or upgrades performed by users after engaging with a mobile ad.
mobile_conversion_updates.assistedDimension
The number of assisted mobile conversions representing application updates.
mobile_conversion_updates.order_quantityDimension
The total quantity of items ordered in mobile conversions related to app updates.
mobile_conversion_updates.post_engagementDimension
The number of mobile conversions representing app updates, attributed to post-engagement actions.
mobile_conversion_updates.post_viewDimension
The number of mobile conversions representing app updates, attributed to post-view actions.
mobile_conversion_updates.sale_amountDimension
The total revenue from mobile conversions related to app updates.
nameDimension
The user-defined name of an entity, such as a campaign, ad group, or ad.
objectiveDimension
The objective of the ad group.
pay_byDimension
The billing event or unit by which the ad group is charged, such as app installs or clicks.
placementDimension
The placement where the ad was served.
placementsDimension
The specific locations or platforms where ads are displayed, such as within X (Twitter) or on the X Audience Platform.
platformDimension
The operating system or device platform (e.g., iOS, Android) where the ad is served, used for targeting and segmentation.
poll_card_voteMetric
The number of votes on a poll card.
primary_web_event_tagDimension
The unique identifier for the main web conversion event tag associated with the ad group, used for tracking and optimization.
product_typeDimension
The type of product being promoted in the ad group, categorizing the offering (e.g., app, website, lead generation).
purchase_order_numberDimension
The unique identification number associated with a purchase order.
qualified_impressionsMetric
Impressions that meet specific criteria, indicating higher relevance or viewability.
reasons_not_servableDimension
A list or code indicating the specific reasons why an ad entity is not currently eligible for delivery, such as policy violations, account issues, or privacy settings.
repliesMetric
The number of people that responded to your Tweet by clicking the reply button.
retweetsMetric
The number of people that Retweeted your ad by clicking the Retweet button.
segmentation_typeDimension
The category of audience segmentation applied to the campaign performance data. This can include demographics such as age and gender, or other criteria like interests, locations, platforms, and devices.
segmentation_valueDimension
The specific value for the chosen segmentation dimension (e.g., '18-24' for AGE, 'Male' for GENDER).
servableDimension
A boolean indicator specifying whether an ad entity is currently eligible to be served.
standard_deliveryDimension
A boolean indicator specifying whether the campaign uses standard budget delivery, which paces spending evenly over the campaign's duration, as opposed to accelerated delivery.
start_timeDimension
The scheduled date and time when the ad group or campaign begins running.
target_cpa_local_microDimension
The desired average cost-per-acquisition (CPA) for the ad group, expressed in local currency micro-units.
timestampDimension
The timestamp for the data being reported.
timezoneDimension
The timezone setting configured for the ad account, used for reporting and scheduling.
total_audience_reachMetric
The total number of unique people who have been reached by the campaign.
total_budget_amount_local_microMetric
The total budget amount for a campaign or line item, expressed in micro-units of the local currency. For example, 1,000,000 micro-units would equal 1 unit of the specified currency.
tweetDimension
The full text of the tweet used in the ad.
tweet_accountDimension
The X (Twitter) account from which the promoted tweet originated.
tweet_created_atDimension
The timestamp when the tweet was created.
tweet_entitiesDimension
Structured data extracted from a tweet, including mentions, hashtags, URLs, and media objects.
tweet_entity_statusDimension
The status of the promoted tweet entity.
tweet_idDimension
The unique numeric ID of the original tweet being used in the promoted tweet ad.
tweet_nameDimension
The name of the promoted tweet. Note that this can be empty for older Tweets or ones created without a name.
tweet_previewDimension
A visual representation or rendered example of how a tweet creative will appear on the X (Twitter) platform before it is published, allowing for pre-publication review.
tweet_preview_urlDimension
A URL to preview the promoted Tweet.
tweet_updated_atDimension
The timestamp indicating when the promoted tweet was last updated.
tweet_user_idDimension
The unique identifier of the user who authored the tweet.
tweets_sendMetric
The total number of tweets sent or published during a specific period. This can include promoted and organic tweets.
typeDimension
The type of entity (e.g., campaign, line item) or media.
unfollowsMetric
The number of users who unfollowed the account after being exposed to the ad. This is often derived from changes in follower count related to ad exposure.
updated_atDimension
The timestamp when the record or entity was last updated.
url_clicksMetric
Total clicks on the link or Website Card in your ad, including earned clicks.
video_15s_viewsMetric
Total number of views where at least 15 seconds of the video or for 95% of the total duration was viewed.
video_3s100pct_viewsMetric
Total number of views where at least 3 seconds were played while 100% in view.
video_6s_viewsMetric
Total number of views where at least 6 seconds of the video was viewed.
video_content_startsMetric
The number of people who started the video, regardless of how much of the video player is in view.
video_content_starts_with_50_ptc_viewMetric
Metric indicating when a video ad's content starts with at least 50% of the video being in view.
video_content_starts_with_50_ptc_view_and_audioMetric
Metric indicating when a video ad's content starts with at least 50% of the video being in view and with audio enabled.
video_content_starts_with_audioMetric
Metric indicating when a video ad's content starts with audio enabled.
video_cta_clicksMetric
Total clicks on the call to action in the video player, including unbilled clicks.
video_total_viewsMetric
Total video views, counted when your video is watched in 50% view for 2 seconds or more, or when a user clicks to expand/unmute. Includes unbilled views.
video_views_100Metric
The number of people who watched 100% of the video, regardless of how much of the video player is in view. These views are not billed.
video_views_100_with_50_ptc_viewMetric
The number of times a video ad was viewed to 100% completion, with at least 50% of the video being in view.
video_views_100_with_50_ptc_view_and_audioMetric
The number of times a video ad was viewed to 100% completion, with at least 50% of the video being in view and with audio enabled.
video_views_100_with_audioMetric
The number of times a video ad was viewed to 100% completion with audio enabled.
video_views_25Metric
The number of people who watched 25% of the video, regardless of how much of the video player is in view. These views are not billed.
video_views_25_with_50_ptc_viewMetric
The number of times a video ad was viewed to 25% completion, with at least 50% of the video being in view.
video_views_25_with_50_ptc_view_and_audioMetric
The number of times a video ad was viewed to 25% completion, with at least 50% of the video being in view and with audio enabled.
video_views_25_with_audioMetric
The number of times a video ad was viewed to 25% completion with audio enabled.
video_views_50Metric
The number of people who watched 50% of the video, regardless of how much of the video player is in view. These views are not billed.
video_views_50_with_50_ptc_viewMetric
The number of times a video ad was viewed to 50% completion, with at least 50% of the video being in view.
video_views_50_with_50_ptc_view_and_audioMetric
The number of times a video ad was viewed to 50% completion, with at least 50% of the video being in view and with audio enabled.
video_views_50_with_audioMetric
The number of times a video ad was viewed to 50% completion with audio enabled.
video_views_75Metric
The number of people who watched 75% of the video, regardless of how much of the video player is in view. These views are not billed.
video_views_75_with_50_ptc_viewMetric
The number of times a video ad was viewed to 75% completion, with at least 50% of the video being in view.
video_views_75_with_50_ptc_view_and_audioMetric
The number of times a video ad was viewed to 75% completion, with at least 50% of the video being in view and with audio enabled.
video_views_75_with_audioMetric
The number of times a video ad was viewed to 75% completion with audio enabled.