Snapchat: Most-used fields

The table below gives information about most-used fields that you can import from Snapchat. Other fields might also be available in Adverity.

The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs.

API name	Adverity UI name	Description	Use in Adverity
Gender	gender	The gender of the audience targeted in Snapchat ads.	dimension
ad_account_id	ad_account_id	The unique identifier for the ad account.	dimension
ad_account_name	ad_account_name	The name of the ad account.	dimension
ad_id	ad_id	The unique identifier for an individual ad.	dimension
ad_name	ad_name	The name of the ad.	dimension
ad_product	ad_product	The specific ad product used for the creative (e.g., Story Ad, Collection Ad).	dimension
ad_scheduling_config	ad_scheduling_config		dimension
ad_squad_id	ad_squad_id	The unique identifier for an ad squad, which is a group of ads.	dimension
ad_squad_name	ad_squad_name	The name of the ad squad.	dimension
ad_squad_placement	ad_squad_placement	The placement where the ad squad’s ads are displayed (e.g., Content, Story).	dimension
ad_squad_placement_v2_config	ad_squad_placement_v2_config	Configuration settings for the ad squad’s placements using the V2 placement system.	dimension
ad_squad_placement_v2_inclusion	ad_squad_placement_v2_inclusion	Inclusion rules for ad squad placements using the V2 placement system.	dimension
ad_squad_placement_v2_platforms	ad_squad_placement_v2_platforms	The platforms where the ad squad’s ads are allowed to be placed (e.g., Snapchat) using the V2 placement system.	dimension
ad_squad_placement_v2_snapchat_positions	ad_squad_placement_v2_snapchat_positions	Specific positions within Snapchat where the ad squad’s ads are allowed to be placed (e.g., CHAT_FEED) using the V2 placement system.	dimension
ad_squad_targeting_demographics_gender	ad_squad_targeting_demographics_gender	Gender demographic targeting applied at the ad squad level.	dimension
ad_squad_targeting_demographics_languages	ad_squad_targeting_demographics_languages	The demographic (e.g., age, gender) and language targeting settings for the ad squad.	dimension
ad_squad_targeting_demographics_max_age	ad_squad_targeting_demographics_max_age	Maximum age for demographic targeting applied at the ad squad level.	dimension
ad_squad_targeting_demographics_min_age	ad_squad_targeting_demographics_min_age	Minimum age for demographic targeting applied at the ad squad level.	metric
ad_squad_targeting_geos_country_code	ad_squad_targeting_geos_country_code	The two-letter ISO country code used to specify the geographical region for ad targeting within an Ad Squad. This field defines the countries where the ads in the Ad Squad will be displayed.	dimension
ad_squad_targeting_geos_excluded	ad_squad_targeting_geos_excluded	Geographic locations explicitly excluded from the ad squad’s targeting.	dimension
ad_squad_targeting_geos_included	ad_squad_targeting_geos_included	Geographic locations included in the targeting for the ad squad.	dimension
ad_squad_targeting_interests_category_id	ad_squad_targeting_interests_category_id	Category ID for interest-based targeting applied at the ad squad level.	dimension
ad_squad_targeting_locations	ad_squad_targeting_locations	Specific geographic locations targeted by the ad squad.	dimension
ad_squad_targeting_regulated_content	ad_squad_targeting_regulated_content	Flag indicating if the ad squad’s content is regulated (e.g., alcohol), requiring specific targeting considerations.	dimension
ad_squad_targeting_segments_excluded	ad_squad_targeting_segments_excluded	Customer list segments or other audience segments explicitly excluded from the ad squad’s targeting.	dimension
ad_squad_targeting_segments_included	ad_squad_targeting_segments_included	Audience segments included in the targeting for the ad squad.	dimension
advertiser	ad_account_advertiser	The advertiser associated with the ad account.	dimension
advertiser_organization_id	advertiser_organization_id	The unique identifier for the advertiser’s organization.	dimension
age_bucket	age_bucket	The age range or bucket of the audience targeted in Snapchat ads.	dimension
agency	agency	The advertising agency associated with the campaign or ad account.	dimension
agency_representing_client	agency_representing_client	Information about the advertising agency that manages the client’s ad accounts.	dimension
android_installs	android_installs	The total number of app installs on Android devices attributed to the ad.	metric
android_installs_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
app_install_properties	app_install_properties	Properties and settings related to tracking and optimizing app 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	A boolean flag indicating whether the ad platform automatically manages bids to achieve the most goal actions for the given budget and target audience.	dimension
auto_bid_max_bid_micro	auto_bid_max_bid_micro	The maximum bid amount, expressed in micro-currency, that the auto-bidding strategy is allowed to place for an ad.	metric
avg_screen_time_millis	avg_screen_time_millis	The average time, in milliseconds, that users spent on screen interacting with the ad.	metric
avg_view_time_millis	avg_view_time_millis	The average time, in milliseconds, that users viewed the ad creative.	metric
bid_micro	bid_micro	The bid amount for the ad squad, expressed in micro-currency units (1 local currency unit = 1,000,000 micro-currency).	metric
bid_strategy	bid_strategy	The strategy used for bidding on ad placements for the ad squad (e.g., goal-based bidding).	dimension
billing_center_id	billing_center_id	The unique identifier for the billing center associated with the ad account.	dimension
billing_event	billing_event	The specific event or action for which an ad squad is billed, such as impressions or conversions.	dimension
billing_type	billing_type	Defines the billing arrangement for the ad account, such as ‘REVOLVING’.	dimension
brand_safety_config	brand_safety_config	Defines where ads are placed among Snapchat content, allowing advertisers to control the suitability of the content surrounding their ads. This includes options for various inventory filters like Full, Standard, and Limited across different content surfaces.	dimension
buy_model	buy_model	The method used for purchasing ad space, such as ‘AUCTION’ for real-time bidding or ‘RESERVED’ for upfront reach and frequency buys.	dimension
call_to_action	call_to_action	The button or prompt within a creative that encourages users to take a specific action, such as ‘Shop Now’ or ‘Install App’.	dimension
campaign_budget_optimization_properties	campaign_budget_optimization_properties	Properties and settings related to how campaign budgets are optimized across ad squads.	dimension
campaign_end_time	campaign_end_time	The scheduled end time for the campaign.	dimension
campaign_id	campaign_id	The unique identifier for the campaign.	dimension
campaign_name	campaign_name	The name of the campaign.	dimension
campaign_objective	campaign_objective	The primary goal of the advertising campaign, such as app installs or website visits.	dimension
campaign_start_time	campaign_start_time	The scheduled start time for the campaign.	dimension
cap_and_exclusion_config	cap_and_exclusion_config	Configuration for frequency capping, which limits the number of times an ad is shown to a unique user within a specified period, and other ad exclusions.	dimension
client_paying_invoices	client_paying_invoices	Indicates whether the client is directly responsible for paying the invoices associated with the ad account.	dimension
conversion_achievement_unlocked	conversion_achievement_unlocked	Total achievement unlocks attributed to ad engagement.	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_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_offline	conversion_ad_click_offline	Total ad clicks occurring offline.	metric
conversion_ad_click_sk_ad_network	conversion_ad_click_sk_ad_network	Conversion attributed to an ad click via Apple’s SKAdNetwork.	metric
conversion_ad_click_sk_ad_network_total	conversion_ad_click_sk_ad_network_total	Total conversions attributed to an ad click via Apple’s SKAdNetwork.	metric
conversion_ad_click_sk_ad_network_view	conversion_ad_click_sk_ad_network_view	Conversions attributed to a view-through ad interaction via Apple’s SKAdNetwork.	metric
conversion_ad_click_swipe_up	conversion_ad_click_swipe_up	The number of conversions attributed to ad clicks resulting from a swipe-up action.	metric
conversion_ad_click_view	conversion_ad_click_view	The number of conversions attributed to ad clicks from users who previously viewed the ad.	metric
conversion_ad_click_web	conversion_ad_click_web	Total ad clicks occurring on the web.	metric
conversion_ad_view	conversion_ad_view	The total number of conversions attributed to ad views (view-through conversions).	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_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_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_offline	conversion_add_billing_offline	Total billing information additions occurring offline attributed to ad engagement.	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_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_cart	conversion_add_cart	The total number of ‘add to cart’ conversions attributed to the ad.	metric
conversion_add_cart_app	conversion_add_cart_app	Total additions to cart occurring in an app attributed to ad engagement.	metric
conversion_add_cart_app_swipe_up	conversion_add_cart_app_swipe_up	Total additions to cart occurring in an app attributed to users swiping up on an ad, based on the swipe-up attribution window.	metric
conversion_add_cart_app_view	conversion_add_cart_app_view	Total additions to cart occurring in an app attributed to users viewing an ad, based on the view-through attribution window.	metric
conversion_add_cart_offline	conversion_add_cart_offline	Total additions to cart occurring offline attributed to ad engagement.	metric
conversion_add_cart_offline_swipe_up	conversion_add_cart_offline_swipe_up	Total additions to cart occurring offline attributed to users swiping up on an ad, based on the swipe-up attribution window.	metric
conversion_add_cart_offline_view	conversion_add_cart_offline_view	Total additions to cart occurring offline attributed to users viewing an ad, based on the view-through attribution window.	metric
conversion_add_cart_sk_ad_network	conversion_add_cart_sk_ad_network	Add-to-cart conversions attributed via Apple’s SKAdNetwork.	metric
conversion_add_cart_sk_ad_network_total	conversion_add_cart_sk_ad_network_total	Total add-to-cart conversions attributed via Apple’s SKAdNetwork.	metric
conversion_add_cart_swipe_up	conversion_add_cart_swipe_up	The number of ‘add to cart’ conversions attributed to users swiping up on the ad.	metric
conversion_add_cart_value	conversion_add_cart_value	The monetary value generated from ‘add to cart’ conversions.	metric
conversion_add_cart_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_offline	conversion_add_to_wishlist_offline	Total additions to wishlist occurring offline attributed to ad engagement.	metric
conversion_add_to_wishlist_swipe_up	conversion_add_to_wishlist_swipe_up	The number of ‘add to wishlist’ conversions attributed to users swiping up on the ad.	metric
conversion_add_to_wishlist_value	conversion_add_to_wishlist_value	This field represents the monetary value associated with a user adding an item to their wishlist, tracked as a conversion event via the Snapchat Conversions API.	metric
conversion_add_to_wishlist_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_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_offline	conversion_app_opens_offline	Total app opens occurring offline attributed to ad engagement.	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_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_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_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_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_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_offline	conversion_invite_offline	Total invites sent occurring offline attributed to ad engagement.	metric
conversion_invite_web	conversion_invite_web	Total invites sent occurring on the web attributed to ad engagement.	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_offline	conversion_level_completes_offline	Total level completions occurring offline attributed to ad engagement.	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_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_offline	conversion_list_view_offline	Total times a list was viewed occurring offline attributed to ad engagement.	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_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_offline	conversion_login_offline	Total logins occurring offline attributed to ad engagement.	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_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_offline	conversion_page_views_offline	A conversion metric for offline page views after interacting with 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_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_purchases	conversion_purchases	The total number of purchase conversions attributed to the ad.	metric
conversion_purchases_app	conversion_purchases_app	The total number of purchases made within an app, attributed to an ad campaign.	metric
conversion_purchases_app_swipe_up	conversion_purchases_app_swipe_up	The number of purchases made within an app, attributed to a swipe-up interaction with an ad.	metric
conversion_purchases_app_view	conversion_purchases_app_view	The number of purchases made within an app, attributed to viewing an ad.	metric
conversion_purchases_offline	conversion_purchases_offline	The total number of offline purchases, attributed to an ad campaign.	metric
conversion_purchases_offline_swipe_up	conversion_purchases_offline_swipe_up	The number of offline purchases, attributed to a swipe-up interaction with an ad.	metric
conversion_purchases_offline_view	conversion_purchases_offline_view	The number of offline purchases, attributed to viewing an ad.	metric
conversion_purchases_sk_ad_network	conversion_purchases_sk_ad_network	Purchase conversions attributed via Apple’s SKAdNetwork.	metric
conversion_purchases_sk_ad_network_total	conversion_purchases_sk_ad_network_total	Total purchase conversions attributed via Apple’s SKAdNetwork.	metric
conversion_purchases_sk_ad_network_view	conversion_purchases_sk_ad_network_view	The number of view-through purchase conversions attributed via Apple’s SKAdNetwork framework.	metric
conversion_purchases_swipe_up	conversion_purchases_swipe_up	The number of purchase conversions attributed to users swiping up on the ad.	metric
conversion_purchases_value	conversion_purchases_value	The monetary value generated from purchase conversions attributed to the ad.	metric
conversion_purchases_value_EUR	conversion_purchases_value_EUR	The value of purchase conversions, expressed in Euros.	metric
conversion_purchases_value_app	conversion_purchases_value_app	The total monetary value of purchases made within an app, attributed to an ad campaign.	metric
conversion_purchases_value_app_swipe_up	conversion_purchases_value_app_swipe_up	The monetary value of purchases made within an app, attributed to a swipe-up interaction with an ad.	metric
conversion_purchases_value_app_view	conversion_purchases_value_app_view	The monetary value of purchases made within an app, attributed to viewing an ad.	metric
conversion_purchases_value_offline	conversion_purchases_value_offline	The total monetary value of offline purchases, attributed to an ad campaign.	metric
conversion_purchases_value_offline_swipe_up	conversion_purchases_value_offline_swipe_up	The monetary value of offline purchases, attributed to a swipe-up interaction with an ad.	metric
conversion_purchases_value_offline_view	conversion_purchases_value_offline_view	The monetary value of offline purchases, attributed to viewing an ad.	metric
conversion_purchases_value_swipe_up	conversion_purchases_value_swipe_up	The monetary value generated from purchase conversions attributed to users swiping up on the ad.	metric
conversion_purchases_value_view	conversion_purchases_value_view	The monetary value generated from purchase conversions attributed to users who viewed the ad (view-through conversions).	metric
conversion_purchases_value_web	conversion_purchases_value_web	The total monetary value of purchases made on a website, attributed to an ad campaign.	metric
conversion_purchases_value_web_swipe_up	conversion_purchases_value_web_swipe_up	The monetary value of purchases made on a website, attributed to a swipe-up interaction with an ad.	metric
conversion_purchases_value_web_view	conversion_purchases_value_web_view	The monetary value of purchases made on a website, attributed to viewing an ad.	metric
conversion_purchases_view	conversion_purchases_view	The number of purchase conversions attributed to users who viewed the ad (view-through conversions).	metric
conversion_purchases_web	conversion_purchases_web	The total number of purchases made on a website, attributed to an ad campaign.	metric
conversion_purchases_web_swipe_up	conversion_purchases_web_swipe_up	The number of purchases made on a website, attributed to a swipe-up interaction with an ad.	metric
conversion_purchases_web_view	conversion_purchases_web_view	The number of purchases made on a website, attributed to viewing an ad.	metric
conversion_rate	conversion_rate	The rate at which ad impressions or clicks lead to a desired conversion event.	metric
conversion_rate_app	conversion_rate_app	The rate of conversions that occurred within an app, attributed to an ad campaign.	metric
conversion_rate_offline	conversion_rate_offline	The rate of offline conversions, attributed to an ad campaign.	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_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_offline	conversion_reserve_offline	The number of offline reservation events, attributed to an ad campaign.	metric
conversion_reserve_web	conversion_reserve_web	The number of reservation events that occurred on a website, attributed to an ad campaign.	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_offline	conversion_save_offline	A conversion metric for offline saves after interacting with 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_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_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_offline	conversion_searches_offline	A conversion metric for offline searches after interacting with 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_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_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_offline	conversion_share_offline	A conversion metric for offline shares after interacting with 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_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_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_offline	conversion_sign_ups_offline	A conversion metric for offline sign-ups after interacting with 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_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_spend_credits	conversion_spend_credits	A conversion metric for users who spent credits after interacting with 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_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_offline	conversion_start_trial_offline	A conversion metric for users who started an offline trial after interacting with 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_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_offline	conversion_subscribe_offline	A conversion metric for offline subscriptions after interacting with 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_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_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_offline	conversion_view_content_offline	A conversion metric for offline content views after interacting with 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_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_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 duration after an ad interaction within which a conversion is attributed to that ad.	dimension
country	country	This field represents the geographical country where an advertising campaign is targeted, or for which performance data (like impressions and engagements) is reported. It can be used as a dimension to break down metrics.	dimension
created_at	created_at	The timestamp when the entity was created.	dimension
creation_state	creation_state	The current state of an ad entity at its creation, such as DRAFT or PENDING.	dimension
creative_clickthrough_url	creative_clickthrough_url	The URL that users are directed to when they interact with the ad creative.	dimension
creative_composite_properties	creative_composite_properties	A collection of various properties that define the complex characteristics of a creative.	dimension
creative_id	creative_id	The unique identifier for the creative asset used in an ad.	dimension
creative_name	creative_name	The name of the creative asset.	dimension
creative_preview_properties	creative_preview_properties	Properties related to how an ad creative appears in a preview, including its format and content.	dimension
creator_partnership_type	creator_partnership_type	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	currency	The currency used for the ad account.	dimension
custom_conversion[{PLACEHOLDER}]	custom_conversion[{PLACEHOLDER}]	A dynamically named custom conversion event.	metric
custom_conversion_id	custom_conversion_id	The unique identifier for a custom conversion event.	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}_offline	custom_event_{NUM}_offline	A custom offline conversion event tracked after interacting with 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}_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
daily_budget_micro	daily_budget_micro	The daily budget for a campaign, expressed in micro-currency units.	metric
date	date	The specific date for which the data is reported.	dimension
delivery_constraint	delivery_constraint	Defines the budget type for an ad campaign or ad squad, such as ‘DAILY_BUDGET’ for a daily spend limit or ‘LIFETIME_BUDGET’ for a total budget over the campaign’s duration.	dimension
delivery_constraint_sub_type	delivery_constraint_sub_type		dimension
delivery_status	delivery_status	The current status of an ad campaign, ad squad, or ad regarding its delivery, such as DELIVERING or PAUSED.	dimension
dma	dma	This field represents the Designated Market Area (DMA) targeted by an advertising campaign, used for audience segmentation and reporting of performance data. It is a geographical dimension.	dimension
dma_name	dma_name	The Designated Market Area (DMA) of the audience targeted in Snapchat ads.	dimension
earned_impressions	earned_impressions	Impressions generated through organic sharing or viral spread of the ad content, rather than paid placements.	metric
earned_reach	earned_reach	The number of unique users reached through organic sharing or viral spread of the ad content.	metric
end_time	end_time	The scheduled end date and time for the advertising campaign.	dimension
event_sources	event_sources	Identifies the origin of conversion events, such as the Snap Pixel, Conversions API, or other event tracking mechanisms used to attribute actions to advertising campaigns.	dimension
experiment_id	experiment_id	A unique identifier for an advertising experiment or A/B test, used to track and analyze the performance of different ad variations or strategies.	dimension
favorite_display_mode	favorite_display_mode	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
frequency	frequency	The average number of times a unique user saw the ad.	metric
funding_source_ids	funding_source_ids	A list of identifiers for the funding sources used for the ad account or campaign.	dimension
gross_impressions	gross_impressions	The total number of times an ad was displayed, including repeated displays to the same user.	metric
id	organization_id	The unique identifier for the ad.	metric
impression_goal	impression_goal	The target number of impressions for the campaign.	metric
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_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
landing_page_views	landing_page_views	The total number of views for the landing page associated with an advertisement.	metric
lifetime_budget_micro	lifetime_budget_micro	The total budget allocated for the entire duration of an ad squad’s campaign, expressed in micro-units of the currency (e.g., 1,000,000 micro = 1 unit of currency).	metric
lifetime_spend_cap_micro	lifetime_spend_cap_micro	The maximum total amount that can be spent on a campaign over its entire lifespan, expressed in micro-units of the currency.	metric
max_reach_goal	max_reach_goal	The maximum target reach for the campaign.	metric
measured_impressions	measured_impressions	The number of ad impressions that were successfully measured for viewability, indicating they met industry standards for being seen.	metric
media_cost	media_cost	The expenditure associated with an advertising campaign or ad, representing the total amount spent on media placements. This is often referred to as ‘Spend’ in performance reporting.	metric
media_plan_id	media_plan_id		dimension
min_reach_goal	min_reach_goal	The minimum target reach for the campaign.	metric
name	name	The name of the organization associated with the ad account.	dimension
native_leads	native_leads	The number of leads generated directly through Snapchat’s native lead generation forms.	metric
non_viewable_impressions	non_viewable_impressions	The number of ad impressions that did not meet the industry standards for viewability and were therefore not considered seen by a user.	metric
objective	objective	The marketing objective of the advertising campaign (e.g., app installs, brand awareness, conversions).	dimension
objective_v2_properties	objective_v2_properties	Properties and settings defining the objective of the campaign, using version 2 of the objective model.	dimension
operating_system	operating_system	The operating system of the device on which an ad is displayed, often used for ad targeting or performance breakdown.	dimension
optimization_goal	optimization_goal	The goal for which the ad squad is optimized, influencing bid strategy and delivery (e.g., app installs, purchases).	dimension
pacing_level	pacing_level	Indicates the organizational level at which pacing settings are applied, such as ‘CAMPAIGN’ level.	dimension
pacing_properties_version	pacing_properties_version	The version of the pacing properties applied to an advertising campaign or ad squad, which dictates how the budget is spent over a specific period.	metric
pacing_type	pacing_type	Determines how the ad spend is distributed over the campaign’s duration, typically ‘STANDARD’ for even distribution, and generally not supporting ‘ACCELERATED’ delivery.	dimension
packaging_status	packaging_status	Indicates the current processing or readiness status of an ad creative or media asset within the platform, reflecting its stage from upload to being ready for campaigns.	dimension
paid_impressions	paid_impressions	Impressions generated from paid placements of the ad content.	metric
pixel_id	pixel_id	The unique identifier for the Snap Pixel used for website tracking.	dimension
placement	placement	Defines where an ad will appear on Snapchat, including options like Automatic Placement, Publisher Stories, Creator Stories, Spotlight, and Chat Feed.	dimension
position_impressions	position_impressions	The number of impressions recorded for the ad in a specific placement position.	metric
position_swipe_up_percent	position_swipe_up_percent	The percentage of impressions in a specific position that resulted in a swipe-up action.	metric
post_ad_preview_url	post_ad_preview_url	A URL that provides a preview of the ad after it has been created and posted.	dimension
premium_content_bundle_ids	premium_content_bundle_ids	Identifiers for bundles of premium content on Snapchat where ads, particularly Commercials, can be targeted to appear.	dimension
preview_creative_id	creative_preview_creative_id	The unique identifier for a creative asset used for preview purposes.	dimension
primary_profile	primary_profile	The main user or business profile associated with an ad account or creative.	dimension
product_properties	product_properties	Properties related to products, used within Dynamic Product Ads (DPA) to specify the product set from which ads will dynamically pull product information.	dimension
profile_properties	profile_properties	A collection of properties related to a user or business profile on Snapchat.	dimension
quartile_{NUM}	quartile_{NUM}	Video quartile data (e.g., 25%, 50%, 75%, 100%) for video views within the ad creative.	metric
reach_and_frequency_rate_micro	reach_and_frequency_rate_micro	The rate for reach and frequency targeting, expressed in micro-currency units.	dimension
reach_and_frequency_status	reach_and_frequency_status	The status of the reach and frequency campaign or settings.	dimension
reach_goal	reach_goal	The target number of unique users to reach with the campaign.	metric
region	region	This field indicates the geographical region targeted by an advertising campaign or for which performance data is reported. It can be used as a dimension for insights and targeting.	dimension
regulations	regulations	Specifies regulatory requirements or classifications for ads, particularly for sensitive categories like Housing, Credit, or Employment.	dimension
render_type	render_type	The rendering type of the ad, indicating how it is displayed within the Snapchat application.	dimension
reserved_type	reserved_type	The type of reserved ad buy.	dimension
review_status	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	The specific reasons provided for an ad’s current review status (e.g., rejected due to policy violation).	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
shareable	shareable	Indicates whether the creative content is shareable by users.	dimension
skadnetwork_properties	skadnetwork_properties	Properties related to Apple’s SKAdNetwork for app install attribution.	dimension
spend	spend	The total amount of money spent on the advertising campaign.	metric
spend_EUR	spend_EUR	The total amount spent on the ad campaign, expressed in Euros.	metric
start_time	start_time	The scheduled start date and time for the advertising campaign.	dimension
status	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	The takeover_slot represents a premium ad placement on Snapchat, specifically the “Total Snap Takeover,” which ensures the advertiser’s ad is the first one displayed across all major tabs within the app during a user’s session.	dimension
target_bid	target_bid	The desired average cost-per-action (CPA) that the ad platform aims to achieve for an ad set.	dimension
targeting.app_install_states	targeting.app_install_states	Targeting criteria based on the app install status of users.	dimension
targeting.auto_expansion_options	targeting.auto_expansion_options	Options for automatically expanding the audience beyond the initially defined targeting criteria.	dimension
targeting.demographics	targeting.demographics	Demographic targeting criteria such as age, gender, and income.	dimension
targeting.devices	targeting.devices	Targeting criteria based on user devices, including operating system and device type.	dimension
targeting.enable_targeting_expansion	targeting.enable_targeting_expansion	A boolean indicating whether automatic targeting expansion is enabled for the ad squad.	dimension
targeting.geos	targeting.geos	Geographical targeting criteria for the ad, such as countries or regions.	dimension
targeting.interests	targeting.interests	Targeting criteria based on the expressed interests of the audience on the Snapchat platform.	dimension
targeting.maid_status_spec	targeting.maid_status_spec	Specifies targeting criteria related to Mobile Advertising ID (MAID) status, which can be used to refine audience segments based on device identifiers.	dimension
targeting.product_audiences	targeting.product_audiences	A collection of product-specific audiences used for targeting advertisements, allowing campaigns to reach users based on their interest in or interaction with particular products.	dimension
targeting.regulated_content	targeting.regulated_content	A boolean flag indicating whether the ad content is classified as regulated (e.g., alcohol, red band movie trailers), which requires specific targeting considerations and compliance with advertising policies.	dimension
targeting.segments	targeting.segments	Audience segments used for targeting, such as custom audiences.	dimension
targeting.separated_types	targeting.separated_types	Indicates if certain targeting criteria, such as geographical targeting, have been moved into a separate ‘targeting_spec’ entity for more modular configuration.	dimension
targeting_reach_status	targeting_reach_status	The status of the estimated reach for the specified targeting parameters.	dimension
third_party_on_swipe_tracking_urls	third_party_on_swipe_tracking_urls	URLs for third-party trackers to log swipe-up events.	dimension
third_party_tracking_urls	third_party_tracking_urls	URLs for general third-party tracking, such as impression trackers.	dimension
timezone	timezone	The timezone configured for the ad account.	dimension
top_snap_crop_position	top_snap_crop_position	Specifies the position of the cropped ad creative, particularly relevant for ‘Top Snap’ ad formats to ensure optimal display.	dimension
top_snap_media_id	creative_top_snap_media_id	The unique identifier for the primary media asset (Top Snap) used in a creative.	dimension
total_impressions	total_impressions	The cumulative total of all impressions generated by the ad.	metric
total_installs	total_installs	The overall number of app installs attributed to the ad across all device types.	metric
total_installs_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_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	A unique identifier for a Snapchat creative asset, such as a Lens or Filter, that users can ‘unlock’ or interact with. This relates to media assets or creatives managed within the platform.	dimension
updated_at	updated_at	The timestamp when the entity was last updated.	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