Skip to main content

Documentation Index

Fetch the complete documentation index at: https://support.detrics.io/llms.txt

Use this file to discover all available pages before exploring further.

Last updated: May 9, 2026
45 dimensions
53 metrics
This reference covers all available dimensions and metrics for Snapchat Ads data through Detrics. Use this guide to understand what data you can extract and how to structure your queries.
Supported destinations:
Google Sheets

​
Dimensions

Dimensions are the attributes you can use to segment and group your Snapchat Ads data.

​
Account

Account ID
Unique identifier for the Snapchat ad account

Field Name: accountId
Type: dimension
Account Name
Name of the Snapchat ad account

Field Name: accountName
Type: dimension
Account Currency
ISO currency code of the ad account (e.g. USD, EUR)

Field Name: accountCurrency
Type: dimension
Account Timezone
IANA timezone of the ad account (e.g. America/Los_Angeles)

Field Name: accountTimezone
Type: dimension
Account Status
Status of the ad account (ACTIVE, PAUSED)

Field Name: accountStatus
Type: dimension
Account Type
Type of the ad account (PARTNER, DIRECT)

Field Name: accountType
Type: dimension
Organization ID
ID of the Snapchat business organization

Field Name: organizationId
Type: dimension

​
Campaign

Campaign Name
Name of the campaign

Field Name: campaignName
Type: dimension
Campaign ID
Unique identifier for the campaign

Field Name: campaignId
Type: dimension
Campaign Status
Status of the campaign (ACTIVE, PAUSED, ARCHIVED)

Field Name: campaignStatus
Type: dimension
Campaign Objective
Campaign objective (BRAND_AWARENESS, WEB_VIEW, APP_INSTALL, VIDEO_VIEW, etc.)

Field Name: campaignObjective
Type: dimension
Campaign Objective (V2)
New-format campaign objective (AWARENESS_AND_ENGAGEMENT, TRAFFIC, APP_PROMOTION, LEADS, SALES)

Field Name: campaignObjectiveV2
Type: dimension
Campaign Buy Model
Buy model of the campaign (AUCTION, RESERVED)

Field Name: campaignBuyModel
Type: dimension
Campaign Start Time
Date the campaign was scheduled to start

Field Name: campaignStartTime
Type: dimension
Campaign End Time
Date the campaign was scheduled to end

Field Name: campaignEndTime
Type: dimension
Campaign Daily Budget
Daily budget amount for the campaign in account currency

Field Name: campaignDailyBudget
Type: dimension
Campaign Lifetime Spend Cap
Total lifetime spend cap for the campaign in account currency

Field Name: campaignLifetimeSpendCap
Type: dimension

​
Ad Squad

Ad Squad Name
Name of the ad squad

Field Name: adSquadName
Type: dimension
Ad Squad ID
Unique identifier for the ad squad

Field Name: adSquadId
Type: dimension
Ad Squad Status
Status of the ad squad (ACTIVE, PAUSED)

Field Name: adSquadStatus
Type: dimension
Ad Squad Type
Type of the ad squad (SNAP_ADS, STORY)

Field Name: adSquadType
Type: dimension
Ad Squad Billing Event
Billing event for the ad squad (IMPRESSION, SWIPE)

Field Name: adSquadBillingEvent
Type: dimension
Ad Squad Bid Strategy
Bidding strategy (AUTO_BID, LOWEST_COST_WITH_MAX_BID, TARGET_COST)

Field Name: adSquadBidStrategy
Type: dimension
Ad Squad Optimization Goal
Optimization goal (IMPRESSIONS, SWIPES, INSTALLS, VIDEO_VIEWS, etc.)

Field Name: adSquadOptimizationGoal
Type: dimension
Ad Squad Daily Budget
Daily budget for the ad squad in account currency

Field Name: adSquadDailyBudget
Type: dimension
Ad Squad Lifetime Budget
Lifetime budget for the ad squad in account currency

Field Name: adSquadLifetimeBudget
Type: dimension
Ad Squad Start Time
Date the ad squad was scheduled to start

