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.

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