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 |
|---|---|---|---|
Buying Currency |
Buying Currency |
The currency used for buying advertisements or for billing purposes. |
dimension |
Campaign Name |
Campaign Name |
The name of the advertising campaign on Snapchat. |
dimension |
Campaign Type |
Campaign Type |
The type or objective of the advertising campaign (e.g., app installs, brand awareness). |
dimension |
Country |
country |
The country setting configured for the targeted audience in Snapchat ads. |
dimension |
Created at |
created_at |
The timestamp when an entity (e.g., campaign, ad, invoice) was created. |
dimension |
Creative Dimensions |
Creative Dimensions |
The dimensions (e.g., width x height) of the creative asset. |
dimension |
Creative Type |
Creative Type |
The type of creative asset used in an ad (e.g., image, video, AR lens). |
dimension |
DMA |
dma |
The Designated Market Area (DMA) where the ad was shown. |
dimension |
End Date |
End Date |
The scheduled end date for a campaign or ad squad. |
dimension |
Gender |
gender |
The gender of the audience targeted in Snapchat ads. |
dimension |
Market |
Market |
The geographical market or region where an ad campaign is running or being measured. |
dimension |
Region |
region |
The geographical region where the ad was shown. |
dimension |
Site |
Site |
A high-level category referring to the website or online property where an ad conversion occurs or where the ad directs users. |
dimension |
Start Date |
Start Date |
The scheduled start date for a campaign or ad squad. |
dimension |
Updated at |
updated_at |
The timestamp when an entity (e.g., campaign, ad, invoice) was last updated. |
dimension |
Video Length |
Video Length |
The duration of a video creative in an ad. |
dimension |
actions |
actions |
Represents various user interactions or actions taken in response to an ad, contributing to engagement metrics. |
metric |
ad_product |
creative_ad_product |
The specific ad product used for the creative (e.g., Story Ad, Collection Ad). |
dimension |
ad_scheduling_config |
ad_scheduling_config |
Configuration that defines the specific dates and times when an ad campaign or ad set is active and eligible for delivery. |
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. |
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 |
Unique identifier for the organization of the advertiser. |
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 |
The name of the advertising agency managing 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 number of app installs attributed to an ad on Android devices (click-through or swipe-up attribution). |
metric |
android_installs_app_swipe_up |
android_installs_app_swipe_up |
The number of app installs attributed to a swipe-up action on an ad on Android devices. |
metric |
android_installs_app_view |
android_installs_app_view |
The number of Android app installs attributed to an in-app view of an ad. |
metric |
android_installs_offline |
android_installs_offline |
The number of offline installs attributed to an ad on Android devices (click-through or swipe-up attribution). |
metric |
android_installs_offline_swipe_up |
android_installs_offline_swipe_up |
The number of offline installs attributed to a swipe-up action on an ad on Android devices. |
metric |
android_installs_offline_view |
android_installs_offline_view |
The number of Android app installs attributed to an offline view of an ad. |
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 number of web-based installs attributed to an ad on Android devices (click-through or swipe-up attribution). |
metric |
android_installs_web_swipe_up |
android_installs_web_swipe_up |
The number of web-based installs attributed to a swipe-up action on an ad on Android devices. |
metric |
android_installs_web_view |
android_installs_web_view |
The number of Android app installs attributed to a web view of an ad. |
metric |
app_install_properties |
app_install_properties |
Specific settings and configurations for campaigns designed with the primary objective of driving mobile application installs. |
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 |
Indicates whether the ad set uses an automatic bidding strategy. |
dimension |
auto_bid_max_bid_micro |
auto_bid_max_bid_micro |
The maximum bid set for an ad squad when using an automated bidding strategy, expressed in micro-units of the ad account’s currency. |
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 |
ad_squad_bid |
The bid amount for the ad squad, expressed in micro-currency units (1 local currency unit = 1,000,000 micro-currency). |
metric |
bid_strategy |
ad_squad_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 |
An identifier for the billing center associated with an ad account or campaign. |
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 |
The method of billing used for the advertising account (e.g., credit card, invoice). |
dimension |
brand |
brand |
The brand name associated with the ad campaign. |
dimension |
brand_safety_config |
brand_safety_config |
Settings to ensure ads are displayed in environments that align with brand values and avoid inappropriate content categories or placements. |
dimension |
buy_model |
buy_model |
The pricing model used for purchasing ad inventory, such as cost-per-impression (CPM), cost-per-click (CPC), or cost-per-install (CPI). |
dimension |
buying_type |
buying_type |
The purchasing model for an advertising campaign, such as auction or guaranteed delivery. |
dimension |
call_to_action |
creative_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 that control how the overall campaign budget is automatically allocated and optimized across ad sets or ads to maximize performance. |
dimension |
cap_and_exclusion_config |
cap_and_exclusion_config |
Configuration for setting limits on ad exposure to individual users (frequency capping) and excluding specific audiences, demographics, or placements. |
dimension |
clicks |
clicks |
The total number of clicks on an advertisement. |
metric |
client_paying_invoices |
client_paying_invoices |
A flag indicating whether the client is directly responsible for settling the invoices related to the advertising spend. |
dimension |
composite_properties |
composite_properties |
Properties associated with composite creative types, such as Story Ads, typically containing a list of creative IDs that make up the composite ad. |
dimension |
conversion_achievement_unlocked |
conversion_achievement_unlocked |
Total achievement unlocks attributed to ad engagement. |
metric |
conversion_achievement_unlocked_app |
conversion_achievement_unlocked_app |
Total achievement unlocks occurring in an app attributed to ad engagement. |
metric |
conversion_achievement_unlocked_app_swipe_up |
conversion_achievement_unlocked_app_swipe_up |
Total achievement unlocks occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_achievement_unlocked_app_view |
conversion_achievement_unlocked_app_view |
Total achievement unlocks occurring in an app attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_achievement_unlocked_offline |
conversion_achievement_unlocked_offline |
Total achievement unlocks occurring offline attributed to ad engagement. |
metric |
conversion_achievement_unlocked_offline_swipe_up |
conversion_achievement_unlocked_offline_swipe_up |
Total achievement unlocks occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_achievement_unlocked_offline_view |
conversion_achievement_unlocked_offline_view |
Total achievement unlocks occurring offline attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_achievement_unlocked_swipe_up |
conversion_achievement_unlocked_swipe_up |
Total achievement unlocks attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_achievement_unlocked_view |
conversion_achievement_unlocked_view |
Total achievement unlocks attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_achievement_unlocked_web |
conversion_achievement_unlocked_web |
Total achievement unlocks occurring on the web attributed to ad engagement. |
metric |
conversion_achievement_unlocked_web_swipe_up |
conversion_achievement_unlocked_web_swipe_up |
Total achievement unlocks occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_achievement_unlocked_web_view |
conversion_achievement_unlocked_web_view |
Total achievement unlocks occurring on the web attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total ad clicks occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_ad_click_app_view |
conversion_ad_click_app_view |
Total ad clicks occurring in an app attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total ad clicks occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_ad_click_offline_view |
conversion_ad_click_offline_view |
Total ad clicks occurring offline attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_ad_click_sk_ad_network |
conversion_ad_click_sk_ad_network |
The count of ad click conversions attributed via SKAdNetwork. |
metric |
conversion_ad_click_sk_ad_network_total |
conversion_ad_click_sk_ad_network_total |
The total count of ad click conversions reported via SKAdNetwork, encompassing both view-through and click-through attributions. |
metric |
conversion_ad_click_sk_ad_network_view |
conversion_ad_click_sk_ad_network_view |
The count of ad click conversions attributed via SKAdNetwork specifically for view-through attributions. |
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 |
Total ad clicks occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_ad_click_web_view |
conversion_ad_click_web_view |
Total ad clicks occurring on the web attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total ad views occurring in an app. |
metric |
conversion_ad_view_app_swipe_up |
conversion_ad_view_app_swipe_up |
Total ad views occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_ad_view_app_view |
conversion_ad_view_app_view |
Total ad views occurring in an app attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_ad_view_offline |
conversion_ad_view_offline |
Total ad views occurring offline. |
metric |
conversion_ad_view_offline_swipe_up |
conversion_ad_view_offline_swipe_up |
Total ad views occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_ad_view_offline_view |
conversion_ad_view_offline_view |
Total ad views occurring offline attributed to users viewing an ad, based on the view-through attribution window. |
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 attributed monetary or weighted value generated from a user viewing an ad within an app. |
metric |
conversion_ad_view_value_offline |
conversion_ad_view_value_offline |
The attributed monetary or weighted value generated from a user viewing an ad, with the conversion occurring offline. |
metric |
conversion_ad_view_value_web |
conversion_ad_view_value_web |
The attributed monetary or weighted value generated from a user viewing an ad on the web. |
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 |
Total ad views occurring on the web. |
metric |
conversion_ad_view_web_swipe_up |
conversion_ad_view_web_swipe_up |
Total ad views occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_ad_view_web_view |
conversion_ad_view_web_view |
Total ad views occurring on the web attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total billing information additions occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_add_billing_app_view |
conversion_add_billing_app_view |
Total billing information additions occurring in an app attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total billing information additions occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_add_billing_offline_view |
conversion_add_billing_offline_view |
Total billing information additions occurring offline attributed to users viewing an ad, based on the view-through attribution window. |
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 attributed monetary or weighted value generated from a user adding billing information after interacting with an ad. |
metric |
conversion_add_billing_value_app |
conversion_add_billing_value_app |
The attributed monetary or weighted value generated from a user adding billing information within an app after interacting with an ad. |
metric |
conversion_add_billing_value_offline |
conversion_add_billing_value_offline |
The attributed monetary or weighted value generated from a user adding billing information offline after interacting with an ad. |
metric |
conversion_add_billing_value_web |
conversion_add_billing_value_web |
The attributed monetary or weighted value generated from a user adding billing information on the web after interacting with an ad. |
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 |
Total billing information additions occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_add_billing_web_view |
conversion_add_billing_web_view |
Total billing information additions occurring on the web attributed to users viewing an ad, based on the view-through attribution window. |
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_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 attributed monetary or weighted value generated from a user adding an item to their cart within an app after interacting with an ad. |
metric |
conversion_add_cart_value_offline |
conversion_add_cart_value_offline |
The attributed monetary or weighted value generated from a user adding an item to their cart offline after interacting with an ad. |
metric |
conversion_add_cart_value_web |
conversion_add_cart_value_web |
The attributed monetary or weighted value generated from a user adding an item to their cart on the web after interacting with an ad. |
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 |
Total additions to wishlist occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_add_to_wishlist_app_view |
conversion_add_to_wishlist_app_view |
Total additions to wishlist occurring in an app attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total additions to wishlist occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_add_to_wishlist_offline_view |
conversion_add_to_wishlist_offline_view |
Total additions to wishlist occurring offline attributed to users viewing an ad, based on the view-through attribution window. |
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 |
The attributed monetary or weighted value generated from a user adding an item to a wishlist after interacting with an ad. |
metric |
conversion_add_to_wishlist_value_app |
conversion_add_to_wishlist_value_app |
The attributed monetary or weighted value generated from a user adding an item to a wishlist within an app after interacting with an ad. |
metric |
conversion_add_to_wishlist_value_offline |
conversion_add_to_wishlist_value_offline |
The attributed monetary or weighted value generated from a user adding an item to a wishlist offline after interacting with an ad. |
metric |
conversion_add_to_wishlist_value_web |
conversion_add_to_wishlist_value_web |
The attributed monetary or weighted value generated from a user adding an item to a wishlist on the web after interacting with an ad. |
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 |
Total additions to wishlist occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_add_to_wishlist_web_view |
conversion_add_to_wishlist_web_view |
Total additions to wishlist occurring on the web attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total app opens occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_app_opens_app_view |
conversion_app_opens_app_view |
Total app opens occurring in an app attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total app opens occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_app_opens_offline_view |
conversion_app_opens_offline_view |
Total app opens occurring offline attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total app opens occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_app_opens_web_view |
conversion_app_opens_web_view |
Total app opens occurring on the web attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total completed tutorials occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window. |
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 |
Total completed tutorials occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window. |
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 |
Total completed tutorials attributed to users swiping up on an ad, based on the swipe-up attribution window. |
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 |
Total completed tutorials occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window. |
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 |
Total invites sent occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_invite_app_view |
conversion_invite_app_view |
Total invites sent occurring in an app attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total invites sent occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_invite_offline_view |
conversion_invite_offline_view |
Total invites sent occurring offline attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_invite_swipe_up |
conversion_invite_swipe_up |
Total invites sent attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_invite_view |
conversion_invite_view |
Total invites sent attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total invites sent occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_invite_web_view |
conversion_invite_web_view |
Total invites sent occurring on the web attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_ios_installs_sk_ad_network |
conversion_ios_installs_sk_ad_network |
The number of iOS app installs attributed via Apple’s SKAdNetwork framework. |
metric |
conversion_ios_installs_sk_ad_network_total |
conversion_ios_installs_sk_ad_network_total |
The total number of iOS app installs attributed via Apple’s SKAdNetwork framework, aggregated from all sources. |
metric |
conversion_ios_installs_sk_ad_network_view |
conversion_ios_installs_sk_ad_network_view |
The number of iOS app installs attributed via Apple’s SKAdNetwork framework that originated from a view-through attribution model. |
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 |
Total level completions occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_level_completes_app_view |
conversion_level_completes_app_view |
Total level completions occurring in an app attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total level completions occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_level_completes_offline_view |
conversion_level_completes_offline_view |
Total level completions occurring offline attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_level_completes_swipe_up |
conversion_level_completes_swipe_up |
Total level completions attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_level_completes_view |
conversion_level_completes_view |
Total level completions attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total level completions occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_level_completes_web_view |
conversion_level_completes_web_view |
Total level completions occurring on the web attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total times a list was viewed occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_list_view_app_view |
conversion_list_view_app_view |
Total times a list was viewed occurring in an app attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total times a list was viewed occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_list_view_offline_view |
conversion_list_view_offline_view |
Total times a list was viewed occurring offline attributed to users viewing an ad, based on the view-through attribution window. |
metric |
conversion_list_view_swipe_up |
conversion_list_view_swipe_up |
Total times a list was viewed attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_list_view_view |
conversion_list_view_view |
Total times a list was viewed attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total times a list was viewed occurring on the web attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_list_view_web_view |
conversion_list_view_web_view |
Total times a list was viewed occurring on the web attributed to users viewing an ad, based on the view-through attribution window. |
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 |
Total logins occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window. |
metric |
conversion_login_app_view |
conversion_login_app_view |
Total logins occurring in an app attributed to users viewing an ad, based on the view-through attribution window. |
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 number of times a user logged in offline, attributed to a swipe-up interaction with an ad. |
metric |
conversion_login_offline_view |
conversion_login_offline_view |
The number of times a user logged in offline, attributed to viewing an ad. |
metric |
conversion_login_swipe_up |
conversion_login_swipe_up |
A conversion metric for users who logged in after swiping up on an ad. |
metric |
conversion_login_view |
conversion_login_view |
A conversion metric for users who logged in after viewing an ad. |
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 number of times a user logged in on a website, attributed to a swipe-up interaction with an ad. |
metric |
conversion_login_web_view |
conversion_login_web_view |
The number of times a user logged in on a website, attributed to viewing an ad. |
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 number of page views within an app, attributed to a swipe-up interaction with an ad. |
metric |
conversion_page_views_app_view |
conversion_page_views_app_view |
The number of page views within an app, attributed to viewing an ad. |
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 |
A conversion metric for offline page views after swiping up on an ad. |
metric |
conversion_page_views_offline_view |
conversion_page_views_offline_view |
A conversion metric for offline page views after viewing an ad. |
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 attributed monetary or weighted value generated from a user viewing a page within an app after interacting with an ad. |
metric |
conversion_page_views_value_offline |
conversion_page_views_value_offline |
The attributed monetary or weighted value generated from a user viewing a page offline after interacting with an ad. |
metric |
conversion_page_views_value_web |
conversion_page_views_value_web |
The attributed monetary or weighted value generated from a user viewing a page on the web after interacting with an ad. |
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 number of page views on a website, attributed to a swipe-up interaction with an ad. |
metric |
conversion_page_views_web_view |
conversion_page_views_web_view |
The number of page views on a website, attributed to viewing an ad. |
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_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_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 an app, attributed to a swipe-up interaction with an ad. |
metric |
conversion_rate_app_view |
conversion_rate_app_view |
The rate of conversions within an app, attributed to viewing an ad. |
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 offline conversions, attributed to a swipe-up interaction with an ad. |
metric |
conversion_rate_offline_view |
conversion_rate_offline_view |
The rate of offline conversions, attributed to viewing an ad. |
metric |
conversion_rate_swipe_up |
conversion_rate_swipe_up |
The conversion rate specifically for actions initiated by a swipe-up gesture on the ad. |
metric |
conversion_rate_view |
conversion_rate_view |
The conversion rate specifically for view-through conversions (users who saw the ad and later converted). |
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 interaction with an ad. |
metric |
conversion_rate_web_view |
conversion_rate_web_view |
The rate of conversions on a website, attributed to viewing an ad. |
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 number of reservation events within an app, attributed to a swipe-up interaction with an ad. |
metric |
conversion_reserve_app_view |
conversion_reserve_app_view |
The number of reservation events within an app, attributed to viewing an ad. |
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 number of offline reservation events, attributed to a swipe-up interaction with an ad. |
metric |
conversion_reserve_offline_view |
conversion_reserve_offline_view |
The number of offline reservation events, attributed to viewing an ad. |
metric |
conversion_reserve_swipe_up |
conversion_reserve_swipe_up |
A conversion metric for users who made a reservation after swiping up on an ad. |
metric |
conversion_reserve_view |
conversion_reserve_view |
A conversion metric for users who made a reservation after viewing an ad. |
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 number of reservation events on a website, attributed to a swipe-up interaction with an ad. |
metric |
conversion_reserve_web_view |
conversion_reserve_web_view |
The number of reservation events on a website, attributed to viewing an ad. |
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 number of save events within an app, attributed to a swipe-up interaction with an ad. |
metric |
conversion_save_app_view |
conversion_save_app_view |
The number of save events within an app, attributed to viewing an ad. |
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 |
A conversion metric for offline saves after swiping up on an ad. |
metric |
conversion_save_offline_view |
conversion_save_offline_view |
A conversion metric for offline saves after viewing an ad. |
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 attributed monetary or weighted value generated from a user saving content or an item within an app after interacting with an ad. |
metric |
conversion_save_value_offline |
conversion_save_value_offline |
The attributed monetary or weighted value generated from a user saving content or an item offline after interacting with an ad. |
metric |
conversion_save_value_web |
conversion_save_value_web |
The attributed monetary or weighted value generated from a user saving content or an item on the web after interacting with an ad. |
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 number of save events on a website, attributed to a swipe-up interaction with an ad. |
metric |
conversion_save_web_view |
conversion_save_web_view |
The number of save events on a website, attributed to viewing an ad. |
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 number of search events within an app, attributed to a swipe-up interaction with an ad. |
metric |
conversion_searches_app_view |
conversion_searches_app_view |
The number of search events within an app, attributed to viewing an ad. |
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 |
A conversion metric for offline searches after swiping up on an ad. |
metric |
conversion_searches_offline_view |
conversion_searches_offline_view |
A conversion metric for offline searches after viewing an ad. |
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 attributed monetary or weighted value generated from a user performing a search within an app after interacting with an ad. |
metric |
conversion_searches_value_offline |
conversion_searches_value_offline |
The attributed monetary or weighted value generated from a user performing a search offline after interacting with an ad. |
metric |
conversion_searches_value_web |
conversion_searches_value_web |
The attributed monetary or weighted value generated from a user performing a search on the web after interacting with an ad. |
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 number of search events on a website, attributed to a swipe-up interaction with an ad. |
metric |
conversion_searches_web_view |
conversion_searches_web_view |
The number of search events on a website, attributed to viewing an ad. |
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 number of share events within an app, attributed to a swipe-up interaction with an ad. |
metric |
conversion_share_app_view |
conversion_share_app_view |
The number of share events within an app, attributed to viewing an ad. |
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 |
A conversion metric for offline shares after swiping up on an ad. |
metric |
conversion_share_offline_view |
conversion_share_offline_view |
A conversion metric for offline shares after viewing an ad. |
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 attributed monetary or weighted value generated from a user sharing content within an app after interacting with an ad. |
metric |
conversion_share_value_offline |
conversion_share_value_offline |
The attributed monetary or weighted value generated from a user sharing content offline after interacting with an ad. |
metric |
conversion_share_value_web |
conversion_share_value_web |
The attributed monetary or weighted value generated from a user sharing content on the web after interacting with an ad. |
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 number of share events on a website, attributed to a swipe-up interaction with an ad. |
metric |
conversion_share_web_view |
conversion_share_web_view |
The number of share events on a website, attributed to viewing an ad. |
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 number of sign-up events within an app, attributed to a swipe-up interaction with an ad. |
metric |
conversion_sign_ups_app_view |
conversion_sign_ups_app_view |
The number of sign-up events within an app, attributed to viewing an ad. |
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 |
A conversion metric for offline sign-ups after swiping up on an ad. |
metric |
conversion_sign_ups_offline_view |
conversion_sign_ups_offline_view |
A conversion metric for offline sign-ups after viewing an 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 attributed monetary or weighted value generated from a user completing a sign-up within an app after interacting with an ad. |
metric |
conversion_sign_ups_value_offline |
conversion_sign_ups_value_offline |
The attributed monetary or weighted value generated from a user completing a sign-up offline after interacting with an ad. |
metric |
conversion_sign_ups_value_web |
conversion_sign_ups_value_web |
The attributed monetary or weighted value generated from a user completing a sign-up on the web after interacting with an ad. |
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 |
The number of sign-up events on a website, attributed to a swipe-up interaction with an ad. |
metric |
conversion_sign_ups_web_view |
conversion_sign_ups_web_view |
The number of sign-up events on a website, attributed to viewing an 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 |
A conversion metric for users who spent credits within an app after interacting with an ad. |
metric |
conversion_spend_credits_app_swipe_up |
conversion_spend_credits_app_swipe_up |
A conversion metric for users who spent credits within an app after swiping up on an ad. |
metric |
conversion_spend_credits_app_view |
conversion_spend_credits_app_view |
A conversion metric for users who spent credits within an app after viewing an ad. |
metric |
conversion_spend_credits_offline |
conversion_spend_credits_offline |
A conversion metric for users who spent credits offline after interacting with an ad. |
metric |
conversion_spend_credits_offline_swipe_up |
conversion_spend_credits_offline_swipe_up |
A conversion metric for users who spent credits offline after swiping up on an ad. |
metric |
conversion_spend_credits_offline_view |
conversion_spend_credits_offline_view |
A conversion metric for users who spent credits offline after viewing an ad. |
metric |
conversion_spend_credits_swipe_up |
conversion_spend_credits_swipe_up |
A conversion metric for users who spent credits after swiping up on an ad. |
metric |
conversion_spend_credits_view |
conversion_spend_credits_view |
A conversion metric for users who spent credits after viewing an ad. |
metric |
conversion_spend_credits_web |
conversion_spend_credits_web |
A conversion metric for users who spent credits on a website after interacting with an ad. |
metric |
conversion_spend_credits_web_swipe_up |
conversion_spend_credits_web_swipe_up |
A conversion metric for users who spent credits on a website after swiping up on an ad. |
metric |
conversion_spend_credits_web_view |
conversion_spend_credits_web_view |
A conversion metric for users who spent credits on a website after viewing an 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 attributed monetary or weighted value generated from a user initiating a checkout process after interacting with an ad. |
metric |
conversion_start_checkout_value_app |
conversion_start_checkout_value_app |
The attributed monetary or weighted value generated from a user initiating a checkout process within an app after interacting with an ad. |
metric |
conversion_start_checkout_value_offline |
conversion_start_checkout_value_offline |
The attributed monetary or weighted value generated from a user initiating a checkout process offline after interacting with an ad. |
metric |
conversion_start_checkout_value_web |
conversion_start_checkout_value_web |
The attributed monetary or weighted value generated from a user initiating a checkout process on the web after interacting with an ad. |
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 |
A conversion metric for users who started an app trial after swiping up on an ad. |
metric |
conversion_start_trial_app_view |
conversion_start_trial_app_view |
A conversion metric for users who started an app trial after viewing an 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 |
A conversion metric for users who started an offline trial after swiping up on an ad. |
metric |
conversion_start_trial_offline_view |
conversion_start_trial_offline_view |
A conversion metric for users who started an offline trial after viewing an ad. |
metric |
conversion_start_trial_swipe_up |
conversion_start_trial_swipe_up |
A conversion metric for users who started a trial after swiping up on an ad. |
metric |
conversion_start_trial_view |
conversion_start_trial_view |
A conversion metric for users who started a trial after viewing an 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 |
A conversion metric for users who started a web trial after swiping up on an ad. |
metric |
conversion_start_trial_web_view |
conversion_start_trial_web_view |
A conversion metric for users who started a web trial after viewing an 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 |
The number of subscription events within an app, attributed to a swipe-up interaction with an ad. |
metric |
conversion_subscribe_app_view |
conversion_subscribe_app_view |
The number of subscription events within an app, attributed to viewing an 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 |
A conversion metric for offline subscriptions after swiping up on an ad. |
metric |
conversion_subscribe_offline_view |
conversion_subscribe_offline_view |
A conversion metric for offline subscriptions after viewing an 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 attributed monetary or weighted value generated from a user subscribing within an app after interacting with an ad. |
metric |
conversion_subscribe_value_offline |
conversion_subscribe_value_offline |
The attributed monetary or weighted value generated from a user subscribing offline after interacting with an ad. |
metric |
conversion_subscribe_value_web |
conversion_subscribe_value_web |
The attributed monetary or weighted value generated from a user subscribing on the web after interacting with an ad. |
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 |
The number of subscription events on a website, attributed to a swipe-up interaction with an ad. |
metric |
conversion_subscribe_web_view |
conversion_subscribe_web_view |
The number of subscription events on a website, attributed to viewing an ad. |
metric |
conversion_total_installs_sk_ad_network |
conversion_total_installs_sk_ad_network |
The total number of app installs across all operating systems attributed via SKAdNetwork, without specifying view-through or click-through. |
metric |
conversion_total_installs_sk_ad_network_total |
conversion_total_installs_sk_ad_network_total |
The overall total number of app installs across all operating systems attributed via SKAdNetwork, combining all attribution methods. |
metric |
conversion_total_installs_sk_ad_network_view |
conversion_total_installs_sk_ad_network_view |
The total number of app installs attributed via Apple’s SKAdNetwork after an ad view. |
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 |
The number of content view events within an app, attributed to a swipe-up interaction with an ad. |
metric |
conversion_view_content_app_view |
conversion_view_content_app_view |
The number of content view events within an app, attributed to viewing an 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 |
A conversion metric for offline content views after swiping up on an ad. |
metric |
conversion_view_content_offline_view |
conversion_view_content_offline_view |
A conversion metric for offline content views after viewing an 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 attributed monetary or weighted value generated from a user viewing specific content within an app after interacting with an ad. |
metric |
conversion_view_content_value_offline |
conversion_view_content_value_offline |
The attributed monetary or weighted value generated from a user viewing specific content offline after interacting with an ad. |
metric |
conversion_view_content_value_web |
conversion_view_content_value_web |
The attributed monetary or weighted value generated from a user viewing specific content on the web after interacting with an ad. |
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 |
The number of content view events on a website, attributed to a swipe-up interaction with an ad. |
metric |
conversion_view_content_web_view |
conversion_view_content_web_view |
The number of content view events on a website, attributed to viewing an 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 time period following an ad interaction (view or click) during which a conversion event is attributed to that ad. |
dimension |
conversion_{NUM}_app |
conversion_{NUM}_app |
A custom conversion event, where {NUM} represents the unique ID, occurring in an app. |
metric |
conversion_{NUM}_offline |
conversion_{NUM}_offline |
A custom conversion event, where {NUM} represents the unique ID, occurring offline. |
metric |
conversion_{NUM}_web |
conversion_{NUM}_web |
A custom conversion event, where {NUM} represents the unique ID, occurring on the web. |
metric |
creation_state |
creation_state |
The current state of an ad, ad squad, or campaign, such as ‘DRAFT’, ‘ACTIVE’, or ‘PAUSED’. |
dimension |
creative |
creative |
The unique identifier or name of the creative asset used in an ad. |
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_duration |
creative_duration |
The playback duration of the creative content in an ad. |
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 |
The type of partnership with a content creator if the ad involves sponsored or collaborative content. |
dimension |
cta_color_display_mode |
cta_color_display_mode |
The display mode or color scheme applied to the call-to-action button of a creative. |
dimension |
currency |
ad_account_currency |
The currency used for the ad account. |
dimension |
custom_conversion[{PLACEHOLDER}] |
custom_conversion[{PLACEHOLDER}] |
A custom conversion event defined by the advertiser, where ‘PLACEHOLDER’ represents the specific custom event name or ID. |
metric |
custom_conversion_full_name |
custom_conversion_full_name |
The complete, user-defined name for a custom conversion event, as configured in Snapchat Ads Manager or via the API. Custom conversions track specific user actions that are valuable to an advertiser. |
dimension |
custom_conversion_id |
custom_conversion_id |
A unique identifier assigned to a custom conversion event. This ID is used to track and report on specific user actions defined by the advertiser. |
dimension |
custom_conversion_name |
custom_conversion_name |
The user-defined name assigned to a custom conversion event within Snapchat Ads Manager or via the API. This name is used for identification, granular measurement, and reporting of specific user actions. |
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 count of a custom event (specified by {NUM}) occurring within an app, attributed to a swipe-up interaction with an ad. |
metric |
custom_event_{NUM}_app_view |
custom_event_{NUM}_app_view |
The count of a custom event (specified by {NUM}) occurring within an app, attributed to viewing an 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 |
A custom offline conversion event tracked after swiping up on an ad, identified by a number. |
metric |
custom_event_{NUM}_offline_view |
custom_event_{NUM}_offline_view |
A custom offline conversion event tracked after viewing an ad, identified by a number. |
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 total value generated from a specific custom conversion event, identified by ‘{NUM}’, across all platforms. |
metric |
custom_event_{NUM}_value_app |
custom_event_{NUM}_value_app |
The attributed monetary or weighted value generated from a specific custom event (identified by {NUM}) occurring within an app after interacting with an ad. |
metric |
custom_event_{NUM}_value_offline |
custom_event_{NUM}_value_offline |
The attributed monetary or weighted value generated from a specific custom event (identified by {NUM}) occurring offline after interacting with an ad. |
metric |
custom_event_{NUM}_value_web |
custom_event_{NUM}_value_web |
The attributed monetary or weighted value generated from a specific custom event (identified by {NUM}) occurring on the web after interacting with an ad. |
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 count of a custom event (specified by {NUM}) occurring on a website, attributed to a swipe-up interaction with an ad. |
metric |
custom_event_{NUM}_web_view |
custom_event_{NUM}_web_view |
The count of a custom event (specified by {NUM}) occurring on a website, attributed to viewing an ad. |
metric |
daily_budget_micro |
campaign_daily_budget_micro |
The daily budget for a campaign, expressed in micro-currency units. |
metric |
data_currency |
data_currency |
The currency in which the reporting data is presented. |
dimension |
date |
date |
The specific date for which the data is reported. |
dimension |
delivery_constraint |
delivery_constraint |
Determines how an ad campaign’s budget is spent over its duration. Common options include ‘Standard Delivery’ (ads paced throughout the flight dates) and ‘Accelerated Delivery’ (budget spent as quickly as possible). |
dimension |
delivery_constraint_sub_type |
delivery_constraint_sub_type |
A specific classification or category of a delivery constraint, detailing the exact nature of the limitation applied to how an ad campaign is delivered, such as daily or lifetime budget limits. |
dimension |
delivery_status |
delivery_status |
The current status of an ad’s delivery, indicating if it’s active, paused, or completed. |
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 |
ad_squad_end_time |
The scheduled end date and time for the advertising campaign. |
dimension |
experiment_id |
experiment_id |
The unique identifier for an A/B test or other experiment being conducted on an ad campaign. |
dimension |
favorite_display_mode |
favorite_display_mode |
Determines whether users can favorite a creative within the Snapchat app, with options to show or hide the favorite functionality. |
dimension |
forced_view_eligibility |
forced_view_eligibility |
Indicates if a creative is eligible to be used as an unskippable commercial and for what duration (e.g., full duration or six seconds). |
dimension |
format_size |
format_size |
The size specifications of the ad format. |
dimension |
format_type |
format_type |
The type of ad format (e.g., Single Image or Video, Collection Ad). |
dimension |
frequency |
frequency |
The average number of times a unique user saw the ad. |
metric |
funding |
funding |
Information pertaining to the financial funding sources for advertising campaigns. |
dimension |
funding_source_ids |
funding_source_ids |
A list of identifiers for the financial sources used to fund an ad campaign. |
dimension |
gross_impressions |
gross_impressions |
The total number of times an ad was displayed, including repeated displays to the same user. |
metric |
id |
id |
The unique identifier for the ad. |
dimension |
impression_goal |
impression_goal |
The target number of impressions set for the campaign. |
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 |
The number of app installs attributed to an ad on iOS devices (click-through or swipe-up attribution). |
metric |
ios_installs_app_swipe_up |
ios_installs_app_swipe_up |
The number of app installs attributed to a swipe-up action on an ad on iOS devices. |
metric |
ios_installs_app_view |
ios_installs_app_view |
The number of app installs attributed to an ad on iOS devices, where the install occurred after a user viewed the ad (view-through attribution). |
metric |
ios_installs_offline |
ios_installs_offline |
The number of offline installs attributed to an ad on iOS devices (click-through or swipe-up attribution). |
metric |
ios_installs_offline_swipe_up |
ios_installs_offline_swipe_up |
The number of offline installs attributed to a swipe-up action on an ad on iOS devices. |
metric |
ios_installs_offline_view |
ios_installs_offline_view |
The number of offline installs attributed to an ad on iOS devices, where the install occurred after a user viewed the ad (view-through attribution). Offline installs refer to conversions that happen outside the app or web environment. |
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 |
The number of web-based installs attributed to an ad on iOS devices (click-through or swipe-up attribution). |
metric |
ios_installs_web_swipe_up |
ios_installs_web_swipe_up |
The number of web-based installs attributed to a swipe-up action on an ad on iOS devices. |
metric |
ios_installs_web_view |
ios_installs_web_view |
The number of web-based installs attributed to an ad on iOS devices, where the install occurred after a user viewed the ad (view-through attribution). |
metric |
landing_page_views |
landing_page_views |
The total number of views for the landing page associated with an advertisement. |
metric |
language |
language |
The language targeted by the ad campaign or the language of the ad creative. |
dimension |
last_refresh_date |
last_refresh_date |
The date and time when the data was last refreshed. |
dimension |
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 |
campaign_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 |
lob_{NUM} |
lob_{NUM} |
dimension |
|
max_reach_goal |
max_reach_goal |
The maximum target number of unique users an ad campaign aims to expose to its advertising content. |
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 |
min_reach_goal |
min_reach_goal |
The minimum target number of unique users an ad campaign is expected to expose to its advertising content. |
dimension |
name |
media_name |
The name of the organization associated with the ad account. |
dimension |
national_or_local |
national_or_local |
An indicator of the geographical scope of an advertising campaign, specifying whether the target audience is defined nationally or within a more confined local region. |
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 |
campaign_objective |
The marketing objective of the advertising campaign (e.g., app installs, brand awareness, conversions). |
dimension |
objective_v2_properties |
objective_v2_properties |
Properties related to the specific advertising objective of a campaign, such as app installs or brand awareness. |
dimension |
optimization_goal |
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 |
The pacing strategy applied to an ad campaign or ad squad, determining how the budget is spent over time (e.g., standard, accelerated). |
dimension |
pacing_properties_version |
pacing_properties_version |
The version of the pacing settings that control how a campaign’s budget is spent over time. |
metric |
pacing_type |
pacing_type |
The method by which the ad budget is spent over the campaign’s duration, controlling the speed of ad delivery (e.g., standard or accelerated). |
dimension |
packaging_status |
packaging_status |
This field represents the processing or readiness status of a creative asset. While the exact definition is not in the primary API documentation, similar terms like creative_packaging_status appear in related documentation. |
dimension |
paid_impressions |
paid_impressions |
Impressions generated from paid placements of the ad content. |
metric |
pixel_id |
pixel_id |
The unique identifier for a Snap Pixel, used for tracking website and app events. |
dimension |
placement |
placement |
The specific location or type of inventory where an ad is displayed within the Snapchat ecosystem, such as Story Ads, Content Ads, or Audience Network. |
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 |
premium_content_bundle_ids |
premium_content_bundle_ids |
Identifiers for curated collections of high-quality content on Snapchat, such as Creator Stories or Shows. These IDs allow advertisers to target their Commercials (non-skippable video ads) to specific premium content environments. |
dimension |
preview_creative_id |
preview_creative_id |
The unique identifier for a creative asset used for preview purposes. |
dimension |
preview_properties |
preview_properties |
General properties that define the preview settings for an ad or creative. |
dimension |
primary_profile |
primary_profile |
The main user or business profile associated with an ad account or creative. |
dimension |
profile_properties |
profile_properties |
A collection of properties related to a user or business profile on Snapchat. |
dimension |
quarters |
quarters |
The financial or calendar quarter for which advertising data or metrics are reported. |
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 |
A granular rate for reach and frequency campaigns, indicating the cost or value per targeted impression. |
dimension |
reach_and_frequency_status |
reach_and_frequency_status |
The current status of a reach and frequency campaign, indicating whether it’s active, paused, or completed. |
dimension |
reach_goal |
reach_goal |
The target number of unique users to reach with the ad campaign. |
dimension |
regulations |
regulations |
Information regarding compliance with advertising policies and specific legal or industry regulations. |
dimension |
render_type |
render_type |
The rendering type of the ad, indicating how it is displayed within the Snapchat application. |
dimension |
reserved_end_target_date |
reserved_end_target_date |
The scheduled end date for an ad campaign or ad placement that has been reserved, often associated with a ‘Reach & Frequency’ buying model rather than an auction. |
dimension |
reserved_rate_micro |
reserved_rate_micro |
The cost per impression or action for reserved ad inventory, expressed in micro-currency units (1.00 local currency unit = 1,000,000 Micro-currency). |
metric |
reserved_start_target_date |
reserved_start_target_date |
The scheduled start date for an ad campaign or ad placement that has been reserved, typical for guaranteed impressions or reach. |
dimension |
reserved_status |
reserved_status |
Indicates the current state of an ad campaign or inventory booking that was purchased with a ‘Reserved’ buy model. This status can be active, paused, or completed for campaigns guaranteeing impressions or reach. |
dimension |
reserved_type |
reserved_type |
The specific type of reservation for ad inventory, such as ‘Reach & Frequency’ buying, which allows for guaranteed reach and impression delivery at a fixed price. |
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 |
Detailed information regarding the current review status of an ad or creative. |
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 contributing to the current review status of an ad or creative. |
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 within the Snapchat API that carries inherent meaning or context, facilitating the identification of specific objects or entities. |
dimension |
share_of_voice |
share_of_voice |
A metric indicating the percentage of total ad impressions or activity an advertiser has captured within a specific audience, market, or content category on Snapchat. |
metric |
shareable |
shareable |
Indicates whether the creative content is shareable by users. |
dimension |
skadnetwork_properties |
skadnetwork_properties |
Properties and settings related to SKAdNetwork integration for app install attribution. |
dimension |
skippable |
skippable |
Indicates whether a video ad can be skipped by the user. |
dimension |
spend |
spend |
The total amount of money spent on the advertising campaign. |
metric |
start_date |
start_date |
The scheduled start date for a campaign or ad squad. |
dimension |
start_time |
campaign_start_time |
The scheduled start date and time for the advertising campaign. |
dimension |
status |
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 |
Refers to a premium ad placement that secures the first ad impression within certain content types, such as ‘First Story Takeovers’ or ‘First Commercials’, providing exclusive visibility at the beginning of a user’s content experience. |
dimension |
target_bid |
target_bid |
The specific bid amount or strategy set for reaching a target cost per action. |
dimension |
targeting |
targeting |
Criteria used to define the audience for an ad squad, including demographic, geographic, interest-based, and device-specific attributes, to ensure ads reach the most relevant users. |
dimension |
targeting.app_install_states |
targeting.app_install_states |
Specific states of app installation (e.g., installed, not installed) used to target or exclude audiences. |
dimension |
targeting.auto_expansion_options |
targeting.auto_expansion_options |
Options for automatically expanding the target audience beyond the initially defined parameters. |
dimension |
targeting.demographics |
targeting.demographics |
Demographic attributes (e.g., age, gender) used to define the target audience for an ad. |
dimension |
targeting.devices |
targeting.devices |
Device targeting criteria, such as operating system or device model. |
dimension |
targeting.enable_targeting_expansion |
targeting.enable_targeting_expansion |
A boolean indicator specifying whether targeting expansion is enabled to reach a broader audience. |
dimension |
targeting.geos |
targeting.geos |
Geographical locations (e.g., countries, regions) used to define the target audience for an ad. |
dimension |
targeting.interests |
targeting.interests |
User interests used to define the target audience for an ad. |
dimension |
targeting.maid_status_spec |
targeting.maid_status_spec |
Specifications related to the Mobile Ad ID (MAID) status for audience targeting purposes. |
dimension |
targeting.regulated_content |
targeting.regulated_content |
Content that is subject to specific regulations, used to ensure compliance with advertising policies during targeting. |
dimension |
targeting.segments |
targeting.segments |
Audience segments used for targeting, which can be custom or predefined. |
dimension |
targeting.separated_types |
targeting.separated_types |
Indicates when a targeting specification type (e.g., GEO targeting) has been moved to a separate targeting_spec entity due to a large number of criteria. |
dimension |
targeting_reach_status |
targeting_reach_status |
The status of the estimated audience reach for the configured targeting criteria. |
dimension |
targeting_type |
targeting_type |
The type of targeting used for the ad (e.g., demographic, interest-based). |
dimension |
third_party_on_swipe_tracking_urls |
third_party_on_swipe_tracking_urls |
URLs used for third-party tracking when a user performs a swipe action on an ad. |
dimension |
third_party_paid_impression_tracking_urls |
third_party_paid_impression_tracking_urls |
URLs provided for third-party systems to track paid ad impressions. |
dimension |
third_party_tracking_urls |
third_party_tracking_urls |
URLs used to enable tracking of ad impressions, clicks, or other events by third-party analytics providers. |
dimension |
timezone |
ad_account_timezone |
The timezone configured for the ad account. |
dimension |
top_snap_additional_format_properties |
top_snap_additional_format_properties |
Additional properties related to the format of the primary snap (Top Snap) within a creative. |
dimension |
top_snap_crop_position |
top_snap_crop_position |
The cropping position for the top Snap creative, influencing how the ad media is displayed to users. |
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 |
The total number of app installs across all operating systems attributed to an ad (click-through or swipe-up attribution). |
metric |
total_installs_app_swipe_up |
total_installs_app_swipe_up |
The total number of app installs across all operating systems attributed to a swipe-up action on an ad. |
metric |
total_installs_app_view |
total_installs_app_view |
The total number of app installs across all operating systems attributed to an ad, where the install occurred after a user viewed the ad (view-through attribution). |
metric |
total_installs_offline |
total_installs_offline |
The total number of offline installs across all operating systems attributed to an ad (click-through or swipe-up attribution). |
metric |
total_installs_offline_swipe_up |
total_installs_offline_swipe_up |
The total number of offline installs across all operating systems attributed to a swipe-up action on an ad. |
metric |
total_installs_offline_view |
total_installs_offline_view |
The total number of offline installs across all operating systems attributed to an ad, where the install occurred after a user viewed the ad (view-through attribution). |
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 |
The total number of web-based installs across all operating systems attributed to an ad (click-through or swipe-up attribution). |
metric |
total_installs_web_swipe_up |
total_installs_web_swipe_up |
The total number of web-based installs across all operating systems attributed to a swipe-up action on an ad. |
metric |
total_installs_web_view |
total_installs_web_view |
The total number of web-based installs across all operating systems attributed to an ad, where the install occurred after a user viewed the ad (view-through attribution). |
metric |
total_reach |
total_reach |
The total number of unique users who saw the ad at least once. |
metric |
type |
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 |
The unique identifier for an unlockable Snapchat feature, such as a filter or lens, associated with an ad. |
dimension |
utm_autofix_permission |
utm_autofix_permission |
Permission setting indicating whether UTM parameters in ad URLs are automatically adjusted or fixed by the platform. |
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 that control the behavior and appearance of a web view embedded within an ad creative. |
dimension |