Fields Reference · Snapchat Ads
Snapchat Ads Fields List
108 fields · 16 dimensions · 92 metrics · 3 groups
| Field name | Label | Category | Description |
|---|---|---|---|
ad_id | Ad ID | ad_daily | The Snapchat ad id. |
ad_name | Ad Name | ad_daily | The ad name as it is now, deleted ads included. Falls back to the id. |
ad_status | Ad Status | ad_daily | The ad status as it is now (ACTIVE, PAUSED), not as it was on the row's day. |
ad_type | Ad Type | ad_daily | The ad format (REMOTE_WEBPAGE, COLLECTION…). |
ad_squad_id | Ad Squad ID | ad_squad_daily | The Snapchat ad squad id. |
ad_squad_name | Ad Squad Name | ad_squad_daily | The ad squad name as it is now, deleted ad squads included. Falls back to the id. |
ad_squad_optimization_goal | Ad Squad Optimization Goal | ad_squad_daily | What the ad squad optimizes for (PIXEL_PURCHASE, SWIPES, IMPRESSIONS…). |
ad_squad_status | Ad Squad Status | ad_squad_daily | The ad squad status as it is now (ACTIVE, PAUSED), not as it was on the row's day. |
account_currency | Currency | campaign_daily | The ad account's currency (ISO code). Spend and every conversion value are in this currency; summing them across accounts with different currencies mixes units. |
account_id | Ad Account ID | campaign_daily | The Snapchat ad account id. Filled by the connector from the selected account. |
account_name | Ad Account Name | campaign_daily | The ad account name as Snapchat reports it at read time. Filled by the connector; falls back to the account id, never blank. |
android_installs | Android Installs | campaign_daily | Android app installs attributed to the ads. Adds up across days and entities. |
attachment_avg_view_time_millis | Attachment Average View Time (ms) | campaign_daily | Average time spent on the attachment per attachment impression. In milliseconds. It is an AVERAGE for the row: summing it across rows gives a meaningless number. |
attachment_impressions | Attachment Impressions | campaign_daily | Impressions of the ad's attachment, as Snapchat counts them. Adds up across days and entities. |
attachment_quartile_1 | Attachment Video Views to 25% | campaign_daily | Attachment video views that reached 25 %. Adds up across days and entities. |
attachment_quartile_2 | Attachment Video Views to 50% | campaign_daily | Attachment video views that reached 50 %. Adds up across days and entities. |
attachment_quartile_3 | Attachment Video Views to 75% | campaign_daily | Attachment video views that reached 75 %. Adds up across days and entities. |
attachment_total_view_time_millis | Attachment View Time (ms) | campaign_daily | Total time spent on the attachment. In milliseconds. Adds up across days and entities. |
attachment_video_views | Attachment Video Views | campaign_daily | Video views on the attachment. Adds up across days and entities. |
attachment_view_completion | Attachment Video Completions | campaign_daily | Attachment video views that reached the end. Adds up across days and entities. |
avg_screen_time_millis | Average Screen Time (ms) | campaign_daily | Average time an ad was on screen per impression. In milliseconds. It is an AVERAGE for the row: summing it across rows gives a meaningless number. |
campaign_id | Campaign ID | campaign_daily | The Snapchat campaign id. |
campaign_name | Campaign Name | campaign_daily | The campaign name as it is now, deleted campaigns included. Falls back to the id. |
campaign_objective | Campaign Objective | campaign_daily | The campaign objective (SALES, TRAFFIC, AWARENESS_AND_ENGAGEMENT…). |
campaign_status | Campaign Status | campaign_daily | The campaign status as it is now (ACTIVE, PAUSED), not as it was on the row's day. |
conversion_achievement_unlocked | Achievements Unlocked | campaign_daily | Achievements Unlocked conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_achievement_unlocked_value | Achievements Unlocked Value | campaign_daily | Value of the Achievements Unlocked conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_ad_click | Ad Clicks (Conversion) | campaign_daily | Ad Clicks (Conversion) conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_ad_click_value | Ad Clicks (Conversion) Value | campaign_daily | Value of the Ad Clicks (Conversion) conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_ad_view | Ad Views (Conversion) | campaign_daily | Ad Views (Conversion) conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_ad_view_value | Ad Views (Conversion) Value | campaign_daily | Value of the Ad Views (Conversion) conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_add_billing | Add Billing | campaign_daily | Add Billing conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_add_billing_value | Add Billing Value | campaign_daily | Value of the Add Billing conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_add_cart | Add to Cart | campaign_daily | Add to Cart conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_add_cart_value | Add to Cart Value | campaign_daily | Value of the Add to Cart conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_add_to_wishlist | Add to Wishlist | campaign_daily | Add to Wishlist conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_add_to_wishlist_value | Add to Wishlist Value | campaign_daily | Value of the Add to Wishlist conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_app_opens | App Opens | campaign_daily | App Opens conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_app_opens_value | App Opens Value | campaign_daily | Value of the App Opens conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_complete_tutorial | Tutorial Completes | campaign_daily | Tutorial Completes conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_complete_tutorial_value | Tutorial Completes Value | campaign_daily | Value of the Tutorial Completes conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_invite | Invites | campaign_daily | Invites conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_invite_value | Invites Value | campaign_daily | Value of the Invites conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_level_completes | Level Completes | campaign_daily | Level Completes conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_level_completes_value | Level Completes Value | campaign_daily | Value of the Level Completes conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_list_view | List Views | campaign_daily | List Views conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_list_view_value | List Views Value | campaign_daily | Value of the List Views conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_login | Logins | campaign_daily | Logins conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_login_value | Logins Value | campaign_daily | Value of the Logins conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_page_views | Page Views | campaign_daily | Page Views conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_page_views_value | Page Views Value | campaign_daily | Value of the Page Views conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_purchases | Purchases | campaign_daily | Purchases conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_purchases_value | Purchases Value | campaign_daily | Value of the Purchases conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_rate | Ratings | campaign_daily | Ratings conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_rate_value | Ratings Value | campaign_daily | Value of the Ratings conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_reserve | Reservations | campaign_daily | Reservations conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_reserve_value | Reservations Value | campaign_daily | Value of the Reservations conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_save | Save | campaign_daily | Save conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_save_value | Save Value | campaign_daily | Value of the Save conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_searches | Searches | campaign_daily | Searches conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_searches_value | Searches Value | campaign_daily | Value of the Searches conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_share | Shares (Conversion) | campaign_daily | Shares (Conversion) conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_share_value | Shares (Conversion) Value | campaign_daily | Value of the Shares (Conversion) conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_sign_ups | Sign Ups | campaign_daily | Sign Ups conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_sign_ups_value | Sign Ups Value | campaign_daily | Value of the Sign Ups conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_spend_credits | Spend Credits | campaign_daily | Spend Credits conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_spend_credits_value | Spend Credits Value | campaign_daily | Value of the Spend Credits conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_start_checkout | Start Checkout | campaign_daily | Start Checkout conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_start_checkout_value | Start Checkout Value | campaign_daily | Value of the Start Checkout conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_start_trial | Start Trial | campaign_daily | Start Trial conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_start_trial_value | Start Trial Value | campaign_daily | Value of the Start Trial conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_subscribe | Subscribe | campaign_daily | Subscribe conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_subscribe_value | Subscribe Value | campaign_daily | Value of the Subscribe conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_view_content | View Content | campaign_daily | View Content conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_view_content_value | View Content Value | campaign_daily | Value of the View Content conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
conversion_visit | Visits | campaign_daily | Visits conversions. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. Adds up across days and entities. |
conversion_visit_value | Visits Value | campaign_daily | Value of the Visits conversions, as the pixel or the Conversions API reported it. Attributed with Snapchat's default windows, sent explicitly: 28 days after a swipe and 1 day after a view, counted on the day of the conversion. In the ad account's currency (see Currency). Adds up across days and entities. |
date | Date | campaign_daily | The day in the ad account's timezone, as Snapchat reports it. Snapchat finalizes a day 48 hours after it ends, so the two most recent days can still change. Days after today are not read. |
earned_impressions | Earned Impressions | campaign_daily | Impressions Snapchat counts as earned, not paid for. Adds up across days and entities. |
engaged_views | Engaged Views | campaign_daily | Engaged views, as Snapchat counts them. Adds up across days and entities. |
impressions | Impressions | campaign_daily | Times an ad was served. Adds up across days and entities. |
ios_installs | iOS Installs | campaign_daily | iOS app installs attributed to the ads. Adds up across days and entities. |
landing_page_views | Landing Page Views | campaign_daily | Landing page loads after a swipe up. Adds up across days and entities. |
native_leads | Leads | campaign_daily | Leads collected with Snapchat lead forms. Adds up across days and entities. |
paid_impressions | Paid Impressions | campaign_daily | Impressions that were paid for. Adds up across days and entities. |
place_actions | Place Actions | campaign_daily | Place actions, as Snapchat counts them. Adds up across days and entities. |
place_opens | Place Opens | campaign_daily | Place opens, as Snapchat counts them. Adds up across days and entities. |
play_time_millis | Play Time (ms) | campaign_daily | Play time, as Snapchat reports it. In milliseconds. Adds up across days and entities. |
profile_clicks | Profile Clicks | campaign_daily | Taps to the advertiser's public profile. Adds up across days and entities. |
quartile_1 | Video Views to 25% | campaign_daily | Video views that reached 25 % of the video. Adds up across days and entities. |
quartile_2 | Video Views to 50% | campaign_daily | Video views that reached 50 % of the video. Adds up across days and entities. |
quartile_3 | Video Views to 75% | campaign_daily | Video views that reached 75 % of the video. Adds up across days and entities. |
reminders_set | Reminders Set | campaign_daily | Reminders set from the ad. Adds up across days and entities. |
saves | Saves | campaign_daily | Times the ad was saved. Adds up across days and entities. |
screen_time_millis | Screen Time (ms) | campaign_daily | Total time the ads were on screen. In milliseconds. Adds up across days and entities. |
shares | Shares | campaign_daily | Times the ad was shared. Adds up across days and entities. |
spend | Spend | campaign_daily | Amount spent. In the ad account's currency (see Currency). Adds up across days and entities. |
story_completes | Story Completes | campaign_daily | Story ad completions. Adds up across days and entities. |
story_opens | Story Opens | campaign_daily | Story ad opens. Adds up across days and entities. |
swipe_up_percent | Swipe Up Rate | campaign_daily | Swipe ups divided by impressions, as a fraction (0.0213 is 2.13 %), rounded by Snapchat to four decimals. It is an AVERAGE for the row: summing it across rows gives a meaningless number. |
swipes | Swipe Ups | campaign_daily | Swipe ups (taps) on the ad. Adds up across days and entities. |
total_impressions | Total Impressions | campaign_daily | Paid plus earned impressions (equal to their sum on every row measured). Adds up across days and entities. |
total_installs | Installs | campaign_daily | App installs attributed to the ads. Adds up across days and entities. |
video_views | Video Views | campaign_daily | Video views, as Snapchat counts them. Adds up across days and entities. |
video_views_15s | Video Views (15s) | campaign_daily | Video views of at least 15 seconds. Adds up across days and entities. |
video_views_5s | Video Views (5s) | campaign_daily | Video views of at least 5 seconds. Adds up across days and entities. |
video_views_time_based | Video Views (Time Based) | campaign_daily | Time-based video views, as Snapchat counts them. Adds up across days and entities. |
view_completion | Video Completions | campaign_daily | Video views that reached the end of the video. Adds up across days and entities. |