Snapchat
The table below gives information about all the data fields that you can import from Snapchat.
The fields that you can fetch in Adverity are updated regularly to reflect updates to data source APIs. As a result, the fields shown here may not be the same as the fields available in Adverity. If you notice a difference between this documentation and the fields you see in Adverity, please contact your Adverity account manager for more information.
To see the fields you can collect from another data source, go back to the Available fields in Adverity overview.
|
Field UI name |
Field API name |
Description |
Use in Adverity |
Docs |
|---|---|---|---|---|
|
|
ad_account_advertiser |
Advertiser Name |
dimension |
|
|
|
ad_account_currency |
Your ad account currency |
dimension |
|
|
|
ad_account_id |
Ad Account ID |
dimension |
|
|
|
ad_account_name |
Your ad account name |
dimension |
|
|
|
ad_account_timezone |
Your ad accounts timezone |
dimension |
|
|
|
ad_account_type |
Your ad account type |
dimension |
|
|
|
ad_id |
The ID of your ad |
dimension |
|
|
|
ad_name |
The name of your ad. |
dimension |
|
|
|
ad_review_status |
The review status of your ad |
dimension |
|
|
|
ad_review_status_reason |
Ad Review Status |
dimension |
|
|
|
ad_squad_bid |
Ad Squad Bid |
dimension |
|
|
|
ad_squad_billing_event |
Billing Event |
dimension |
|
|
|
ad_squad_daily_budget |
Daily Budget |
dimension |
|
|
|
ad_squad_id |
Ad squad ID |
dimension |
|
|
|
ad_squad_lifetime_budget_micro |
Lifetime budget (micro-currency) |
dimension |
|
|
|
ad_squad_name |
Ad Squad name |
dimension |
|
|
|
ad_squad_optimization_goal |
Optimization Goal |
dimension |
|
|
|
ad_squad_placement |
Placement |
dimension |
|
|
|
ad_squad_status |
Ad Squad status |
dimension |
|
|
|
ad_squad_targeting |
Targeting spec |
dimension |
|
|
|
ad_squad_type |
Ad Squad Type |
dimension |
|
|
|
ad_status |
Ad Status |
dimension |
|
|
|
ad_type |
Ad Type |
dimension |
|
|
|
android_installs |
# of Android App Installs |
metric |
|
|
|
android_installs_swipe_up |
# of Android App Installs after Swipe Ups |
metric |
|
|
|
android_installs_view |
# of Android App Installs (Viewthrough) |
metric |
|
|
|
attachment_avg_view_time_millis |
Average Attachment View Time (milli-seconds) |
metric |
|
|
|
attachment_quartile_1 |
Long Form Video Views to 25% |
metric |
|
|
|
attachment_quartile_2 |
Long Form Video Views to 50% |
metric |
|
|
|
attachment_quartile_3 |
Long Form Video Views to 75% |
metric |
|
|
|
attachment_total_view_time_millis |
Total Attachment View Time (milli-seconds) |
metric |
|
|
|
attachment_view_completion |
Long Form Video Views to completion |
metric |
|
|
|
avg_view_time_millis |
Use avg_screen_time_millis instead. Average Top Snap view time per User Reached |
metric |
|
|
|
campaign_daily_budget_micro |
Daily Budget |
dimension |
|
|
|
campaign_end_time |
End Date of campaign |
dimension |
|
|
|
campaign_id |
Campaign ID |
dimension |
|
|
|
campaign_lifetime_spend_cap_micro |
Lifetime spend cap for the campaign (microcurrency) |
dimension |
|
|
|
campaign_measurement_spec |
The apps to be tracked for this campaign |
dimension |
|
|
|
campaign_name |
Campaign Name |
dimension |
|
|
|
campaign_objective |
Objective of the Campaign |
dimension |
|
|
|
campaign_start_time |
Start time |
dimension |
|
|
|
campaign_status |
Campaign status |
dimension |
|
|
|
conversion_add_billing |
# of attributed “ADD_BILLING” conversion events |
metric |
|
|
|
conversion_add_billing_swipe_up |
# of attributed “ADD_BILLING” conversion events after Swipe Up |
metric |
|
|
|
conversion_add_billing_view |
# of attributed “ADD_BILLING” conversion events (Viewthrough) |
metric |
|
|
|
conversion_add_cart |
# of attributed “ADD_CART” conversion events |
metric |
|
|
|
conversion_add_cart_swipe_up |
# of attributed “ADD_CART” conversion events after Swipe Up |
metric |
|
|
|
conversion_add_cart_view |
# of attributed “ADD_CART” conversion events (Viewthrough) |
metric |
|
|
|
conversion_app_opens |
# of attributed “APP_OPEN” conversion events |
metric |
|
|
|
conversion_app_opens_swipe_up |
# of attributed “APP_OPEN” conversion events after Swipe Up |
metric |
|
|
|
conversion_app_opens_view |
# of attributed “APP_OPEN” conversion events (Viewthrough) |
metric |
|
|
|
conversion_level_completes |
# of attributed “LEVEL_COMPLETE” conversion events |
metric |
|
|
|
conversion_level_completes_swipe_up |
# of attributed “LEVEL_COMPLETE” conversion events after Swipe Up |
metric |
|
|
|
conversion_level_completes_view |
# of attributed “LEVEL_COMPLETE” conversion events (Viewthrough) |
metric |
|
|
|
conversion_page_views |
# of attributed “PAGE_VIEW” conversion events |
metric |
|
|
|
conversion_page_views_swipe_up |
# of attributed “PAGE_VIEW” conversion events after Swipe Up |
metric |
|
|
|
conversion_page_views_view |
# of attributed “PAGE_VIEW” conversion events (Viewthrough) |
metric |
|
|
|
conversion_purchases |
# of attributed “PURCHASE” conversion events |
metric |
|
|
|
conversion_purchases_swipe_up |
# of attributed “PURCHASE” conversion events after Swipe Up |
metric |
|
|
|
conversion_purchases_value |
Value of attributed “PURCHASE” conversion events (microcurrency in Ad Account’s currency) |
metric |
|
|
|
conversion_purchases_value_swipe_up |
Value of attributed “PURCHASE” conversion events (microcurrency in Ad Account’s currency) after Swipe Up |
metric |
|
|
|
conversion_purchases_value_view |
Value of attributed “PURCHASE” conversion events (microcurrency in Ad Account’s currency) (Viewthrough) |
metric |
|
|
|
conversion_purchases_view |
# of attributed “PURCHASE” conversion events (Viewthrough) |
metric |
|
|
|
conversion_save |
# of attributed “SAVE” conversion events |
metric |
|
|
|
conversion_save_swipe_up |
# of attributed “SAVE” conversion events after Swipe Up |
metric |
|
|
|
conversion_save_view |
# of attributed “SAVE” conversion events (Viewthrough) |
metric |
|
|
|
conversion_searches |
# of attributed “SEARCH” conversion events |
metric |
|
|
|
conversion_searches_swipe_up |
# of attributed “SEARCH” conversion events after Swipe Up |
metric |
|
|
|
conversion_searches_view |
# of attributed “SEARCH” conversion events (Viewthrough) |
metric |
|
|
|
conversion_sign_ups |
# of attributed “SIGN_UP” conversion events |
metric |
|
|
|
conversion_sign_ups_swipe_up |
# of attributed “SIGN_UP” conversion events after Swipe Up |
metric |
|
|
|
conversion_sign_ups_view |
# of attributed “SIGN_UP” conversion events (Viewthrough) |
metric |
|
|
|
conversion_start_checkout |
# of attributed “START_CHECKOUT” conversion events |
metric |
|
|
|
conversion_start_checkout_swipe_up |
# of attributed “START_CHECKOUT” conversion events after Swipe Up |
metric |
|
|
|
conversion_start_checkout_view |
# of attributed “START_CHECKOUT” conversion events (Viewthrough) |
metric |
|
|
|
conversion_view_content |
# of attributed “VIEW_CONTENT” conversion events |
metric |
|
|
|
conversion_view_content_swipe_up |
# of attributed “VIEW_CONTENT” conversion events after Swipe Up |
metric |
|
|
|
conversion_view_content_view |
# of attributed “VIEW_CONTENT” conversion events (Viewthrough) |
metric |
|
|
|
creative_ad_product |
Type of Ad Product |
dimension |
|
|
|
creative_brand_name |
Brand Name |
dimension |
|
|
|
creative_call_to_action |
Call to Action |
dimension |
|
|
|
creative_headline |
Headline (displayed under brand name) |
dimension |
|
|
|
creative_id |
Creative ID |
dimension |
|
|
|
creative_name |
Creative name |
dimension |
|
|
|
creative_playback_type |
Specifies whether the creatives within the composite auto-advance or loop |
dimension |
|
|
|
creative_preview_creative_id |
ID of the preview creative |
dimension |
|
|
|
creative_shareable |
Allow Users to Share with Friends |
dimension |
|
|
|
creative_top_snap_crop_position |
Top Snap Crop Position |
dimension |
|
|
|
creative_top_snap_media_id |
Top Snap Media ID |
dimension |
|
|
|
creative_type |
Creative Type |
dimension |
|
|
|
impressions |
Impression Count |
metric |
|
|
|
ios_installs |
# of iOS App Installs |
metric |
|
|
|
ios_installs_swipe_up |
# of iOS App Installs after Swipe up |
metric |
|
|
|
ios_installs_view |
# of iOS App Installs (Viewthrough) |
metric |
|
|
|
media_download_link |
URL to Media File |
dimension |
|
|
|
media_id |
Media ID |
dimension |
|
|
|
media_name |
Media name |
dimension |
|
|
|
media_status |
Media Status |
dimension |
|
|
|
media_type |
Media Type |
dimension |
|
|
|
organization_id |
Organization ID |
dimension |
|
|
|
organization_name |
Organization name |
dimension |
|
|
|
quartile_1 |
Video Views to 25% |
metric |
|
|
|
quartile_2 |
Video Views to 50% |
metric |
|
|
|
quartile_3 |
Video Views to 75% |
metric |
|
|
|
screen_time_millis |
Total Time Spent on top Snap Ad (milliseconds) |
metric |
|
|
|
spend |
Amount Spent (micro-currency) |
metric |
|
|
|
swipe_up_percent |
% of Impressions that Swiped-Up |
metric |
|
|
|
swipes |
Swipe-Up Count |
metric |
|
|
|
total_installs |
Total # of App Installs |
metric |
|
|
|
total_installs_swipe_up |
Total # of App Installs after Swipe Up |
metric |
|
|
|
total_installs_view |
Total # of App Installs (Viewthrough) |
metric |
|
|
|
video_views |
The 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 |
metric |
|
|
|
view_completion |
Video Views to completion |
metric |
|
|
|
view_time_millis |
Use screen_time_millis instead. Total Time Spent on top Snap Ad (milliseconds) |
metric |
|