Overview
The Snapchat Ads API provides programmatic access to campaign, ad set, and creative-level performance metrics for paid Snapchat advertising campaigns. It supports Snap Ads, Story Ads, Collection Ads, Commercials, and AR/interactive formats, enabling marketers to track performance, optimise campaigns, and integrate Snapchat data into dashboards.
Data handled by the integration:
Account & Campaign Data
Advertiser accounts and account IDs
Campaigns and ad sets
Campaign objectives (awareness, traffic, app installs, conversions)
Budgets, bids, and pacing settings
Campaign and ad set status (active, paused, completed)
Creative & Ad Data
Creative metadata: ad ID, type (Snap Ads, Story Ads, Collection, AR)
Associated campaign and ad set
Media assets (images, videos, AR lenses), captions, call-to-actions
Approval status and policy compliance
Performance Metrics
Impressions, swipes / taps, CTR
Cost, CPC, CPM, spend
Conversions and conversion value
Video metrics: views, completion rates, watch time
Engagement metrics (screenshots, shares, lens usage for AR creatives)
Audience & Targeting
Demographics (age, gender, location)
Device type (mobile, tablet)
Interests, behaviours, and custom audience segments
Retargeting and lookalike audiences
Metadata & Reference Tables
Account, campaign, and ad set hierarchy
Ad format and creative type definitions
Conversion action definitions
Geographic and demographic mappings
Granularity:
This integration retrieves data at: Account, Campaign, Ad group, Ad and Creative Levels which can be broken down by device type, location and demographic.
Purpose:
Analyse ad set and creative effectiveness
Track conversions, CTR, and engagement metrics
Optimise targeting, bidding, and creative strategy
Build dashboards integrating Snapchat Ads with other paid channels
Conduct historical campaign audits and performance analysis
Refresh Cadence:
Data is refreshed daily.
Update Modes:
Append (for data table), Refresh (for metadata)
For more information on this integration, please follow the link here.
Jobs Configuration
Job 1: Snap Ads - Data Import
Field | Value |
Feed |
|
Status |
|
Label |
|
Lookback | 3 days |
First Run Hour | 5 AM |
Poll Frequency | 24 hours |
Lookback Window | 0 |
Targets
Priority | Table | Description | Update Mode |
1 |
| Snap Ads - Delivery Data | append |
2 |
| Snap Ads - Conversion Data | append |
Job 2: Snap Ads - Meta Refresh
Field | Value |
Feed |
|
Status |
|
Label |
|
Lookback | 1 day |
First Run Hour | 5 AM |
Poll Frequency | 24 hours |
Lookback Window | 0 |
Targets
Priority | Table | Description | Update Mode |
1 |
| Snap - Meta Account | refresh |
2 |
| Snap - Meta Campaign | refresh |
3 |
| Snap - Meta AdSquad | refresh |
4 |
| Snap - Meta Ad | refresh |
Connection Settings
Key | Description | Type | Required |
| Comma-delimited Snap Account IDs | text | Yes |
| Snap Ads API username (ID/token) | text | Yes |
| API secret token | text | Yes |
Connection Description:
Snap Ads
Dimensions
Name | Maps to Field |
Account [Snap] |
|
Campaign [Snap] |
|
Ad Squad [Snap] |
|
Ad [Snap] |
|
Base Metrics
Name | Formula (simplified) | Format |
Spend [Snap] |
| £, 2dp |
Swipes [Snap] |
| integer |
Impressions [Snap] |
| integer |
Video Views [Snap] |
| integer |
Video Views Quartile - 25% |
| integer |
Video Views Quartile - 50% |
| integer |
Video Views Quartile - 75% |
| integer |
Video Completes [Snap] |
| integer |
Conversion Page Views [Snap] |
| integer |
Composite Metrics
Name | Formula | Format |
Swipe Up Rate [Snap] |
| %, 2dp |
VTR [Snap] |
| %, 2dp |
VCR [Snap] |
| %, 2dp |
Cost Per Swipe [Snap] |
| £, 2dp |
Data Joins
Both snap_data_ad and snap_data_ad_conversions are joined to the metadata tables via:
Join Field | Joins With Table |
|
|
|
|
|
|
|
|