Snapchat API Connector

• 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 Deleted campaigns are not retrieved and don’t appear in your data.

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.