At a glance: From mid-September 2023, Snapchat has become an Advanced SRN. Learn how to set up the integration between AppsFlyer and Snapchat to enable attribution measurement.
Overview
An Advanced SRN integration means that all dual-consented traffic is attributed and reported as regular SRN traffic. For non-consented traffic, AppsFlyer is able to attribute and measure attribution based on clicks and impressions coming from Snapchat using other attribution methods, in accordance with privacy restrictions.
Setting up Snapchat integration
Prerequisite: Before setting up the integration, make sure you contact the partner and open an account with them.
To activate or edit the integration:
-
To activate: In AppsFlyer, from the side menu, select Collaborate > Partner Marketplace.
To edit: In AppsFlyer, from the side menu, select Collaborate > Active Integrations. - Search for the Snapchat and select it.
- Click Set up integration. You’re directed to the integration setup page.
- In the Integration tab, select the app for the integration and turn Activate partner on.
Note: The toggle must be on (activated) for as long as you work with the partner. - Complete the configuration using the relevant tabs, as described below.
For a detailed description of the partner configuration window header, click here.
Note
- Some settings differ for iOS and Android devices
- Learn more about setting up partner integrations
Integration tab
The integration supports click and impression attribution, cost, ad revenue, and audiences.
Activate partner
On the first visit here, you must turn on Activate Partner to enable setup.
For more details about partner activation click here.
Enable attribution
Enable Activate Partner to allow attribution to Snapchat.
General settings
Snap App ID
- In your Snap Business Manager, go to Apps, and copy the Snap App ID (read Snapchat's guide on how to generate a Snap App ID).
- Paste the ID in the Snap App ID field in AppsFlyer.
In case the app is promoted by an agency,
- Snap App ID can be added by the advertiser only.
- If the agency is under the same organization as you on Snapchat ad platform, use only one Snap App ID.
- If the agency is under a different organization on Snapchat ad platform, request from them to provide their Snap App ID for this app, and enter it in this field. Multiple IDs can be entered. Press Enter after each ID.
Install attribution
Set the different attribution windows to attribute new installs (first launches) of users who viewed, clicked, or engaged with your ad. Note that only installs within the lookback window may be attributed to Snapchat.
Note: Attribution for reinstalls (any install that isn’t the initial setup on the device) isn’t supported.
- Set the Install click-through lookback window to either 1-23 hours or 1-30 days. Note: Snapchat recommends aligning with them by setting the Install click-through lookback window to 7 days.
Note
Setting the click-through lookback window also determines the lookback windows for engaged views and engaged clicks.
- [Optional] Turn on Install view-through attribution and set the lookback windows:
- Install view-through lookback window between 1-24 hours. Note: Snapchat recommends aligning with them by setting the Install view-through lookback window to 1 day.
Re-engagement attribution
Set the different attribution windows to attribute re-engagements of your existing users who viewed, clicked, or engaged with your ad. Note that only re-engagements within the lookback window may be attributed to Snapchat.
- Set the Re-engagement click-through lookback window to either 1-23 hours or 1-30 days. Note: Snapchat recommends aligning with them by setting the Re-engagement click-through lookback window to 7 days.
Note
Setting the re-engagement click-through lookback window also determines the re-engagement lookback windows for engaged views and engaged clicks.
- [Optional] Turn on Re-engagement view-through attribution and set the lookback windows:
- Re-engagement view-through lookback window between 1-24 hours. Note: Snapchat recommends aligning with them by setting the Re-engagement view-through lookback window to 1 day.
- Set the Re-engagement window to either 1-23 hours, 1-90 days, or Lifetime.
Ignore active users for retargeting
Set a window timeframe to ignore re-engagements and re-attributions of users who launched your app. This means their activity during the window timeframe isn't recorded in AppsFlyer.
Note
Re-engagement and re-attribution conversions of users who were dormant in the set timeframe are recorded.
- Turn on Ignore active users for retargeting.
- Set the Inactivity window.
In-app event postbacks
Map AppsFlyer events with the partner via postbacks. If postback sending is enabled, this includes rejected in-app events (events blocked by Protect360 or events found to be non-compliant by target validation rules).
To configure in-app event postbacks:
- Set the Partner ID (if required).
- Enable In-app event postback.
- Set the In-app event postback window, if required (read more about in-app event postback window configuration).
- If available, select whether to send events automatically or manually. Learn more about sending all events as they are.
- Click Add event to add an SDK or server-to-server event to the list.
- Complete the parameters required.
- [Optional] Click to set conditions for sending certain in-app events to the partner.
Learn more about conditional in-app events postbacks.
Parameter name | Description |
---|---|
AppsFlyer event | The name of the event, as received by AppsFlyer either from the SDK integrated into your app or from server-to-server events. Tip: Don't see the event you are looking for?
|
mapped to partner event | The unique name or ID of each event, as defined on the partner's side. Possible mapping configurations are:
|
for users from | Select the sending option for the event:
|
including |
|
Attribution link tab
Attribution links are not available for Snapchat.
Note
For all SRNs, such as Facebook, Apple Search Ads, Adwords, Snapchat etc. this tab is not functional, as they do not use external attribution links.
Cost tab
The cost integration provides the following aggregated data:
- Cost data for your campaigns, adsets, ads, and channel levels. See the ad network cost integration table for full details on the supported dimensions, metrics, and features.
Note: Cost data requires an ROI360 subscription. - Data on clicks and impressions.
To enable the cost API:
- Follow these integration instructions.
Cost data sync status
View your cost API status and the last time AppsFlyer managed to pull matching cost data in either the cost (and ad revenue) integration status dashboard, or in the individual ad network dashboard.
Stop Snapchat cost sync
To stop getting Snapchat cost and to delete a connected Snapchat account:
-
In the actions column, hover over an account, click Delete connection
Once deleted, AppsFlyer stops getting the cost. Deleting the connection does not impact historical data.
Notes
- Make sure your campaign setup in Snapchat is for either an iOS or Android app; not both. If the campaign is for both apps, AppsFlyer can't break down the cost per app, and the cost does not display in AppsFlyer.
- To avoid discrepancies in cost data, set the same timezone in both app settings and your Snapchat advertising account.
- Once you set Snap's cost do not change the name of any running campaign, ad set, or single ad, as it may cause serious discrepancies or missing cost data.
Ad revenue tab
Ad Revenue is not supported in the integration with this partner.
Permissions tab
Select which permissions to grant Snapchat to access your data and perform various actions.
Note
When the integration is deactivated while the Permissions toggle is still turned on, permissions remain granted.
Deep linking with Snapchat
Deep linking with Snapchat is based on using a native deep link in Snapchat's platform, while adding AppsFlyer parameters to it.
To perform deep linking with Snapchat:
- Verify that deep linking for retargeting is enabled for Snapchat.
- Verify that re-engagement attribution is enabled in AppsFlyer.
- Take the app's deep link scheme URI and add at least the following parameters:
- PID - The media source in this case is always snapchat_int. This enables all data to appear in the AppsFlyer dashboard under the Snapchat_int media source.
- C - the relevant campaign name
- is_retargeting=true - this field defines the campaign as a retargeting campaign. The engagements of existing users with the retargeting campaign are marked as re-engagements due to the existence of this field in the URI. This ensures the user's data appear in the retargeting dashboard.
URI Example
client://home?pid=snapchat_int&c=TEST&is_retargeting=true
How to set up deep links on Snap platform?
Deferred deep linking with Snapchat
You can access Snapchat user conversion data in real-time directly at the SDK level using deferred deep linking.
The Snapchat conversion data includes the af_dp parameter, which enables you to deep link and serve customized content, based on the user's engagement with your ad in Snapchat.
In addition, you can use other conversion data parameters such as af_adset or af_channel.
Agencies working on behalf of advertisers can turn on the Snapchat integration and start getting attribution for their campaigns. However, this integration has some limitations when it comes to agencies.
Setting up Snapchat for agencies
Agencies working on behalf of advertisers can turn on the Snapchat integration and start getting attribution for their campaigns. However, this integration has some limitations when it comes to agencies
Agency limitations
- An agency can access the Snapchat integration only after the advertiser they work with has activated it on their side.
- Attribution parameters showing on the agency's integration page are inherited from the advertiser's integration in view-only mode. This means the agency can see how the advertiser configured the attribution lookback windows but can't configure them on their own.
- For post-attribution events, if granted permission by the advertiser, an agency can configure in-app event postbacks.
- An agency can't turn on the Advanced Privacy setting (even when granted permission)—this is limited to the advertiser only.
To set up Snapchat for agencies:
- In AppsFlyer, under Configuration go to Partner Marketplace.
- Find Snapchat and select it.
- Enter your agency's Snapchat Account ID. This identifies agency traffic and distinguishes it from the advertiser's. You can enter up to 50 different Snapchat account IDs. All attribution data coming from the accounts you entered are visible under the agency's dashboard.
- Click Save Integration.
Warning
Snapchat account IDs mustn't be shared between the advertiser or the agency. If they are shared then ALL the advertiser's installs are automatically attributed on the agency's dashboard.
Raw data restrictions
- Starting March 1, 2023, Snapchat Uninstalls aren’t included in the raw data reports
- Starting September 12, 2023, Snapchat is providing advertisers with limited view-through attribution data at the device level. For user-level sources, such as raw data reports, Push API messages, Pull API reports, Export data page, and Data Locker, only the following fields are populated:
-
- Media source (snapchat_int)
- Channel
- Attributed touch type (impression)
- Attributed touch time (reported as date only - "dd/mm/yyyy")
- Campaign is reported as "restricted"
Keeping Snapchat data
Snapchat requires attribution providers to delete its user-level data 12 months after the install. This means that the events performed by these users 12 months after they install the app are counted as organic.
Past aggregate data remains the same.