๐ Summary
This configuration supports comprehensive tracking of Snapchat ad delivery, conversion events, and associated metadata. The system is composed of two scheduled jobs: one for daily delivery/conversion data imports, and one for daily metadata refreshes. It supports metric aggregation, dimension tagging, and performance calculations such as Swipe Rate, VTR, and VCR.
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 |
|
|
|
|
|
|
|
|
๐งพ API Use Case Summary
The Snapchat Ads integration uses the Snap Marketing API to:
Import daily performance data for ads and conversions.
Auto-refresh all metadata (campaigns, ad accounts, squads, ads) to ensure up-to-date taxonomy.
Support granular reporting via swipes, impressions, video quartiles, and conversions.
Enable performance calculations like swipe rate, view-through rate (VTR), view completion rate (VCR), and cost per swipe.
Join ad-level data with meta tables to power dashboards or feed business logic in downstream systems.