Snapchat: Most-used fields#
The table below gives information about most-used fields that you can import from Snapchat. 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 |
|---|---|---|---|
Gender |
gender |
The gender of the audience targeted in Snapchat ads. |
dimension |
ad_account_id |
ad_account_id |
The unique identifier for the ad account. |
dimension |
ad_account_name |
ad_account_name |
The name of the ad account. |
dimension |
ad_id |
ad_id |
The unique identifier for an individual ad. |
dimension |
ad_name |
ad_name |
The name of the ad. |
dimension |
ad_product |
ad_product |
The specific ad product used for the creative (e.g., Story Ad, Collection Ad). |
dimension |
ad_scheduling_config |
ad_scheduling_config |
Configuration settings that dictate the specific days and times an ad campaign or ad squad is scheduled to run, determining its active periods for ad delivery. |
dimension |
ad_squad_id |
ad_squad_id |
The unique identifier for an ad squad, which is a group of ads. |
dimension |
ad_squad_name |
ad_squad_name |
The name of the ad squad. |
dimension |
ad_squad_placement |
ad_squad_placement |
The placement where the ad squad’s ads are displayed (e.g., Content, Story). |
dimension |
ad_squad_placement_v2_config |
ad_squad_placement_v2_config |
Configuration settings for the ad squad’s placements using the V2 placement system. |
dimension |
ad_squad_placement_v2_inclusion |
ad_squad_placement_v2_inclusion |
Inclusion rules for ad squad placements using the V2 placement system. |
dimension |
ad_squad_placement_v2_platforms |
ad_squad_placement_v2_platforms |
The platforms where the ad squad’s ads are allowed to be placed (e.g., Snapchat) using the V2 placement system. |
dimension |
ad_squad_placement_v2_snapchat_positions |
ad_squad_placement_v2_snapchat_positions |
Specific positions within Snapchat where the ad squad’s ads are allowed to be placed (e.g., CHAT_FEED) using the V2 placement system. |
dimension |
ad_squad_targeting_demographics_gender |
ad_squad_targeting_demographics_gender |
Gender demographic targeting applied at the ad squad level. |
dimension |
ad_squad_targeting_demographics_languages |
ad_squad_targeting_demographics_languages |
The demographic (e.g., age, gender) and language targeting settings for the ad squad. |
dimension |
ad_squad_targeting_demographics_max_age |
ad_squad_targeting_demographics_max_age |
Maximum age for demographic targeting applied at the ad squad level. |
dimension |
ad_squad_targeting_demographics_min_age |
ad_squad_targeting_demographics_min_age |
Minimum age for demographic targeting applied at the ad squad level. |
metric |
ad_squad_targeting_geos_country_code |
ad_squad_targeting_geos_country_code |
The two-letter ISO country code used to specify the geographical region for ad targeting within an Ad Squad. This field defines the countries where the ads in the Ad Squad will be displayed. |
dimension |
ad_squad_targeting_geos_excluded |
ad_squad_targeting_geos_excluded |
Geographic locations explicitly excluded from the ad squad’s targeting. |
dimension |
ad_squad_targeting_geos_included |
ad_squad_targeting_geos_included |
Geographic locations included in the targeting for the ad squad. |
dimension |
ad_squad_targeting_interests_category_id |
ad_squad_targeting_interests_category_id |
Category ID for interest-based targeting applied at the ad squad level. |
dimension |
ad_squad_targeting_locations |
ad_squad_targeting_locations |
Specific geographic locations targeted by the ad squad. |
dimension |
ad_squad_targeting_regulated_content |
ad_squad_targeting_regulated_content |
Flag indicating if the ad squad’s content is regulated (e.g., alcohol), requiring specific targeting considerations. |
dimension |
ad_squad_targeting_segments_excluded |
ad_squad_targeting_segments_excluded |
Customer list segments or other audience segments explicitly excluded from the ad squad’s targeting. |
dimension |
ad_squad_targeting_segments_included |
ad_squad_targeting_segments_included |
Audience segments included in the targeting for the ad squad. |
dimension |
advertiser |
ad_account_advertiser |
The advertiser associated with the ad account. |
dimension |
advertiser_organization_id |
advertiser_organization_id |
The unique identifier for the advertiser’s organization. |
dimension |
age_bucket |
age_bucket |
The age range or bucket of the audience targeted in Snapchat ads. |
dimension |
agency |
agency |
The advertising agency associated with the campaign or ad account. |
dimension |
agency_representing_client |
agency_representing_client |
Information about the advertising agency that manages the client’s ad accounts. |
dimension |
android_installs |
android_installs |
The total number of app installs on Android devices attributed to the ad. |
metric |
android_installs_app |
android_installs_app |
The total number of times your application was installed and opened on an Android device, attributed to in-app ad interactions. |
metric |
android_installs_app_swipe_up |
android_installs_app_swipe_up |
The total number of Android app installs attributed to a swipe-up action on an in-app ad. |
metric |
android_installs_app_view |
android_installs_app_view |
The total number of Android app installs attributed to a view of an in-app ad. |
metric |
android_installs_offline |
android_installs_offline |
The total number of Android app installs attributed to offline conversion events. |
metric |
android_installs_offline_swipe_up |
android_installs_offline_swipe_up |
The total number of Android app installs from offline events attributed to a swipe-up action. |
metric |
android_installs_offline_view |
android_installs_offline_view |
The total number of Android app installs from offline events attributed to an ad view. |
metric |
android_installs_swipe_up |
android_installs_swipe_up |
The number of app installs on Android devices attributed to users swiping up on the ad. |
metric |
android_installs_view |
android_installs_view |
The number of app installs on Android devices attributed to users who viewed the ad (view-through conversions). |
metric |
android_installs_web |
android_installs_web |
The total number of Android app installs attributed to web conversion events. |
metric |
android_installs_web_swipe_up |
android_installs_web_swipe_up |
The total number of Android app installs from web events attributed to a swipe-up action. |
metric |
android_installs_web_view |
android_installs_web_view |
The total number of Android app installs from web events attributed to an ad view. |
metric |
app_install_properties |
app_install_properties |
Properties and configurations specific to app install campaigns, used when the ad’s interaction type is an app install. |
dimension |
attachment_avg_view_time_millis |
attachment_avg_view_time_millis |
The average time, in milliseconds, that users viewed the attachment within the ad. |
metric |
attachment_frequency |
attachment_frequency |
The average number of times a unique user viewed the ad’s attachment. |
metric |
attachment_impressions |
attachment_impressions |
The total number of times the ad’s attachment was displayed. |
metric |
attachment_quartile_{NUM} |
attachment_quartile_{NUM} |
Video quartile data (e.g., 25%, 50%, 75%, 100%) for the ad’s attachment. |
metric |
attachment_total_view_time_millis |
attachment_total_view_time_millis |
The total time, in milliseconds, that users viewed the ad’s attachment. |
metric |
attachment_uniques |
attachment_uniques |
The number of unique users who viewed the ad’s attachment. |
metric |
attachment_video_views |
attachment_video_views |
The number of video views for the ad’s attachment. |
metric |
attachment_view_completion |
attachment_view_completion |
The percentage of users who completed viewing the ad’s attachment. |
metric |
auto_bid |
auto_bid |
A boolean flag indicating whether the ad platform automatically manages bids to achieve the most goal actions for the given budget and target audience. |
dimension |
auto_bid_max_bid_micro |
auto_bid_max_bid_micro |
The maximum bid amount, expressed in micro-currency, that the auto-bidding strategy is allowed to place for an ad. |
metric |
avg_screen_time_millis |
avg_screen_time_millis |
The average time, in milliseconds, that users spent on screen interacting with the ad. |
metric |
avg_view_time_millis |
avg_view_time_millis |
The average time, in milliseconds, that users viewed the ad creative. |
metric |
bid_micro |
bid_micro |
The bid amount for the ad squad, expressed in micro-currency units (1 local currency unit = 1,000,000 micro-currency). |
dimension |
bid_strategy |
bid_strategy |
The strategy used for bidding on ad placements for the ad squad (e.g., goal-based bidding). |
dimension |
billing_center_id |
billing_center_id |
The unique identifier for the billing center associated with the ad account. |
dimension |
billing_event |
ad_squad_billing_event |
The specific event or action for which an ad squad is billed, such as impressions or conversions. |
dimension |
billing_type |
billing_type |
Defines the billing arrangement for the ad account, such as ‘REVOLVING’. |
dimension |
brand_safety_config |
brand_safety_config |
Defines where ads are placed among Snapchat content, allowing advertisers to control the suitability of the content surrounding their ads. |
dimension |
buy_model |
buy_model |
The method used for purchasing ad space, such as ‘AUCTION’ for real-time bidding or ‘RESERVED’ for upfront reach and frequency buys. |
dimension |
call_to_action |
call_to_action |
The button or prompt within a creative that encourages users to take a specific action, such as ‘Shop Now’ or ‘Install App’. |
dimension |
campaign_budget_optimization_properties |
campaign_budget_optimization_properties |
Properties related to campaign budget optimization, defining how the budget is managed across ad squads within a campaign. |
dimension |
campaign_end_time |
campaign_end_time |
The scheduled end time for the campaign. |
dimension |
campaign_id |
campaign_id |
The unique identifier for the campaign. |
dimension |
campaign_name |
campaign_name |
The name of the campaign. |
dimension |
campaign_objective |
campaign_objective |
The primary goal of the advertising campaign, such as app installs or website visits. |
dimension |
campaign_start_time |
campaign_start_time |
The scheduled start time for the campaign. |
dimension |
cap_and_exclusion_config |
cap_and_exclusion_config |
Configuration for frequency capping and excluding certain audiences for an Ad Squad. |
dimension |
conversion_achievement_unlocked |
conversion_achievement_unlocked |
Total achievement unlocks attributed to ad engagement. |
metric |
conversion_achievement_unlocked_app |
conversion_achievement_unlocked_app |
The total number of times a user unlocked an achievement within the app. |
metric |
conversion_achievement_unlocked_app_swipe_up |
conversion_achievement_unlocked_app_swipe_up |
The total number of times a user unlocked an achievement within the app, attributed to a swipe-up action. |
metric |
conversion_achievement_unlocked_app_view |
conversion_achievement_unlocked_app_view |
The total number of times a user unlocked an achievement within the app, attributed to an ad view. |
metric |
conversion_achievement_unlocked_offline |
conversion_achievement_unlocked_offline |
The total number of times a user unlocked an achievement through offline events. |
metric |
conversion_achievement_unlocked_offline_swipe_up |
conversion_achievement_unlocked_offline_swipe_up |
The total number of times a user unlocked an achievement through offline events, attributed to a swipe-up action. |
metric |
conversion_achievement_unlocked_offline_view |
conversion_achievement_unlocked_offline_view |
The total number of times a user unlocked an achievement through offline events, attributed to an ad view. |
metric |
conversion_achievement_unlocked_swipe_up |
conversion_achievement_unlocked_swipe_up |
The total number of times an achievement was unlocked, attributed to a swipe-up action. |
metric |
conversion_achievement_unlocked_view |
conversion_achievement_unlocked_view |
Represents the number of ‘achievement unlocked’ conversions attributed to users who viewed the ad. |
metric |
conversion_achievement_unlocked_web |
conversion_achievement_unlocked_web |
The total number of times a user unlocked an achievement on a website. |
metric |
conversion_achievement_unlocked_web_swipe_up |
conversion_achievement_unlocked_web_swipe_up |
The total number of times a user unlocked an achievement on a website, attributed to a swipe-up action. |
metric |
conversion_achievement_unlocked_web_view |
conversion_achievement_unlocked_web_view |
The total number of times a user unlocked an achievement on a website, attributed to an ad view. |
metric |
conversion_ad_click |
conversion_ad_click |
The total number of conversions attributed to ad clicks. |
metric |
conversion_ad_click_app |
conversion_ad_click_app |
Total ad clicks occurring in an app. |
metric |
conversion_ad_click_app_swipe_up |
conversion_ad_click_app_swipe_up |
The total number of ad clicks within the app, attributed to a swipe-up action. |
metric |
conversion_ad_click_app_view |
conversion_ad_click_app_view |
The total number of ad clicks within the app, attributed to an ad view. |
metric |
conversion_ad_click_offline |
conversion_ad_click_offline |
Total ad clicks occurring offline. |
metric |
conversion_ad_click_offline_swipe_up |
conversion_ad_click_offline_swipe_up |
The total number of ad clicks from offline events, attributed to a swipe-up action. |
metric |
conversion_ad_click_offline_view |
conversion_ad_click_offline_view |
The total number of ad clicks from offline events, attributed to an ad view. |
metric |
conversion_ad_click_sk_ad_network |
conversion_ad_click_sk_ad_network |
Conversion attributed to an ad click via Apple’s SKAdNetwork. |
metric |
conversion_ad_click_sk_ad_network_total |
conversion_ad_click_sk_ad_network_total |
Total conversions attributed to an ad click via Apple’s SKAdNetwork. |
metric |
conversion_ad_click_sk_ad_network_view |
conversion_ad_click_sk_ad_network_view |
Conversions attributed to a view-through ad interaction via Apple’s SKAdNetwork. |
metric |
conversion_ad_click_swipe_up |
conversion_ad_click_swipe_up |
The number of conversions attributed to ad clicks resulting from a swipe-up action. |
metric |
conversion_ad_click_view |
conversion_ad_click_view |
The number of conversions attributed to ad clicks from users who previously viewed the ad. |
metric |
conversion_ad_click_web |
conversion_ad_click_web |
Total ad clicks occurring on the web. |
metric |
conversion_ad_click_web_swipe_up |
conversion_ad_click_web_swipe_up |
The total number of ad clicks on a website, attributed to a swipe-up action. |
metric |
conversion_ad_click_web_view |
conversion_ad_click_web_view |
The total number of ad clicks on a website, attributed to an ad view. |
metric |
conversion_ad_view |
conversion_ad_view |
The total number of conversions attributed to ad views (view-through conversions). |
metric |
conversion_ad_view_app |
conversion_ad_view_app |
The total number of times an ad was viewed within the app. |
metric |
conversion_ad_view_app_swipe_up |
conversion_ad_view_app_swipe_up |
The total number of times an ad was viewed within the app, attributed to a swipe-up action. |
metric |
conversion_ad_view_app_view |
conversion_ad_view_app_view |
The total number of times an ad was viewed within the app, attributed to an ad view. |
metric |
conversion_ad_view_offline |
conversion_ad_view_offline |
The total number of times an ad was viewed, based on offline events. |
metric |
conversion_ad_view_offline_swipe_up |
conversion_ad_view_offline_swipe_up |
The total number of times an ad was viewed through offline events, attributed to a swipe-up action. |
metric |
conversion_ad_view_offline_view |
conversion_ad_view_offline_view |
The total number of times an ad was viewed through offline events, attributed to an ad view. |
metric |
conversion_ad_view_swipe_up |
conversion_ad_view_swipe_up |
The number of conversions attributed to ad views resulting from a swipe-up action. |
metric |
conversion_ad_view_value |
conversion_ad_view_value |
The attributed monetary or weighted value generated from a user viewing an ad across all conversion sources. |
metric |
conversion_ad_view_value_app |
conversion_ad_view_value_app |
The total value generated from ad views within the app. |
metric |
conversion_ad_view_value_offline |
conversion_ad_view_value_offline |
The total value generated from ad views based on offline events. |
metric |
conversion_ad_view_value_web |
conversion_ad_view_value_web |
The total value generated from ad views on a website. |
metric |
conversion_ad_view_view |
conversion_ad_view_view |
A conversion metric indicating that a user viewed an ad and subsequently performed a desired action, attributed to the view. |
metric |
conversion_ad_view_web |
conversion_ad_view_web |
The total number of times an ad was viewed on a website. |
metric |
conversion_ad_view_web_swipe_up |
conversion_ad_view_web_swipe_up |
The total number of times an ad was viewed on a website, attributed to a swipe-up action. |
metric |
conversion_ad_view_web_view |
conversion_ad_view_web_view |
The total number of times an ad was viewed on a website, attributed to an ad view. |
metric |
conversion_add_billing |
conversion_add_billing |
The total number of ‘add billing information’ conversions attributed to the ad. |
metric |
conversion_add_billing_app |
conversion_add_billing_app |
Total billing information additions occurring in an app attributed to ad engagement. |
metric |
conversion_add_billing_app_swipe_up |
conversion_add_billing_app_swipe_up |
The total number of times billing information was added within the app, attributed to a swipe-up action. |
metric |
conversion_add_billing_app_view |
conversion_add_billing_app_view |
The total number of times billing information was added within the app, attributed to an ad view. |
metric |
conversion_add_billing_offline |
conversion_add_billing_offline |
Total billing information additions occurring offline attributed to ad engagement. |
metric |
conversion_add_billing_offline_swipe_up |
conversion_add_billing_offline_swipe_up |
The total number of times billing information was added through offline events, attributed to a swipe-up action. |
metric |
conversion_add_billing_offline_view |
conversion_add_billing_offline_view |
The total number of times billing information was added through offline events, attributed to an ad view. |
metric |
conversion_add_billing_swipe_up |
conversion_add_billing_swipe_up |
The number of ‘add billing information’ conversions attributed to users swiping up on the ad. |
metric |
conversion_add_billing_value |
conversion_add_billing_value |
The total monetary value associated with users adding billing information. |
metric |
conversion_add_billing_value_app |
conversion_add_billing_value_app |
The total monetary value generated from users adding billing information within the app. |
metric |
conversion_add_billing_value_offline |
conversion_add_billing_value_offline |
The total monetary value generated from users adding billing information through offline events. |
metric |
conversion_add_billing_value_web |
conversion_add_billing_value_web |
The total monetary value generated from users adding billing information on a website. |
metric |
conversion_add_billing_view |
conversion_add_billing_view |
The number of ‘add billing information’ conversions attributed to users who viewed the ad (view-through conversions). |
metric |
conversion_add_billing_web |
conversion_add_billing_web |
Total billing information additions occurring on the web attributed to ad engagement. |
metric |
conversion_add_billing_web_swipe_up |
conversion_add_billing_web_swipe_up |
The total number of times billing information was added on a website, attributed to a swipe-up action. |
metric |
conversion_add_billing_web_view |
conversion_add_billing_web_view |
The total number of times billing information was added on a website, attributed to an ad view. |
metric |
conversion_add_cart |
conversion_add_cart |
The total number of ‘add to cart’ conversions attributed to the ad. |
metric |
conversion_add_cart_app |
conversion_add_cart_app |
Total additions to cart occurring in an app attributed to ad engagement. |
metric |
conversion_add_cart_app_swipe_up |
conversion_add_cart_app_swipe_up |
Total additions to cart occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_add_cart_app_view |
conversion_add_cart_app_view |
Total additions to cart occurring in an app attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_add_cart_offline |
conversion_add_cart_offline |
Total additions to cart occurring offline attributed to ad engagement. |
metric |
conversion_add_cart_offline_swipe_up |
conversion_add_cart_offline_swipe_up |
Total additions to cart occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_add_cart_offline_view |
conversion_add_cart_offline_view |
Total additions to cart occurring offline attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_add_cart_sk_ad_network |
conversion_add_cart_sk_ad_network |
Add-to-cart conversions attributed via Apple’s SKAdNetwork. |
metric |
conversion_add_cart_sk_ad_network_total |
conversion_add_cart_sk_ad_network_total |
Total add-to-cart conversions attributed via Apple’s SKAdNetwork. |
metric |
conversion_add_cart_swipe_up |
conversion_add_cart_swipe_up |
The number of ‘add to cart’ conversions attributed to users swiping up on the ad. |
metric |
conversion_add_cart_value |
conversion_add_cart_value |
The monetary value generated from ‘add to cart’ conversions. |
metric |
conversion_add_cart_value_app |
conversion_add_cart_value_app |
The total monetary value of items added to a cart within the app. |
metric |
conversion_add_cart_value_offline |
conversion_add_cart_value_offline |
The total monetary value of items added to a cart through offline events. |
metric |
conversion_add_cart_value_web |
conversion_add_cart_value_web |
The total monetary value of items added to a cart on a website. |
metric |
conversion_add_cart_view |
conversion_add_cart_view |
The number of ‘add to cart’ conversions attributed to users who viewed the ad (view-through conversions). |
metric |
conversion_add_cart_web |
conversion_add_cart_web |
Total additions to cart occurring on the web attributed to ad engagement. |
metric |
conversion_add_cart_web_swipe_up |
conversion_add_cart_web_swipe_up |
Total additions to cart occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_add_cart_web_view |
conversion_add_cart_web_view |
Total additions to cart occurring on the web attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_add_to_wishlist |
conversion_add_to_wishlist |
The total number of ‘add to wishlist’ conversions attributed to the ad. |
metric |
conversion_add_to_wishlist_app |
conversion_add_to_wishlist_app |
Total additions to wishlist occurring in an app attributed to ad engagement. |
metric |
conversion_add_to_wishlist_app_swipe_up |
conversion_add_to_wishlist_app_swipe_up |
The total number of times an item was added to a wishlist within the app, attributed to a swipe-up action. |
metric |
conversion_add_to_wishlist_app_view |
conversion_add_to_wishlist_app_view |
The total number of times an item was added to a wishlist within the app, attributed to an ad view. |
metric |
conversion_add_to_wishlist_offline |
conversion_add_to_wishlist_offline |
Total additions to wishlist occurring offline attributed to ad engagement. |
metric |
conversion_add_to_wishlist_offline_swipe_up |
conversion_add_to_wishlist_offline_swipe_up |
The total number of times an item was added to a wishlist through offline events, attributed to a swipe-up action. |
metric |
conversion_add_to_wishlist_offline_view |
conversion_add_to_wishlist_offline_view |
The total number of times an item was added to a wishlist through offline events, attributed to an ad view. |
metric |
conversion_add_to_wishlist_swipe_up |
conversion_add_to_wishlist_swipe_up |
The number of ‘add to wishlist’ conversions attributed to users swiping up on the ad. |
metric |
conversion_add_to_wishlist_value |
conversion_add_to_wishlist_value |
This field represents the monetary value associated with a user adding an item to their wishlist, tracked as a conversion event via the Snapchat Conversions API. |
metric |
conversion_add_to_wishlist_value_app |
conversion_add_to_wishlist_value_app |
The total monetary value of items added to a wishlist within the app. |
metric |
conversion_add_to_wishlist_value_offline |
conversion_add_to_wishlist_value_offline |
The total monetary value of items added to a wishlist through offline events. |
metric |
conversion_add_to_wishlist_value_web |
conversion_add_to_wishlist_value_web |
The total monetary value of items added to a wishlist on a website. |
metric |
conversion_add_to_wishlist_view |
conversion_add_to_wishlist_view |
The number of ‘add to wishlist’ conversions attributed to users who viewed the ad (view-through conversions). |
metric |
conversion_add_to_wishlist_web |
conversion_add_to_wishlist_web |
Total additions to wishlist occurring on the web attributed to ad engagement. |
metric |
conversion_add_to_wishlist_web_swipe_up |
conversion_add_to_wishlist_web_swipe_up |
The total number of times an item was added to a wishlist on a website, attributed to a swipe-up action. |
metric |
conversion_add_to_wishlist_web_view |
conversion_add_to_wishlist_web_view |
The total number of times an item was added to a wishlist on a website, attributed to an ad view. |
metric |
conversion_app_opens |
conversion_app_opens |
Total app opens attributed to ad engagement. |
metric |
conversion_app_opens_app |
conversion_app_opens_app |
Total app opens occurring in an app attributed to ad engagement. |
metric |
conversion_app_opens_app_swipe_up |
conversion_app_opens_app_swipe_up |
The total number of times the app was opened, attributed to a swipe-up action on an in-app ad. |
metric |
conversion_app_opens_app_view |
conversion_app_opens_app_view |
The total number of times the app was opened, attributed to an ad view on an in-app ad. |
metric |
conversion_app_opens_offline |
conversion_app_opens_offline |
Total app opens occurring offline attributed to ad engagement. |
metric |
conversion_app_opens_offline_swipe_up |
conversion_app_opens_offline_swipe_up |
The total number of times the app was opened through offline events, attributed to a swipe-up action. |
metric |
conversion_app_opens_offline_view |
conversion_app_opens_offline_view |
The total number of times the app was opened through offline events, attributed to an ad view. |
metric |
conversion_app_opens_swipe_up |
conversion_app_opens_swipe_up |
Total app opens attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_app_opens_view |
conversion_app_opens_view |
Total app opens attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_app_opens_web |
conversion_app_opens_web |
Total app opens occurring on the web attributed to ad engagement. |
metric |
conversion_app_opens_web_swipe_up |
conversion_app_opens_web_swipe_up |
The total number of times the app was opened from a website, attributed to a swipe-up action. |
metric |
conversion_app_opens_web_view |
conversion_app_opens_web_view |
The total number of times the app was opened from a website, attributed to an ad view. |
metric |
conversion_complete_tutorial |
conversion_complete_tutorial |
Total completed tutorials attributed to ad engagement. |
metric |
conversion_complete_tutorial_app |
conversion_complete_tutorial_app |
Total completed tutorials occurring in an app attributed to ad engagement. |
metric |
conversion_complete_tutorial_app_swipe_up |
conversion_complete_tutorial_app_swipe_up |
The total number of times a tutorial was completed within the app, attributed to a swipe-up action. |
metric |
conversion_complete_tutorial_app_view |
conversion_complete_tutorial_app_view |
Total completed tutorials occurring in an app attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_complete_tutorial_offline |
conversion_complete_tutorial_offline |
Total completed tutorials occurring offline attributed to ad engagement. |
metric |
conversion_complete_tutorial_offline_swipe_up |
conversion_complete_tutorial_offline_swipe_up |
The total number of times a tutorial was completed through offline events, attributed to a swipe-up action. |
metric |
conversion_complete_tutorial_offline_view |
conversion_complete_tutorial_offline_view |
Total completed tutorials occurring offline attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_complete_tutorial_swipe_up |
conversion_complete_tutorial_swipe_up |
The total number of times a tutorial was completed, attributed to a swipe-up action. |
metric |
conversion_complete_tutorial_view |
conversion_complete_tutorial_view |
Total completed tutorials attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_complete_tutorial_web |
conversion_complete_tutorial_web |
Total completed tutorials occurring on the web attributed to ad engagement. |
metric |
conversion_complete_tutorial_web_swipe_up |
conversion_complete_tutorial_web_swipe_up |
The total number of times a tutorial was completed on a website, attributed to a swipe-up action. |
metric |
conversion_complete_tutorial_web_view |
conversion_complete_tutorial_web_view |
Total completed tutorials occurring on the web attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_invite |
conversion_invite |
Total invites sent attributed to ad engagement. |
metric |
conversion_invite_app |
conversion_invite_app |
Total invites sent occurring in an app attributed to ad engagement. |
metric |
conversion_invite_app_swipe_up |
conversion_invite_app_swipe_up |
The total number of times a user was invited within the app, attributed to a swipe-up action. |
metric |
conversion_invite_app_view |
conversion_invite_app_view |
The total number of times a user was invited within the app, attributed to an ad view. |
metric |
conversion_invite_offline |
conversion_invite_offline |
Total invites sent occurring offline attributed to ad engagement. |
metric |
conversion_invite_offline_swipe_up |
conversion_invite_offline_swipe_up |
The total number of times a user was invited through offline events, attributed to a swipe-up action. |
metric |
conversion_invite_offline_view |
conversion_invite_offline_view |
The total number of times a user was invited through offline events, attributed to an ad view. |
metric |
conversion_invite_swipe_up |
conversion_invite_swipe_up |
The total number of times an invite occurred, attributed to a swipe-up action. |
metric |
conversion_invite_view |
conversion_invite_view |
The total number of times an invite occurred, attributed to an ad view. |
metric |
conversion_invite_web |
conversion_invite_web |
Total invites sent occurring on the web attributed to ad engagement. |
metric |
conversion_invite_web_swipe_up |
conversion_invite_web_swipe_up |
The total number of times a user was invited on a website, attributed to a swipe-up action. |
metric |
conversion_invite_web_view |
conversion_invite_web_view |
The total number of times a user was invited on a website, attributed to an ad view. |
metric |
conversion_level_completes |
conversion_level_completes |
Total level completions attributed to ad engagement. |
metric |
conversion_level_completes_app |
conversion_level_completes_app |
Total level completions occurring in an app attributed to ad engagement. |
metric |
conversion_level_completes_app_swipe_up |
conversion_level_completes_app_swipe_up |
The total number of times a level was completed within the app, attributed to a swipe-up action. |
metric |
conversion_level_completes_app_view |
conversion_level_completes_app_view |
The total number of times a level was completed within the app, attributed to an ad view. |
metric |
conversion_level_completes_offline |
conversion_level_completes_offline |
Total level completions occurring offline attributed to ad engagement. |
metric |
conversion_level_completes_offline_swipe_up |
conversion_level_completes_offline_swipe_up |
The total number of times a level was completed through offline events, attributed to a swipe-up action. |
metric |
conversion_level_completes_offline_view |
conversion_level_completes_offline_view |
The total number of times a level was completed through offline events, attributed to an ad view. |
metric |
conversion_level_completes_swipe_up |
conversion_level_completes_swipe_up |
The total number of times a level was completed, attributed to a swipe-up action. |
metric |
conversion_level_completes_view |
conversion_level_completes_view |
Represents the number of ‘level completes’ conversions attributed to users who viewed the ad. |
metric |
conversion_level_completes_web |
conversion_level_completes_web |
Total level completions occurring on the web attributed to ad engagement. |
metric |
conversion_level_completes_web_swipe_up |
conversion_level_completes_web_swipe_up |
The total number of times a level was completed on a website, attributed to a swipe-up action. |
metric |
conversion_level_completes_web_view |
conversion_level_completes_web_view |
The total number of times a level was completed on a website, attributed to an ad view. |
metric |
conversion_list_view |
conversion_list_view |
Total times a list was viewed attributed to ad engagement. |
metric |
conversion_list_view_app |
conversion_list_view_app |
Total times a list was viewed occurring in an app attributed to ad engagement. |
metric |
conversion_list_view_app_swipe_up |
conversion_list_view_app_swipe_up |
The total number of times a list was viewed within the app, attributed to a swipe-up action. |
metric |
conversion_list_view_app_view |
conversion_list_view_app_view |
The total number of times a list was viewed within the app, attributed to an ad view. |
metric |
conversion_list_view_offline |
conversion_list_view_offline |
Total times a list was viewed occurring offline attributed to ad engagement. |
metric |
conversion_list_view_offline_swipe_up |
conversion_list_view_offline_swipe_up |
The total number of times a list was viewed through offline events, attributed to a swipe-up action. |
metric |
conversion_list_view_offline_view |
conversion_list_view_offline_view |
The total number of times a list was viewed through offline events, attributed to an ad view. |
metric |
conversion_list_view_swipe_up |
conversion_list_view_swipe_up |
The total number of times a list was viewed, attributed to a swipe-up action. |
metric |
conversion_list_view_view |
conversion_list_view_view |
The total number of times a list was viewed, attributed to an ad view. |
metric |
conversion_list_view_web |
conversion_list_view_web |
Total times a list was viewed occurring on the web attributed to ad engagement. |
metric |
conversion_list_view_web_swipe_up |
conversion_list_view_web_swipe_up |
The total number of times a list was viewed on a website, attributed to a swipe-up action. |
metric |
conversion_list_view_web_view |
conversion_list_view_web_view |
The total number of times a list was viewed on a website, attributed to an ad view. |
metric |
conversion_login |
conversion_login |
Total logins attributed to ad engagement. |
metric |
conversion_login_app |
conversion_login_app |
Total logins occurring in an app attributed to ad engagement. |
metric |
conversion_login_app_swipe_up |
conversion_login_app_swipe_up |
The total number of times a user logged in within the app, attributed to a swipe-up action. |
metric |
conversion_login_app_view |
conversion_login_app_view |
The total number of times a user logged in within the app, attributed to an ad view. |
metric |
conversion_login_offline |
conversion_login_offline |
Total logins occurring offline attributed to ad engagement. |
metric |
conversion_login_offline_swipe_up |
conversion_login_offline_swipe_up |
The total number of times a user logged in through offline events, attributed to a swipe-up action. |
metric |
conversion_login_offline_view |
conversion_login_offline_view |
The total number of times a user logged in through offline events, attributed to an ad view. |
metric |
conversion_login_swipe_up |
conversion_login_swipe_up |
The total number of times a user logged in, attributed to a swipe-up action. |
metric |
conversion_login_view |
conversion_login_view |
The total number of times a user logged in, attributed to an ad view. |
metric |
conversion_login_web |
conversion_login_web |
The number of times a user logged in on a website, attributed to an ad campaign. |
metric |
conversion_login_web_swipe_up |
conversion_login_web_swipe_up |
The total number of times a user logged in on a website, attributed to a swipe-up action. |
metric |
conversion_login_web_view |
conversion_login_web_view |
The total number of times a user logged in on a website, attributed to an ad view. |
metric |
conversion_page_views |
conversion_page_views |
The total number of page view conversions attributed to the ad. |
metric |
conversion_page_views_app |
conversion_page_views_app |
The total number of page views within an app, attributed to an ad campaign. |
metric |
conversion_page_views_app_swipe_up |
conversion_page_views_app_swipe_up |
The total number of page views within the app, attributed to a swipe-up action. |
metric |
conversion_page_views_app_view |
conversion_page_views_app_view |
The total number of page views within the app, attributed to an ad view. |
metric |
conversion_page_views_offline |
conversion_page_views_offline |
A conversion metric for offline page views after interacting with an ad. |
metric |
conversion_page_views_offline_swipe_up |
conversion_page_views_offline_swipe_up |
The total number of page views through offline events, attributed to a swipe-up action. |
metric |
conversion_page_views_offline_view |
conversion_page_views_offline_view |
The total number of page views through offline events, attributed to an ad view. |
metric |
conversion_page_views_swipe_up |
conversion_page_views_swipe_up |
The number of page view conversions attributed to users swiping up on the ad. |
metric |
conversion_page_views_value |
conversion_page_views_value |
The monetary value generated from page view conversions. |
metric |
conversion_page_views_value_app |
conversion_page_views_value_app |
The total monetary value generated from page views within the app. |
metric |
conversion_page_views_value_offline |
conversion_page_views_value_offline |
The total monetary value generated from page views through offline events. |
metric |
conversion_page_views_value_web |
conversion_page_views_value_web |
The total monetary value generated from page views on a website. |
metric |
conversion_page_views_view |
conversion_page_views_view |
The number of page view conversions attributed to users who viewed the ad (view-through conversions). |
metric |
conversion_page_views_web |
conversion_page_views_web |
The total number of page views on a website, attributed to an ad campaign. |
metric |
conversion_page_views_web_swipe_up |
conversion_page_views_web_swipe_up |
The total number of page views on a website, attributed to a swipe-up action. |
metric |
conversion_page_views_web_view |
conversion_page_views_web_view |
The total number of page views on a website, attributed to an ad view. |
metric |
conversion_purchases |
conversion_purchases |
The total number of purchase conversions attributed to the ad. |
metric |
conversion_purchases_app |
conversion_purchases_app |
The total number of purchases made within an app, attributed to an ad campaign. |
metric |
conversion_purchases_app_swipe_up |
conversion_purchases_app_swipe_up |
The number of purchases made within an app, attributed to a swipe-up interaction with an ad. |
metric |
conversion_purchases_app_view |
conversion_purchases_app_view |
The number of purchases made within an app, attributed to viewing an ad. |
metric |
conversion_purchases_offline |
conversion_purchases_offline |
The total number of offline purchases, attributed to an ad campaign. |
metric |
conversion_purchases_offline_swipe_up |
conversion_purchases_offline_swipe_up |
The number of offline purchases, attributed to a swipe-up interaction with an ad. |
metric |
conversion_purchases_offline_view |
conversion_purchases_offline_view |
The number of offline purchases, attributed to viewing an ad. |
metric |
conversion_purchases_sk_ad_network |
conversion_purchases_sk_ad_network |
Purchase conversions attributed via Apple’s SKAdNetwork. |
metric |
conversion_purchases_sk_ad_network_total |
conversion_purchases_sk_ad_network_total |
Total purchase conversions attributed via Apple’s SKAdNetwork. |
metric |
conversion_purchases_sk_ad_network_view |
conversion_purchases_sk_ad_network_view |
The number of view-through purchase conversions attributed via Apple’s SKAdNetwork framework. |
metric |
conversion_purchases_swipe_up |
conversion_purchases_swipe_up |
The number of purchase conversions attributed to users swiping up on the ad. |
metric |
conversion_purchases_value |
conversion_purchases_value |
The monetary value generated from purchase conversions attributed to the ad. |
metric |
conversion_purchases_value_EUR |
conversion_purchases_value_EUR |
The value of purchase conversions, expressed in Euros. |
metric |
conversion_purchases_value_app |
conversion_purchases_value_app |
The total monetary value of purchases made within an app, attributed to an ad campaign. |
metric |
conversion_purchases_value_app_swipe_up |
conversion_purchases_value_app_swipe_up |
The monetary value of purchases made within an app, attributed to a swipe-up interaction with an ad. |
metric |
conversion_purchases_value_app_view |
conversion_purchases_value_app_view |
The monetary value of purchases made within an app, attributed to viewing an ad. |
metric |
conversion_purchases_value_offline |
conversion_purchases_value_offline |
The total monetary value of offline purchases, attributed to an ad campaign. |
metric |
conversion_purchases_value_offline_swipe_up |
conversion_purchases_value_offline_swipe_up |
The monetary value of offline purchases, attributed to a swipe-up interaction with an ad. |
metric |
conversion_purchases_value_offline_view |
conversion_purchases_value_offline_view |
The monetary value of offline purchases, attributed to viewing an ad. |
metric |
conversion_purchases_value_swipe_up |
conversion_purchases_value_swipe_up |
The monetary value generated from purchase conversions attributed to users swiping up on the ad. |
metric |
conversion_purchases_value_view |
conversion_purchases_value_view |
The monetary value generated from purchase conversions attributed to users who viewed the ad (view-through conversions). |
metric |
conversion_purchases_value_web |
conversion_purchases_value_web |
The total monetary value of purchases made on a website, attributed to an ad campaign. |
metric |
conversion_purchases_value_web_swipe_up |
conversion_purchases_value_web_swipe_up |
The monetary value of purchases made on a website, attributed to a swipe-up interaction with an ad. |
metric |
conversion_purchases_value_web_view |
conversion_purchases_value_web_view |
The monetary value of purchases made on a website, attributed to viewing an ad. |
metric |
conversion_purchases_view |
conversion_purchases_view |
The number of purchase conversions attributed to users who viewed the ad (view-through conversions). |
metric |
conversion_purchases_web |
conversion_purchases_web |
The total number of purchases made on a website, attributed to an ad campaign. |
metric |
conversion_purchases_web_swipe_up |
conversion_purchases_web_swipe_up |
The number of purchases made on a website, attributed to a swipe-up interaction with an ad. |
metric |
conversion_purchases_web_view |
conversion_purchases_web_view |
The number of purchases made on a website, attributed to viewing an ad. |
metric |
conversion_rate |
conversion_rate |
The rate at which ad impressions or clicks lead to a desired conversion event. |
metric |
conversion_rate_app |
conversion_rate_app |
The rate of conversions that occurred within an app, attributed to an ad campaign. |
metric |
conversion_rate_app_swipe_up |
conversion_rate_app_swipe_up |
The rate of conversions within the app, attributed to a swipe-up action. |
metric |
conversion_rate_app_view |
conversion_rate_app_view |
The rate of conversions within the app, attributed to an ad view. |
metric |
conversion_rate_offline |
conversion_rate_offline |
The rate of offline conversions, attributed to an ad campaign. |
metric |
conversion_rate_offline_swipe_up |
conversion_rate_offline_swipe_up |
The rate of conversions through offline events, attributed to a swipe-up action. |
metric |
conversion_rate_offline_view |
conversion_rate_offline_view |
The rate of conversions through offline events, attributed to an ad view. |
metric |
conversion_rate_swipe_up |
conversion_rate_swipe_up |
The rate of conversions attributed to users who swiped up on the ad. |
metric |
conversion_rate_view |
conversion_rate_view |
The rate of conversions attributed to users who viewed the ad. |
metric |
conversion_rate_web |
conversion_rate_web |
The rate of conversions that occurred on a website, attributed to an ad campaign. |
metric |
conversion_rate_web_swipe_up |
conversion_rate_web_swipe_up |
The rate of conversions on a website, attributed to a swipe-up action. |
metric |
conversion_rate_web_view |
conversion_rate_web_view |
The rate of conversions on a website, attributed to an ad view. |
metric |
conversion_reserve |
conversion_reserve |
The total number of reservation events attributed to an ad campaign. |
metric |
conversion_reserve_app |
conversion_reserve_app |
The number of reservation events that occurred within an app, attributed to an ad campaign. |
metric |
conversion_reserve_app_swipe_up |
conversion_reserve_app_swipe_up |
The total number of times a reservation occurred within the app, attributed to a swipe-up action. |
metric |
conversion_reserve_app_view |
conversion_reserve_app_view |
The total number of times a reservation occurred within the app, attributed to an ad view. |
metric |
conversion_reserve_offline |
conversion_reserve_offline |
The number of offline reservation events, attributed to an ad campaign. |
metric |
conversion_reserve_offline_swipe_up |
conversion_reserve_offline_swipe_up |
The total number of times a reservation occurred through offline events, attributed to a swipe-up action. |
metric |
conversion_reserve_offline_view |
conversion_reserve_offline_view |
The total number of times a reservation occurred through offline events, attributed to an ad view. |
metric |
conversion_reserve_swipe_up |
conversion_reserve_swipe_up |
The total number of times a reservation occurred, attributed to a swipe-up action. |
metric |
conversion_reserve_view |
conversion_reserve_view |
The total number of times a reservation occurred, attributed to an ad view. |
metric |
conversion_reserve_web |
conversion_reserve_web |
The number of reservation events that occurred on a website, attributed to an ad campaign. |
metric |
conversion_reserve_web_swipe_up |
conversion_reserve_web_swipe_up |
The total number of times a reservation occurred on a website, attributed to a swipe-up action. |
metric |
conversion_reserve_web_view |
conversion_reserve_web_view |
The total number of times a reservation occurred on a website, attributed to an ad view. |
metric |
conversion_save |
conversion_save |
The total number of ‘save’ conversions attributed to the ad. |
metric |
conversion_save_app |
conversion_save_app |
The total number of save events that occurred within an app, attributed to an ad campaign. |
metric |
conversion_save_app_swipe_up |
conversion_save_app_swipe_up |
The total number of times a save action occurred within the app, attributed to a swipe-up action. |
metric |
conversion_save_app_view |
conversion_save_app_view |
The total number of times a save action occurred within the app, attributed to an ad view. |
metric |
conversion_save_offline |
conversion_save_offline |
A conversion metric for offline saves after interacting with an ad. |
metric |
conversion_save_offline_swipe_up |
conversion_save_offline_swipe_up |
The total number of times a save action occurred through offline events, attributed to a swipe-up action. |
metric |
conversion_save_offline_view |
conversion_save_offline_view |
The total number of times a save action occurred through offline events, attributed to an ad view. |
metric |
conversion_save_swipe_up |
conversion_save_swipe_up |
The number of ‘save’ conversions attributed to users swiping up on the ad. |
metric |
conversion_save_value |
conversion_save_value |
The attributed monetary or weighted value generated from a user saving content or an item after interacting with an ad. |
metric |
conversion_save_value_app |
conversion_save_value_app |
The total monetary value generated from save actions within the app. |
metric |
conversion_save_value_offline |
conversion_save_value_offline |
The total monetary value generated from save actions through offline events. |
metric |
conversion_save_value_web |
conversion_save_value_web |
The total monetary value generated from save actions on a website. |
metric |
conversion_save_view |
conversion_save_view |
The number of ‘save’ conversions attributed to users who viewed the ad (view-through conversions). |
metric |
conversion_save_web |
conversion_save_web |
The total number of save events that occurred on a website, attributed to an ad campaign. |
metric |
conversion_save_web_swipe_up |
conversion_save_web_swipe_up |
The total number of times a save action occurred on a website, attributed to a swipe-up action. |
metric |
conversion_save_web_view |
conversion_save_web_view |
The total number of times a save action occurred on a website, attributed to an ad view. |
metric |
conversion_searches |
conversion_searches |
The total number of ‘search’ conversions attributed to the ad. |
metric |
conversion_searches_app |
conversion_searches_app |
The total number of search events that occurred within an app, attributed to an ad campaign. |
metric |
conversion_searches_app_swipe_up |
conversion_searches_app_swipe_up |
The total number of searches performed within the app, attributed to a swipe-up action. |
metric |
conversion_searches_app_view |
conversion_searches_app_view |
The total number of searches performed within the app, attributed to an ad view. |
metric |
conversion_searches_offline |
conversion_searches_offline |
A conversion metric for offline searches after interacting with an ad. |
metric |
conversion_searches_offline_swipe_up |
conversion_searches_offline_swipe_up |
The total number of searches performed through offline events, attributed to a swipe-up action. |
metric |
conversion_searches_offline_view |
conversion_searches_offline_view |
The total number of searches performed through offline events, attributed to an ad view. |
metric |
conversion_searches_swipe_up |
conversion_searches_swipe_up |
The number of ‘search’ conversions attributed to users swiping up on the ad. |
metric |
conversion_searches_value |
conversion_searches_value |
The attributed monetary or weighted value generated from a user performing a search after interacting with an ad. |
metric |
conversion_searches_value_app |
conversion_searches_value_app |
The total monetary value generated from searches performed within the app. |
metric |
conversion_searches_value_offline |
conversion_searches_value_offline |
The total monetary value generated from searches performed through offline events. |
metric |
conversion_searches_value_web |
conversion_searches_value_web |
The total monetary value generated from searches performed on a website. |
metric |
conversion_searches_view |
conversion_searches_view |
The number of ‘search’ conversions attributed to users who viewed the ad (view-through conversions). |
metric |
conversion_searches_web |
conversion_searches_web |
The total number of search events that occurred on a website, attributed to an ad campaign. |
metric |
conversion_searches_web_swipe_up |
conversion_searches_web_swipe_up |
The total number of searches performed on a website, attributed to a swipe-up action. |
metric |
conversion_searches_web_view |
conversion_searches_web_view |
The total number of searches performed on a website, attributed to an ad view. |
metric |
conversion_share |
conversion_share |
The total number of share conversions attributed to the ad. |
metric |
conversion_share_app |
conversion_share_app |
The total number of share events that occurred within an app, attributed to an ad campaign. |
metric |
conversion_share_app_swipe_up |
conversion_share_app_swipe_up |
The total number of shares that occurred within the app, attributed to a swipe-up action. |
metric |
conversion_share_app_view |
conversion_share_app_view |
The total number of shares that occurred within the app, attributed to an ad view. |
metric |
conversion_share_offline |
conversion_share_offline |
A conversion metric for offline shares after interacting with an ad. |
metric |
conversion_share_offline_swipe_up |
conversion_share_offline_swipe_up |
The total number of shares that occurred through offline events, attributed to a swipe-up action. |
metric |
conversion_share_offline_view |
conversion_share_offline_view |
The total number of shares that occurred through offline events, attributed to an ad view. |
metric |
conversion_share_swipe_up |
conversion_share_swipe_up |
The number of ‘share’ conversions attributed to users swiping up on the ad. |
metric |
conversion_share_value |
conversion_share_value |
The attributed monetary or weighted value generated from a user sharing content after interacting with an ad. |
metric |
conversion_share_value_app |
conversion_share_value_app |
The total monetary value generated from shares within the app. |
metric |
conversion_share_value_offline |
conversion_share_value_offline |
The total monetary value generated from shares through offline events. |
metric |
conversion_share_value_web |
conversion_share_value_web |
The total monetary value generated from shares on a website. |
metric |
conversion_share_view |
conversion_share_view |
Total shares of content attributed to ad views, based on the view-through attribution window. |
metric |
conversion_share_web |
conversion_share_web |
The total number of share events that occurred on a website, attributed to an ad campaign. |
metric |
conversion_share_web_swipe_up |
conversion_share_web_swipe_up |
The total number of shares that occurred on a website, attributed to a swipe-up action. |
metric |
conversion_share_web_view |
conversion_share_web_view |
The total number of shares that occurred on a website, attributed to an ad view. |
metric |
conversion_sign_ups |
conversion_sign_ups |
Total sign-ups attributed to ad engagement. |
metric |
conversion_sign_ups_app |
conversion_sign_ups_app |
The total number of sign-up events that occurred within an app, attributed to an ad campaign. |
metric |
conversion_sign_ups_app_swipe_up |
conversion_sign_ups_app_swipe_up |
The total number of sign-ups that occurred within the app, attributed to a swipe-up action. |
metric |
conversion_sign_ups_app_view |
conversion_sign_ups_app_view |
The total number of sign-ups that occurred within the app, attributed to an ad view. |
metric |
conversion_sign_ups_offline |
conversion_sign_ups_offline |
A conversion metric for offline sign-ups after interacting with an ad. |
metric |
conversion_sign_ups_offline_swipe_up |
conversion_sign_ups_offline_swipe_up |
Number of offline sign-up conversions attributed to a ‘swipe up’ (click) on the ad. |
metric |
conversion_sign_ups_offline_view |
conversion_sign_ups_offline_view |
Number of offline sign-up conversions attributed to a ‘view’ of the ad. |
metric |
conversion_sign_ups_swipe_up |
conversion_sign_ups_swipe_up |
Total sign-ups attributed specifically to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_sign_ups_value |
conversion_sign_ups_value |
The monetary value generated from sign-up conversions. |
metric |
conversion_sign_ups_value_app |
conversion_sign_ups_value_app |
The monetary value generated from sign-up conversions that occurred within the app. |
metric |
conversion_sign_ups_value_offline |
conversion_sign_ups_value_offline |
The monetary value generated from offline sign-up conversions. |
metric |
conversion_sign_ups_value_web |
conversion_sign_ups_value_web |
The monetary value generated from sign-up conversions that occurred on the website. |
metric |
conversion_sign_ups_view |
conversion_sign_ups_view |
Total sign-ups attributed specifically to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_sign_ups_web |
conversion_sign_ups_web |
The total number of sign-up events that occurred on a website, attributed to an ad campaign. |
metric |
conversion_sign_ups_web_swipe_up |
conversion_sign_ups_web_swipe_up |
Number of website sign-up conversions attributed to a ‘swipe up’ (click) on the ad. |
metric |
conversion_sign_ups_web_view |
conversion_sign_ups_web_view |
Number of website sign-up conversions attributed to a ‘view’ of the ad. |
metric |
conversion_spend_credits |
conversion_spend_credits |
A conversion metric for users who spent credits after interacting with an ad. |
metric |
conversion_spend_credits_app |
conversion_spend_credits_app |
Total number of ‘spend credits’ conversions that occurred within the app. |
metric |
conversion_spend_credits_app_swipe_up |
conversion_spend_credits_app_swipe_up |
Number of ‘spend credits’ conversions within the app attributed to a ‘swipe up’ (click) on the ad. |
metric |
conversion_spend_credits_app_view |
conversion_spend_credits_app_view |
Number of ‘spend credits’ conversions within the app attributed to a ‘view’ of the ad. |
metric |
conversion_spend_credits_offline |
conversion_spend_credits_offline |
Total number of offline ‘spend credits’ conversions. |
metric |
conversion_spend_credits_offline_swipe_up |
conversion_spend_credits_offline_swipe_up |
Number of offline ‘spend credits’ conversions attributed to a ‘swipe up’ (click) on the ad. |
metric |
conversion_spend_credits_offline_view |
conversion_spend_credits_offline_view |
Number of offline ‘spend credits’ conversions attributed to a ‘view’ of the ad. |
metric |
conversion_spend_credits_swipe_up |
conversion_spend_credits_swipe_up |
Total number of ‘spend credits’ conversions attributed to a ‘swipe up’ (click) on the ad across all sources (app, web, offline). |
metric |
conversion_spend_credits_view |
conversion_spend_credits_view |
Total number of ‘spend credits’ conversions attributed to a ‘view’ of the ad across all sources (app, web, offline). |
metric |
conversion_spend_credits_web |
conversion_spend_credits_web |
Total number of ‘spend credits’ conversions that occurred on the website. |
metric |
conversion_spend_credits_web_swipe_up |
conversion_spend_credits_web_swipe_up |
Number of ‘spend credits’ conversions on the website attributed to a ‘swipe up’ (click) on the ad. |
metric |
conversion_spend_credits_web_view |
conversion_spend_credits_web_view |
Number of ‘spend credits’ conversions on the website attributed to a ‘view’ of the ad. |
metric |
conversion_start_checkout |
conversion_start_checkout |
Total times users initiated a checkout process attributed to ad engagement. |
metric |
conversion_start_checkout_app |
conversion_start_checkout_app |
The total number of times users started the checkout process within an app, attributed to an ad campaign. |
metric |
conversion_start_checkout_app_swipe_up |
conversion_start_checkout_app_swipe_up |
The number of times users started the checkout process within an app, attributed to a swipe-up interaction with an ad. |
metric |
conversion_start_checkout_app_view |
conversion_start_checkout_app_view |
The number of times users started the checkout process within an app, attributed to viewing an ad. |
metric |
conversion_start_checkout_offline |
conversion_start_checkout_offline |
A conversion metric for users who started an offline checkout process after interacting with an ad. |
metric |
conversion_start_checkout_offline_swipe_up |
conversion_start_checkout_offline_swipe_up |
A conversion metric for users who started an offline checkout process after swiping up on an ad. |
metric |
conversion_start_checkout_offline_view |
conversion_start_checkout_offline_view |
A conversion metric for users who started an offline checkout process after viewing an ad. |
metric |
conversion_start_checkout_swipe_up |
conversion_start_checkout_swipe_up |
Total times users initiated a checkout process attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_start_checkout_value |
conversion_start_checkout_value |
The total monetary value generated from ‘start checkout’ conversions across all sources. |
metric |
conversion_start_checkout_value_app |
conversion_start_checkout_value_app |
The monetary value generated from ‘start checkout’ conversions that occurred within the app. |
metric |
conversion_start_checkout_value_offline |
conversion_start_checkout_value_offline |
The monetary value generated from offline ‘start checkout’ conversions. |
metric |
conversion_start_checkout_value_web |
conversion_start_checkout_value_web |
The monetary value generated from ‘start checkout’ conversions that occurred on the website. |
metric |
conversion_start_checkout_view |
conversion_start_checkout_view |
Total times users initiated a checkout process attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_start_checkout_web |
conversion_start_checkout_web |
The total number of times users started the checkout process on a website, attributed to an ad campaign. |
metric |
conversion_start_checkout_web_swipe_up |
conversion_start_checkout_web_swipe_up |
The number of times users started the checkout process on a website, attributed to a swipe-up interaction with an ad. |
metric |
conversion_start_checkout_web_view |
conversion_start_checkout_web_view |
The number of times users started the checkout process on a website, attributed to viewing an ad. |
metric |
conversion_start_trial |
conversion_start_trial |
A conversion metric for users who started a trial after interacting with an ad. |
metric |
conversion_start_trial_app |
conversion_start_trial_app |
A conversion metric for users who started an app trial after interacting with an ad. |
metric |
conversion_start_trial_app_swipe_up |
conversion_start_trial_app_swipe_up |
Number of ‘start trial’ conversions within the app attributed to a ‘swipe up’ (click) on the ad. |
metric |
conversion_start_trial_app_view |
conversion_start_trial_app_view |
Number of ‘start trial’ conversions within the app attributed to a ‘view’ of the ad. |
metric |
conversion_start_trial_offline |
conversion_start_trial_offline |
A conversion metric for users who started an offline trial after interacting with an ad. |
metric |
conversion_start_trial_offline_swipe_up |
conversion_start_trial_offline_swipe_up |
Number of offline ‘start trial’ conversions attributed to a ‘swipe up’ (click) on the ad. |
metric |
conversion_start_trial_offline_view |
conversion_start_trial_offline_view |
Number of offline ‘start trial’ conversions attributed to a ‘view’ of the ad. |
metric |
conversion_start_trial_swipe_up |
conversion_start_trial_swipe_up |
Represents the number of ‘start trial’ conversions attributed to users who swiped up on the ad. |
metric |
conversion_start_trial_view |
conversion_start_trial_view |
Represents the number of ‘start trial’ conversions attributed to users who viewed the ad. |
metric |
conversion_start_trial_web |
conversion_start_trial_web |
A conversion metric for users who started a web trial after interacting with an ad. |
metric |
conversion_start_trial_web_swipe_up |
conversion_start_trial_web_swipe_up |
Number of ‘start trial’ conversions on the website attributed to a ‘swipe up’ (click) on the ad. |
metric |
conversion_start_trial_web_view |
conversion_start_trial_web_view |
Number of ‘start trial’ conversions on the website attributed to a ‘view’ of the ad. |
metric |
conversion_subscribe |
conversion_subscribe |
Total subscriptions attributed to ad engagement. |
metric |
conversion_subscribe_app |
conversion_subscribe_app |
The total number of subscription events that occurred within an app, attributed to an ad campaign. |
metric |
conversion_subscribe_app_swipe_up |
conversion_subscribe_app_swipe_up |
Number of ‘subscribe’ conversions within the app attributed to a ‘swipe up’ (click) on the ad. |
metric |
conversion_subscribe_app_view |
conversion_subscribe_app_view |
Number of ‘subscribe’ conversions within the app attributed to a ‘view’ of the ad. |
metric |
conversion_subscribe_offline |
conversion_subscribe_offline |
A conversion metric for offline subscriptions after interacting with an ad. |
metric |
conversion_subscribe_offline_swipe_up |
conversion_subscribe_offline_swipe_up |
Number of offline ‘subscribe’ conversions attributed to a ‘swipe up’ (click) on the ad. |
metric |
conversion_subscribe_offline_view |
conversion_subscribe_offline_view |
Number of offline ‘subscribe’ conversions attributed to a ‘view’ of the ad. |
metric |
conversion_subscribe_swipe_up |
conversion_subscribe_swipe_up |
Total subscriptions attributed specifically to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_subscribe_value |
conversion_subscribe_value |
The attributed monetary or weighted value generated from a user subscribing after interacting with an ad. |
metric |
conversion_subscribe_value_app |
conversion_subscribe_value_app |
The monetary value generated from ‘subscribe’ conversions that occurred within the app. |
metric |
conversion_subscribe_value_offline |
conversion_subscribe_value_offline |
The monetary value generated from offline ‘subscribe’ conversions. |
metric |
conversion_subscribe_value_web |
conversion_subscribe_value_web |
The monetary value generated from ‘subscribe’ conversions that occurred on the website. |
metric |
conversion_subscribe_view |
conversion_subscribe_view |
Total subscriptions attributed specifically to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_subscribe_web |
conversion_subscribe_web |
The total number of subscription events that occurred on a website, attributed to an ad campaign. |
metric |
conversion_subscribe_web_swipe_up |
conversion_subscribe_web_swipe_up |
Number of ‘subscribe’ conversions on the website attributed to a ‘swipe up’ (click) on the ad. |
metric |
conversion_subscribe_web_view |
conversion_subscribe_web_view |
Number of ‘subscribe’ conversions on the website attributed to a ‘view’ of the ad. |
metric |
conversion_view_content |
conversion_view_content |
Total views of specific content attributed to ad engagement. |
metric |
conversion_view_content_app |
conversion_view_content_app |
The total number of content view events that occurred within an app, attributed to an ad campaign. |
metric |
conversion_view_content_app_swipe_up |
conversion_view_content_app_swipe_up |
Number of ‘view content’ conversions within the app attributed to a ‘swipe up’ (click) on the ad. |
metric |
conversion_view_content_app_view |
conversion_view_content_app_view |
Number of ‘view content’ conversions within the app attributed to a ‘view’ of the ad. |
metric |
conversion_view_content_offline |
conversion_view_content_offline |
A conversion metric for offline content views after interacting with an ad. |
metric |
conversion_view_content_offline_swipe_up |
conversion_view_content_offline_swipe_up |
Number of offline ‘view content’ conversions attributed to a ‘swipe up’ (click) on the ad. |
metric |
conversion_view_content_offline_view |
conversion_view_content_offline_view |
Number of offline ‘view content’ conversions attributed to a ‘view’ of the ad. |
metric |
conversion_view_content_swipe_up |
conversion_view_content_swipe_up |
Total views of specific content attributed specifically to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_view_content_value |
conversion_view_content_value |
The attributed monetary or weighted value generated from a user viewing specific content after interacting with an ad. |
metric |
conversion_view_content_value_app |
conversion_view_content_value_app |
The monetary value generated from ‘view content’ conversions that occurred within the app. |
metric |
conversion_view_content_value_offline |
conversion_view_content_value_offline |
The monetary value generated from offline ‘view content’ conversions. |
metric |
conversion_view_content_value_web |
conversion_view_content_value_web |
The monetary value generated from ‘view content’ conversions that occurred on the website. |
metric |
conversion_view_content_view |
conversion_view_content_view |
Total views of specific content attributed specifically to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_view_content_web |
conversion_view_content_web |
The total number of content view events that occurred on a website, attributed to an ad campaign. |
metric |
conversion_view_content_web_swipe_up |
conversion_view_content_web_swipe_up |
Number of ‘view content’ conversions on the website attributed to a ‘swipe up’ (click) on the ad. |
metric |
conversion_view_content_web_view |
conversion_view_content_web_view |
Number of ‘view content’ conversions on the website attributed to a ‘view’ of the ad. |
metric |
conversion_visit |
conversion_visit |
Attributed visit conversion events. |
metric |
conversion_visit_app |
conversion_visit_app |
The number of visit conversion events that occurred within an app. |
metric |
conversion_visit_offline |
conversion_visit_offline |
A conversion metric for offline visits after interacting with an ad. |
metric |
conversion_visit_web |
conversion_visit_web |
The number of visit conversion events that occurred on a website. |
metric |
conversion_window |
conversion_window |
The defined period of time (e.g., 7-day click, 1-day view) during which a conversion can be attributed to an ad engagement. |
dimension |
country |
country |
This field represents the geographical country where an advertising campaign is targeted, or for which performance data (like impressions and engagements) is reported. It can be used as a dimension to break down metrics. |
dimension |
created_at |
created_at |
The timestamp when the entity was created. |
dimension |
creation_state |
creation_state |
The current state of an ad entity at its creation, such as DRAFT or PENDING. |
dimension |
creative_clickthrough_url |
creative_clickthrough_url |
The URL that users are directed to when they interact with the ad creative. |
dimension |
creative_composite_properties |
creative_composite_properties |
A collection of various properties that define the complex characteristics of a creative. |
dimension |
creative_id |
creative_id |
The unique identifier for the creative asset used in an ad. |
dimension |
creative_name |
creative_name |
The name of the creative asset. |
dimension |
creative_preview_properties |
creative_preview_properties |
Properties related to how an ad creative appears in a preview, including its format and content. |
dimension |
creator_partnership_type |
creator_partnership_type |
Defines the type of partnership with a creator (e.g., Brand Partnership, Ad Partnership), impacting ad disclosure and capabilities. |
dimension |
cta_color_display_mode |
cta_color_display_mode |
Defines the color display mode for the Call-to-Action (CTA) button on a creative. |
dimension |
currency |
ad_account_currency |
The currency used for the ad account. |
dimension |
custom_conversion[{PLACEHOLDER}] |
custom_conversion[{PLACEHOLDER}] |
A dynamically named custom conversion event. |
metric |
custom_conversion_id |
custom_conversion_id |
A unique identifier for a custom conversion event, allowing for granular measurement and optimization based on specific event parameters. |
dimension |
custom_event_{NUM} |
custom_event_{NUM} |
Total occurrences of a custom conversion event, where {NUM} represents the unique ID of the custom conversion. |
metric |
custom_event_{NUM}_app |
custom_event_{NUM}_app |
The total count of a custom event (specified by {NUM}) occurring within an app, attributed to an ad campaign. |
metric |
custom_event_{NUM}_app_swipe_up |
custom_event_{NUM}_app_swipe_up |
The total number of custom event conversions (numbered by {NUM}) within the app, attributed to a ‘swipe up’ (click) on the ad. |
metric |
custom_event_{NUM}_app_view |
custom_event_{NUM}_app_view |
The total number of custom event conversions (numbered by {NUM}) within the app, attributed to a ‘view’ of the ad. |
metric |
custom_event_{NUM}_offline |
custom_event_{NUM}_offline |
A custom offline conversion event tracked after interacting with an ad, identified by a number. |
metric |
custom_event_{NUM}_offline_swipe_up |
custom_event_{NUM}_offline_swipe_up |
The total number of offline custom event conversions (numbered by {NUM}) attributed to a ‘swipe up’ (click) on the ad. |
metric |
custom_event_{NUM}_offline_view |
custom_event_{NUM}_offline_view |
The total number of offline custom event conversions (numbered by {NUM}) attributed to a ‘view’ of the ad. |
metric |
custom_event_{NUM}_swipe_up |
custom_event_{NUM}_swipe_up |
Total occurrences of a custom conversion event, where {NUM} represents the unique ID, attributed to users swiping up on an ad. |
metric |
custom_event_{NUM}_value |
custom_event_{NUM}_value |
The specific value associated with a custom conversion event, as defined by the advertiser. This allows for granular reporting and optimization by tracking additional data points beyond standard conversion metrics, such as a purchase amount or an item ID. |
metric |
custom_event_{NUM}_value_app |
custom_event_{NUM}_value_app |
The monetary value generated from custom event conversions (numbered by {NUM}) within the app. |
metric |
custom_event_{NUM}_value_offline |
custom_event_{NUM}_value_offline |
The monetary value generated from offline custom event conversions (numbered by {NUM}). |
metric |
custom_event_{NUM}_value_web |
custom_event_{NUM}_value_web |
The monetary value generated from custom event conversions (numbered by {NUM}) that occurred on the website. |
metric |
custom_event_{NUM}_view |
custom_event_{NUM}_view |
Total occurrences of a custom conversion event, where {NUM} represents the unique ID, attributed to users viewing an ad. |
metric |
custom_event_{NUM}_web |
custom_event_{NUM}_web |
The total count of a custom event (specified by {NUM}) occurring on a website, attributed to an ad campaign. |
metric |
custom_event_{NUM}_web_swipe_up |
custom_event_{NUM}_web_swipe_up |
The total number of custom event conversions (numbered by {NUM}) on the website, attributed to a ‘swipe up’ (click) on the ad. |
metric |
custom_event_{NUM}_web_view |
custom_event_{NUM}_web_view |
The total number of custom event conversions (numbered by {NUM}) on the website, attributed to a ‘view’ of the ad. |
metric |
daily_budget_micro |
daily_budget_micro |
The daily budget for a campaign, expressed in micro-currency units. |
dimension |
date |
date |
The specific date for which the data is reported. |
dimension |
day |
day |
This field represents the specific day for which performance data or insights are reported, allowing for daily granularity in analysis. |
dimension |
delivery_constraint |
delivery_constraint |
Defines the budget type for ad delivery, such as daily or lifetime budget. |
dimension |
delivery_constraint_sub_type |
delivery_constraint_sub_type |
A specific sub-type of the delivery constraint, further defining how the ad budget is managed. |
dimension |
delivery_status |
delivery_status |
The current status of an ad campaign, ad squad, or ad regarding its delivery, such as DELIVERING or PAUSED. |
dimension |
dma |
dma |
This field represents the Designated Market Area (DMA) targeted by an advertising campaign, used for audience segmentation and reporting of performance data. It is a geographical dimension. |
dimension |
dma_name |
dma_name |
The Designated Market Area (DMA) of the audience targeted in Snapchat ads. |
dimension |
earned_impressions |
earned_impressions |
Impressions generated through organic sharing or viral spread of the ad content, rather than paid placements. |
metric |
earned_reach |
earned_reach |
The number of unique users reached through organic sharing or viral spread of the ad content. |
metric |
end_time |
end_time |
The scheduled end date and time for the advertising campaign. |
dimension |
event_sources |
event_sources |
The source from which conversion events are collected, such as web (Snap Pixel) or mobile app (Snap App ID). |
dimension |
experiment_id |
experiment_id |
A unique identifier for an advertising experiment or A/B test, used to track and analyze the performance of different ad variations or strategies. |
dimension |
favorite_display_mode |
favorite_display_mode |
Controls whether users are allowed to ‘favorite’ a creative within the Snapchat app. |
dimension |
forced_view_eligibility |
forced_view_eligibility |
Indicates whether a creative is eligible to be used as a Commercial (non-skippable video ad) and defines its unskippable duration. |
dimension |
frequency |
frequency |
The average number of times a unique user saw the ad. |
metric |
funding_source_ids |
funding_source_ids |
A list of identifiers for the funding sources used for the ad account or campaign. |
dimension |
gross_impressions |
gross_impressions |
The total number of times an ad was displayed, including repeated displays to the same user. |
metric |
id |
organization_id |
The unique identifier for the ad. |
metric |
impression_goal |
impression_goal |
The target number of impressions set for an ad campaign or ad squad. |
dimension |
impressions |
impressions |
The total number of times the ad was displayed. |
metric |
interest_category_id |
interest_category_id |
The unique identifier for a target audience interest category. |
dimension |
interest_category_name |
interest_category_name |
The name of a specific interest category used for audience targeting. |
dimension |
ios_installs |
ios_installs |
The total number of app installs on iOS devices attributed to the ad. |
metric |
ios_installs_app |
ios_installs_app |
Total number of iOS app installs. |
metric |
ios_installs_app_swipe_up |
ios_installs_app_swipe_up |
Number of iOS app installs attributed to a ‘swipe up’ (click) on the ad. |
metric |
ios_installs_app_view |
ios_installs_app_view |
Number of iOS app installs attributed to a ‘view’ of the ad. |
metric |
ios_installs_offline |
ios_installs_offline |
Number of iOS app installs attributed to an offline interaction with the ad. |
metric |
ios_installs_offline_swipe_up |
ios_installs_offline_swipe_up |
Number of iOS app installs attributed to an offline ‘swipe up’ (click) on the ad. |
metric |
ios_installs_offline_view |
ios_installs_offline_view |
Number of iOS app installs attributed to an offline ‘view’ of the ad. |
metric |
ios_installs_swipe_up |
ios_installs_swipe_up |
The number of app installs on iOS devices attributed to users swiping up on the ad. |
metric |
ios_installs_view |
ios_installs_view |
The number of app installs on iOS devices attributed to users who viewed the ad (view-through conversions). |
metric |
ios_installs_web |
ios_installs_web |
Number of iOS app installs attributed to a web interaction with the ad. |
metric |
ios_installs_web_swipe_up |
ios_installs_web_swipe_up |
Number of iOS app installs attributed to a ‘swipe up’ (click) on a web ad. |
metric |
ios_installs_web_view |
ios_installs_web_view |
Number of iOS app installs attributed to a ‘view’ of a web ad. |
metric |
landing_page_views |
landing_page_views |
The total number of views for the landing page associated with an advertisement. |
metric |
lifetime_budget_micro |
lifetime_budget_micro |
The total budget allocated for the entire duration of an ad squad’s campaign, expressed in micro-units of the currency (e.g., 1,000,000 micro = 1 unit of currency). |
metric |
lifetime_spend_cap_micro |
lifetime_spend_cap_micro |
The maximum total amount that can be spent on a campaign over its entire lifespan, expressed in micro-units of the currency. |
metric |
max_reach_goal |
max_reach_goal |
The maximum target for the number of unique users an ad campaign aims to reach. |
dimension |
measured_impressions |
measured_impressions |
The number of ad impressions that were successfully measured for viewability, indicating they met industry standards for being seen. |
metric |
media_cost |
media_cost |
The expenditure associated with an advertising campaign or ad, representing the total amount spent on media placements. This is often referred to as ‘Spend’ in performance reporting. |
metric |
media_plan_id |
media_plan_id |
dimension |
|
min_reach_goal |
min_reach_goal |
The minimum target for the number of unique users an ad campaign aims to reach. |
dimension |
name |
name |
The name of the organization associated with the ad account. |
dimension |
native_leads |
native_leads |
The number of leads generated directly through Snapchat’s native lead generation forms. |
metric |
non_viewable_impressions |
non_viewable_impressions |
The number of ad impressions that did not meet the industry standards for viewability and were therefore not considered seen by a user. |
metric |
objective |
objective |
The marketing objective of the advertising campaign (e.g., app installs, brand awareness, conversions). |
dimension |
objective_v2_properties |
objective_v2_properties |
Properties and settings defining the objective of the campaign, using version 2 of the objective model. |
dimension |
operating_system |
operating_system |
The operating system of the device on which an ad is displayed, often used for ad targeting or performance breakdown. |
dimension |
optimization_goal |
ad_squad_optimization_goal |
The goal for which the ad squad is optimized, influencing bid strategy and delivery (e.g., app installs, purchases). |
dimension |
pacing_level |
pacing_level |
Indicates the organizational level at which pacing settings are applied, such as ‘CAMPAIGN’ level. |
dimension |
pacing_properties_version |
pacing_properties_version |
The version of the pacing properties applied to an advertising campaign or ad squad, which dictates how the budget is spent over a specific period. |
metric |
pacing_type |
pacing_type |
Defines how the ad spend is distributed over time for an ad campaign or ad squad. |
dimension |
packaging_status |
packaging_status |
The status of the ad’s packaging, related to its readiness or configuration. |
dimension |
paid_impressions |
paid_impressions |
Impressions generated from paid placements of the ad content. |
metric |
pixel_id |
pixel_id |
A unique identifier for the Snap Pixel, used to track web, app, and offline conversion events. |
dimension |
placement |
placement |
Specifies where an ad will be displayed on the Snapchat platform, such as in Stories, Spotlight, or between content. |
dimension |
position_impressions |
position_impressions |
The number of impressions recorded for the ad in a specific placement position. |
metric |
position_swipe_up_percent |
position_swipe_up_percent |
The percentage of impressions in a specific position that resulted in a swipe-up action. |
metric |
post_ad_preview_url |
post_ad_preview_url |
A URL that provides a preview of the ad after it has been created and posted. |
dimension |
premium_content_bundle_ids |
premium_content_bundle_ids |
Identifiers for bundles of premium content where Commercial ads are targeted to be shown. |
dimension |
preview_creative_id |
creative_preview_creative_id |
The unique identifier for a creative asset used for preview purposes. |
dimension |
primary_profile |
primary_profile |
Indicates whether the primary profile for an ad is the ‘CREATOR’ or ‘BRAND’. |
dimension |
product_properties |
product_properties |
Properties related to products, essential for Dynamic Product Ads to specify the product set from which ads dynamically pull content. |
dimension |
profile_properties |
profile_properties |
Contains details about the public profile (e.g., brand or creator) associated with a creative. |
dimension |
quartile_{NUM} |
quartile_{NUM} |
Video quartile data (e.g., 25%, 50%, 75%, 100%) for video views within the ad creative. |
metric |
reach_and_frequency_rate_micro |
reach_and_frequency_rate_micro |
The rate for reach and frequency campaigns, expressed in micro-currency units. |
dimension |
reach_and_frequency_status |
reach_and_frequency_status |
The current status of a reach and frequency ad squad, such as PENDING, ACTIVE, or FAILED. |
dimension |
reach_goal |
reach_goal |
The target number of unique users an ad campaign aims to reach. |
dimension |
region |
region |
This field indicates the geographical region targeted by an advertising campaign or for which performance data is reported. It can be used as a dimension for insights and targeting. |
dimension |
regulations |
regulations |
Specifies regulatory requirements or classifications for ads, particularly for sensitive categories like Housing, Credit, or Employment. |
dimension |
render_type |
render_type |
Specifies how the ad creative is rendered, for example, STATIC or DYNAMIC for dynamic product ads. |
dimension |
reserved_type |
reserved_type |
The type of reserved ad buy. |
dimension |
review_status |
ad_review_status |
The current review status of the ad (e.g., Pending, Approved, Rejected). |
dimension |
review_status_details |
review_status_details |
Provides detailed information about the review status of an ad, often including reasons for rejection if applicable. |
dimension |
review_status_reason |
ad_review_status_reason |
The reason provided for the current review status of an ad, if it’s not approved. |
dimension |
review_status_reasons |
review_status_reasons |
A list of reasons provided if an ad’s review status is rejected. |
dimension |
saves |
saves |
The number of times users saved the ad content. |
metric |
screen_time_millis |
screen_time_millis |
The total time, in milliseconds, that users spent on screen interacting with the ad. |
metric |
semantic_id |
semantic_id |
A unique identifier used for internal tracking or classification of creatives. |
dimension |
shareable |
shareable |
Indicates whether the creative content is shareable by users. |
dimension |
skadnetwork_properties |
skadnetwork_properties |
Properties and configurations related to Apple’s SKAdNetwork for privacy-focused app install attribution and measurement. |
dimension |
spend |
spend |
The total amount of money spent on the advertising campaign. |
metric |
spend_EUR |
spend_EUR |
The total amount spent on the ad campaign, expressed in Euros. |
metric |
start_time |
start_time |
The scheduled start date and time for the advertising campaign. |
dimension |
status |
campaign_status |
The current status of the advertising campaign (e.g., Active, Paused, Completed). |
dimension |
story_completes |
story_completes |
The number of times users watched the entire ad creative within a story format. |
metric |
story_opens |
story_opens |
The number of times a user opened the story containing the ad. |
metric |
swipe_up_percent |
swipe_up_percent |
The percentage of users who swiped up on the ad after viewing it. |
metric |
swipes |
swipes |
The total number of times users swiped up on the ad. |
metric |
takeover_slot |
takeover_slot |
dimension |
|
target_bid |
target_bid |
The target bid amount set for an ad squad, used in conjunction with bidding strategies to optimize ad delivery. |
dimension |
targeting.app_install_states |
targeting.app_install_states |
Targeting option that defines whether the intended audience has a specific app installed or not. |
dimension |
targeting.auto_expansion_options |
targeting.auto_expansion_options |
Options for automatically expanding the target audience based on factors like interests or custom audiences. |
dimension |
targeting.demographics |
targeting.demographics |
Demographic targeting parameters such as age range, gender, and language to define the audience for ads. |
dimension |
targeting.devices |
targeting.devices |
Device-specific targeting options, including operating system, device make, and connection type (e.g., Wi-Fi, cellular). |
dimension |
targeting.enable_targeting_expansion |
targeting.enable_targeting_expansion |
(Deprecated) A flag to enable or disable targeting expansion for an ad squad. This attribute is being replaced by auto_expansion_options. |
dimension |
targeting.geos |
targeting.geos |
Geographic targeting parameters, allowing advertisers to specify locations such as countries, regions, cities, or custom areas. |
dimension |
targeting.interests |
targeting.interests |
Targeting options based on user interests, behaviors, and daily activities. |
dimension |
targeting.maid_status_spec |
targeting.maid_status_spec |
Defines the specification for targeting users based on their Mobile Ad ID (MAID) status, potentially related to app install states. |
dimension |
targeting.product_audiences |
targeting.product_audiences |
Targeting options based on product audiences, used for retargeting users who have interacted with specific products or product sets. |
dimension |
targeting.regulated_content |
targeting.regulated_content |
A flag indicating whether the ad’s content is regulated (e.g., alcohol), which requires specific age and country targeting considerations. |
dimension |
targeting.segments |
targeting.segments |
Targeting based on customer list segments or other predefined audience segments. |
dimension |
targeting.separated_types |
targeting.separated_types |
Indicates if a targeting specification type has been separated into a new entity. |
dimension |
targeting_reach_status |
targeting_reach_status |
The status of the campaign’s targeting reach, indicating if the targeting configuration is valid. |
dimension |
third_party_on_swipe_tracking_urls |
third_party_on_swipe_tracking_urls |
URLs used for tracking swipe-up events by third-party vendors. |
dimension |
third_party_paid_impression_tracking_urls |
third_party_paid_impression_tracking_urls |
URLs used for tracking paid impressions by third-party vendors. |
dimension |
third_party_tracking_urls |
third_party_tracking_urls |
General URLs used for tracking various ad engagements by third-party vendors. |
dimension |
timezone |
timezone |
The timezone configured for the ad account. |
dimension |
top_snap_crop_position |
top_snap_crop_position |
Specifies the position of the cropped ad creative, particularly relevant for ‘Top Snap’ ad formats to ensure optimal display. |
dimension |
top_snap_media_id |
creative_top_snap_media_id |
The unique identifier for the primary media asset (Top Snap) used in a creative. |
dimension |
total_impressions |
total_impressions |
The cumulative total of all impressions generated by the ad. |
metric |
total_installs |
total_installs |
The overall number of app installs attributed to the ad across all device types. |
metric |
total_installs_app |
total_installs_app |
Total number of app installs across all platforms. |
metric |
total_installs_app_swipe_up |
total_installs_app_swipe_up |
Total number of app installs attributed to a ‘swipe up’ (click) on the ad. |
metric |
total_installs_app_view |
total_installs_app_view |
Total number of app installs attributed to a ‘view’ of the ad. |
metric |
total_installs_offline |
total_installs_offline |
Total number of app installs attributed to an offline interaction with the ad. |
metric |
total_installs_offline_swipe_up |
total_installs_offline_swipe_up |
Total number of app installs attributed to an offline ‘swipe up’ (click) on the ad. |
metric |
total_installs_offline_view |
total_installs_offline_view |
Total number of app installs attributed to an offline ‘view’ of the ad. |
metric |
total_installs_swipe_up |
total_installs_swipe_up |
The total number of app installs attributed to users swiping up on the ad across all device types. |
metric |
total_installs_view |
total_installs_view |
The total number of app installs attributed to users who viewed the ad (view-through conversions) across all device types. |
metric |
total_installs_web |
total_installs_web |
Total number of app installs attributed to a web interaction with the ad. |
metric |
total_installs_web_swipe_up |
total_installs_web_swipe_up |
Total number of app installs attributed to a ‘swipe up’ (click) on a web ad. |
metric |
total_installs_web_view |
total_installs_web_view |
Total number of app installs attributed to a ‘view’ of a web ad. |
metric |
total_reach |
total_reach |
The total number of unique users who saw the ad at least once. |
metric |
type |
ad_type |
The specific type of ad creative or ad format. |
dimension |
uniques |
uniques |
The total number of unique users who saw or interacted with the ad. |
metric |
unlockable_id |
unlockable_id |
dimension |
|
updated_at |
updated_at |
The timestamp when the entity was last updated. |
dimension |
utm_autofix_permission |
utm_autofix_permission |
Permission setting that enables or disables the automatic fixing or addition of UTM parameters to ad URLs. |
dimension |
video_views |
video_views |
The total number of times the video ad creative was viewed. |
metric |
video_views_15s |
video_views_15s |
The number of times the video ad creative was viewed for at least 15 seconds. |
metric |
video_views_time_based |
video_views_time_based |
Video views measured based on a specific time threshold, indicating a longer view duration. |
metric |
view_completion |
view_completion |
The percentage of users who completed viewing the ad creative. |
metric |
view_time_millis |
view_time_millis |
The total time, in milliseconds, that the ad creative was viewed. |
metric |
viewable_impressions |
viewable_impressions |
The number of ad impressions that were considered viewable according to industry standards. |
metric |
viewable_rate |
viewable_rate |
The percentage of total impressions that were considered viewable. |
metric |
web_view_properties |
web_view_properties |
Properties and configurations related to web view attachments within ads, including the URL and JavaScript SDK permissions. |
dimension |