Snapchat Ads Metrics and Dimensions

Field group
Field
Type
Data type
Description
PerformanceImpressions
METRIC
INTEGERThe amount of impressions for an ad
PerformanceUnique impressions
METRIC
INTEGERThe amount of unique impressions
PerformancePaid impressions
METRIC
INTEGERThe amount of paid impressions for the ad
PerformanceSwipes
METRIC
INTEGERSwipe up count
PerformanceAmount Spent
METRIC
MICRO_CURRENCYThe amount spent on the ad.
EngagementsScreen time
METRIC
SECONDSTotal time spent on top Snap Ad
EngagementsFirst quartile views
METRIC
INTEGERVideo Views to 25%
EngagementsSecond quartile views
METRIC
INTEGERVideo Views to 50%
EngagementsThird quartile views
METRIC
INTEGERVideo Views to 75%
EngagementsView completions
METRIC
INTEGERVideo Views to ~100%
EngagementsVideo views
METRIC
INTEGERThe 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
EngagementsVideo views 15 seconds
METRIC
INTEGERThe 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
SpendeCPM
METRIC
FLOATThe effective cost per thousand impressions
SpendeCPV
METRIC
FLOATThe effective cost per video view
DeliveryReach
METRIC
INTEGERThe number of unique Snapchatters who viewed your Lens ad, either by receiving a Paid or Earned Impression.
DeliveryFrequency
METRIC
FLOATThe average amount of impressions per user reached
AttachmentsAttachment frequency
METRIC
INTEGERThe average amount of impressions per user reached for the attachment
AttachmentsSwipe up rate
METRIC
FLOATThe percent of impressions that Swiped-Up
AttachmentseCPSU
METRIC
FLOATThe effective cost for a swipe-up
AttachmentsAttachment avg. view
METRIC
SECONDSThe average view time in seconds for the attachment
AttachmentsAttachment total view time
METRIC
SECONDSThe total view time in seconds for the attachment
AttachmentsAttachment impressions
METRIC
INTEGERThe amount of impressions for the attachment
AttachmentsAttachment uniques
METRIC
INTEGERThe average amount of unique impressions for the attachment
App InstallsTotal app installs
METRIC
INTEGERThe total amount of app installs
App InstallsAndroid installs
METRIC
INTEGERThe amount of installs on the Android platform
App InstallsiOS installs
METRIC
INTEGERThe amount of installs on the iOS platform
App InstallseCPI
METRIC
FLOATThe effective cost per app install
App InstallsApplication install rate
METRIC
FLOATThe rate of app installs of all impressions
Long Form Video25% attachment quartile
METRIC
INTEGERThe amount of long form videos views to 25% completion
Long Form Video50% attachment quartile
METRIC
INTEGERThe amount of long form videos views to 50% completion
Long Form Video75% attachment quartile
METRIC
INTEGERThe amount of long form videos views to 75% completion
Long Form VideoAttachment completions
METRIC
INTEGERThe amount of long form videos views to completion
Long Form VideoAttachment video views
METRIC
INTEGERThe amount of long form video views viewed for at least 10 seconds or 97% of the video duration
Long Form VideoCost per long form video view
METRIC
FLOATThe cost per long form video view
CameraCamera saves
METRIC
INTEGERThe amount of saves for a camera ad
CameraCamera shares
METRIC
INTEGERThe amount of shares for a camera ad
CameraEarned impressions
METRIC
INTEGEREarned impressions for the camera ad
CameraCamera save rate
METRIC
FLOATThe save rate for the camera ad
CameraCamera share rate
METRIC
FLOATThe share rate for the camera ad
CameraeCPS
METRIC
FLOATThe effective cost per share for the camera ad
Story AdsStory opens
METRIC
INTEGERThe amount of opens for the story ad
Story AdsCost per story open
METRIC
FLOATThe cost per open for the story ad
Story AdsStory open rate
METRIC
FLOATThe open rate for the story ad
Story AdsStory completes
METRIC
INTEGERThe amount of completes for the story ad
Story AdsStory complete rate
METRIC
FLOATThe complete rate for the story ad
LeadsLeads
METRIC
INTEGERTotal number of users that fill out submit Lead Form attachments
LeadsCost per lead
METRIC
CURRENCYCost per Lead Form submissions
ConversionPurchase ROAS
METRIC
CURRENCYPurchase Return on Ad spend
ConversionPurchases value
METRIC
MICRO_CURRENCYThe total value of purchases
ConversionPurchases value swipe up
METRIC
INTEGERThe total value of purchases attributed to swipe-ups
ConversionPurchases value view
METRIC
INTEGERThe total value of purchases attributed to view
ConversionPurchases
METRIC
INTEGERThe amount of purchases
ConversionAchievement unlocked
METRIC
INTEGERThe number of achievements unlocked
ConversionAchievement unlocked swipe ups
METRIC
INTEGER# of attributed CONVERSION_ACHIEVEMENT_UNLOCKED conversion events attributed to swipe-ups
ConversionAchievement unlocked views
METRIC
INTEGER# of attributed CONVERSION_ACHIEVEMENT_UNLOCKED conversion events attributed to views
ConversionAchievement unlocked value
METRIC
INTEGER# of attributed CONVERSION_ACHIEVEMENT_UNLOCKED conversion events value
ConversionCost per achievement unlocked
METRIC
FLOATCost per achievement unlocked conversion
ConversionPurchases swipe up
METRIC
INTEGERThe amount of purchases attributed to swipe-ups
ConversionPurchases view
METRIC
INTEGERThe amount of purchases attributed to view
ConversionCost per purchase
METRIC
INTEGERThe cost per purchase
ConversionConversion save
METRIC
INTEGERThe amount of saves
ConversionSave swipe up
METRIC
INTEGERThe amount of saves attributed to swipe-ups
ConversionSave view
METRIC
INTEGERThe amount of saves attributed to view
ConversionCost per save
METRIC
FLOATThe cost per save
ConversionConversion app opens
METRIC
INTEGERThe amount of app opens
ConversionApp opens swipe up
METRIC
INTEGERThe amount of app opens attributed to swipe-ups
ConversionApp opens view
METRIC
INTEGERThe amount of app opens attributed to view
ConversionConversion add billing
METRIC
INTEGERThe amount of billing adds
ConversionAdd billing swipe up
METRIC
INTEGERThe amount of billing adds attributed to swipe-ups
ConversionAdd billing view
METRIC
INTEGERThe amount of billing adds attributed to view
ConversionCost per add billing
METRIC
INTEGERThe cost per add billing
ConversionAdd to cart
METRIC
INTEGERThe amount of adds to cart
ConversionAdd to cart swipe up
METRIC
INTEGERThe amount of adds to cart attributed to swipe-ups
ConversionAdd to cart view
METRIC
INTEGERThe amount of adds to cart attributed to view
ConversionCost per add to cart
METRIC
FLOATThe cost per add to cart
ConversionConversion level completes
METRIC
INTEGERThe amount of level completes
ConversionLevel complete swipe up
METRIC
INTEGERThe amount of level completes attributed to swipe-ups
ConversionLevel complete view
METRIC
INTEGERThe amount of level completes attributed to view
ConversionConversion page views
METRIC
INTEGERThe amount of page views
ConversionPage views swipe up
METRIC
INTEGERThe amount of page views attributed to swipe-ups
ConversionPage views view
METRIC
INTEGERThe amount of page views attributed to view
ConversionCost per page view
METRIC
FLOATThe cost per page view
ConversionConversion searches
METRIC
INTEGERThe amount of searches
ConversionSearches swipe up
METRIC
INTEGERThe amount of searches attributed to swipe-ups
ConversionSearches view
METRIC
INTEGERThe amount of searces attributed to view
ConversionCost per search
METRIC
FLOATThe cost per search
ConversionSign ups
METRIC
INTEGERThe amount of sign-ups
ConversionSign ups swipe up
METRIC
INTEGERThe amount of sign-ups attributed to swipe-ups
ConversionSign ups view
METRIC
INTEGERThe amount of sign-ups attributed to view
ConversionCost per sign up
METRIC
FLOATThe cost per sign up
ConversionConversion view content
METRIC
INTEGERThe amount of content views
ConversionContent views swipe up
METRIC
INTEGERThe amount of content views attributed to swipe-ups
ConversionContent views view
METRIC
INTEGERThe amount of content views attributed to view
ConversionCost per content view
METRIC
FLOATThe cost per content view
ConversionConversion start checkout
METRIC
INTEGERThe amount of started checkouts
ConversionStarted checkouts swipe up
METRIC
INTEGERThe amount of started checkouts attributed to swipe-ups
ConversionStarted checkouts view
METRIC
INTEGERThe amount of started checkouts attributed to view
ConversionCost per start checkout
METRIC
FLOATThe cost per start checkout
ConversionCustom event 1
METRIC
INTEGERThe amount of CUSTOM_EVENT_1 conversions
ConversionCustom event 1 swipe ups
METRIC
INTEGERThe amount of CUSTOM_EVENT_1 conversions attributed to swipe-ups
ConversionCustom event 1 views
METRIC
INTEGERThe amount of CUSTOM_EVENT_1 conversions attributed to views
ConversionCost per custom event 1
METRIC
FLOATCost per CUSTOM_EVENT_1 conversion
ConversionCustom event 2
METRIC
INTEGERThe amount of CUSTOM_EVENT_2 conversions
ConversionCustom event 2
METRIC
INTEGERThe amount of CUSTOM_EVENT_2 conversions attributed to swipe-ups
ConversionCustom event 2
METRIC
INTEGERThe amount of CUSTOM_EVENT_2 conversions attributed to views
ConversionCost per custom event 2
METRIC
FLOATCost per CUSTOM_EVENT_2 conversion
ConversionCustom event 3
METRIC
INTEGERThe amount of CUSTOM_EVENT_3 conversions
ConversionCustom event 3 swipe ups
METRIC
INTEGERThe amount of CUSTOM_EVENT_3 conversions attributed to swipe-ups
ConversionCustom event 3
METRIC
INTEGERThe amount of CUSTOM_EVENT_3 conversions attributed to views
ConversionCost per custom event 3
METRIC
FLOATCost per CUSTOM_EVENT_3 conversion
ConversionCustom event 4
METRIC
INTEGERThe amount of CUSTOM_EVENT_4 conversions
ConversionCustom event 4 swipe ups
METRIC
INTEGERThe amount of CUSTOM_EVENT_4 conversions attributed to swipe-ups
ConversionCustom event 4 views
METRIC
INTEGERThe amount of CUSTOM_EVENT_4 conversions attributed to views
ConversionCost per custom event 4
METRIC
FLOATCost per CUSTOM_EVENT_4 conversion
ConversionCustom event 5
METRIC
INTEGERThe amount of CUSTOM_EVENT_5 conversions
ConversionCustom event 5 swipe ups
METRIC
INTEGERThe amount of CUSTOM_EVENT_5 conversions attributed to swipe-ups
ConversionCustom event 5 views
METRIC
INTEGERThe amount of CUSTOM_EVENT_5 conversions attributed to views
ConversionCost per custom event 5
METRIC
FLOATCost per CUSTOM_EVENT_5 conversion
ConversionSubscribes
METRIC
INTEGER# of attributed SUBSCRIBE conversion events
ConversionSubscribes swipe ups
METRIC
INTEGER# of attributed SUBSCRIBE conversion events attributed to swipe-ups
ConversionSubscribes views
METRIC
INTEGER# of attributed SUBSCRIBE conversion events attributed to views
ConversionSubscribes value
METRIC
INTEGER# of attributed SUBSCRIBE conversion events value
ConversionCost per subscribe conversion
METRIC
FLOATCost per subscribe conversion
ConversionAd clicks
METRIC
INTEGER# of attributed CONVERSION_AD_CLICK conversion events
ConversionAd clicks swipe ups
METRIC
INTEGER# of attributed CONVERSION_AD_CLICK conversion events attributed to swipe-ups
ConversionAd clicks views
METRIC
INTEGER# of attributed CONVERSION_AD_CLICK conversion events attributed to views
ConversionAd clicks value
METRIC
INTEGER# of attributed CONVERSION_AD_CLICK conversion events value
ConversionCost per ad click
METRIC
FLOATCost per ad click conversion
ConversionAd views
METRIC
INTEGER# of attributed CONVERSION_AD_VIEW conversion events
ConversionAd views swipe ups
METRIC
INTEGER# of attributed CONVERSION_AD_VIEW conversion events attributed to swipe-ups
ConversionAd views views
METRIC
INTEGER# of attributed CONVERSION_AD_VIEW conversion events attributed to views
ConversionAd views value
METRIC
INTEGER# of attributed CONVERSION_AD_VIEW conversion events value
ConversionCost per ad view
METRIC
FLOATCost per ad view conversion
ConversionCompleted tutorials
METRIC
INTEGER# of attributed CONVERSION_COMPLETE_TUTORIAL conversion events
ConversionCompleted tutorials swipe ups
METRIC
INTEGER# of attributed CONVERSION_COMPLETE_TUTORIAL conversion events attributed to swipe-ups
ConversionCompleted tutorials views
METRIC
INTEGER# of attributed CONVERSION_COMPLETE_TUTORIAL conversion events attributed to views
ConversionCompleted tutorials value
METRIC
INTEGER# of attributed CONVERSION_COMPLETE_TUTORIAL conversion events value
ConversionCost per completed tutorial
METRIC
FLOATCost per completed tutorial
ConversionInvites sent
METRIC
INTEGER# of attributed CONVERSION_INVITE conversion events
ConversionInvites sent swipe ups
METRIC
INTEGER# of attributed CONVERSION_INVITE conversion events attributed to swipe-ups
ConversionInvites sent views
METRIC
INTEGER# of attributed CONVERSION_INVITE conversion events attributed to views
ConversionInvites sent value
METRIC
INTEGER# of attributed CONVERSION_INVITE conversion events value
ConversionCost per invites sent
METRIC
FLOATCost per invites sent conversion
ConversionConversion login
METRIC
INTEGER# of attributed CONVERSION_LOGIN conversion events
ConversionLogins swipe ups
METRIC
INTEGER# of attributed CONVERSION_LOGIN conversion events attributed to swipe-ups
ConversionLogins views
METRIC
INTEGER# of attributed CONVERSION_LOGIN conversion events attributed to views
ConversionLogins value
METRIC
INTEGER# of attributed CONVERSION_LOGIN conversion events value
ConversionCost per login
METRIC
FLOATCost per login conversion
ConversionConversion share
METRIC
INTEGER# of attributed CONVERSION_SHARE conversion events
ConversionShares swipe ups
METRIC
INTEGER# of attributed CONVERSION_SHARE conversion events attributed to swipe-ups
ConversionShares views
METRIC
INTEGER# of attributed CONVERSION_SHARE conversion events attributed to views
ConversionShares value
METRIC
INTEGER# of attributed CONVERSION_SHARE conversion events value
ConversionCost per share
METRIC
FLOATCost per share conversion
ConversionConversion reserve
METRIC
INTEGER# of attributed CONVERSION_RESERVE conversion events
ConversionReservations swipe ups
METRIC
INTEGER# of attributed CONVERSION_RESERVE conversion events attributed to swipe-ups
ConversionReservations views
METRIC
INTEGER# of attributed CONVERSION_RESERVE conversion events attributed to views
ConversionReservations value
METRIC
INTEGER# of attributed CONVERSION_RESERVE conversion events value
ConversionCost per reservation
METRIC
FLOATCost per reservation conversion
ConversionAdds to wishlist
METRIC
INTEGER# of attributed CONVERSION_ADD_TO_WISHLIST conversion events
ConversionAdds to wishlist swipe ups
METRIC
INTEGER# of attributed CONVERSION_ADD_TO_WISHLIST conversion events attributed to swipe-ups
ConversionAdds to wishlist views
METRIC
INTEGER# of attributed CONVERSION_ADD_TO_WISHLIST conversion events attributed to views
ConversionAdds to wishlist value
METRIC
INTEGER# of attributed CONVERSION_ADD_TO_WISHLIST conversion events value
ConversionCost per add to wishlist
METRIC
FLOATCost per add to wishlist conversion
ConversionCredits spent
METRIC
INTEGER# of attributed CONVERSION_SPEND_CREDITS conversion events
ConversionCredits spent swipe ups
METRIC
INTEGER# of attributed CONVERSION_SPEND_CREDITS conversion events attributed to swipe-ups
ConversionCredits spent views
METRIC
INTEGER# of attributed CONVERSION_SPEND_CREDITS conversion events attributed to views
ConversionCredits spent value
METRIC
INTEGER# of attributed CONVERSION_SPEND_CREDITS conversion events value
ConversionCost per credit spent
METRIC
FLOATCost per credit spent conversion
ConversionRates submitted
METRIC
INTEGER# of attributed CONVERSION_RATE conversion events
ConversionRates submitted swipe ups
METRIC
INTEGER# of attributed CONVERSION_RATE conversion events attributed to swipe-ups
ConversionRates submitted views
METRIC
INTEGER# of attributed CONVERSION_RATE conversion events attributed to views
ConversionRates submitted value
METRIC
INTEGER# of attributed CONVERSION_RATE conversion events value
ConversionCost per rate submitted conversion
METRIC
FLOATCost per rate submitted conversion
ConversionTrial starts
METRIC
INTEGER# of attributed CONVERSION_START_TRIAL conversion events
ConversionTrial starts swipe ups
METRIC
INTEGER# of attributed CONVERSION_START_TRIAL conversion events attributed to swipe-ups
ConversionTrial starts views
METRIC
INTEGER# of attributed CONVERSION_START_TRIAL conversion events attributed to views
ConversionTrial starts value
METRIC
INTEGER# of attributed CONVERSION_START_TRIAL conversion events value
ConversionCost per trial start
METRIC
FLOATCost per trial start conversion
ConversionLists viewed
METRIC
INTEGER# of attributed LIST_VIEW conversion events
ConversionLists viewed swipe ups
METRIC
INTEGER# of attributed LIST_VIEW conversion events attributed to swipe-ups
ConversionLists viewed views
METRIC
INTEGER# of attributed LIST_VIEW conversion events attributed to views
ConversionLists viewed value
METRIC
INTEGER# of attributed LIST_VIEW conversion events value
ConversionStore visits
METRIC
INTEGER# of attributed VISIT conversion events
ConversionStore visits swipe ups
METRIC
INTEGER# of attributed VISIT conversion events attributed to swipe-ups
ConversionStore visits views
METRIC
INTEGER# of attributed VISIT conversion events attributed to views
ConversionStore visits value
METRIC
INTEGER# of attributed VISIT conversion events value
TimeYear
DIMENSION
YEARYear in the format 2022
TimeYear month
DIMENSION
YEARMONTHYear & Month in the format 2022-Nov
TimeYear month number
DIMENSION
YEAR_MONTH_NUMBERYear & Month in the format 2022-09
TimeMonth
DIMENSION
MONTHNAMEYou will get one result set for each calendar month in the given period.
TimeMonth number
DIMENSION
MONTHYou will get one result set for each calendar month in the given period.
TimeWeek number(sun-sat)
DIMENSION
WEEK_NUMBERWeek number. You will get one result set for every 7 Days in the given period
TimeWeek number(mon-sun)
DIMENSION
WEEK_ISO_NUMBERISO week number, where each week starts on Monday.
TimeWeek start date(sun - sat)
DIMENSION
WEEK_START_DATEStart date of the week.
TimeWeek start date(mon - sun)
DIMENSION
WEEK_ISO_START_DATEStart date of the ISO week.
TimeDate
DIMENSION
DATEYou will get one result set for each day in the given period
TimeHour
DIMENSION
HOURHour based on the time zone of the advertising account.
Ad AccountsAd account name
DIMENSION
STRINGThe name of the ad account
Ad AccountsAd account ID
DIMENSION
STRINGThe unique identifier of the ad account
Ad AccountsAd account currency
DIMENSION
STRINGThe currency of the ad account
Ad AccountsAd account type
DIMENSION
STRINGThe type of the ad account
Ad AccountsAd account status
DIMENSION
STRINGThe status of the ad account
Ad AccountsAd account organization ID
DIMENSION
STRINGThe unique identifier of the organization of the ad account
Ad AccountsAd account timezone
DIMENSION
STRINGThe timezone of the ad account
CampaignCampaign name
DIMENSION
STRINGThe name of the campaign
CampaignCampaign ID
DIMENSION
STRINGThe unique identifier of the campaign
CampaignCampaign status
DIMENSION
STRINGThe status of the campaign
CampaignCampaign start date
DIMENSION
DATEThe date when the campaign started
CampaignCampaign end date
DIMENSION
DATEThe date when the campaign ended
CampaignCampaign start datetime
DIMENSION
DATETIMEThe date and time when the campaign started
CampaignCampaign end datetime
DIMENSION
DATETIMEThe date when when the campaign ended
CampaignCampaign created date
DIMENSION
DATEThe date when the campaign was created.
CampaignCampaign updated date
DIMENSION
DATEThe date when the campaign was last updated.
CampaignCampaign created datetime
DIMENSION
DATETIMEThe date and time when the campaign was created.
CampaignCampaign updated datetime
DIMENSION
DATETIMEThe date and time when the campaign was last updated.
CampaignCampaign objective
DIMENSION
STRINGThe objective of the Campaign
Ad SquadAd squad name
DIMENSION
STRINGThe name of the ad squad.
Ad SquadAd squad ID
DIMENSION
STRINGThe unique identifier of the ad squad
Ad SquadAd squad status
DIMENSION
STRINGThe current status of the ad squad.
Ad SquadAd squad start date
DIMENSION
DATEThe date when the squad started.
Ad SquadAd squad end date
DIMENSION
DATEThe date when the squad ended.
Ad SquadAd squad start datetime
DIMENSION
DATETIMEThe date and time when the ad squad started.
Ad SquadAd squad end datetime
DIMENSION
DATETIMEThe date and time when the ad squad ended.
Ad SquadAd squad created date
DIMENSION
DATEThe date when the ad squad was created
Ad SquadAd squad updated date
DIMENSION
DATEThe date when the ad squad was last updated.
Ad SquadAd squad created datetime
DIMENSION
DATETIMEThe date and time when the ad squad was created.
Ad SquadAd squad updated datetime
DIMENSION
DATETIMEThe date and time when the ad squad was last updated.
Ad SquadAd squad type
DIMENSION
STRINGThe type of the ad squad.
Ad SquadAd squad placement
DIMENSION
STRINGThe placement of the ad squad.
Ad SquadAd squad event
DIMENSION
STRINGThe billing event of the ad squad
Ad SquadAd squad daily budget
DIMENSION
STRINGThe daily budget of the ad squad.
Ad SquadAd squad optimization goal
DIMENSION
STRINGThe optimization goal of the ad squad.
AdAd name
DIMENSION
STRINGThe name of the ad
AdAd ID
DIMENSION
STRINGThe unique identifier of the ad
AdAd status
DIMENSION
STRINGThe status of the ad
AdAd created date
DIMENSION
DATEThe date when the ad was created.
AdAd updated date
DIMENSION
DATEThe date when the ad was last updated.
AdAd created datetime
DIMENSION
DATETIMEThe date and time when the ad was created.
AdAd updated datetime
DIMENSION
DATETIMEThe date and time when the ad was last updated.
AdAd review status
DIMENSION
STRINGThe review status of the ad
AdAd type
DIMENSION
STRINGThe type of the ad
CreativeCreative name
DIMENSION
STRINGThe name of the creative
CreativeCreative ID
DIMENSION
STRINGThe unique identifier of the creative
CreativeCreative type
DIMENSION
STRINGThe type of the creative
CreativeCreative packaging status
DIMENSION
STRINGPackaging status of the creative
CreativeCreative review
DIMENSION
STRINGThe review status of the creative
CreativeCreative is shareable
DIMENSION
STRINGWhether or not the creative is shareable
CreativePosition of cropped ad creative
DIMENSION
STRINGCreative top Snap crop position
CreativeCreative web view URL
DIMENSION
URLWeb view URL of ad creative
CountryCountry code
DIMENSION
COUNTRY_CODEThe country code of the requested insights
CountryCountry
DIMENSION
COUNTRYThe country of the requested insights
RegionRegion code
DIMENSION
REGION_CODEThe region of the requested insights
DMADMA code
DIMENSION
STRINGThe DMA code of the requested insights
DemographicGender
DIMENSION
STRINGThe gender group of the ad insights
DemographicAge group
DIMENSION
STRINGThe age group of the ad insights
Device OSOperating system
DIMENSION
STRINGThe operating system of the requested insights
Device MakeDevice Make
DIMENSION
STRINGThe make of the device for the requested insights