---
schema_version: "1"
id: 94d2a13725c5f6887240e7116883c6a994ce3aaace493d216e09a3cbde8f02d8
title: Snapchat API Connector
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/mktg/264-0-0/dato_data_streams_api_connect_snapchat.md
canonical_url: https://help.salesforce.com/s/articleView?id=mktg.dato_data_streams_api_connect_snapchat.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: ba6f415e62240d48a3dc31570878914e50948d98290eaa6ecba76188051be141
description: Snapchat Ads is an ads platform that provides three types of advertising - Snap Ads, Snapchat Geofilters, and Lenses.
products:
  - Marketing
  - Marketing Cloud Intelligence
release: "264"
---
# 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:

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-mktg-salesforce_datorama-264-0-0-production-enus/d38a342d-dd4a-4af8-8343-f372280a75dd/images/icon_note.png)

Note Deleted campaigns are not retrieved and don’t appear in your data.

| 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.
- The Marketing Cloud Intelligence Snapchat Ads connector retrieves data by Conversion Time. Snapchat Ads Manager shows Impression Time by default, which can cause discrepancies between the two platforms. When you pull a report from the Snapchat UI, use Conversion Time.