You are here:
Snapchat API Connector
Snapchat Ads is an ads platform that provides three types of advertising - Snap Ads, Snapchat Geofilters, and Lenses.
- Channel: Display
- Data Stream Type: Ads
- The sliding window for the Snapchat API connector is 4.
- Data Lagging:
- Core Measurements (such as Impressions, Swipes, Video, Spend) have lagging data of 1 day.
- Additional Measurements (such as Frequency, and Unique Measurements) have lagging data of 1 day.
Prerequisites
To connect to Snapchat Ads, you need a valid Username and Password for Snapchat Business. You’ll also need to have access to at least one Snapchat Business Account.
Details
Following is a list of the main Entities and Measurements retrieved from Snapchat and where they’re mapped to in Marketing Cloud Intelligence:
| Snapchat Fields | type | Intelligence fields |
|---|---|---|
| Campaign | Dimension | Campaign |
| Ad | Dimension | Creative |
| Device | Dimension | Device Category |
| Ad Squad | Dimension | Media Buy |
| Targeting | Dimension | Media Buy |
| Swipes | Measurement | Clicks |
| Screen Time | Measurement | Display Time |
| Frequency | Measurement | Frequency |
| Paid Impressions | Measurement | Impressions |
| Spend | Measurement | Media Cost |
| Installs | Measurement | Social App Installs |
| Earned Impressions | Measurement | Social Impressions |
| Video Completion Quartiles | Measurement | Video Completions 25%, 50%, 75%, Fully Played |
| Video Views | Measurement | Video Views |
General Setup
After entering your credentials, select the relevant Ads Account you want to retrieve data for.
Extended Properties
- Get Conversions Data - Select this checkbox to retrieve conversion data. The following
fields are added to the Conversion Tag Data Stream Type:
- Total Conversions
- Revenue
- Post Impression Conversions
- Post Click Conversions
- Conversion Tag Name
- Conversion Tag Category
- Swipe Attribution Window - Select the swipe attribution window that you defined in your
Snapchat account. The following options are available:
- 1 day
- 7 days
- 28 days
- View Attribution Window - Select the view attribution window that you defined in your
Snapchat account. The following options are available:
- None
- 1 Hour
- 3 Hours
- 6 hours
- 1 day
- 7 days
- 28 days
The following table shows all the combinations of Attribution Windows that are allowed:
View Window swipe window 1 Day Swipe window 7 day swipe window 28 day None Allowed Allowed Allowed 1 Hour Allowed Allowed Allowed 3 Hour Allowed Allowed Allowed 6 Hour Allowed Allowed Allowed 1 Day Allowed Allowed Allowed 7 Day Not Allowed Allowed Allowed 28 Day Not Allowed Not Allowed Allowed The default selection for the Attribution Window is: 28 Days swipe, 1-Day view. A wrong combination of Attribution Windows results in an error and a Data Stream failure.
How to QA Your Data
- Select the relevant Account from within Snapchat Business. To access the relevant section from which reports are created, open the Navigation at the top of the page and select Manage Ads
- You can QA the data from within the Snapchat platform or export the daily data
- Create a Report/Table Widget/Pivot Table in Marketing Cloud Intelligence containing the exact same Dimensions, Measurements, Filtering, and Date Range, and then compare the numbers.
- Calculated metrics such as Cost Per Swipe Up aren’t retrieved by the API, but you can create
them in Marketing Cloud Intelligence via the Calculated Measurements feature. Opposed to how
it’s displayed in the Snapchat Ads platform, the Conversion Measurements in Intelligence are
transposed.
For example, in the Snapchat Ads platform, there’s a Measurement for each conversion type, Lead, Purchase, View Content, and so on.
In Marketing Cloud Intelligence, the type of the conversion is returned as a value of a Conversion Tag Category Dimension, while the metric values of all conversions are available in the Total Conversions metric in order to align with the Data Model and other platforms.

