Snapchat Ads Field Reference

Sample

 

https://connectors.windsor.ai/snapchat?api_key=[your API key]&date_preset=last_7d&fields=campaign,clicks,spend,impressions,date,source&_renderer=csv


Fields

IDTypeNameDescription
account_idTEXTAccount IDSnapchat Ads advertiser ID.
account_nameTEXTAccount NameSnapchat Ads advertiser name.
ad_nameTEXTAd NameAd name
ad_squad_daily_budgetNUMERICAd Squad Daily BudgetAd squad daily budget
ad_squad_idTEXTAd Squad IDAd squad ID
ad_squad_lifetime_budgetNUMERICAd Squad Lifetime BudgetAd squad lifetime budget
ad_squad_nameTEXTAd Squad NameAd squad name
ad_squad_optimization_goalTEXTAd Squad Optimization GoalAd squad optimization goal
ad_squad_statusTEXTAd Squad StatusAd squad status
ad_squad_typeTEXTAd Squad TypeAd squad type
adnetwork_conversionsNUMERICAd Network ConversionsAd network reported conversions (alias for Purchases)
adnetwork_revenueNUMERICAd Network RevenueAd network reported revenue (alias for Purchase Value)
campaignTEXTCampaignCampaign name
clicksNUMERICClicksNumber of ad clicks (alias for Ad Click)
conversion_achievement_unlockedNUMERICAchievement Unlocked (Conversion Event)Number of attributed "ACHIEVEMENT_UNLOCKED" conversion events
conversion_ad_clickNUMERICAd Click (Conversion Event)Number of attributed "AD_CLICK" conversion events
conversion_ad_viewNUMERICAd View (Conversion Event)Number of attributed "AD_VIEW" conversion events
conversion_add_billingNUMERICAdd Billing (Conversion Event)Number of attributed "ADD_BILLING" conversion events
conversion_add_cartNUMERICAdd to Cart (Conversion Event)Number of attributed "ADD_CART" conversion events
conversion_add_to_wishlistNUMERICAdd to Wishlist (Conversion Event)Number of attributed "ADD_TO_WISHLIST" conversion events
conversion_app_opensNUMERICApp Open (Conversion Event)Number of attributed "APP_OPEN" conversion events
conversion_complete_tutorialNUMERICComplete Tutorial (Conversion Event)Number of attributed "COMPLETE_TUTORIAL" conversion events
conversion_inviteNUMERICInvite (Conversion Event)Number of attributed "INVITE" conversion events
conversion_level_completesNUMERICLevel Complete (Conversion Event)Number of attributed "LEVEL_COMPLETE" conversion events
conversion_list_viewNUMERICList View (Conversion Event)Number of attributed "LIST_VIEW" conversion events
conversion_loginNUMERICLogin (Conversion Event)Number of attributed "LOGIN" conversion events
conversion_page_viewsNUMERICPage View (Conversion Event)Number of attributed "PAGE_VIEW" conversion events
conversion_purchasesNUMERICPurchases (Conversion Event)Number of attributed "PURCHASE" conversion events
conversion_purchases_valueNUMERICPurchase ValueValue of attributed "PURCHASE" conversion events (in Ad Account’s currency)
conversion_ratePERCENTRate (Conversion Event)Number of attributed "RATE" conversion events
conversion_reserveNUMERICReserve (Conversion Event)Number of attributed "RESERVE" conversion events
conversion_saveNUMERICSave (Conversion Event)Number of attributed "SAVE" conversion events
conversion_searchesNUMERICSearch (Conversion Event)Number of attributed "SEARCH" conversion events
conversion_shareNUMERICShare (Conversion Event)Number of attributed "SHARE" conversion events
conversion_sign_upsNUMERICSign Up (Conversion Event)Number of attributed "SIGN_UP" conversion events
conversion_spend_creditsNUMERICSpent Credits (Conversion Event)Number of attributed "SPENT_CREDITS" conversion events
conversion_start_checkoutNUMERICStart Checkout (Conversion Event)Number of attributed "START_CHECKOUT" conversion events
conversion_start_trialNUMERICStart Trial (Conversion Event)Number of attributed "START_TRIAL" conversion events
conversion_subscribeNUMERICSubscribe(Conversion Event)Number of attributed "SUBSCRIBE" conversion events
conversion_view_contentNUMERICView Content (Conversion Event)Number of attributed "VIEW_CONTENT" conversion events
conversion_visitNUMERICVisit (Conversion Event)Number of attributed "VISIT" conversion events
currencyTEXTCurrencyAd Account currency
custom_event_1NUMERICCustom Event 1 (Conversion Event)Number of attributed "CUSTOM_EVENT_1" conversion events
custom_event_2NUMERICCustom Event 2 (Conversion Event)Number of attributed "CUSTOM_EVENT_2" conversion events
custom_event_3NUMERICCustom Event 3 (Conversion Event)Number of attributed "CUSTOM_EVENT_3" conversion events
custom_event_4NUMERICCustom Event 4 (Conversion Event)Number of attributed "CUSTOM_EVENT_4" conversion events
custom_event_5NUMERICCustom Event 5 (Conversion Event)Number of attributed "CUSTOM_EVENT_5" conversion events
dateDATEDateDate
impressionsNUMERICImpressionsNumber of impressions
objectiveTEXTObjectiveThe Objective of the campaign
quartile_1NUMERICVideo Views to 25%Video views to 25%
quartile_2NUMERICVideo Views to 50%Video views to 50%
quartile_3NUMERICVideo Views to 75%Video views to 75%
screen_time_millisNUMERICTime Spent (milliseconds)Total time spent on top Snap ad (milliseconds)
spendNUMERICSpendAmount of money spent
swipe_up_percentNUMERICSwipe Up RateThe Swipe Up Rate
swipesNUMERICSwipe UpsNumber of swipes
totalcostNUMERICTotal CostAmount of money spent (alias for Spend)
transactionrevenueNUMERICTransaction RevenueTransaction revenue (alias for Purchase Value)
transactionsNUMERICTransactionsNumber of transactions (alias for Purchases)
video_viewsNUMERICVideo ViewsTotal number of impressions that meet the qualifying video view criteria of at least 2 seconds of consecutive watch time or a swipe up action on the Top Snap
video_views_time_basedNUMERICVideo Views (View Time Only)Total number of impressions that meet the qualifying video view criteria of at least 2 seconds, not including swipe ups
view_completionNUMERICVideo Views to CompletionVideo views to completion