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 |
The name of the advertising account. |
metric |
AGE |
Age |
The age demographic of the audience targeted or reached by the ad. |
dimension |
Account ID |
Account ID |
The unique identifier for the advertising account. |
dimension |
Campaign |
Campaign |
The name of the advertising campaign. |
dimension |
Campaign Name |
Campaign Name |
The name of the advertising campaign. |
dimension |
CampaignName |
CampaignName |
The name of the advertising campaign. |
dimension |
Clicks |
Clicks |
The total number of clicks on the ad. |
metric |
Country |
Country |
The country where the ad was displayed or targeted. |
dimension |
Country Code |
Country Code |
The two-letter ISO country code for the audience location. |
dimension |
Created at |
created_at |
The date and time when the entity was created. |
dimension |
Data Source |
Data Source |
This field indicates the origin of the collected data, which for this platform is the X Ads (Twitter) API. |
dimension |
DayofWeek |
DayofWeek |
The day of the week (e.g., Monday, Tuesday) for the reported data. |
dimension |
Duration |
Duration |
The total duration of the advertising campaign or line item. |
dimension |
End Date |
End Date |
The conclusion date for the reporting period or campaign duration. |
dimension |
Format |
Format |
The format of the ad creative used in the campaign, such as various promoted formats available on the X Ads platform. |
dimension |
GENDER |
Gender |
The gender demographic of the audience targeted or reached by the ad. |
dimension |
Location |
Location |
Geographical location (regional or metro) where the ad campaign was targeted or where ad impressions/engagements occurred. This is a segmentation type for data breakdown. |
dimension |
Objective |
Objective |
The marketing objective set for the campaign or ad group. |
dimension |
Placements |
Placements |
The locations where the ad was displayed (e.g., Twitter feed, audience network). |
dimension |
Platform |
Platform |
The platform or device on which the ad was delivered (e.g., iOS, Android, web). |
dimension |
Post ID |
Post ID |
The unique identifier for the original tweet used in a promoted ad campaign. |
metric |
Post Type |
Post Type |
The type of post being advertised or analyzed, such as a Promoted Tweet, Organic Tweet, or Media Creative, relevant at the TWEET entity level. |
dimension |
Region |
Region |
The geographical region targeted by the ad. |
dimension |
Start Date |
Start Date |
The commencement date for the reporting period or campaign duration. |
dimension |
Targeting |
Targeting |
Details about the audience targeting criteria used for the ad campaign, such as demographics, interests, or behaviors. |
dimension |
Type |
Type |
Indicates the type of advertising entity the data represents, such as an account, funding instrument, campaign, line item, or tweet. |
dimension |
Updated at |
updated_at |
The timestamp indicating when the record or entity was last updated. |
dimension |
WeekNum |
WeekNum |
The week number of the year for which the data is reported, used for time-based aggregation or segmentation. This is a time dimension similar to ‘date’. |
metric |
Year |
Year |
The calendar year associated with the campaign data. |
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_media_id |
account_media_id |
The media ID associated with the account. |
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 |
ad_end_date |
ad_end_date |
The date when the advertisement or campaign is scheduled to end. |
dimension |
ad_group_id |
ad_group_id |
The unique identifier for the ad group. |
dimension |
ad_id |
ad_id |
The unique identifier for the ad. |
dimension |
ad_name |
ad_name |
The name of the individual advertisement or ad creative. |
dimension |
ad_post_permalink |
ad_post_permalink |
The permanent URL (permalink) to the X (formerly Twitter) post used in the ad. |
dimension |
ad_preview |
ad_preview |
A representation or view of an advertisement, often used to visualize how it will appear to users before publication. This can include previews of promoted tweets. |
dimension |
ad_start_date |
ad_start_date |
The date when the advertisement or campaign is scheduled to begin. |
dimension |
adgroup_id |
adgroup_id |
The unique identifier for the ad group. |
dimension |
adgroup_name |
adgroup_name |
The name of the ad group. |
dimension |
advertiser_domain |
advertiser_domain |
The domain of the advertiser associated with the campaign. |
dimension |
advertiser_user_id |
advertiser_user_id |
The unique identifier for the advertiser’s user account. |
dimension |
android_app_store_identifier |
android_app_store_identifier |
The identifier for the Android app in its respective app store. |
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 |
audience_expansion |
audience_expansion |
Indicates whether audience expansion is enabled for the campaign to reach a broader but relevant audience. |
dimension |
auto_created_conversion_add_to_cart |
auto_created_conversion_add_to_cart |
The number of automatically created add-to-cart conversions. |
dimension |
auto_created_conversion_add_to_wish_list |
auto_created_conversion_add_to_wish_list |
The number of automatically created add-to-wishlist conversions. |
dimension |
auto_created_conversion_added_payment_info |
auto_created_conversion_added_payment_info |
The number of automatically created payment info addition conversions. |
dimension |
auto_created_conversion_checkout_initiated |
auto_created_conversion_checkout_initiated |
The number of automatically created checkout initiated conversions. |
dimension |
auto_created_conversion_complete_registration |
auto_created_conversion_complete_registration |
The number of automatically created complete registration conversions. |
dimension |
auto_created_conversion_content_view |
auto_created_conversion_content_view |
The number of automatically created content view conversions. |
dimension |
auto_created_conversion_download |
auto_created_conversion_download |
The number of automatically created download conversions. |
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_page_view |
auto_created_conversion_page_view |
The number of automatically created page view conversions. |
dimension |
auto_created_conversion_purchase |
auto_created_conversion_purchase |
The number of automatically created purchase conversions. |
dimension |
auto_created_conversion_search |
auto_created_conversion_search |
The number of automatically created search conversions. |
dimension |
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 |
auto_created_conversion_sign_up_initiated |
auto_created_conversion_sign_up_initiated |
The number of automatically created sign-up initiated conversions. |
dimension |
automatic_tweet_promotion |
automatic_tweet_promotion |
Indicates if automatic tweet promotion is active for the account or campaign. |
dimension |
average_frequency |
average_frequency |
The average number of times a person has seen ads related to a specific campaign. |
dimension |
bid_amount_local_micro |
bid_amount_local_micro |
The bid amount for the ad, in micro-currency units of the local currency. |
dimension |
bid_strategy |
bid_strategy |
The bidding strategy employed for the campaign or line item (e.g., automated, maximum bid). |
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. |
dimension |
budget_optimization |
budget_optimization |
Indicates if budget optimization is enabled, allowing the system to distribute budget effectively across ad groups. |
dimension |
business_id |
business_id |
The unique identifier for the business associated with the ad account. |
dimension |
business_name |
business_name |
The name of the business associated with the ad account. |
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_end_date |
campaign_end_date |
The date when the campaign ends. |
dimension |
campaign_end_time |
campaign_end_time |
The scheduled end date and time for the campaign. |
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_start_date |
campaign_start_date |
The date your campaign is scheduled to launch. |
dimension |
campaign_start_time |
campaign_start_time |
The date your campaign is scheduled to launch. This field is deprecated by Twitter, please use Ad group start date instead. |
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. |
dimension |
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_iphone_app_id |
card_iphone_app_id |
The application ID specifically for an iPhone app card. |
dimension |
card_iphone_deep_link |
card_iphone_deep_link |
The deep link URL for the iPhone 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. |
dimension |
categories |
categories |
Classifications used to group campaigns, ad creatives, or target audiences based on shared characteristics, interests, or themes. This can be used for reporting or targeting purposes. |
dimension |
clicks |
clicks |
Total clicks on links, hashtags, a Website Card, and other Tweet details in your ad, combined with likes and profile clicks. |
metric |
clicks_cost |
clicks_cost |
The total cost incurred for all clicks on the ad. |
metric |
components |
components |
The creative elements or structural parts that make up an ad, such as images, videos (media creative), or interactive cards associated with a promoted tweet. |
dimension |
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 items ordered resulting from an automatically created conversion landing page view. |
metric |
conversion_auto_created_conversion_landing_page_view.order_quantity_engagement |
conversion_auto_created_conversion_landing_page_view.order_quantity_engagement |
The quantity of items ordered resulting from an automatically created conversion landing page view attributed to 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 items ordered resulting from an automatically created conversion landing page view attributed to a view. |
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 total sale amount resulting from an automatically created conversion landing page view. |
metric |
conversion_auto_created_conversion_landing_page_view.sale_amount_engagement |
conversion_auto_created_conversion_landing_page_view.sale_amount_engagement |
The total sale amount resulting from an automatically created conversion landing page view attributed to engagement. |
metric |
conversion_auto_created_conversion_landing_page_view.sale_amount_view |
conversion_auto_created_conversion_landing_page_view.sale_amount_view |
The total sale amount resulting from an automatically created conversion landing page view attributed to a view. |
metric |
conversion_auto_created_conversion_session.metric |
conversion_auto_created_conversion_session.metric |
A metric representing conversion sessions that were automatically created by the platform. |
metric |
conversion_auto_created_conversion_session.order_quantity |
conversion_auto_created_conversion_session.order_quantity |
The quantity of items ordered resulting from an automatically created conversion session. |
metric |
conversion_auto_created_conversion_session.order_quantity_engagement |
conversion_auto_created_conversion_session.order_quantity_engagement |
The quantity of items ordered resulting from an automatically created conversion session attributed to engagement. |
metric |
conversion_auto_created_conversion_session.order_quantity_view |
conversion_auto_created_conversion_session.order_quantity_view |
The quantity of items ordered resulting from an automatically created conversion session attributed to a view. |
metric |
conversion_auto_created_conversion_session.post_engagement |
conversion_auto_created_conversion_session.post_engagement |
The number of post-engagement conversions resulting from an automatically created conversion session. |
metric |
conversion_auto_created_conversion_session.post_view |
conversion_auto_created_conversion_session.post_view |
The number of post-view conversions resulting from an automatically created conversion session. |
metric |
conversion_auto_created_conversion_session.sale_amount |
conversion_auto_created_conversion_session.sale_amount |
The total sale amount resulting from an automatically created conversion session. |
metric |
conversion_auto_created_conversion_session.sale_amount_engagement |
conversion_auto_created_conversion_session.sale_amount_engagement |
The total sale amount resulting from an automatically created conversion session attributed to engagement. |
metric |
conversion_auto_created_conversion_session.sale_amount_view |
conversion_auto_created_conversion_session.sale_amount_view |
The total sale amount resulting from an automatically created conversion session attributed to a view. |
metric |
conversion_custom |
conversion_custom |
The total count of custom conversions. |
metric |
conversion_custom.order_quantity |
conversion_custom.order_quantity |
The order quantity for custom conversions. |
dimension |
conversion_custom.sale_amount |
conversion_custom.sale_amount |
The sale amount for custom conversions. |
dimension |
conversion_downloads |
conversion_downloads |
Total number of downloads generated from the ad. |
metric |
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. |
dimension |
conversion_downloads.order_quantity_engagement |
conversion_downloads.order_quantity_engagement |
The number of download conversions attributed to user engagement with an ad. |
dimension |
conversion_downloads.order_quantity_view |
conversion_downloads.order_quantity_view |
The number of download conversions attributed to a user viewing an ad. |
dimension |
conversion_downloads.post_engagement |
conversion_downloads.post_engagement |
The number of download conversions attributed to engagement with an ad post. |
dimension |
conversion_downloads.post_view |
conversion_downloads.post_view |
The number of download conversions attributed to a view of an ad post. |
dimension |
conversion_downloads.sale_amount |
conversion_downloads.sale_amount |
The sale amount for download conversions. |
dimension |
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. |
dimension |
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. |
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. |
dimension |
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. |
dimension |
conversion_purchases.order_quantity_engagement |
conversion_purchases.order_quantity_engagement |
The number of purchase conversions attributed to user engagement with an ad. |
dimension |
conversion_purchases.order_quantity_view |
conversion_purchases.order_quantity_view |
The number of purchase conversions attributed to a user viewing an ad. |
dimension |
conversion_purchases.post_engagement |
conversion_purchases.post_engagement |
Purchase conversions that occurred after an engagement with the ad. |
dimension |
conversion_purchases.post_view |
conversion_purchases.post_view |
Purchase conversions that occurred after viewing the ad. |
dimension |
conversion_purchases.sale_amount |
conversion_purchases.sale_amount |
The sale amount for purchase conversions. |
dimension |
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. |
dimension |
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. |
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. |
dimension |
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. |
dimension |
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. |
dimension |
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. |
dimension |
conversion_sign_ups.post_engagement |
conversion_sign_ups.post_engagement |
Sign-up conversions that occurred after an engagement with the ad. |
dimension |
conversion_sign_ups.post_view |
conversion_sign_ups.post_view |
Sign-up conversions that occurred after viewing the ad. |
dimension |
conversion_sign_ups.sale_amount |
conversion_sign_ups.sale_amount |
The sale amount for sign-up conversions. |
dimension |
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. |
dimension |
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. |
dimension |
conversion_site_visits |
conversion_site_visits |
The total count of site visit conversions. |
metric |
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. |
dimension |
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. |
dimension |
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. |
dimension |
conversion_site_visits.post_engagement |
conversion_site_visits.post_engagement |
Site visit conversions that occurred after an engagement with the ad. |
dimension |
conversion_site_visits.post_view |
conversion_site_visits.post_view |
Site visit conversions that occurred after viewing the ad. |
dimension |
conversion_site_visits.sale_amount |
conversion_site_visits.sale_amount |
The sale amount for site visit conversions. |
dimension |
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. |
dimension |
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. |
dimension |
cost_USD |
cost_USD |
The total amount of money spent on an advertisement or campaign, specifically in United States Dollars. |
metric |
costs |
costs |
The total spend for the ad campaign. |
metric |
costs_USD |
costs_USD |
The total cost incurred for the advertising campaign, expressed in United States Dollars. |
metric |
costs_lc |
costs_lc |
The total cost incurred for the advertising campaign, expressed in the local currency of the advertiser. |
metric |
costs_usd |
costs_usd |
The total cost incurred for the advertising campaign, expressed in United States Dollars. |
metric |
country |
country |
The country associated with the campaign’s targeting or performance data. |
dimension |
country_code |
country_code |
The two-letter ISO country code for the audience location. |
dimension |
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_date |
created_date |
The date when the advertising entity was created. |
dimension |
creative_body |
creative_body |
The primary textual content or main message of the advertisement creative. |
dimension |
creative_format |
creative_format |
The format of the ad creative, such as image, video, text, or various card types. |
dimension |
creative_id |
creative_id |
A unique identifier for the specific ad creative used in a campaign. |
dimension |
creative_source |
creative_source |
Specifies the origin or type of the ad creative, such as whether it’s a promoted tweet, a card, or another advertising format. |
dimension |
creative_type |
creative_type |
The type of creative used in the ad, such as image, video, or text. |
dimension |
currency |
currency |
The currency used for billing and reporting of the ad campaign. |
dimension |
currency_type |
currency_type |
The type of currency used for all financial transactions, such as ad spend and billing, within the X Ads platform. |
dimension |
daily_budget_amount_local_micro |
daily_budget_amount_local_micro |
The daily budget allocated to the campaign or line item, in micro-currency units of the local currency. |
dimension |
datasource |
datasource |
This field identifies the origin of the data. For this integration, it refers to the X Ads (Twitter) platform. |
dimension |
date |
date |
The date for which the data is reported, in ‘YYYY-MM-DD’ format. |
dimension |
day_of_the_year |
day_of_the_year |
The sequential day number within the year for the reported data. |
metric |
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 advertising campaign in days. |
metric |
effective_status |
effective_status |
The current operational status of an ad campaign or ad group (line item), which can include values like ACTIVE, DRAFT, or PAUSED. |
dimension |
end_time |
end_time |
The end date/time for the data being reported or the campaign/line item to stop serving. This field is deprecated for campaign level, please use Ad group end date instead for line items. |
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 |
engagements_cost |
engagements_cost |
The total cost incurred for all engagements with the ad, such as likes, retweets, or replies. |
metric |
entities_expanded_urls |
entities_expanded_urls |
A list of expanded (unshortened) URLs found within the content of an entity, such as a tweet. |
dimension |
entities_media_call_to_action_urls |
entities_media_call_to_action_urls |
A list of Call-to-Action (CTA) URLs embedded within the ad media. |
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 |
A list of URLs for video media assets used in the advertisement. |
dimension |
entity_status |
entity_status |
The current operational status of an advertising entity (e.g., active, paused, deleted). |
dimension |
follows |
follows |
Total number of followers generated from your Tweet, including earned follows from other locations like ‘Who to follow’. |
metric |
format |
format |
The type of ad creative or campaign structure used for a given promotion on the X (Twitter) platform, such as promoted text, image, video, carousel, or app cards. |
dimension |
frequency_cap |
frequency_cap |
The maximum number of times an ad is shown to a unique user within a specified period. |
metric |
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 |
goal |
goal |
The primary objective of the advertising campaign, such as website clicks, app installs, or total conversions. |
dimension |
impressions |
impressions |
The number of times your ad is shown to users, including earned impressions. |
metric |
industry_type |
industry_type |
A classification or category associated with the ad group, potentially indicating the industry or content focus of the campaign. |
dimension |
installs |
installs |
The total number of app installs. |
dimension |
ios_app_store_identifier |
ios_app_store_identifier |
The identifier for the iOS app in its respective app store. |
dimension |
landing_url |
landing_url |
The URL where users are directed after interacting with an ad. |
dimension |
lifetime_campaign_frequency |
lifetime_campaign_frequency |
The average number of times a unique user has been shown the campaign’s ads over the entire duration of the campaign. |
metric |
lifetime_campaign_reach |
lifetime_campaign_reach |
The total number of unique users who have seen the campaign’s ads over the entire duration of the campaign. |
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. |
dimension |
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_objective |
line_item_objective |
The marketing objective set for the line item, reflecting the desired marketing outcome. |
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 |
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_category |
media_category |
The categorization of the media content used in the advertisement (e.g., image, video). |
dimension |
media_cost |
media_cost |
The cost specifically attributed to the media assets used in the ad campaign. |
metric |
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_duration |
media_duration |
The duration of the media in seconds. |
metric |
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. |
metric |
media_poster_media_url |
media_poster_media_url |
The URL of the poster image for video media. |
dimension |
media_serving_status |
media_serving_status |
The current serving status of the media creative, indicating if it is active and being displayed. |
dimension |
media_status |
media_status |
The current status of the media object. |
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_achievements_unlocked |
mobile_conversion_achievements_unlocked |
The number of in-app achievements unlocked by users after interacting with a mobile ad. |
metric |
mobile_conversion_achievements_unlocked.assisted |
mobile_conversion_achievements_unlocked.assisted |
The number of assisted mobile conversions where achievements were unlocked. ‘Assisted’ indicates conversions influenced by the ad but not directly attributed to the last click/view. |
dimension |
mobile_conversion_achievements_unlocked.order_quantity |
mobile_conversion_achievements_unlocked.order_quantity |
The total quantity of items ordered in mobile conversions where achievements were unlocked. |
dimension |
mobile_conversion_achievements_unlocked.post_engagement |
mobile_conversion_achievements_unlocked.post_engagement |
The number of mobile conversions where achievements were unlocked, attributed to post-engagement actions with the ad. |
dimension |
mobile_conversion_achievements_unlocked.post_view |
mobile_conversion_achievements_unlocked.post_view |
The number of mobile conversions where achievements were unlocked, attributed to post-view actions (impressions) of the ad. |
dimension |
mobile_conversion_achievements_unlocked.sale_amount |
mobile_conversion_achievements_unlocked.sale_amount |
The total revenue from mobile conversions where achievements were unlocked. |
dimension |
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. |
dimension |
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. |
dimension |
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 |
Breakdown of mobile conversions of type ADD_TO_WISHLIST. |
metric |
mobile_conversion_add_to_wishlists.assisted |
mobile_conversion_add_to_wishlists.assisted |
The number of assisted mobile add-to-wishlist conversions. |
dimension |
mobile_conversion_add_to_wishlists.order_quantity |
mobile_conversion_add_to_wishlists.order_quantity |
The order quantity for mobile add-to-wishlist conversions. |
dimension |
mobile_conversion_add_to_wishlists.post_engagement |
mobile_conversion_add_to_wishlists.post_engagement |
Mobile add-to-wishlist conversions that occurred after an engagement with the ad. |
dimension |
mobile_conversion_add_to_wishlists.post_view |
mobile_conversion_add_to_wishlists.post_view |
Mobile add-to-wishlist conversions that occurred after viewing the ad. |
dimension |
mobile_conversion_add_to_wishlists.sale_amount |
mobile_conversion_add_to_wishlists.sale_amount |
The sale amount for mobile add-to-wishlist conversions. |
dimension |
mobile_conversion_checkouts_initiated |
mobile_conversion_checkouts_initiated |
The number of times users initiated a checkout process within a mobile app after interacting with an ad. |
metric |
mobile_conversion_checkouts_initiated.assisted |
mobile_conversion_checkouts_initiated.assisted |
The number of assisted mobile conversions where checkouts were initiated. |
dimension |
mobile_conversion_checkouts_initiated.order_quantity |
mobile_conversion_checkouts_initiated.order_quantity |
The total quantity of items ordered in mobile conversions where checkouts were initiated. |
dimension |
mobile_conversion_checkouts_initiated.post_engagement |
mobile_conversion_checkouts_initiated.post_engagement |
The number of mobile conversions where checkouts were initiated, attributed to post-engagement actions. |
dimension |
mobile_conversion_checkouts_initiated.post_view |
mobile_conversion_checkouts_initiated.post_view |
The number of mobile conversions where checkouts were initiated, attributed to post-view actions. |
dimension |
mobile_conversion_checkouts_initiated.sale_amount |
mobile_conversion_checkouts_initiated.sale_amount |
The total revenue from mobile conversions where checkouts were initiated. |
dimension |
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.order_quantity |
mobile_conversion_downloads.order_quantity |
The order quantity for mobile download conversions. |
dimension |
mobile_conversion_downloads.post_engagement |
mobile_conversion_downloads.post_engagement |
Mobile download conversions that occurred after an engagement with the ad. |
dimension |
mobile_conversion_downloads.post_view |
mobile_conversion_downloads.post_view |
Mobile download conversions that occurred after viewing the ad. |
dimension |
mobile_conversion_downloads.sale_amount |
mobile_conversion_downloads.sale_amount |
The sale amount for mobile download conversions. |
dimension |
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. |
dimension |
mobile_conversion_installs.order_quantity |
mobile_conversion_installs.order_quantity |
The order quantity for mobile install conversions. |
dimension |
mobile_conversion_installs.post_engagement |
mobile_conversion_installs.post_engagement |
Mobile install conversions that occurred after an engagement with the ad. |
dimension |
mobile_conversion_installs.post_view |
mobile_conversion_installs.post_view |
Mobile install conversions that occurred after viewing the ad. |
dimension |
mobile_conversion_installs.sale_amount |
mobile_conversion_installs.sale_amount |
The sale amount for mobile install conversions. |
dimension |
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_invites |
mobile_conversion_invites |
The number of in-app invitations sent by users after engaging with a mobile ad. |
metric |
mobile_conversion_invites.assisted |
mobile_conversion_invites.assisted |
The number of assisted mobile conversions where invites were sent. |
dimension |
mobile_conversion_invites.order_quantity |
mobile_conversion_invites.order_quantity |
The total quantity of items ordered in mobile conversions related to invites. |
dimension |
mobile_conversion_invites.post_engagement |
mobile_conversion_invites.post_engagement |
The number of mobile conversions where invites were sent, attributed to post-engagement actions. |
dimension |
mobile_conversion_invites.post_view |
mobile_conversion_invites.post_view |
The number of mobile conversions where invites were sent, attributed to post-view actions. |
dimension |
mobile_conversion_invites.sale_amount |
mobile_conversion_invites.sale_amount |
The total revenue from mobile conversions related to invites. |
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_levels_achieved |
mobile_conversion_levels_achieved |
The number of in-app levels achieved by users after interacting with a mobile ad. |
metric |
mobile_conversion_levels_achieved.assisted |
mobile_conversion_levels_achieved.assisted |
The number of assisted mobile conversions where levels were achieved within an app or game. |
dimension |
mobile_conversion_levels_achieved.order_quantity |
mobile_conversion_levels_achieved.order_quantity |
The total quantity of items ordered in mobile conversions where levels were achieved. |
dimension |
mobile_conversion_levels_achieved.post_engagement |
mobile_conversion_levels_achieved.post_engagement |
The number of mobile conversions where levels were achieved, attributed to post-engagement actions. |
dimension |
mobile_conversion_levels_achieved.post_view |
mobile_conversion_levels_achieved.post_view |
The number of mobile conversions where levels were achieved, attributed to post-view actions. |
dimension |
mobile_conversion_levels_achieved.sale_amount |
mobile_conversion_levels_achieved.sale_amount |
The total revenue from mobile conversions where levels were achieved. |
dimension |
mobile_conversion_lifetime_value_achievements_unlocked |
mobile_conversion_lifetime_value_achievements_unlocked |
The total lifetime value generated from achievements unlocked conversions on mobile. |
metric |
mobile_conversion_lifetime_value_achievements_unlocked.metric |
mobile_conversion_lifetime_value_achievements_unlocked.metric |
The total count of achievements unlocked conversions on mobile, contributing to lifetime value. |
metric |
mobile_conversion_lifetime_value_achievements_unlocked.order_quantity |
mobile_conversion_lifetime_value_achievements_unlocked.order_quantity |
The quantity of achievements unlocked conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_achievements_unlocked.sale_amount |
mobile_conversion_lifetime_value_achievements_unlocked.sale_amount |
The sales amount from achievements unlocked conversions on mobile, contributing to lifetime value. |
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 |
The total count of add-to-cart conversions on mobile, contributing to lifetime value. |
metric |
mobile_conversion_lifetime_value_add_to_carts.order_quantity |
mobile_conversion_lifetime_value_add_to_carts.order_quantity |
The quantity of add-to-cart conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_add_to_carts.sale_amount |
mobile_conversion_lifetime_value_add_to_carts.sale_amount |
The sales amount from add-to-cart conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_add_to_wishlists |
mobile_conversion_lifetime_value_add_to_wishlists |
The total lifetime value generated from add-to-wishlist conversions on mobile. |
metric |
mobile_conversion_lifetime_value_add_to_wishlists.metric |
mobile_conversion_lifetime_value_add_to_wishlists.metric |
The total count of add-to-wishlist conversions on mobile, contributing to lifetime value. |
metric |
mobile_conversion_lifetime_value_add_to_wishlists.order_quantity |
mobile_conversion_lifetime_value_add_to_wishlists.order_quantity |
The quantity of add-to-wishlist conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_add_to_wishlists.sale_amount |
mobile_conversion_lifetime_value_add_to_wishlists.sale_amount |
The sales amount from add-to-wishlist conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_checkouts_initiated |
mobile_conversion_lifetime_value_checkouts_initiated |
The total lifetime value generated from checkout initiated conversions on mobile. |
metric |
mobile_conversion_lifetime_value_checkouts_initiated.metric |
mobile_conversion_lifetime_value_checkouts_initiated.metric |
The total count of checkout initiated conversions on mobile, contributing to lifetime value. |
metric |
mobile_conversion_lifetime_value_checkouts_initiated.order_quantity |
mobile_conversion_lifetime_value_checkouts_initiated.order_quantity |
The quantity of checkout initiated conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_checkouts_initiated.sale_amount |
mobile_conversion_lifetime_value_checkouts_initiated.sale_amount |
The sales amount from checkout initiated conversions on mobile, contributing 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_invites |
mobile_conversion_lifetime_value_invites |
The total lifetime value generated from invite conversions on mobile. |
metric |
mobile_conversion_lifetime_value_invites.metric |
mobile_conversion_lifetime_value_invites.metric |
The total count of invite conversions on mobile, contributing to lifetime value. |
metric |
mobile_conversion_lifetime_value_invites.order_quantity |
mobile_conversion_lifetime_value_invites.order_quantity |
The quantity of invite conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_invites.sale_amount |
mobile_conversion_lifetime_value_invites.sale_amount |
The sales amount from invite conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_levels_achieved |
mobile_conversion_lifetime_value_levels_achieved |
The total lifetime value generated from levels achieved conversions on mobile. |
metric |
mobile_conversion_lifetime_value_levels_achieved.metric |
mobile_conversion_lifetime_value_levels_achieved.metric |
The total count of levels achieved conversions on mobile, contributing to lifetime value. |
metric |
mobile_conversion_lifetime_value_levels_achieved.order_quantity |
mobile_conversion_lifetime_value_levels_achieved.order_quantity |
The quantity of levels achieved conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_levels_achieved.sale_amount |
mobile_conversion_lifetime_value_levels_achieved.sale_amount |
The sales amount from levels achieved 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_payment_info_additions |
mobile_conversion_lifetime_value_payment_info_additions |
The total lifetime value generated from payment information additions conversions on mobile. |
metric |
mobile_conversion_lifetime_value_payment_info_additions.metric |
mobile_conversion_lifetime_value_payment_info_additions.metric |
The total count of payment information additions conversions on mobile, contributing to lifetime value. |
metric |
mobile_conversion_lifetime_value_payment_info_additions.order_quantity |
mobile_conversion_lifetime_value_payment_info_additions.order_quantity |
The quantity of payment information additions conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_payment_info_additions.sale_amount |
mobile_conversion_lifetime_value_payment_info_additions.sale_amount |
The sales amount from payment information additions 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_reservations |
mobile_conversion_lifetime_value_reservations |
The total lifetime value generated from reservation conversions on mobile. |
metric |
mobile_conversion_lifetime_value_reservations.metric |
mobile_conversion_lifetime_value_reservations.metric |
The total count of reservation conversions on mobile, contributing to lifetime value. |
metric |
mobile_conversion_lifetime_value_reservations.order_quantity |
mobile_conversion_lifetime_value_reservations.order_quantity |
The quantity of reservation conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_reservations.sale_amount |
mobile_conversion_lifetime_value_reservations.sale_amount |
The sales amount from reservation 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_lifetime_value_shares |
mobile_conversion_lifetime_value_shares |
The total lifetime value generated from share conversions on mobile. |
metric |
mobile_conversion_lifetime_value_shares.metric |
mobile_conversion_lifetime_value_shares.metric |
The total count of share conversions on mobile, contributing to lifetime value. |
metric |
mobile_conversion_lifetime_value_shares.order_quantity |
mobile_conversion_lifetime_value_shares.order_quantity |
The quantity of share conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_shares.sale_amount |
mobile_conversion_lifetime_value_shares.sale_amount |
The sales amount from share conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_sign_ups |
mobile_conversion_lifetime_value_sign_ups |
The total lifetime value generated from sign-up conversions on mobile. |
metric |
mobile_conversion_lifetime_value_sign_ups.metric |
mobile_conversion_lifetime_value_sign_ups.metric |
The total count of sign-up conversions on mobile, contributing to lifetime value. |
metric |
mobile_conversion_lifetime_value_sign_ups.order_quantity |
mobile_conversion_lifetime_value_sign_ups.order_quantity |
The quantity of sign-up conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_sign_ups.sale_amount |
mobile_conversion_lifetime_value_sign_ups.sale_amount |
The sales amount from sign-up conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_spent_credits |
mobile_conversion_lifetime_value_spent_credits |
The total lifetime value generated from spent credits conversions on mobile. |
metric |
mobile_conversion_lifetime_value_spent_credits.metric |
mobile_conversion_lifetime_value_spent_credits.metric |
The total count of spent credits conversions on mobile, contributing to lifetime value. |
metric |
mobile_conversion_lifetime_value_spent_credits.order_quantity |
mobile_conversion_lifetime_value_spent_credits.order_quantity |
The quantity of spent credits conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_spent_credits.sale_amount |
mobile_conversion_lifetime_value_spent_credits.sale_amount |
The sales amount from spent credits conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_tutorials_completed |
mobile_conversion_lifetime_value_tutorials_completed |
The total lifetime value generated from tutorial completion conversions on mobile. |
metric |
mobile_conversion_lifetime_value_tutorials_completed.metric |
mobile_conversion_lifetime_value_tutorials_completed.metric |
The total count of tutorial completion conversions on mobile, contributing to lifetime value. |
metric |
mobile_conversion_lifetime_value_tutorials_completed.order_quantity |
mobile_conversion_lifetime_value_tutorials_completed.order_quantity |
The quantity of tutorial completion conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_tutorials_completed.sale_amount |
mobile_conversion_lifetime_value_tutorials_completed.sale_amount |
The sales amount from tutorial completion conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_updates |
mobile_conversion_lifetime_value_updates |
The total lifetime value generated from application update conversions on mobile. |
metric |
mobile_conversion_lifetime_value_updates.metric |
mobile_conversion_lifetime_value_updates.metric |
The total count of application update conversions on mobile, contributing to lifetime value. |
metric |
mobile_conversion_lifetime_value_updates.order_quantity |
mobile_conversion_lifetime_value_updates.order_quantity |
The quantity of application update conversions on mobile, contributing to lifetime value. |
dimension |
mobile_conversion_lifetime_value_updates.sale_amount |
mobile_conversion_lifetime_value_updates.sale_amount |
The sales amount from application update 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_payment_info_additions |
mobile_conversion_payment_info_additions |
The number of times users added payment information within a mobile app after ad interaction. |
metric |
mobile_conversion_payment_info_additions.assisted |
mobile_conversion_payment_info_additions.assisted |
The number of assisted mobile conversions where payment information was added. |
dimension |
mobile_conversion_payment_info_additions.order_quantity |
mobile_conversion_payment_info_additions.order_quantity |
The total quantity of items ordered in mobile conversions where payment information was added. |
dimension |
mobile_conversion_payment_info_additions.post_engagement |
mobile_conversion_payment_info_additions.post_engagement |
The number of mobile conversions where payment information was added, attributed to post-engagement actions. |
dimension |
mobile_conversion_payment_info_additions.post_view |
mobile_conversion_payment_info_additions.post_view |
The number of mobile conversions where payment information was added, attributed to post-view actions. |
dimension |
mobile_conversion_payment_info_additions.sale_amount |
mobile_conversion_payment_info_additions.sale_amount |
The total revenue from mobile conversions where payment information was added. |
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. |
dimension |
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. |
dimension |
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_engages |
mobile_conversion_re_engages |
The number of times users re-engaged with a mobile application after ad exposure. |
metric |
mobile_conversion_re_engages.assisted |
mobile_conversion_re_engages.assisted |
The number of assisted mobile conversions representing re-engagements with an app. |
dimension |
mobile_conversion_re_engages.order_quantity |
mobile_conversion_re_engages.order_quantity |
The total quantity of items ordered in mobile conversions representing re-engagements. |
dimension |
mobile_conversion_re_engages.post_engagement |
mobile_conversion_re_engages.post_engagement |
The number of mobile conversions representing re-engagements, attributed to post-engagement actions. |
dimension |
mobile_conversion_re_engages.post_view |
mobile_conversion_re_engages.post_view |
The number of mobile conversions representing re-engagements, attributed to post-view actions. |
dimension |
mobile_conversion_re_engages.sale_amount |
mobile_conversion_re_engages.sale_amount |
The total revenue from mobile conversions representing re-engagements. |
dimension |
mobile_conversion_reservations |
mobile_conversion_reservations |
The number of reservations made within a mobile app after interacting with an ad. |
metric |
mobile_conversion_reservations.assisted |
mobile_conversion_reservations.assisted |
The number of assisted mobile reservation conversions. |
dimension |
mobile_conversion_reservations.order_quantity |
mobile_conversion_reservations.order_quantity |
The order quantity for mobile reservation conversions. |
dimension |
mobile_conversion_reservations.post_engagement |
mobile_conversion_reservations.post_engagement |
Mobile reservation conversions that occurred after an engagement with the ad. |
dimension |
mobile_conversion_reservations.post_view |
mobile_conversion_reservations.post_view |
Mobile reservation conversions that occurred after viewing the ad. |
dimension |
mobile_conversion_reservations.sale_amount |
mobile_conversion_reservations.sale_amount |
The sale amount for mobile reservation conversions. |
dimension |
mobile_conversion_searches |
mobile_conversion_searches |
The number of searches performed within a mobile application after ad interaction. |
metric |
mobile_conversion_searches.assisted |
mobile_conversion_searches.assisted |
The number of assisted mobile conversions where users performed searches. |
dimension |
mobile_conversion_searches.order_quantity |
mobile_conversion_searches.order_quantity |
The total quantity of items ordered in mobile conversions where searches were performed. |
dimension |
mobile_conversion_searches.post_engagement |
mobile_conversion_searches.post_engagement |
The number of mobile conversions where searches were performed, attributed to post-engagement actions. |
dimension |
mobile_conversion_searches.post_view |
mobile_conversion_searches.post_view |
The number of mobile conversions where searches were performed, attributed to post-view actions. |
dimension |
mobile_conversion_searches.sale_amount |
mobile_conversion_searches.sale_amount |
The total revenue from mobile conversions where searches were performed. |
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_spent_credits |
mobile_conversion_spent_credits |
The number of in-app credits or currency spent by users after engaging with a mobile ad. |
metric |
mobile_conversion_spent_credits.assisted |
mobile_conversion_spent_credits.assisted |
The number of assisted mobile conversions where in-app credits were spent. |
dimension |
mobile_conversion_spent_credits.order_quantity |
mobile_conversion_spent_credits.order_quantity |
The total quantity of items ordered in mobile conversions where credits were spent. |
dimension |
mobile_conversion_spent_credits.post_engagement |
mobile_conversion_spent_credits.post_engagement |
The number of mobile conversions where credits were spent, attributed to post-engagement actions. |
dimension |
mobile_conversion_spent_credits.post_view |
mobile_conversion_spent_credits.post_view |
The number of mobile conversions where credits were spent, attributed to post-view actions. |
dimension |
mobile_conversion_spent_credits.sale_amount |
mobile_conversion_spent_credits.sale_amount |
The total revenue from mobile conversions where credits were spent. |
dimension |
mobile_conversion_tutorials_completed |
mobile_conversion_tutorials_completed |
The number of in-app tutorials completed by users after interacting with a mobile ad. |
metric |
mobile_conversion_tutorials_completed.assisted |
mobile_conversion_tutorials_completed.assisted |
The number of assisted mobile conversions where in-app tutorials were completed. |
dimension |
mobile_conversion_tutorials_completed.order_quantity |
mobile_conversion_tutorials_completed.order_quantity |
The total quantity of items ordered in mobile conversions where tutorials were completed. |
dimension |
mobile_conversion_tutorials_completed.post_engagement |
mobile_conversion_tutorials_completed.post_engagement |
The number of mobile conversions where tutorials were completed, attributed to post-engagement actions. |
dimension |
mobile_conversion_tutorials_completed.post_view |
mobile_conversion_tutorials_completed.post_view |
The number of mobile conversions where tutorials were completed, attributed to post-view actions. |
dimension |
mobile_conversion_tutorials_completed.sale_amount |
mobile_conversion_tutorials_completed.sale_amount |
The total revenue from mobile conversions where tutorials were completed. |
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 |
monthly_campaign_frequency |
monthly_campaign_frequency |
This metric represents the average number of times a unique user is shown ads from a specific campaign within a one-month period. It helps in managing ad exposure and preventing audience fatigue. |
dimension |
monthly_campaign_reach |
monthly_campaign_reach |
The total number of unique users who saw ads from a specific campaign at least once within a one-month period. This metric indicates the breadth of a campaign’s audience. |
dimension |
name |
name |
A descriptive name for an entity such as an account, campaign, line item, or creative. |
dimension |
objective |
objective |
The objective of the ad group. |
dimension |
pay_by |
pay_by |
The billing event for the ad or line item (e.g., impressions, engagements). |
dimension |
placement |
placement |
The placement where the ad was served. |
dimension |
placement_id |
placement_id |
A unique identifier for the specific placement where the ad was displayed. |
dimension |
placements |
placements |
The locations where the ad was displayed (e.g., Twitter feed, audience network). |
dimension |
platform |
platform |
The platform where the ad was displayed (e.g., iOS, Android, Desktop). |
dimension |
platform_name |
platform_name |
The name of the advertising platform where the data originated (e.g., X Ads). |
dimension |
poll_card_vote |
poll_card_vote |
The number of votes on a poll card. |
dimension |
post_id |
post_id |
The unique identifier of the post or tweet. |
dimension |
post_publish_date |
post_publish_date |
The date and time when the associated post (Tweet) was originally published. |
dimension |
post_text |
post_text |
The full textual content of the associated post (Tweet). |
dimension |
post_type |
post_type |
The classification of the post, such as a promoted tweet or an organic tweet. |
dimension |
post_url |
post_url |
The URL linking directly to the associated post (Tweet) on the X platform. |
dimension |
primary_web_event_tag |
primary_web_event_tag |
The identifier for the primary tracking tag used to measure web conversion events. |
dimension |
product_type |
product_type |
The type of product or ad format associated with the advertising entity. |
dimension |
purchase_order_number |
purchase_order_number |
An identifier for the associated insertion order, often used for billing and financial tracking of advertising expenditures. |
dimension |
qualified_impressions |
qualified_impressions |
Impressions that meet specific criteria, indicating higher relevance or viewability. |
metric |
quarterly_campaign_frequency |
quarterly_campaign_frequency |
This metric represents the average number of times a unique user is shown ads from a specific campaign within a three-month (quarterly) period, helping to manage ad exposure over a longer duration. |
dimension |
quarterly_campaign_reach |
quarterly_campaign_reach |
The total number of unique users who saw ads from a specific campaign at least once within a three-month (quarterly) period, indicating the campaign’s audience breadth over a quarter. |
dimension |
reasons_not_servable |
reasons_not_servable |
A list of reasons or explanations why an ad or campaign is currently not eligible to be served or displayed on the X (Twitter) platform. |
dimension |
region |
region |
The geographical region associated with the campaign’s targeting or performance data. |
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 |
revenue_lc |
revenue_lc |
The total revenue generated from purchases or sales, reported in local currency, as a result of ad conversions. |
dimension |
revenue_usd |
revenue_usd |
The revenue generated from advertising activities, reported in United States Dollars. |
dimension |
servable |
servable |
A boolean indicator specifying whether an ad creative or campaign is currently eligible to be served and displayed to users on the X (Twitter) platform. |
dimension |
serving_status |
serving_status |
The current serving status of an entity, indicating if it is active and being displayed. |
dimension |
spend |
spend |
The total amount of money spent on advertising within the specified period. |
metric |
sponsorship_program_id |
sponsorship_program_id |
A unique identifier for a specific sponsorship program, potentially used to group or categorize campaigns or line items. This would link to campaign or line item entity levels. |
dimension |
standard_delivery |
standard_delivery |
A boolean indicator specifying whether the campaign uses a standard delivery method, where the budget is spent evenly over the campaign’s duration, as opposed to accelerated delivery. |
dimension |
start_time |
start_time |
The start date and time of the advertising campaign or line item. |
dimension |
target_cpa_local_micro |
target_cpa_local_micro |
The target Cost Per Acquisition (CPA), in micro-currency units of the local currency. |
dimension |
target_url |
target_url |
The destination URL that users are directed to after interacting with the ad. |
dimension |
targeting |
targeting |
Details about the audience targeting criteria used for the ad campaign, such as demographics, interests, or behaviors. |
dimension |
timestamp |
timestamp |
The timestamp for the data being reported. |
dimension |
timezone |
timezone |
The timezone setting for the advertising account or campaign. |
dimension |
timezone_switch_at |
timezone_switch_at |
The timestamp indicating the most recent time when the timezone setting for the advertising account or campaign was changed. |
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 allocated to the campaign, in micro-currency units of the local currency. |
dimension |
total_conversions |
total_conversions |
The total number of conversion events attributed to the advertising campaign. |
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 |
The URL where a preview of a tweet creative can be viewed, allowing users to see how the tweet will appear before publishing. |
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. |
dimension |
twitter_clicks |
twitter_clicks |
The total number of clicks on the ad, including links, hashtags, and other tweet details. |
dimension |
twitter_impressions |
twitter_impressions |
The number of times the ad was shown to users. |
dimension |
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. |
dimension |
url_clicks |
url_clicks |
Total clicks on the link or Website Card in your ad, including earned clicks. |
metric |
utm_campaign |
utm_campaign |
The Urchin Tracking Module (UTM) parameter used to identify the specific campaign that referred the traffic to a website. |
dimension |
utm_content |
utm_content |
The Urchin Tracking Module (UTM) parameter used to differentiate between similar content within the same ad or link. |
dimension |
utm_medium |
utm_medium |
The Urchin Tracking Module (UTM) parameter used to identify the medium that referred the traffic, such as ‘cpc’, ‘social’, or ‘email’. |
dimension |
utm_source |
utm_source |
The Urchin Tracking Module (UTM) parameter used to identify the source of the traffic, such as ‘twitter’, ‘newsletter’, or ‘google’. |
dimension |
utm_term |
utm_term |
The Urchin Tracking Module (UTM) parameter used to identify paid keywords for search advertising, or other terms to track. |
dimension |
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 |
The number of times a video content started playing with at least 50% of the video player in view. |
metric |
video_content_starts_with_50_ptc_view_and_audio |
video_content_starts_with_50_ptc_view_and_audio |
The number of times a video ad started playing, with at least 50% of the video in view and audio enabled. |
metric |
video_content_starts_with_audio |
video_content_starts_with_audio |
The number of times a video content started playing with the audio turned on. |
metric |
video_cta_clicks |
video_cta_clicks |
Total clicks on the call to action in the video player, including unbilled clicks. |
dimension |
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 was viewed 100% to completion with at least 50% of the video player in view. |
metric |
video_views_100_with_50_ptc_view_and_audio |
video_views_100_with_50_ptc_view_and_audio |
The number of full video views (100% completion) where at least 50% of the video was in view and audio was enabled. |
metric |
video_views_100_with_audio |
video_views_100_with_audio |
The number of times a video was viewed 100% to completion with the audio turned on. |
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 was viewed to 25% completion with at least 50% of the video player in view. |
metric |
video_views_25_with_50_ptc_view_and_audio |
video_views_25_with_50_ptc_view_and_audio |
The number of video views that reached 25% completion, with at least 50% of the video in view and audio enabled. |
metric |
video_views_25_with_audio |
video_views_25_with_audio |
The number of times a video was viewed to 25% completion with the audio turned on. |
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 was viewed to 50% completion with at least 50% of the video player in view. |
metric |
video_views_50_with_50_ptc_view_and_audio |
video_views_50_with_50_ptc_view_and_audio |
The number of video views that reached 50% completion, with at least 50% of the video in view and audio enabled. |
metric |
video_views_50_with_audio |
video_views_50_with_audio |
The number of times a video was viewed to 50% completion with the audio turned on. |
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 was viewed to 75% completion with at least 50% of the video player in view. |
metric |
video_views_75_with_50_ptc_view_and_audio |
video_views_75_with_50_ptc_view_and_audio |
The number of video views that reached 75% completion, with at least 50% of the video in view and audio enabled. |
metric |
video_views_75_with_audio |
video_views_75_with_audio |
The number of times a video was viewed to 75% completion with the audio turned on. |
metric |
views_cost |
views_cost |
The total cost incurred for all views or impressions of the ad. |
metric |
website_card_url |
website_card_url |
The URL of the website card used in the ad. |
dimension |
yearly_campaign_frequency |
yearly_campaign_frequency |
This metric represents the average number of times a unique user is shown ads from a specific campaign within a one-year period, used for long-term ad exposure management. |
dimension |
yearly_campaign_reach |
yearly_campaign_reach |
The total number of unique users who saw ads from a specific campaign at least once within a one-year period, representing the annual audience breadth. |
dimension |