Field Name: adSquadStartTime
Type: dimension
Ad Squad End Time
Date the ad squad was scheduled to end

Field Name: adSquadEndTime
Type: dimension
Ad Squad Pacing Type
Pacing type for the ad squad (STANDARD, ACCELERATED)

Field Name: adSquadPacingType
Type: dimension
Ad Squad Delivery Constraint
Budget delivery constraint (DAILY_BUDGET, LIFETIME_BUDGET)

Field Name: adSquadDeliveryConstraint
Type: dimension
Ad Name
Name of the ad

Field Name: adName
Type: dimension
Ad ID
Unique identifier for the ad

Field Name: adId
Type: dimension
Ad Status
Status of the ad (ACTIVE, PAUSED, ARCHIVED)

Field Name: adStatus
Type: dimension
Ad Type
Type of the ad (REMOTE_WEBPAGE, APP_INSTALL, DEEP_LINK_ATTACHMENT, etc.)

Field Name: adType
Type: dimension
Ad Render Type
How the ad is rendered (STATIC, COMPOSITE)

Field Name: adRenderType
Type: dimension
Ad Review Status
Review status (APPROVED, PENDING, REJECTED)

Field Name: adReviewStatus
Type: dimension
Creative ID
ID of the creative used by the ad

Field Name: adCreativeId
Type: dimension

​
Geography

Country
ISO 2-letter country code of the user

Field Name: country
Type: dimension
Region
US-only region (state) breakdown. Cannot be combined with conversion metrics.

Field Name: region
Type: dimension
DMA
US-only Designated Market Area. Cannot be combined with conversion metrics.

Field Name: dma
Type: dimension

​
Demographics

Gender
Gender of the user (male, female, unknown)

Field Name: gender
Type: dimension
Age Bucket
Age range of the user (13-17, 18-20, 21-24, 25-34, 35-44, 45-54, 55+, 35+)

Field Name: ageBucket
Type: dimension

​
Device

Operating System
Mobile operating system (ios, android, web)

Field Name: operatingSystem
Type: dimension
Device Make
Device manufacturer (Apple, Samsung, etc.). Cannot be combined with conversion metrics.

Field Name: deviceMake
Type: dimension

​
Interests

Lifestyle Category
Snapchat lifestyle interest category

Field Name: lifestyleCategory
Type: dimension

​
Metrics

Metrics are the numerical values you can measure and analyze from your Snapchat Ads campaigns.

​
Delivery

Impressions
Total number of times the ad was shown

Field Name: impressions
Type: metric
Swipes
Total number of swipe-up actions on the ad

Field Name: swipes
Type: metric
Spend
Total amount spent in account currency

Field Name: spend
Type: metric
Unique Reach
Number of unique users reached

Field Name: uniques
Type: metric
Frequency
Average impressions per unique user

Field Name: frequency
Type: metric
Landing Page Views
Number of landing page views from the ad

Field Name: landingPageViews
Type: metric

​
Video

Video Views
Number of times the video was viewed (≥2 seconds)

Field Name: videoViews
Type: metric
Video Views (5s)
Number of times the video was viewed for at least 5 seconds

Field Name: videoViews5s
Type: metric
Video Views (15s)
Number of times the video was viewed for at least 15 seconds

Field Name: videoViews15s
Type: metric
Screen Time (Seconds)
Total screen time in seconds across all impressions

Field Name: screenTimeSeconds
Type: metric
Video 25% Views
Number of users who watched at least 25% of the video

Field Name: quartile1
Type: metric
Video 50% Views
Number of users who watched at least 50% of the video

Field Name: quartile2
Type: metric
Video 75% Views
Number of users who watched at least 75% of the video

Field Name: quartile3
Type: metric
Video 100% Views
Number of users who watched the full video

Field Name: viewCompletion
Type: metric
Engaged Views
Engaged views (15+ seconds or completed video) since Feb 2025

Field Name: engagedViews
Type: metric

​
Engagement

