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.
Account Dimension
Represents the advertising account under which campaigns and ads are managed.
Account ID Dimension
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.
Platform Dimension
The platform where the ad was displayed or the user engaged with the ad.
account Dimension
The name of the ad account.
account_id Dimension
The unique identifier for the ad account.
account_id_ui Dimension
The unique identifier for the advertising account, as displayed in the user interface.
account_name Dimension
The user-defined name of the ad account.
account_timezone Dimension
The timezone configured for the ad account.
advertiser_domain Dimension
The domain name of the advertiser's website.
advertiser_user_id Dimension
The unique identifier for the advertiser's user account.
android_app_store_identifier Dimension
The identifier for the Android application in its respective app store, used for app-install campaigns.
app_clicks Metric
The total number of clicks on an ad that led to an application.
approval_status Dimension
The approval status of the ad creative or campaign.
audience_expansion Dimension
A setting that enables or disables the expansion of the target audience beyond explicitly defined criteria to potentially reach more relevant users.
auto_created_conversion_landing_page_view conversion_auto_created_conversion_landing_page_view Metric
The number of automatically created landing page view conversions.
auto_created_conversion_session conversion_auto_created_conversion_session Metric
A conversion event automatically detected or created, indicating a user session that led to a conversion.
automatic_tweet_promotion Dimension
Indicates whether automatic promotion is enabled for tweets, allowing the platform to automatically promote tweets based on predefined rules.
average_frequency Dimension
The average number of times a person has seen ads related to a specific campaign.
bid_amount_local_micro Dimension
The bid amount for an ad, expressed in local currency micro units.
bid_strategy Dimension
The chosen bidding strategy for a campaign or line item, such as automatic bidding for lowest cost or manual maximum bid.
billed_charge_local_micro Metric
The amount billed for charges, in local currency micro units.
billed_engagements Metric
The total number of engagements for which you were billed.
budget_optimization Dimension
Indicates if automated campaign budget optimization is enabled, allowing X to distribute the budget across ads and groups to maximize performance.
campaign Dimension
The name of the advertising campaign.
campaign_created_at Dimension
The date when the campaign was created.
campaign_currency Dimension
The currency in which the campaign budget and costs are reported.
campaign_daily_budget_amount_local_micro Metric
The maximum amount you're willing to spend on each campaign on average per day, in local currency micro units.
campaign_deleted Dimension
A boolean flag indicating whether the campaign has been marked as deleted.
campaign_duration_in_days Dimension
The total duration of the campaign in days.
campaign_entity_status Dimension
The status of the campaign entity (e.g., ACTIVE, DRAFT, PAUSED).
campaign_frequency_cap Dimension
The frequency cap setting for the campaign, limiting how many times an ad is shown to a user.
campaign_funding_instrument_id Dimension
The unique identifier of the funding instrument used for the campaign.
campaign_id Dimension
The unique identifier for the advertising campaign.
campaign_id_ui Dimension
The campaign ID converted to base-10 to match the UI value.
campaign_name Dimension
The name of the ad campaign.
campaign_reasons_not_servable Dimension
A list of reasons why the campaign is currently not eligible to serve ads.
campaign_standard_delivery Dimension
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_micro Metric
The maximum amount you're willing to spend on each campaign for its duration, in local currency micro units.
campaign_updated_at Dimension
The date and time when the campaign was last updated.
card_app_cta Dimension
The Call to Action (CTA) text displayed on an app card.
card_content_duration_seconds Dimension
The duration, in seconds, of video content embedded within an ad card.
card_country_code Dimension
The country code associated with the card.
card_created_at Dimension
The timestamp when the card was created.
card_deleted Dimension
A boolean flag indicating whether the card has been marked as deleted.
card_engagements Metric
Total number of engagements with the card.
card_first_cta Dimension
The text for the first Call to Action (CTA) button on the card.
card_first_cta_tweet Dimension
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_id Dimension
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_cta Dimension
The text for the fourth Call to Action (CTA) button on the card.
card_fourth_cta_tweet Dimension
The text of the fourth Call-to-Action (CTA) button displayed on a Twitter Card.
card_fourth_cta_welcome_message_id Dimension
The unique identifier for a welcome message associated with the fourth Call-to-Action (CTA) button on a Twitter Card.
card_googleplay_app_id Dimension
The Google Play Store application ID for an app card.
card_googleplay_deep_link Dimension
The deep link URL for the Google Play Store application, used to direct users to specific content within the app.
card_id Dimension
The unique identifier for the card creative.
card_image_display_height Dimension
The display height of an image within the card, in pixels.
card_image_display_width Dimension
The display width of an image within the card, in pixels.
card_ios_app_store_identifier Dimension
The Apple App Store identifier for an iOS app card.
card_ios_deep_link Dimension
The deep link URL for the iOS application, used to direct users to specific content within the app.
card_ipad_app_id Dimension
The application ID specifically for an iPad app card.
card_ipad_deep_link Dimension
The deep link URL for the iPad application.
card_media_key Dimension
The unique key identifying the primary media asset used in the card.
card_media_url Dimension
The URL of the media associated with the card.
card_name Dimension
The name of the card used in the ad.
card_poll_duration_in_minutes Dimension
The duration of the poll within the card, in minutes.
card_poll_end_time Dimension
The scheduled end date and time for the poll within the card.
card_poll_first_choice Dimension
The text for the first choice option in a poll card.
card_poll_fourth_choice Dimension
The text for the fourth choice option in a poll card.
card_poll_second_choice Dimension
The text for the second choice option in a poll card.
card_poll_start_time Dimension
The scheduled start date and time for the poll within the card.
card_poll_third_choice Dimension
The text for the third choice option in a poll card.
card_poster_media_key Dimension
The unique key identifying the poster image media asset used for a video card.
card_poster_media_url Dimension
The URL of the poster image media asset used for a video card.
card_recipient_user_id Dimension
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_cta Dimension
The text for the second Call to Action (CTA) button on the card.
card_second_cta_tweet Dimension
The text of the second Call-to-Action (CTA) button displayed on a Twitter Card.
card_second_cta_welcome_message_id Dimension
The unique identifier for a welcome message associated with the second Call-to-Action (CTA) button on a Twitter Card.
card_thank_you_text Dimension
The thank you message text displayed after a user completes an action on the card.
card_thank_you_url Dimension
The URL where users are redirected after completing an action on the card, displaying a thank you message.
card_third_cta Dimension
The text for the third Call to Action (CTA) button on the card.
card_third_cta_tweet Dimension
The text of the third Call-to-Action (CTA) button displayed on a Twitter Card.
card_third_cta_welcome_message_id Dimension
The unique identifier for a welcome message associated with the third Call-to-Action (CTA) button on a Twitter Card.
card_title Dimension
The title of the card creative.
card_type Dimension
The type of card used in the ad (e.g., Image Card, Video Card, Website Card).
card_unlocked_image_media_key Dimension
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_key Dimension
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_at Dimension
The timestamp when the card was last updated.
card_uri Dimension
The Uniform Resource Identifier (URI) for the card creative.
card_url Dimension
The URL of the ad card creative itself.
card_video_height Dimension
The height of the video within the card, in pixels.
card_video_hls_url Dimension
The URL for the HLS (HTTP Live Streaming) manifest of the video within the card.
card_video_owner_id Dimension
The unique identifier of the user account that owns the video associated with the card.
card_video_post_url Dimension
The URL of the post (Tweet) containing a video card.
card_video_poster_height Dimension
The height of the video poster image within the card, in pixels.
card_video_poster_url Dimension
The URL of the video poster image within the card.
card_video_poster_width Dimension
The width of the video poster image within the card, in pixels.
card_video_url Dimension
The URL of the video content within the card.
card_video_width Dimension
The width of the video within the card, in pixels.
card_website_dest_url Dimension
The final destination URL when a user clicks on a website card.
card_website_display_url Dimension
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_url Dimension
A shortened version of the website URL used on the card.
card_website_title Dimension
The title of the website linked on the card.
card_website_url Dimension
The primary URL for the website linked on the card.
carousel_swipes Metric
The number of swipes on a carousel ad.
categories Dimension
Content categories associated with an ad, used for targeting or classification.
clicks Metric
Total clicks on links, hashtags, a Website Card, and other Tweet details in your ad, combined with likes and profile clicks.
components Dimension
Elements that make up an ad creative, such as images, videos, or text.
conversion_add_to_carts.assisted Dimension
Number of times a user added an item to their cart where an ad assisted in the conversion path.
conversion_add_to_carts.metric Metric
Total number of times a user added an item to their cart.
conversion_add_to_carts.order_quantity Dimension
Total number of items added to carts as a result of conversion events.
conversion_add_to_carts.order_quantity_engagement Dimension
Total number of items added to carts attributed to ad engagement.
conversion_add_to_carts.order_quantity_view Dimension
Total number of items added to carts attributed to an ad view (impression).
conversion_add_to_carts.post_engagement Dimension
Total number of add to cart conversions that occurred after a user engaged with an ad.
conversion_add_to_carts.post_view Dimension
Total number of add to cart conversions that occurred after a user viewed an ad (impression).
conversion_add_to_carts.sale_amount Dimension
Total revenue generated from items added to carts.
conversion_add_to_carts.sale_amount_engagement Dimension
Total revenue from items added to carts attributed to ad engagement.
conversion_add_to_carts.sale_amount_view Dimension
Total revenue from items added to carts attributed to an ad view (impression).
conversion_add_to_wishlists.assisted Dimension
Number of times a user added an item to their wishlist where an ad assisted in the conversion path.
conversion_add_to_wishlists.metric Metric
Total number of times a user added an item to their wishlist.
conversion_add_to_wishlists.order_quantity Dimension
Total number of items added to wishlists as a result of conversion events.
conversion_add_to_wishlists.order_quantity_engagement Dimension
Total number of items added to wishlists attributed to ad engagement.
conversion_add_to_wishlists.order_quantity_view Dimension
Total number of items added to wishlists attributed to an ad view (impression).
conversion_add_to_wishlists.post_engagement Dimension
Total number of add to wishlist conversions that occurred after a user engaged with an ad.
conversion_add_to_wishlists.post_view Dimension
Total number of add to wishlist conversions that occurred after a user viewed an ad (impression).
conversion_add_to_wishlists.sale_amount Dimension
Total revenue generated from items added to wishlists.
conversion_add_to_wishlists.sale_amount_engagement Dimension
Total revenue from items added to wishlists attributed to ad engagement.
conversion_add_to_wishlists.sale_amount_view Dimension
Total revenue from items added to wishlists attributed to an ad view (impression).
conversion_auto_created_conversion_landing_page_view Metric
The number of landing page views automatically attributed as conversions, indicating user interest after clicking an ad.
conversion_auto_created_conversion_landing_page_view.metric Metric
The metric value for automatically created landing page view conversions.
conversion_auto_created_conversion_landing_page_view.order_quantity Metric
The quantity of automatically tracked landing page view conversion events.
conversion_auto_created_conversion_landing_page_view.order_quantity_engagement Metric
The quantity of auto-created landing page view conversions attributed to ad engagement.
conversion_auto_created_conversion_landing_page_view.order_quantity_view Metric
The quantity of auto-created landing page view conversions attributed to an ad view (impression).
conversion_auto_created_conversion_landing_page_view.post_engagement Metric
The number of post-engagement conversions resulting from an automatically created conversion landing page view.
conversion_auto_created_conversion_landing_page_view.post_view Metric
The number of post-view conversions resulting from an automatically created conversion landing page view.
conversion_auto_created_conversion_landing_page_view.sale_amount Metric
The revenue generated from auto-created landing page view conversions.
conversion_auto_created_conversion_landing_page_view.sale_amount_engagement Metric
The revenue from auto-created landing page view conversions attributed to ad engagement.
conversion_auto_created_conversion_landing_page_view.sale_amount_view Metric
The revenue from auto-created landing page view conversions attributed to an ad view (impression).
conversion_auto_created_conversion_session Metric
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.metric Metric
The total count of automatically tracked session conversion events.
conversion_auto_created_conversion_session.order_quantity Metric
The total number of orders attributed to automatically detected conversion sessions by the X Ads platform.
conversion_auto_created_conversion_session.order_quantity_engagement Metric
The quantity of auto-created session conversions attributed to ad engagement.
conversion_auto_created_conversion_session.order_quantity_view Metric
The quantity of auto-created session conversions attributed to an ad view (impression).
conversion_auto_created_conversion_session.post_engagement Metric
The count of auto-created session conversions that occurred after a user engaged with an ad.
conversion_auto_created_conversion_session.post_view Metric
The count of auto-created session conversions that occurred after a user viewed an ad (impression).
conversion_auto_created_conversion_session.sale_amount Metric
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_engagement Metric
The revenue from auto-created session conversions attributed to ad engagement.
conversion_auto_created_conversion_session.sale_amount_view Metric
The revenue from auto-created session conversions attributed to an ad view (impression).
conversion_checkouts_initiated.assisted Dimension
Number of times a user initiated a checkout where an ad assisted in the conversion path.
conversion_checkouts_initiated.metric Metric
Total number of initiated checkout conversion events.
conversion_checkouts_initiated.order_quantity Dimension
Total number of items in initiated checkouts as a result of conversion events.
conversion_checkouts_initiated.order_quantity_engagement Dimension
Total number of items in initiated checkouts attributed to ad engagement.
conversion_checkouts_initiated.order_quantity_view Dimension
Total number of items in initiated checkouts attributed to an ad view (impression).
conversion_checkouts_initiated.post_engagement Dimension
Total number of initiated checkout conversions that occurred after a user engaged with an ad.
conversion_checkouts_initiated.post_view Dimension
Total number of initiated checkout conversions that occurred after a user viewed an ad (impression).
conversion_checkouts_initiated.sale_amount Dimension
Total revenue value of initiated checkouts.
conversion_checkouts_initiated.sale_amount_engagement Dimension
Total revenue value of initiated checkouts attributed to ad engagement.
conversion_checkouts_initiated.sale_amount_view Dimension
Total revenue value of initiated checkouts attributed to an ad view (impression).
conversion_content_views.assisted Dimension
Number of content view conversions where an ad assisted in the conversion path.
conversion_content_views.metric Metric
Total number of content view conversion events.
conversion_content_views.order_quantity Dimension
The total number of orders attributed to users who viewed specific content on or off the X platform.
conversion_content_views.order_quantity_engagement Dimension
The number of orders attributed to users who engaged with content (e.g., clicked, liked, shared) after viewing it.
conversion_content_views.order_quantity_view Dimension
The number of orders attributed to users based on their view of content, often without additional engagement beyond the impression.
conversion_content_views.post_engagement Dimension
Total number of content view conversions that occurred after a user engaged with an ad.
conversion_content_views.post_view Dimension
Total number of content view conversions that occurred after a user viewed an ad (impression).
conversion_content_views.sale_amount Dimension
Total revenue generated from content view conversions.
conversion_content_views.sale_amount_engagement Dimension
Total revenue from content view conversions attributed to ad engagement.
conversion_content_views.sale_amount_view Dimension
Total revenue from content view conversions attributed to an ad view (impression).
conversion_custom Metric
The total count of custom conversions.
conversion_custom.order_quantity Metric
The order quantity for custom conversions.
conversion_custom.sale_amount Metric
The sale amount for custom conversions.
conversion_downloads Metric
Total number of downloads generated from the ad.
conversion_downloads.assisted Dimension
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.metric Metric
The total count of download conversions attributed to ad interactions.
conversion_downloads.order_quantity Metric
The order quantity for download conversions.
conversion_downloads.order_quantity_engagement Metric
The number of download conversions attributed to user engagement with an ad.
conversion_downloads.order_quantity_view Metric
The number of download conversions attributed to a user viewing an ad.
conversion_downloads.post_engagement Metric
The number of download conversions attributed to engagement with an ad post.
conversion_downloads.post_view Metric
The number of download conversions attributed to a view of an ad post.
conversion_downloads.sale_amount Metric
The sale amount for download conversions.
conversion_downloads.sale_amount_engagement Metric
The total sales revenue generated from download conversions attributed to user engagement with an ad.
conversion_downloads.sale_amount_view Metric
The total sales revenue generated from download conversions attributed to a user viewing an ad.
conversion_landing_page_views.assisted Dimension
Number of landing page view conversions where an ad assisted in the conversion path.
conversion_landing_page_views.metric Metric
Total number of landing page view conversion events.
conversion_landing_page_views.order_quantity Dimension
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_engagement Dimension
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_view Dimension
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_engagement Dimension
Total number of landing page view conversions that occurred after a user engaged with an ad.
conversion_landing_page_views.post_view Dimension
Total number of landing page view conversions that occurred after a user viewed an ad (impression).
conversion_landing_page_views.sale_amount Dimension
Total revenue generated from landing page view conversions.
conversion_landing_page_views.sale_amount_engagement Dimension
Total revenue from landing page view conversions attributed to ad engagement.
conversion_landing_page_views.sale_amount_view Dimension
Total revenue from landing page view conversions attributed to an ad view (impression).
conversion_payment_info_additions.assisted Dimension
Number of times payment information was added where an ad assisted in the conversion path.
conversion_payment_info_additions.metric Metric
Total number of payment information addition conversion events.
conversion_payment_info_additions.order_quantity Dimension
The total number of orders attributed to users who added payment information as a conversion event.
conversion_payment_info_additions.order_quantity_engagement Dimension
The number of orders attributed to users who engaged with the payment information addition process.
conversion_payment_info_additions.order_quantity_view Dimension
The number of orders attributed to users based on their view of the payment information addition page or process.
conversion_payment_info_additions.post_engagement Dimension
Total number of payment info addition conversions that occurred after a user engaged with an ad.
conversion_payment_info_additions.post_view Dimension
Total number of payment info addition conversions that occurred after a user viewed an ad (impression).
conversion_payment_info_additions.sale_amount Dimension
Total revenue generated from payment info addition conversions.
conversion_payment_info_additions.sale_amount_engagement Dimension
Total revenue from payment info addition conversions attributed to ad engagement.
conversion_payment_info_additions.sale_amount_view Dimension
Total revenue from payment info addition conversions attributed to an ad view (impression).
conversion_purchases Metric
Total number of purchases. The sum of post view, post engagement, and assisted purchases for both your website and mobile app.
conversion_purchases.assisted Metric
The number of assisted purchase conversions.
conversion_purchases.metric Metric
The total count of purchase conversions attributed to ad interactions.
conversion_purchases.order_quantity Metric
The order quantity for purchase conversions.
conversion_purchases.order_quantity_engagement Metric
The number of purchase conversions attributed to user engagement with an ad.
conversion_purchases.order_quantity_view Metric
The number of purchase conversions attributed to a user viewing an ad.
conversion_purchases.post_engagement Metric
Purchase conversions that occurred after an engagement with the ad.
conversion_purchases.post_view Metric
Purchase conversions that occurred after viewing the ad.
conversion_purchases.sale_amount Metric
The sale amount for purchase conversions.
conversion_purchases.sale_amount_engagement Metric
The total sales revenue generated from purchase conversions attributed to user engagement with an ad.
conversion_purchases.sale_amount_view Metric
The total sales revenue generated from purchase conversions attributed to a user viewing an ad.
conversion_searches.assisted Dimension
Number of searches where an ad assisted in the conversion path.
conversion_searches.metric Metric
Total number of search conversion events.
conversion_searches.order_quantity Dimension
The total number of orders attributed to users who performed a search on a connected platform as a conversion event.
conversion_searches.order_quantity_engagement Dimension
The number of orders attributed to users who engaged with search results or subsequent actions after performing a search.
conversion_searches.order_quantity_view Dimension
The number of orders attributed to users based on their view of search results, without necessarily performing additional engagement.
conversion_searches.post_engagement Dimension
Total number of search conversions that occurred after a user engaged with an ad.
conversion_searches.post_view Dimension
Total number of search conversions that occurred after a user viewed an ad (impression).
conversion_searches.sale_amount Dimension
Total revenue generated from search conversions.
conversion_searches.sale_amount_engagement Dimension
Total revenue from search conversions attributed to ad engagement.
conversion_searches.sale_amount_view Dimension
Total revenue from search conversions attributed to an ad view (impression).
conversion_sessions.assisted Dimension
Number of sessions where an ad assisted in the conversion path.
conversion_sessions.metric Metric
Total number of session conversion events.
conversion_sessions.order_quantity Dimension
The total number of orders attributed to conversion sessions, which are user sessions leading to a desired action.
conversion_sessions.order_quantity_engagement Dimension
The number of orders attributed to users who engaged during a conversion session, indicating active interaction within the session.
conversion_sessions.order_quantity_view Dimension
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_engagement Dimension
Total number of session conversions that occurred after a user engaged with an ad.
conversion_sessions.post_view Dimension
Total number of session conversions that occurred after a user viewed an ad (impression).
conversion_sessions.sale_amount Dimension
Total revenue generated from session conversions.
conversion_sessions.sale_amount_engagement Dimension
Total revenue from session conversions attributed to ad engagement.
conversion_sessions.sale_amount_view Dimension
Total revenue from session conversions attributed to an ad view (impression).
conversion_sign_ups Metric
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.assisted Metric
The number of assisted sign-up conversions.
conversion_sign_ups.metric Metric
The total count of sign-up conversions attributed to ad interactions.
conversion_sign_ups.order_quantity Metric
The order quantity for sign-up conversions.
conversion_sign_ups.order_quantity_engagement Metric
The number of sign-up conversions attributed to user engagement with an ad.
conversion_sign_ups.order_quantity_view Metric
The number of sign-up conversions attributed to a user viewing an ad.
conversion_sign_ups.post_engagement Dimension
Sign-up conversions that occurred after an engagement with the ad.
conversion_sign_ups.post_view Metric
Sign-up conversions that occurred after viewing the ad.
conversion_sign_ups.sale_amount Metric
The sale amount for sign-up conversions.
conversion_sign_ups.sale_amount_engagement Metric
The total sales revenue generated from sign-up conversions attributed to user engagement with an ad.
conversion_sign_ups.sale_amount_view Metric
The total sales revenue generated from sign-up conversions attributed to a user viewing an ad.
conversion_site_visits Metric
The total count of site visit conversions.
conversion_site_visits.assisted Dimension
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.metric Metric
The total count of website visit conversions attributed to ad interactions.
conversion_site_visits.order_quantity Metric
The order quantity for site visit conversions.
conversion_site_visits.order_quantity_engagement Metric
The number of website visit conversions attributed to user engagement with an ad.
conversion_site_visits.order_quantity_view Metric
The number of website visit conversions attributed to a user viewing an ad.
conversion_site_visits.post_engagement Dimension
Site visit conversions that occurred after an engagement with the ad.
conversion_site_visits.post_view Metric
Site visit conversions that occurred after viewing the ad.
conversion_site_visits.sale_amount Metric
The sale amount for site visit conversions.
conversion_site_visits.sale_amount_engagement Metric
The total sales revenue generated from website visit conversions attributed to user engagement with an ad.
conversion_site_visits.sale_amount_view Metric
The total sales revenue generated from website visit conversions attributed to a user viewing an ad.
conversion_subscriptions.assisted Dimension
Number of subscriptions where an ad assisted in the conversion path.
conversion_subscriptions.metric Metric
Total number of subscription conversion events.
conversion_subscriptions.order_quantity Dimension
The total number of orders attributed to users who completed a subscription as a conversion event.
conversion_subscriptions.order_quantity_engagement Dimension
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_view Dimension
The number of orders attributed to users based on their view of subscription-related content or offers.
conversion_subscriptions.post_engagement Dimension
Total number of subscription conversions that occurred after a user engaged with an ad.
conversion_subscriptions.post_view Dimension
Total number of subscription conversions that occurred after a user viewed an ad (impression).
conversion_subscriptions.sale_amount Dimension
Total revenue generated from subscription conversions.
conversion_subscriptions.sale_amount_engagement Dimension
Total revenue from subscription conversions attributed to ad engagement.
conversion_subscriptions.sale_amount_view Dimension
Total revenue from subscription conversions attributed to an ad view (impression).
costs Metric
The total spend for the ad campaign.
country_id Dimension
The unique identifier for the country where the ad was shown or targeted.
country_name Dimension
The name of the country where the ad was shown or targeted.
created_at Dimension
The timestamp when the record or entity was created.
creative_type Dimension
The type of creative used in the ad, such as image, video, or text.
currency Dimension
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_micro Metric
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.
date Dimension
The date for which the data is reported, in 'YYYY-MM-DD' format.
deleted Dimension
Indicates whether the entity (e.g., campaign, line item) has been deleted.
duration_in_days Dimension
The total duration of the campaign or line item, specified in number of days.
effective_status Dimension
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.
engagements Metric
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_urls Dimension
The fully expanded URLs associated with the ad entity, after any URL shorteners have been resolved.
entities_media_call_to_action_urls Dimension
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_urls Dimension
A list of URLs for the media assets used in the advertisement.
entities_media_video_urls Dimension
URLs for video media assets associated with the ad entity.
entity_status Dimension
The configured status of an entity, such as a campaign or ad group, which determines its current operational state (e.g., ACTIVE, PAUSED, DRAFT).
follows Metric
Total number of followers generated from your Tweet, including earned follows from other locations like 'Who to follow'.
frequency_cap Dimension
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_description Dimension
A description of the funding instrument used for billing.
funding_instrument_id Dimension
A reference to the funding instrument ID.
funding_instrument_type Dimension
The type of funding instrument (e.g., credit card, insertion order).
goal Dimension
The objective of the advertising campaign, such as awareness, consideration, or conversion.
impressions Metric
The number of times your ad is shown to users, including earned impressions.
ios_app_store_identifier Dimension
The identifier for the iOS application in its respective app store, used for app-install campaigns.
likes Metric
The number of people who liked your ad by clicking the heart button.
line_item_advertiser_domain Dimension
The advertiser's domain associated with the line item.
line_item_advertiser_user_id Metric
The unique identifier of the advertiser's user account associated with the line item.
line_item_automatic_tweet_promotion Dimension
A boolean flag indicating if the line item is set for automatic tweet promotion.
line_item_automatically_select_bid Dimension
A boolean flag indicating if the bid amount for the line item is automatically selected by the system.
line_item_bid_amount_local_micro Dimension
The bid amount for the line item, expressed in local currency micro-units.
line_item_bid_strategy Dimension
The bidding strategy used for the line item, such as lowest cost or target cost.
line_item_bid_type Dimension
The type of bid used for the line item, such as auto-bid or manual bid.
line_item_bid_unit Dimension
The unit for which the bid is placed (e.g., per impression, per click).
line_item_campaign_id Dimension
The unique identifier of the campaign to which the line item belongs.
line_item_categories Dimension
The categories associated with the ad group.
line_item_charge_by Dimension
The billing event for which the line item is charged (e.g., impression, engagement).
line_item_created_at Dimension
The timestamp when the line item was created.
line_item_creative_source Dimension
The source of the creative assets used within the line item.
line_item_currency Dimension
The currency used for all spend-related metrics and billing for the ad group.
line_item_deleted Dimension
Indicates if the line item has been deleted.
line_item_end_time Dimension
The date when the ad group stopped serving.
line_item_entity_status Dimension
The status of the ad group (formerly called line item status), with possible values ACTIVE, DRAFT, or PAUSED.
line_item_goal Dimension
The optimization setting used for this ad group.
line_item_id Dimension
The unique ID for the ad group (formerly called line item id).
line_item_id_ui Dimension
The ad group ID converted to base-10 to match the UI value.
line_item_name Dimension
The name of the ad group (formerly called line item).
line_item_optimization Dimension
The optimization goal or strategy applied to the line item (ad group) for ad delivery.
line_item_pay_by Dimension
The billing event for the line item (e.g., impressions, engagements).
line_item_placements Dimension
The placements where the ad group is configured to run.
line_item_primary_web_event_tag Dimension
The primary web event tag associated with the line item, used for tracking specific user actions on a website.
line_item_product_type Dimension
The type of product or ad format associated with the line item.
line_item_start_time Dimension
The date when the ad group began serving.
line_item_target_cpa_local_micro Dimension
The target Cost Per Acquisition (CPA) for the line item, in micro-currency units of the local currency.
line_item_total_budget_amount_local_micro Dimension
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_tags Dimension
Custom tags used for tracking and categorizing the line item's performance.
line_item_updated_at Dimension
The timestamp when the line item was last updated.
link_clicks Metric
The total number of clicks on links within an ad or promoted content, leading users to a specified destination.
media_account_media_id Dimension
The unique identifier for the media creative within the account.
media_approval_status Dimension
The approval status of the media creative, indicating whether it has been approved to run.
media_aspect_ratio Dimension
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_category Dimension
The categorization of the media content used in the advertisement (e.g., image, video).
media_created_at Dimension
The timestamp when the media creative was initially created.
media_deleted Dimension
A boolean flag indicating whether the media creative has been marked as deleted.
media_description Dimension
The media_description provides descriptive text for media content, primarily used for accessibility purposes as alternative text for images, GIFs, or videos.
media_duration Metric
The duration of the media in seconds.
media_engagements Metric
Total number of clicks on media across videos, Vines, GIFs, and images.
media_entity_status Dimension
The current operational status of the media asset (e.g., active, processing, rejected).
media_file_name Dimension
The file name of the media object.
media_id Dimension
The unique ID of the media object.
media_key Dimension
A unique identifier for a media asset, such as an image or video, used in an ad.
media_landing_url Dimension
The landing URL associated with the media creative.
media_name Dimension
The name of the media object.
media_poster_media_key Metric
The media key of the poster image for video media.
media_poster_media_url Dimension
The URL of the poster image for video media.
media_status Dimension
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_title Dimension
The title of the media asset.
media_type Dimension
The type of media used (e.g., image, video).
media_updated_at Dimension
The timestamp when the media creative was last updated.
media_url Dimension
The URL to the media object.
media_views Metric
Total views (autoplay and click) of your media across videos, Vines, GIFs, and images. This includes views you are not billed for.
mobile_conversion_add_to_carts Metric
Breakdown of mobile conversions of type ADD_TO_CART.
mobile_conversion_add_to_carts.assisted Dimension
The number of assisted mobile add-to-cart conversions.
mobile_conversion_add_to_carts.order_quantity Dimension
The order quantity for mobile add-to-cart conversions.
mobile_conversion_add_to_carts.post_engagement Metric
Mobile add-to-cart conversions that occurred after an engagement with the ad.
mobile_conversion_add_to_carts.post_view Metric
Mobile add-to-cart conversions that occurred after viewing the ad.
mobile_conversion_add_to_carts.sale_amount Dimension
The sale amount for mobile add-to-cart conversions.
mobile_conversion_add_to_wishlists Metric
The total number of mobile app conversion events where a user adds an item to their wishlist.
mobile_conversion_add_to_wishlists.assisted Metric
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_quantity Metric
The total quantity of items added to wishlists as part of mobile app conversion events.
mobile_conversion_add_to_wishlists.post_engagement Metric
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_view Metric
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_amount Metric
The total revenue or monetary value generated from mobile app conversion events where users add items to their wishlists.
mobile_conversion_checkouts_initiated Metric
The total number of initiated checkouts attributed to mobile conversions.
mobile_conversion_checkouts_initiated.assisted Metric
The number of initiated checkouts where a mobile conversion assisted in the conversion path.
mobile_conversion_checkouts_initiated.order_quantity Metric
The total quantity of items in orders where checkouts were initiated as a mobile conversion.
mobile_conversion_checkouts_initiated.post_engagement Metric
The number of initiated checkouts resulting from a mobile conversion after an engagement with an ad.
mobile_conversion_checkouts_initiated.post_view Metric
The number of initiated checkouts resulting from a mobile conversion after viewing an ad.
mobile_conversion_checkouts_initiated.sale_amount Metric
The revenue generated from initiated checkouts attributed to mobile conversions.
mobile_conversion_content_views Metric
The number of times content was viewed within a mobile application after ad interaction.
mobile_conversion_content_views.assisted Dimension
The number of assisted mobile conversions where content was viewed.
mobile_conversion_content_views.order_quantity Dimension
The total quantity of items ordered in mobile conversions where content was viewed.
mobile_conversion_content_views.post_engagement Dimension
The number of mobile conversions where content was viewed, attributed to post-engagement actions.
mobile_conversion_content_views.post_view Dimension
The number of mobile conversions where content was viewed, attributed to post-view actions.
mobile_conversion_content_views.sale_amount Dimension
The total revenue from mobile conversions where content was viewed.
mobile_conversion_downloads Dimension
The number of mobile application downloads attributed as conversions.
mobile_conversion_downloads.assisted Dimension
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_quantity Metric
The order quantity for mobile download conversions.
mobile_conversion_downloads.post_engagement Metric
Mobile download conversions that occurred after an engagement with the ad.
mobile_conversion_downloads.post_view Metric
Mobile download conversions that occurred after viewing the ad.
mobile_conversion_downloads.sale_amount Metric
The sale amount for mobile download conversions.
mobile_conversion_installs Metric
Breakdown of mobile conversions of type INSTALL.
mobile_conversion_installs.assisted Metric
The number of assisted mobile install conversions.
mobile_conversion_installs.order_quantity Metric
The order quantity for mobile install conversions.
mobile_conversion_installs.post_engagement Metric
Mobile install conversions that occurred after an engagement with the ad.
mobile_conversion_installs.post_view Metric
Mobile install conversions that occurred after viewing the ad.
mobile_conversion_installs.sale_amount Metric
The sale amount for mobile install conversions.
mobile_conversion_installs.skan Dimension
Mobile app install conversions attributed via Apple's SKAdNetwork framework, providing privacy-preserving install metrics.
mobile_conversion_invites Metric
The total number of invites attributed to mobile conversions.
mobile_conversion_invites.assisted Dimension
The number of invites where a mobile conversion assisted in the conversion path.
mobile_conversion_invites.order_quantity Dimension
The total quantity of items in orders where invites were generated as a mobile conversion.
mobile_conversion_invites.post_engagement Dimension
The number of invites resulting from a mobile conversion after an engagement with an ad.
mobile_conversion_invites.post_view Dimension
The number of invites resulting from a mobile conversion after viewing an ad.
mobile_conversion_invites.sale_amount Dimension
The revenue generated from invites attributed to mobile conversions.
mobile_conversion_key_page_views Metric
The total number of key page view conversions on mobile devices.
mobile_conversion_key_page_views.post_engagement Dimension
The number of mobile key page view conversions attributed to engagement with an ad post.
mobile_conversion_key_page_views.post_view Dimension
The number of mobile key page view conversions attributed to a view of an ad post.
mobile_conversion_lifetime_value_add_to_carts Metric
The total lifetime value generated from add-to-cart conversions on mobile.
mobile_conversion_lifetime_value_add_to_carts.metric Metric
Total number of mobile add-to-cart events contributing to lifetime value.
mobile_conversion_lifetime_value_add_to_carts.order_quantity Dimension
The total quantity of items added to carts in mobile apps that contribute to lifetime value.
mobile_conversion_lifetime_value_add_to_carts.sale_amount Dimension
The total revenue generated from mobile add-to-cart events that contribute to lifetime value.
mobile_conversion_lifetime_value_content_views.metric Metric
The total count of content view conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_content_views.order_quantity Dimension
The quantity of content view conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_content_views.sale_amount Dimension
The sales amount from content view conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_logins.metric Metric
The total count of login conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_logins.order_quantity Dimension
The quantity of login conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_logins.sale_amount Dimension
The sales amount from login conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_purchases Metric
The total lifetime value generated from purchase conversions on mobile.
mobile_conversion_lifetime_value_purchases.metric Metric
The total count of purchase conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_purchases.order_quantity Dimension
The quantity of purchase conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_purchases.sale_amount Dimension
The sales amount from purchase conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_rates Metric
The total lifetime value generated from rating or review conversions on mobile.
mobile_conversion_lifetime_value_rates.metric Metric
The total count of rating or review conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_rates.order_quantity Dimension
The quantity of rating or review conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_rates.sale_amount Dimension
The sales amount from rating or review conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_searches.metric Metric
The total count of search conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_searches.order_quantity Dimension
The quantity of search conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_searches.sale_amount Dimension
The sales amount from search conversions on mobile, contributing to lifetime value.
mobile_conversion_lifetime_value_shares Metric
The total value of shares attributed to mobile conversions over the lifetime of a user.
mobile_conversion_lifetime_value_shares.metric Dimension
The primary metric associated with lifetime value shares from mobile conversions.
mobile_conversion_lifetime_value_shares.order_quantity Dimension
The total quantity of items in orders associated with lifetime value shares from mobile conversions.
mobile_conversion_lifetime_value_shares.sale_amount Dimension
The revenue generated from lifetime value shares attributed to mobile conversions.
mobile_conversion_lifetime_value_sign_ups Metric
The total value of sign-ups attributed to mobile conversions over the lifetime of a user.
mobile_conversion_lifetime_value_sign_ups.metric Dimension
The primary metric associated with lifetime value sign-ups from mobile conversions.
mobile_conversion_lifetime_value_sign_ups.order_quantity Dimension
The total quantity of items in orders associated with lifetime value sign-ups from mobile conversions.
mobile_conversion_lifetime_value_sign_ups.sale_amount Dimension
The revenue generated from lifetime value sign-ups attributed to mobile conversions.
mobile_conversion_logins Metric
Breakdown of mobile conversions of type LOGIN.
mobile_conversion_logins.assisted Dimension
The number of assisted mobile login conversions.
mobile_conversion_logins.order_quantity Dimension
The order quantity for mobile login conversions.
mobile_conversion_logins.post_engagement Dimension
Mobile login conversions that occurred after an engagement with the ad.
mobile_conversion_logins.post_view Dimension
Mobile login conversions that occurred after viewing the ad.
mobile_conversion_logins.sale_amount Dimension
The sale amount for mobile login conversions.
mobile_conversion_purchases Metric
The number of app purchases attributed to the ads.
mobile_conversion_purchases.assisted Dimension
The number of assisted mobile purchase conversions.
mobile_conversion_purchases.order_quantity Dimension
The order quantity for mobile purchase conversions.
mobile_conversion_purchases.post_engagement Metric
Mobile purchase conversions that occurred after an engagement with the ad.
mobile_conversion_purchases.post_view Dimension
Mobile purchase conversions that occurred after viewing the ad.
mobile_conversion_purchases.sale_amount Metric
The sale amount for mobile purchase conversions.
mobile_conversion_purchases.skan Dimension
Mobile purchase conversions attributed via Apple's SKAdNetwork framework, providing privacy-preserving purchase metrics.
mobile_conversion_rates Metric
The rate at which mobile conversion events occur, calculated as conversions divided by impressions or clicks.
mobile_conversion_rates.assisted Dimension
The assisted conversion rate for mobile conversions.
mobile_conversion_rates.order_quantity Dimension
The conversion rate based on order quantity for mobile conversions.
mobile_conversion_rates.post_engagement Dimension
The mobile conversion rate attributed to post-engagement actions.
mobile_conversion_rates.post_view Dimension
The mobile conversion rate attributed to post-view actions.
mobile_conversion_rates.sale_amount Dimension
The mobile conversion rate based on sale amount.
mobile_conversion_re_engages Metric
The total number of re-engagements attributed to mobile conversions.
mobile_conversion_re_engages.assisted Metric
The number of re-engagements where a mobile conversion assisted in the conversion path.
mobile_conversion_re_engages.order_quantity Metric
The total quantity of items in orders where re-engagements were generated as a mobile conversion.
mobile_conversion_re_engages.post_engagement Metric
The number of re-engagements resulting from a mobile conversion after an engagement with an ad.
mobile_conversion_re_engages.post_view Metric
The number of re-engagements resulting from a mobile conversion after viewing an ad.
mobile_conversion_re_engages.sale_amount Metric
The revenue generated from re-engagements attributed to mobile conversions.
mobile_conversion_re_installs.assisted Dimension
Number of mobile app re-installs where an ad assisted in the conversion path.
mobile_conversion_re_installs.order_quantity Dimension
Total number of mobile app re-installs.
mobile_conversion_re_installs.post_engagement Dimension
Total number of mobile app re-install conversions that occurred after a user engaged with an ad.
mobile_conversion_re_installs.post_view Dimension
Total number of mobile app re-install conversions that occurred after a user viewed an ad (impression).
mobile_conversion_re_installs.sale_amount Dimension
Total revenue generated from mobile app re-install conversions.
mobile_conversion_re_installs.skan Dimension
The count of mobile app re-installs attributed via Apple's SKAdNetwork framework.
mobile_conversion_reservations Metric
The total number of reservations attributed to mobile conversions.
mobile_conversion_reservations.assisted Metric
The number of reservations where a mobile conversion assisted in the conversion path.
mobile_conversion_reservations.order_quantity Metric
The total quantity of items in orders where reservations were generated as a mobile conversion.
mobile_conversion_reservations.post_engagement Metric
The number of reservations resulting from a mobile conversion after an engagement with an ad.
mobile_conversion_reservations.post_view Metric
The number of reservations resulting from a mobile conversion after viewing an ad.
mobile_conversion_reservations.sale_amount Metric
The revenue generated from reservations attributed to mobile conversions.
mobile_conversion_searches Metric
The total number of searches attributed to mobile conversions.
mobile_conversion_searches.assisted Dimension
The number of searches where a mobile conversion assisted in the conversion path.
mobile_conversion_searches.order_quantity Dimension
The total quantity of items in orders where searches were performed as a mobile conversion.
mobile_conversion_searches.post_engagement Dimension
The number of searches resulting from a mobile conversion after an engagement with an ad.
mobile_conversion_searches.post_view Dimension
The number of searches resulting from a mobile conversion after viewing an ad.
mobile_conversion_searches.sale_amount Dimension
The revenue generated from searches attributed to mobile conversions.
mobile_conversion_shares Metric
Breakdown of mobile conversions of type SHARE.
mobile_conversion_shares.assisted Dimension
The number of assisted mobile share conversions.
mobile_conversion_shares.order_quantity Dimension
The order quantity for mobile share conversions.
mobile_conversion_shares.post_engagement Dimension
Mobile share conversions that occurred after an engagement with the ad.
mobile_conversion_shares.post_view Dimension
Mobile share conversions that occurred after viewing the ad.
mobile_conversion_shares.sale_amount Dimension
The sale amount for mobile share conversions.
mobile_conversion_sign_ups Metric
The number of new user sign-ups or registrations occurring within a mobile application after ad interaction.
mobile_conversion_sign_ups.assisted Dimension
The number of assisted mobile sign-up conversions.
mobile_conversion_sign_ups.order_quantity Dimension
The order quantity for mobile sign-up conversions.
mobile_conversion_sign_ups.post_engagement Dimension
Mobile sign-up conversions that occurred after an engagement with the ad.
mobile_conversion_sign_ups.post_view Dimension
Mobile sign-up conversions that occurred after viewing the ad.
mobile_conversion_sign_ups.sale_amount Dimension
The sale amount for mobile sign-up conversions.
mobile_conversion_site_visits Metric
The number of website visits initiated by users interacting with mobile advertisements.
mobile_conversion_site_visits.order_quantity Dimension
The order quantity for mobile site visit conversions.
mobile_conversion_site_visits.post_engagement Dimension
Mobile site visit conversions that occurred after an engagement with the ad.
mobile_conversion_site_visits.post_view Dimension
Mobile site visit conversions that occurred after viewing the ad.
mobile_conversion_site_visits.sale_amount Dimension
The sale amount for mobile site visit conversions.
mobile_conversion_updates Metric
The number of in-app updates or upgrades performed by users after engaging with a mobile ad.
mobile_conversion_updates.assisted Dimension
The number of assisted mobile conversions representing application updates.
mobile_conversion_updates.order_quantity Dimension
The total quantity of items ordered in mobile conversions related to app updates.
mobile_conversion_updates.post_engagement Dimension
The number of mobile conversions representing app updates, attributed to post-engagement actions.
mobile_conversion_updates.post_view Dimension
The number of mobile conversions representing app updates, attributed to post-view actions.
mobile_conversion_updates.sale_amount Dimension
The total revenue from mobile conversions related to app updates.
name Dimension
The user-defined name of an entity, such as a campaign, ad group, or ad.
objective Dimension
The objective of the ad group.
pay_by Dimension
The billing model or method by which the advertiser is charged for ad delivery.
placement Dimension
The placement where the ad was served.
placements Dimension
The specific locations on X (Twitter) where an ad can be displayed.
poll_card_vote Metric
The number of votes on a poll card.
primary_web_event_tag Dimension
The main event tag used for tracking web conversions, often referred to as the X (Twitter) Pixel.
product_type Dimension
The category or type of product being promoted in an ad.
purchase_order_number Dimension
The unique identification number associated with a purchase order.
qualified_impressions Metric
Impressions that meet specific criteria, indicating higher relevance or viewability.
reasons_not_servable Dimension
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.
replies Metric
The number of people that responded to your Tweet by clicking the reply button.
retweets Metric
The number of people that Retweeted your ad by clicking the Retweet button.
segmentation_type Dimension
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_value Dimension
The specific value for the chosen segmentation dimension (e.g., '18-24' for AGE, 'Male' for GENDER).
servable Dimension
A boolean indicator specifying whether an ad entity is currently eligible to be served.
standard_delivery Dimension
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_time Dimension
The date and time when a campaign or other ad entity is scheduled to begin.
target_cpa_local_micro Dimension
The target Cost Per Acquisition (CPA) for a campaign, expressed in local currency micro units.
timestamp Dimension
The timestamp for the data being reported.
total_audience_reach Metric
The total number of unique people who have been reached by the campaign.
total_budget_amount_local_micro Metric
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.
tweet Dimension
The full text of the tweet used in the ad.
tweet_account Dimension
The X (Twitter) account from which the promoted tweet originated.
tweet_created_at Dimension
The timestamp when the tweet was created.
tweet_entities Dimension
Structured data extracted from a tweet, including mentions, hashtags, URLs, and media objects.
tweet_entity_status Dimension
The status of the promoted tweet entity.
tweet_id Dimension
The unique numeric ID of the original tweet being used in the promoted tweet ad.
tweet_name Dimension
The name of the promoted tweet. Note that this can be empty for older Tweets or ones created without a name.
tweet_preview Dimension
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_url Dimension
A URL to preview the promoted Tweet.
tweet_updated_at Dimension
The timestamp indicating when the promoted tweet was last updated.
tweet_user_id Dimension
The unique identifier of the user who authored the tweet.
tweets_send Metric
The total number of tweets sent or published during a specific period. This can include promoted and organic tweets.
type Dimension
The type of entity (e.g., campaign, line item) or media.
unfollows Metric
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_at Dimension
The timestamp when the record or entity was last updated.
url_clicks Metric
Total clicks on the link or Website Card in your ad, including earned clicks.
video_15s_views Metric
Total number of views where at least 15 seconds of the video or for 95% of the total duration was viewed.
video_3s100pct_views Metric
Total number of views where at least 3 seconds were played while 100% in view.
video_6s_views Metric
Total number of views where at least 6 seconds of the video was viewed.
video_content_starts Metric
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_view Metric
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_audio Metric
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_audio Metric
Metric indicating when a video ad's content starts with audio enabled.
video_cta_clicks Metric
Total clicks on the call to action in the video player, including unbilled clicks.
video_total_views Metric
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_100 Metric
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_view Metric
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_audio Metric
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_audio Metric
The number of times a video ad was viewed to 100% completion with audio enabled.
video_views_25 Metric
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_view Metric
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_audio Metric
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_audio Metric
The number of times a video ad was viewed to 25% completion with audio enabled.
video_views_50 Metric
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_view Metric
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_audio Metric
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_audio Metric
The number of times a video ad was viewed to 50% completion with audio enabled.
video_views_75 Metric
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_view Metric
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_audio Metric
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_audio Metric
The number of times a video ad was viewed to 75% completion with audio enabled.