Set up a Snapchat Ads integration for your website app to send web conversion signals to Snapchat via the Conversions API.
Overview
AppsFlyer supports integration with Snapchat Ads (snapweb_int) for website app campaigns, letting you report attribution and conversion data directly through Snapchat's Conversions API. Snapchat can then use this data to optimize ad targeting, measure performance, and build custom audiences.
Here is how it works: a user clicks a Snapchat ad and lands on your website. When the user completes a website event (for example, a purchase or sign-up), AppsFlyer sends the conversion signal to Snapchat via the Conversions API. Snapchat uses this data to optimize ad targeting and measure campaign performance.
Important!
At present, the integration does not support sending re-engagement postbacks via the Conversions API.
Prerequisites
Before activating the Snapchat Ads integration for your website app, make sure you have:
- A website app set up in AppsFlyer
- A business account in Snapchat Ads Manager
How to set up Snapchat Ads for your website app
The setup involves defining the integration between Snapchat Ads and AppsFlyer, and configuring the campaign in Snapchat Ads Manager. It includes the following steps:
- Part 1: Set up Snapchat Ads integration in AppsFlyer (Required)
- Part 2: Set up AppsFlyer integration in Snapchat Ads (Required)
Part 1: Set up Snapchat Ads integration in AppsFlyer
Start by activating the Snapchat Ads integration. Then configure the postbacks that AppsFlyer sends to the Conversions API.
1. Activate the Snapchat Ads integration
To activate the Snapchat Ads integration:
- In AppsFlyer, from the side menu, select Collaborate > Partner Marketplace.
- Search for Snapchat and select it.
- Click Set up integration. You're directed to the Active Integrations setup page.
- In the Integration tab, turn on Activate Partner. The toggle must stay on for as long as you work with the partner.
- Pixel ID: Enter the Pixel ID. You can generate it or retrieve it from your Snapchat Ads Manager by following the instructions in the Snapchat Ads documentation.
- Access token: Enter the access token. To create or retrieve it, follow the instructions in the official Snapchat Ads documentation.
2. Set in-app event postbacks
You can define which web conversion events AppsFlyer sends to Snapchat Ads by mapping AppsFlyer events to Snapchat Ads events. These postbacks can be viewed in Snapchat Ads Manager. Snapchat uses the mapped events for campaign optimization and reporting.
To set in-app event postbacks:
- Turn on In-app event postbacks.
- If required, set the in-app event postback window. Read more in In-app event postback configuration.
- Click Add event to add an event to the list.
- In the AppsFlyer event column, select the event name from the list. AppsFlyer receives the event name either from the Web SDK integrated on your website or from server-to-server (S2S) events you send to AppsFlyer.
- In the Mapped to Partner Event column, select the most suitable predefined partner event from the list.
-
In the For Users From column, select the
appropriate
option:
- This partner only sends events attributed to Snapchat Ads.
- All media sources, including organic sends all events regardless of attribution source.
- In the including column, select whether to send events with their revenue values. See Data to include in the postbacks.
-
[Optional] Click the Add condition icon
to
set conditions
for an event.
Note
- If you are setting a purchase event, set the including column to Values and revenue. Selecting any other option causes the postback to fail.
- Currently, you can set only the purchase event to include revenue.
- Click Save integration.
-
Include
af_customer_event_idin the event payload you send to AppsFlyer. For the Web SDK, send it insideeventValue. For the S2S (server-to-server) API, send it either as a top-level field or insideevent_value. - Send the same value in the corresponding Pixel event.
If you also run the Snap Pixel on your website, send the same event ID to both AppsFlyer and Snapchat so AppsFlyer can deduplicate the events:
AppsFlyer forwards this value to Snapchat as the event ID. Snapchat then uses it to deduplicate the server-side event it receives from AppsFlyer against the Pixel event, so AppsFlyer counts the conversion once.
If you don't send af_customer_event_id,
AppsFlyer generates an event ID automatically. This ID
won't match your Pixel events.
For more information, see [Beta] Integrate AppsFlyer Web SDK.
Note
If you send S2S events and want AppsFlyer to send postbacks for them to Snapchat Ads, make sure each event includes either ip or user_agent. If both are missing, AppsFlyer doesn't send the postback. For all supported event fields, see Server-to-Server (S2S) API for Web Performance Measurement.
Part 2: Set up AppsFlyer integration in Snapchat Ads
Perform the following steps in Snapchat Ads Manager.
1. Set the campaign type, objective, and goals
You can choose any predefined in-app event sent from AppsFlyer as your campaign goal. Select a campaign objective that aligns with your website conversion goals, for example, driving traffic to your website or optimizing for on-site conversions.
2. Set the destination URL
- Under Destination, in the Website URL field, enter the URL of your website, the page where users land after clicking your ad. Website URL is the main destination option. Users click the ad and land directly on your website to complete conversion events.
- [Alternative] AF attribution link (OneLink): If you want to redirect users to the mobile app with a fallback to the website, you can use an AF attribution link (OneLink) as the destination URL instead.
- Click Build a URL parameter to add the URL parameters to the destination URL.
- Under Custom parameters, click Add parameter.
-
Map the AppsFlyer parameters to their Snapchat values:
AF parameter Mapped Snapchat value pidsnapweb_intc*{{campaign.name}}af_c_id{{campaign.id}}af_adset{{adSet.name}}af_adset_id{{adSet.id}}af_ad{{creative.name}}af_ad_id{{ad.id}}af_channel{{site_source_name}}* To simplify campaign analysis, include the campaign type (web or mobile) as a prefix or suffix in the campaign name, for example,
campaign-name_web.For best practices on URL parameter configuration and traffic source resolution, see About traffic source resolution.
An example of the resulting URL:
https://www.example.com?pid=snapweb_int&c={{campaign.name}}&af_c_id={{campaign.id}}&af_adset={{adSet.name}}&af_adset_id={{adSet.id}}&af_ad={{creative.name}}&af_ad_id={{ad.id}}&af_channel={{site_source_name}}
Note
Snapchat adds ScCid={{ScCid}} to the destination URL automatically when the ad is clicked.
View web attribution data
Here's what to expect when you review your attribution data after setup:
- Dashboard: In the cross-platform dashboard, web and app data are displayed side by side, giving you a unified view of campaign performance across platforms.
-
Raw data exports and API responses include Snap Web in the
media_sourcefield for Snap web activity.
Measure web attribution data with web cost
You can get a complete performance view of web attribution data and web cost data from Snapchat Ads in the dashboard and in Cost ETL reports. To do this, make sure you have the ROI360 package and complete the following setup:
- Connect the cost to your website app via
snapchat_int(not viasnapweb_int) from the Cost tab or the Cost Settings page. For more information about how to connect to cost, see Set up ROI360 cost API to measure cost data. - Include the campaign ID (
af_c_id) in the landing page URL. Make sure the URL includes the full campaign hierarchy to view cost, clicks, and impressions matched to web attribution at the most granular level.
Traits and limitations
| Trait | Remarks |
|---|---|
| Clicks and impressions | Clicks and impressions for web campaigns require an ROI360 subscription. |
| Re-engagement | Re-engagement postbacks via the Conversions API are not currently supported. |