Profile Clicks
Number of clicks on the brand profile

Field Name: profileClicks
Type: metric
Shares
Number of times the ad was shared

Field Name: shares
Type: metric
Saves
Number of times the ad was saved

Field Name: saves
Type: metric

​
Story

Story Opens
Number of opens for Story ads

Field Name: storyOpens
Type: metric
Story Completes
Number of users who completed viewing the Story

Field Name: storyCompletes
Type: metric

​
App Install

Android Installs
Number of Android app installs from the ad

Field Name: androidInstalls
Type: metric
iOS Installs
Number of iOS app installs from the ad

Field Name: iosInstalls
Type: metric
Total Installs
Total app installs across all platforms

Field Name: totalInstalls
Type: metric

​
Lead

Native Leads
Number of leads collected via native lead form

Field Name: nativeLeads
Type: metric

​
Conversions

Purchases
Number of purchase conversions (7-day swipe + 1-day view default attribution)

Field Name: conversionPurchases
Type: metric
Sign Ups
Number of sign-up conversions

Field Name: conversionSignUps
Type: metric
App Opens
Number of app open conversions

Field Name: conversionAppOpens
Type: metric
Page Views
Number of page-view conversions

Field Name: conversionPageViews
Type: metric
Adds To Cart
Number of add-to-cart conversions

Field Name: conversionAddCart
Type: metric
Checkouts Started
Number of checkout-started conversions

Field Name: conversionStartCheckout
Type: metric
Searches
Number of search conversions

Field Name: conversionSearches
Type: metric
Subscriptions
Number of subscription conversions

Field Name: conversionSubscribe
Type: metric
Logins
Number of login conversions

Field Name: conversionLogin
Type: metric
Conversion Shares
Number of share conversions

Field Name: conversionShare
Type: metric
Visits
Number of visit conversions

Field Name: conversionVisit
Type: metric
Tutorials Completed
Number of tutorial-completion conversions

Field Name: conversionCompleteTutorial
Type: metric
Invites
Number of invite conversions

Field Name: conversionInvite
Type: metric
Levels Completed
Number of level-completion conversions (game apps)

Field Name: conversionLevelCompletes
Type: metric
Achievements Unlocked
Number of achievement-unlocked conversions

Field Name: conversionAchievementUnlocked
Type: metric
Adds To Wishlist
Number of add-to-wishlist conversions

Field Name: conversionAddToWishlist
Type: metric
Trials Started
Number of trial-started conversions

Field Name: conversionStartTrial
Type: metric
List Views
Number of list-view conversions

Field Name: conversionListView
Type: metric
Credits Spent
Number of credits-spent conversions

Field Name: conversionSpendCredits
Type: metric
Ad Clicks
Number of ad-click conversions

Field Name: conversionAdClick
Type: metric
Ad Views
Number of ad-view conversions

Field Name: conversionAdView
Type: metric
Billing Added
Number of add-billing conversions

Field Name: conversionAddBilling
Type: metric
Reservations
Number of reservation conversions

Field Name: conversionReserve
Type: metric
Conversion Saves
Number of save conversions (distinct from delivery saves)

Field Name: conversionSave
Type: metric
Conversion Rate
Calculated conversion rate (purchases / swipes)

Field Name: conversionRate
Type: metric

​
Conversion Values

Purchase Value
Total monetary value of purchase conversions in account currency

Field Name: conversionPurchasesValue
Type: metric
Subscription Value
Total monetary value of subscription conversions in account currency

Field Name: conversionSubscribeValue
Type: metric
Add To Cart Value
Total monetary value of add-to-cart conversions in account currency

Field Name: conversionAddCartValue
Type: metric
Checkout Started Value
Total monetary value of checkout-started conversions in account currency

Field Name: conversionStartCheckoutValue
Type: metric

Fields Catalog

Browse all platforms

Meta Ads Fields

Meta Ads metrics & dimensions

TikTok Ads Fields

TikTok Ads metrics & dimensions

X Ads Fields

X Ads metrics & dimensions