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 |
GENDER |
Gender |
The gender demographic of the audience targeted or reached by the ad. |
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 |
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 |
This field specifies the type of entity or report being referenced. Examples include entity levels like Account, Campaign, Line Item, Tweet, or report types such as Analytics, Reach and Average Frequency, or Metadata. |
dimension |
Updated at |
updated_at |
The timestamp indicating when the record or entity was last updated. |
dimension |
WeekNum |
WeekNum |
The numerical representation of the week within a given year, used for time-based segmentation and reporting. |
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_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 |
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. |
metric |
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. |
metric |
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. |
metric |
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. |
metric |
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. |
metric |
campaign_updated_at |
campaign_updated_at |
The date and time when the campaign was last updated. |
dimension |
card_app_cta |
card_app_cta |
The Call to Action (CTA) text displayed on an app card. |
dimension |
card_content_duration_seconds |
card_content_duration_seconds |
The duration, in seconds, of video content embedded within an ad card. |
dimension |
card_country_code |
card_country_code |
The country code associated with the card. |
dimension |
card_created_at |
card_created_at |
The timestamp when the card was created. |
dimension |
card_deleted |
card_deleted |
A boolean flag indicating whether the card has been marked as deleted. |
dimension |
card_engagements |
card_engagements |
Total number of engagements with the card. |
metric |
card_first_cta |
card_first_cta |
The text for the first Call to Action (CTA) button on the card. |
dimension |
card_first_cta_tweet |
card_first_cta_tweet |
The text of the first Call-to-Action (CTA) button displayed on a Twitter Card, designed to prompt user interaction directly from the tweet. |
dimension |
card_first_cta_welcome_message_id |
card_first_cta_welcome_message_id |
The unique identifier for a welcome message associated with the first Call-to-Action (CTA) button on a Twitter Card. This message may be automatically sent when a user interacts with the CTA. |
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. |
metric |
card_image_display_width |
card_image_display_width |
The display width of an image within the card, in pixels. |
metric |
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 Twitter user designated as the recipient for direct messages or interactions initiated via a Twitter 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 |
The unique media key identifying an image that is unlocked or revealed upon a specific user interaction with a Twitter Card. |
dimension |
card_unlocked_video_media_key |
card_unlocked_video_media_key |
The unique media key identifying a video that is unlocked or revealed upon a specific user interaction with a Twitter Card. |
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. |
metric |
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. |
metric |
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 URL displayed on a Twitter Card, typically representing the destination website for the card’s action. |
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 distinct elements or building blocks that make up an ad creative or campaign, such as images, videos, text, or interactive elements. |
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. |
metric |
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. |
metric |
conversion_site_visits.post_view |
conversion_site_visits.post_view |
Site visit conversions that occurred after viewing the ad. |
metric |
conversion_site_visits.sale_amount |
conversion_site_visits.sale_amount |
The sale amount for site visit conversions. |
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 monetary cost or spend associated with a campaign or ad group, reported in United States Dollars (USD). This metric typically falls under billing or spend analytics. |
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_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 |
The origin or source of the ad creative, such as an uploaded file or an existing tweet. |
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 |
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. |
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. |
dimension |
funding_instrument_description |
funding_instrument_description |
A description of the funding instrument used for billing. |
dimension |
funding_instrument_id |
funding_instrument_id |
A reference to the funding instrument ID. |
dimension |
funding_instrument_type |
funding_instrument_type |
The type of funding instrument (e.g., credit card, insertion order). |
dimension |
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 |
The industry classification associated with the advertiser or campaign, used for categorizing and benchmarking ad performance. |
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. |
dimension |
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. |
dimension |
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. |
dimension |
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. |
dimension |
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. |
dimension |
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. |
dimension |
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. |
dimension |
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. |
dimension |
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. |
metric |
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. |
dimension |
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. |
dimension |
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. |
dimension |
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. |
dimension |
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. |
dimension |
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. |
dimension |
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. |
dimension |
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 |
A unique identifier assigned to a purchase order for billing and financial tracking purposes related to ad spend. |
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 |
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 |
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 |
timestamp_updated |
timestamp_updated |
The timestamp indicating the last time the data record was updated. |
dimension |
timezone |
timezone |
The timezone setting for the advertising account or campaign. |
dimension |
timezone_switch_at |
timezone_switch_at |
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. |
metric |
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 have unfollowed an account during a specified period. This metric is typically derived by comparing follower lists over time, as the Twitter API does not provide a direct unfollows endpoint. |
metric |
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. |
dimension |
video_6s50pct_views |
video_6s50pct_views |
The total number of video views where at least 6 seconds of the video content was watched, with the implied context of at least 50% of the video being in view (common standard for viewability). |
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. |
metric |
video_total_views |
video_total_views |
Total video views, counted when your video is watched in 50% view for 2 seconds or more, or when a user clicks to expand/unmute. Includes unbilled views. |
metric |
video_views_100 |
video_views_100 |
The number of people who watched 100% of the video, regardless of how much of the video player is in view. These views are not billed. |
metric |
video_views_100_with_50_ptc_view |
video_views_100_with_50_ptc_view |
The number of times a video 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 |