Ad Account Id Id of a Ad Account. |
| ||||||
Account name The Account name |
| ||||||
Account type The Account type. Can be DIRECT or PARTNER. |
| ||||||
Account status The Account status. |
| ||||||
Organization ID The Organization ID. |
| ||||||
Account currency The Account currency. Can be AUD, CAD, EUR, GBP or USD. |
| ||||||
Account timezone The Account timezone. |
| ||||||
Organization ID of Advertiser Organization ID of the Advertiser selected. |
| ||||||
Id du centre de facturation |
| ||||||
Type of billing Type of billing. Can be IO or REVOLVING. |
| ||||||
Agency Representing Client The Agency Representing Client. |
| ||||||
Client paying invoices The Client Paying invoices. Required if agency_representing_client is true and if Advertiser is based in France or targeting Ads to audiences in France. |
| ||||||
Year Year such as 2017. |
| ||||||
Year Quarter Year and quarter. |
| ||||||
Year month Year and month. |
| ||||||
Year week Year and week. |
| ||||||
Date Year, month, and day. |
| ||||||
Year month day hour Year, month, day, and hour. |
| ||||||
Quarter of the year Quarter of the year |
| ||||||
Month of the year Month of the year |
| ||||||
Week of the year Week of the year |
| ||||||
Month and day Month and day |
| ||||||
Day of the week Week of the year |
| ||||||
Day of the month Day of the year |
| ||||||
Hour of the day Hour of the day |
| ||||||
Campaign Id Id of a Campaign. |
| ||||||
Campaign name The Campaign name |
| ||||||
Daily budget (Microdollar) The daily budget in microdollar. |
| ||||||
Campaign status The campaign status. |
| ||||||
Campaign start date The campaign start date and time. |
| ||||||
Ad Squad Id Id of a Ad Squad. |
| ||||||
Ad Squad name The Ad Squad name |
| ||||||
Ad Squad status The Ad Squad status. |
| ||||||
Ad Squad type The Ad Squad type. |
| ||||||
Ad Squad billing event The Ad Squad billing event. |
| ||||||
Ad Squad auto bid Get if the Ad Squad is in auto bid mode. |
| ||||||
Ad Squad target bid Get if the Ad Squad is in target bid mode. |
| ||||||
Ad Squad bid strategy Ad Squad bid strategy. |
| ||||||
Ad Squad daily budget (Micro) The Ad Squad daily budget (in micro). |
| ||||||
Ad Squad optimization goal The Ad Squad optimization goal. |
| ||||||
Ad Squad start date The Ad Squad start date and time. |
| ||||||
Ad Id Id of an Ad. |
| ||||||
Ad name The Ad name |
| ||||||
Ad status The Ad status. |
| ||||||
Ad type The Ad type. |
| ||||||
(deprecated) DATE |
| ||||||
Spend Amount Spent |
| ||||||
Swipes Swipe-Up Count |
| ||||||
Impressions Impression Count |
| ||||||
View Time (millisecondes) Use screen_time_millis instead. Total Time Spent on top Snap Ad (milliseconds) |
| ||||||
Screen time (millisecondes) Total Time Spent on top Snap Ad (milliseconds) |
| ||||||
Quartile 25% Video Views to 25% |
| ||||||
Quartile 50% Video Views to 50% |
| ||||||
Quartile 75% Video Views to 75% |
| ||||||
Views completion Video Views to completion |
| ||||||
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 |
| ||||||
Android Installs # of Android App Installs |
| ||||||
Daily budget The daily budget. |
| ||||||
View Time Use screen_time instead. Total Time Spent on top Snap Ad |
| ||||||
Screen time Total Time Spent on top Snap Ad |
| ||||||
Attachment Average View Time Average Attachment View Time |
| ||||||
Attachment Impressions |
| ||||||
Attachment to 25% Long Form Video Views to 25% |
| ||||||
Attachment to 50% Long Form Video Views to 50% |
| ||||||
Attachment to 75% Long Form Video Views to 75% |
| ||||||
Total Attachment View Time Total Attachment View Time |
| ||||||
Uniques Attachments # of unique attachment impressions |
| ||||||
Attachments view completion Long Form Video Views to completion |
| ||||||
Attachments Video Views Long Form Video Attachment Views, viewed for at least 10 consecutive seconds or reached 97% of the Long Form Video duration |
| ||||||
Average View Time Use avg_screen_time instead. Average Top Snap view time per User Reached |
| ||||||
Average screen Time Average Top Snap view time across all impressions |
| ||||||
Frequency Average # of Impressions per User Reached |
| ||||||
iOS Installs # of iOS App Installs |
| ||||||
Percent Swipe Up % of Impressions that Swiped-Up |
| ||||||
Total Installs Total # of App Installs |
| ||||||
Reach # of unique impressions |
| ||||||
Video Views Time Based The total number of impressions that meet the qualifying video view criteria of at least 2 seconds, not including swipe ups |
| ||||||
Video Views 15s The total number of impressions that meet the qualifying video view criteria of at least 15 seconds, or 97% completion if it’s shorter than 15 seconds, or a swipe up action on the ad |
| ||||||
Stories Opens # of times users tapped on the ad tile in the feed to view the Story Ad |
| ||||||
Stories Complete # of times users viewed through to the last Snap of your Story Ad |
| ||||||
Profile Clicks # of times users tapped the logo in the upper corner taking them to the profile page |
| ||||||
Profile Impressions # the impression number for this story ad position |
| ||||||
Position Screen Time # the total view time in seconds for this story ad position |
| ||||||
Position Swipe Up Rate # the swipe up rate for this story ad position |
| ||||||
Average Position Screen Time # the average view time for this story ad position |
| ||||||
Lens / Filter Shares # of times lens/filter was shared in a Chat or Story |
| ||||||
Lens / Filter Saves # of times lens/filter was saved to Memories |
| ||||||
Paid Impressions The total number of times your ad was served to a Snapchatter. Tracked when the ad fully renders on a device for the first time during a Snapchatter’s viewing session |
| ||||||
Earned Impressions The number of times your ad was viewed after being shared by a Snapchatter via Chat or Stories |
| ||||||
Total Impressions The total number of impressions (Paid and Earned) |
| ||||||
Play Time The total amount of time in where Snapchatters interacted with your Lens in the camera |
| ||||||
Total Reach The number of unique Snapchatters who viewed your Lens ad, either by receiving a Paid or Earned Impression. |
| ||||||
Earned Reach The number of unique Snapchatters who viewed the filter/lens |
| ||||||
Native Leads Total number of Snapchat users that swipe up, fill out the required fields, and hit ‘Submit’ on Lead Form attachments. If a user swipes down or cancels before hitting ‘Submit,’ this action is not counted |
| ||||||
Gender The Gender. |
| ||||||
Age The Age. |
| ||||||
Device The Device. |
| ||||||
Country Code The Country code. |
| ||||||
Country The Country. |
| ||||||
Region The Region. |
| ||||||
DMA The DMA. |
| ||||||
Purchases Number of attributed PURCHASE conversion events |
| ||||||
Purchases Swipe Up Number of attributed PURCHASE conversion swipe up |
| ||||||
Purchases View Number of attributed PURCHASE conversion view |
| ||||||
Purchases Value Value of attributed PURCHASE conversion events |
| ||||||
Purchases Value Swipe Up Value of attributed PURCHASE conversion swipe Up |
| ||||||
Purchases Value View Value of attributed PURCHASE conversion view |
| ||||||
Saves # of attributed “SAVE” conversion events |
| ||||||
Saves Swipe Up # of attributed “SAVE” conversion swipe up |
| ||||||
Saves View # of attributed “SAVE” conversion view |
| ||||||
Start Checkout # of attributed “START_CHECKOUT” conversion events |
| ||||||
Start Checkout Swipe Up # of attributed “START_CHECKOUT” conversion swipe up |
| ||||||
Start Checkout View # of attributed “START_CHECKOUT” conversion events view |
| ||||||
Add To Cart # of attributed “ADD_CART” conversion events |
| ||||||
Add To Cart Swipe Up # of attributed “ADD_CART” conversion swipe up |
| ||||||
Add To Cart View # of attributed “ADD_CART” conversion view |
| ||||||
Content View # of attributed “VIEW_CONTENT” conversion events |
| ||||||
Content View Swipe Up # of attributed “VIEW_CONTENT” conversion swipe up |
| ||||||
Content View View # of attributed “VIEW_CONTENT” conversion view |
| ||||||
Add Billing # of attributed “ADD_BILLING” conversion events |
| ||||||
Add Billing Swipe Up # of attributed “ADD_BILLING” conversion swipe up |
| ||||||
Add Billing View # of attributed “ADD_BILLING” conversion view |
| ||||||
Sign Ups # of attributed “SIGN_UP” conversion events |
| ||||||
Sign Ups Swipe Up # of attributed “SIGN_UP” conversion swipe up |
| ||||||
Sign Ups View # of attributed “SIGN_UP” conversion view |
| ||||||
Searches # of attributed “SEARCH” conversion events |
| ||||||
Searches Swipe Up # of attributed “SEARCH” conversion swipe up |
| ||||||
Searches View # of attributed “SEARCH” conversion view |
| ||||||
Level Completes # of attributed “LEVEL_COMPLETE” conversion events |
| ||||||
Level Completes Swipe Up # of attributed “LEVEL_COMPLETE” conversion swipe up |
| ||||||
Level Completes View # of attributed “LEVEL_COMPLETE” conversion view |
| ||||||
App Opens # of attributed “APP_OPEN” conversion events |
| ||||||
App Opens Swipe Up # of attributed “APP_OPEN” conversion swipe up |
| ||||||
App Opens View # of attributed “APP_OPEN” conversion view |
| ||||||
Page Views # of attributed “PAGE_VIEW” conversion events |
| ||||||
Page Views Swipe Up # of attributed “PAGE_VIEW” conversion swipe up |
| ||||||
Page Views View # of attributed “PAGE_VIEW” conversion view |
| ||||||
Subscribes of attributed “SUBSCRIBE” conversion events |
| ||||||
Subscribes Swipe Up of attributed “SUBSCRIBE” conversion swipe up |
| ||||||
Subscribes View of attributed “SUBSCRIBE” conversion view |
| ||||||
Ad Clicks # of attributed “CONVERSION_AD_CLICK” conversion events |
| ||||||
Ad Clicks Swipe Up # of attributed “CONVERSION_AD_CLICK” conversion swipe up |
| ||||||
Ad Clicks View # of attributed “CONVERSION_AD_CLICK” conversion view |
| ||||||
Ad Views # of attributed “CONVERSION_AD_VIEW” conversion events |
| ||||||
Ad Views Swipe Up # of attributed “CONVERSION_AD_VIEW” conversion swipe up |
| ||||||
Ad Views View # of attributed “CONVERSION_AD_VIEW” conversion view |
| ||||||
Completed Tutorials # of attributed “CONVERSION_COMPLETE_TUTORIAL” conversion events |
| ||||||
Completed Tutorials Swipe Up # of attributed “CONVERSION_COMPLETE_TUTORIAL” conversion swipe up |
| ||||||
Completed Tutorials View # of attributed “CONVERSION_COMPLETE_TUTORIAL” conversion view |
| ||||||
Invites Sent # of attributed “CONVERSION_INVITE” conversion events |
| ||||||
Invites Sent Swipe Up # of attributed “CONVERSION_INVITE” conversion swipe up |
| ||||||
Invites Sent View # of attributed “CONVERSION_INVITE” conversion view |
| ||||||
Logins # of attributed “CONVERSION_LOGIN” conversion events |
| ||||||
Logins Swipe Up # of attributed “CONVERSION_LOGIN” conversion swipe up |
| ||||||
Logins View # of attributed “CONVERSION_LOGIN” conversion view |
| ||||||
Shares # of attributed “CONVERSION_SHARE” conversion events |
| ||||||
Shares Swipe Up # of attributed “CONVERSION_SHARE” conversion swipe up |
| ||||||
Shares View # of attributed “CONVERSION_SHARE” conversion view |
| ||||||
Reservations # of attributed “CONVERSION_RESERVE” conversion events |
| ||||||
Reservations Swipe Up # of attributed “CONVERSION_RESERVE” conversion swipe up |
| ||||||
Reservations View # of attributed “CONVERSION_RESERVE” conversion view |
| ||||||
Achievements Unlocked # of attributed “CONVERSION_ACHIEVEMENT_UNLOCKED” conversion events |
| ||||||
Achievements Unlocked Swipe Up # of attributed “CONVERSION_ACHIEVEMENT_UNLOCKED” conversion swipe up |
| ||||||
Achievements Unlocked View # of attributed “CONVERSION_ACHIEVEMENT_UNLOCKED” conversion view |
| ||||||
Adds to Wishlist # of attributed “CONVERSION_ADD_TO_WISHLIST” conversion events |
| ||||||
Adds to Wishlist Swipe Up # of attributed “CONVERSION_ADD_TO_WISHLIST” conversion swipe up |
| ||||||
Adds to Wishlist View # of attributed “CONVERSION_ADD_TO_WISHLIST” conversion view |
| ||||||
Credits Spent # of attributed “CONVERSION_SPEND_CREDITS” conversion events |
| ||||||
Credits Spent Swipe Up # of attributed “CONVERSION_SPEND_CREDITS” conversion swipe up |
| ||||||
Credits Spent View # of attributed “CONVERSION_SPEND_CREDITS” conversion view |
| ||||||
Rates Submitted # of attributed “CONVERSION_RATE” conversion events |
| ||||||
Rates Submitted Swipe Up # of attributed “CONVERSION_RATE” conversion swipe up |
| ||||||
Rates Submitted View # of attributed “CONVERSION_RATE” conversion view |
| ||||||
Trial Starts # of attributed “CONVERSION_START_TRIAL” conversion events |
| ||||||
Trial Starts Swipe Up # of attributed “CONVERSION_START_TRIAL” conversion swipe up |
| ||||||
Trial Starts View # of attributed “CONVERSION_START_TRIAL” conversion view |
| ||||||
Lists Viewed # of attributed “LIST_VIEW” conversion events |
| ||||||
Lists Viewed Swipe Up # of attributed “LIST_VIEW” conversion swipe up |
| ||||||
Lists Viewed View # of attributed “LIST_VIEW” conversion view |
| ||||||
Store Visits # of attributed “VISIT” conversion events |
| ||||||
Store Visits Swipe Up # of attributed “VISIT” conversion swipe up |
| ||||||
Store Visits View # of attributed “VISIT” conversion view |
| ||||||
Custom Event 1 # of attributed “CUSTOM_EVENT_1” conversion events |
| ||||||
Custom Event 2 # of attributed “CUSTOM_EVENT_2” conversion events |
| ||||||
Custom Event 3 # of attributed “CUSTOM_EVENT_3” conversion events |
| ||||||
Custom Event 4 |
| ||||||
Custom Event 5 # of attributed “CUSTOM_EVENT_5” conversion events |
| ||||||
Media Id Id of an Media. |
| ||||||
Media Updated At The updated at for a media. |
| ||||||
Media Created At The created at for a media. |
| ||||||
Media name Media name |
| ||||||
Media type Media type |
| ||||||
Media status Media status |
| ||||||
Creative Id Id of an crative. |
| ||||||
Creative Updated At The updated at for a creative. |
| ||||||
Creative Created At The created at for a creative. |
| ||||||
Creative name Creative name |
| ||||||
Creative type Creative type |
| ||||||
Creative Packaging status Creative Packaging status |
| ||||||
Creative Review status Creative Review status |
| ||||||
Creative Shareable Creative Shareable |
| ||||||
Creative Call To Action Creative Call To Action |
| ||||||
Creative Top Snap Crop position Creative Top Snap Crop position |
| ||||||
Creative Top Snap Media ID Creative Top Snap Media ID |
| ||||||
Media Preview URL The preview URL for a media. |
| ||||||
Campaign objective Objective of the Campaign. Values are BRAND_AWARENESS (default), APP_CONVERSION, APP_INSTALL, CATALOG_SALES, ENGAGEMENT, LEAD_GENERATION, VIDEO_VIEW, WEB_CONVERSION, PROMOTE_STORIES, PROMOTE_PLACES. |
| ||||||
Week of the year (start Sunday) Week of the year |
| ||||||
Extracted Date The date where the extraction take times. |
| ||||||
Platform Name Return the platform name |
| ||||||
Swipe Up Rate Swipe up rate (swipe up / impressions) |
| ||||||
Cost Per Purchase Cost per purchase |
| ||||||
Cost Per Add To Cart Cost per add to cart |
| ||||||
Cost Per Content View The cost per content view |
| ||||||
Cost Per Page View The cost per page view |
|