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
ID | Type | Name | Description |
---|---|---|---|
account_id | TEXT | Account ID | Snapchat Ads advertiser ID. |
account_name | TEXT | Account Name | Snapchat Ads advertiser name. |
ad_name | TEXT | Ad Name | Ad name |
ad_squad_daily_budget | NUMERIC | Ad Squad Daily Budget | Ad squad daily budget |
ad_squad_id | TEXT | Ad Squad ID | Ad squad ID |
ad_squad_lifetime_budget | NUMERIC | Ad Squad Lifetime Budget | Ad squad lifetime budget |
ad_squad_name | TEXT | Ad Squad Name | Ad squad name |
ad_squad_optimization_goal | TEXT | Ad Squad Optimization Goal | Ad squad optimization goal |
ad_squad_status | TEXT | Ad Squad Status | Ad squad status |
ad_squad_type | TEXT | Ad Squad Type | Ad squad type |
adnetwork_conversions | NUMERIC | Ad Network Conversions | Ad network reported conversions (alias for Purchases) |
adnetwork_revenue | NUMERIC | Ad Network Revenue | Ad network reported revenue (alias for Purchase Value) |
campaign | TEXT | Campaign | Campaign name |
clicks | NUMERIC | Clicks | Number of ad clicks (alias for Ad Click) |
conversion_achievement_unlocked | NUMERIC | Achievement Unlocked (Conversion Event) | Number of attributed "ACHIEVEMENT_UNLOCKED" conversion events |
conversion_ad_click | NUMERIC | Ad Click (Conversion Event) | Number of attributed "AD_CLICK" conversion events |
conversion_ad_view | NUMERIC | Ad View (Conversion Event) | Number of attributed "AD_VIEW" conversion events |
conversion_add_billing | NUMERIC | Add Billing (Conversion Event) | Number of attributed "ADD_BILLING" conversion events |
conversion_add_cart | NUMERIC | Add to Cart (Conversion Event) | Number of attributed "ADD_CART" conversion events |
conversion_add_to_wishlist | NUMERIC | Add to Wishlist (Conversion Event) | Number of attributed "ADD_TO_WISHLIST" conversion events |
conversion_app_opens | NUMERIC | App Open (Conversion Event) | Number of attributed "APP_OPEN" conversion events |
conversion_complete_tutorial | NUMERIC | Complete Tutorial (Conversion Event) | Number of attributed "COMPLETE_TUTORIAL" conversion events |
conversion_invite | NUMERIC | Invite (Conversion Event) | Number of attributed "INVITE" conversion events |
conversion_level_completes | NUMERIC | Level Complete (Conversion Event) | Number of attributed "LEVEL_COMPLETE" conversion events |
conversion_list_view | NUMERIC | List View (Conversion Event) | Number of attributed "LIST_VIEW" conversion events |
conversion_login | NUMERIC | Login (Conversion Event) | Number of attributed "LOGIN" conversion events |
conversion_page_views | NUMERIC | Page View (Conversion Event) | Number of attributed "PAGE_VIEW" conversion events |
conversion_purchases | NUMERIC | Purchases (Conversion Event) | Number of attributed "PURCHASE" conversion events |
conversion_purchases_value | NUMERIC | Purchase Value | Value of attributed "PURCHASE" conversion events (in Ad Account’s currency) |
conversion_rate | PERCENT | Rate (Conversion Event) | Number of attributed "RATE" conversion events |
conversion_reserve | NUMERIC | Reserve (Conversion Event) | Number of attributed "RESERVE" conversion events |
conversion_save | NUMERIC | Save (Conversion Event) | Number of attributed "SAVE" conversion events |
conversion_searches | NUMERIC | Search (Conversion Event) | Number of attributed "SEARCH" conversion events |
conversion_share | NUMERIC | Share (Conversion Event) | Number of attributed "SHARE" conversion events |
conversion_sign_ups | NUMERIC | Sign Up (Conversion Event) | Number of attributed "SIGN_UP" conversion events |
conversion_spend_credits | NUMERIC | Spent Credits (Conversion Event) | Number of attributed "SPENT_CREDITS" conversion events |
conversion_start_checkout | NUMERIC | Start Checkout (Conversion Event) | Number of attributed "START_CHECKOUT" conversion events |
conversion_start_trial | NUMERIC | Start Trial (Conversion Event) | Number of attributed "START_TRIAL" conversion events |
conversion_subscribe | NUMERIC | Subscribe(Conversion Event) | Number of attributed "SUBSCRIBE" conversion events |
conversion_view_content | NUMERIC | View Content (Conversion Event) | Number of attributed "VIEW_CONTENT" conversion events |
conversion_visit | NUMERIC | Visit (Conversion Event) | Number of attributed "VISIT" conversion events |
currency | TEXT | Currency | Ad Account currency |
custom_event_1 | NUMERIC | Custom Event 1 (Conversion Event) | Number of attributed "CUSTOM_EVENT_1" conversion events |
custom_event_2 | NUMERIC | Custom Event 2 (Conversion Event) | Number of attributed "CUSTOM_EVENT_2" conversion events |
custom_event_3 | NUMERIC | Custom Event 3 (Conversion Event) | Number of attributed "CUSTOM_EVENT_3" conversion events |
custom_event_4 | NUMERIC | Custom Event 4 (Conversion Event) | Number of attributed "CUSTOM_EVENT_4" conversion events |
custom_event_5 | NUMERIC | Custom Event 5 (Conversion Event) | Number of attributed "CUSTOM_EVENT_5" conversion events |
date | DATE | Date | Date |
impressions | NUMERIC | Impressions | Number of impressions |
objective | TEXT | Objective | The Objective of the campaign |
quartile_1 | NUMERIC | Video Views to 25% | Video views to 25% |
quartile_2 | NUMERIC | Video Views to 50% | Video views to 50% |
quartile_3 | NUMERIC | Video Views to 75% | Video views to 75% |
screen_time_millis | NUMERIC | Time Spent (milliseconds) | Total time spent on top Snap ad (milliseconds) |
spend | NUMERIC | Spend | Amount of money spent |
swipe_up_percent | NUMERIC | Swipe Up Rate | The Swipe Up Rate |
swipes | NUMERIC | Swipe Ups | Number of swipes |
totalcost | NUMERIC | Total Cost | Amount of money spent (alias for Spend) |
transactionrevenue | NUMERIC | Transaction Revenue | Transaction revenue (alias for Purchase Value) |
transactions | NUMERIC | Transactions | Number of transactions (alias for Purchases) |
video_views | NUMERIC | Video Views | Total 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_based | NUMERIC | Video 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_completion | NUMERIC | Video Views to Completion | Video views to completion |