Collecting data from Snapchat

This guide explains how to collect data from Snapchat. To learn how to collect data from a different data source, go back to the Available data sources in Adverity overview.


For a list of the fields that you can collect from Snapchat, see Snapchat.

  • Snapchat can collect a maximum of 1 million rows per single report. To fetch more data than this, split your fetch into smaller date ranges in the Initial Fetch step of creating a datastream.


Before you start collecting data from Snapchat, perform all of the following actions:

  • Ensure that the account you use to connect to Snapchat has Account Admin or higher role assigned. Snapchat users assigned the Data Analyst role can collect a limited number of fields.

Creating a datastream to collect data from Snapchat

The basics of creating a datastream to collect data from any data source are explained in our guide to Creating a datastream. This guide contains information about the specific steps to create a datastream to fetch data from Snapchat.

Authorization: Allow Adverity to access Snapchat

  1. If you choose Access using your credentials or Access using someone else's credentials, in Set up or edit Ad Accounts, you or the person granting access must choose one of the following options:

    • Choose Grant access to all Ad Accounts, including those created in the future to allow Adverity to access all existing Ad Accounts and all Ad Accounts created in the future.

    • Choose Select specific Ad Accounts to which you want to grant access to determine the specific Ad Accounts that you want Adverity to access. Adverity will not automatically have access to Ad Accounts created in the future. You will need to grant Adverity access to any Ad Accounts created in the future.

    If you use your credentials to grant Adverity access to Snapchat, all the Ad Accounts available to you using your credentials will be visible in the Authorizations page to all Adverity users with permission to edit this authorization.

    If someone else uses their credentials to grant Adverity access to Snapchat, the same applies to the Ad Accounts available using their credentials.

    This is important to consider if you do not want all Adverity users with permission to edit the authorization to be able to see the details of the Ad Accounts. For more information about user permissions, see Managing user permissions.

Configuration: Choose the data you want to collect from Snapchat

To choose what data to collect and customize the Snapchat datastream configuration, follow these steps:

  1. (Optional) Rename your datastream.

  1. In Organizations, Ad Accounts, Campaigns, Ad Squads, and Ads, select the organizations, ad accounts, campaigns, ad squads, and ads for which to collect data. If you do not select any items in a drop-down list, Adverity collects data for all items in the drop-down list.

  1. In Reporting type, select the type of data to collect from Snapchat.

  1. In Fields, change the list of fields that you want to see in your data extract.

For information on configuring other Snapchat fields, see Advanced Snapchat tips.

What's next?

Advanced Snapchat tips

Configuring data collection from Snapchat

In the Settings tab of your Snapchat datastream overview, you can configure a number of additional settings:


Select the time interval in which to collect data. Choose one of the following time intervals:

  • Day

  • Hour

  • Total

  • Lifetime

If you select Hour, the time range is restricted to the last 90 days.

Action report time

Select if you want to use conversion or impression date to report data.


Select the level at which to collect data.

Configuring attribution windows

An attribution window is the time period between a user swiping up on an ad and performing an action (such as a purchase or download) as a result of swiping up. In the Attribution Window section, configure the following fields to return attribution window data.


In Swipe, select the attribution window for an ad. For example, select 1_DAY to view data for swipe impressions that led to an action within 24 hours after swiping up on an ad.


By default, when a user views an ad and does not swipe up, they enter a one-day attribution window in which actions made by that user on your website or app may be attributed to the ad which they viewed. In View, change the length of the non-swipe attribution window.