Snapchat—Create web-based campaigns

To activate the Snapchat Ads web integration:

1. In AppsFlyer, from the side menu, select Collaborate > Partner Marketplace.
2. Search for Snapchat Web and select it.
3. Click Set up integration. You’re directed to the Active Integrations setup page.
4. In the Integration tab, turn on Activate Partner. The toggle must stay on (activated) for as long as you work with the partner.
5. Turn off Advanced Privacy (if you are setting an iOS app integration).
6. Pixel ID: Enter the Pixel ID. You can generate it or retrieve it from your Snapchat Ads Manager by following the instructions detailed in the Snapchat Ads official documentation
7. Access token: Enter the access token. To generate it or retrieve it, follow the instructions in the Snapchat Ads official documentation

AppsFlyer supports view-through attribution for Snapchat Web campaigns when you use a Smart Script or Smart Banner-enabled landing page. This enables probabilistic modeling (PMOD) attribution for app installs triggered by ad impressions, even when users do not click the ad.

If available, the ScCid will be included in the postback to Snapchat to enhance attribution fidelity.

To enable Snapchat Web view-through attribution:

1. In AppsFlyer, from the sidebar, open Active Integrations > Snapchat Ads web.
2. In the Integration tab, scroll to the Install attribution section.
3. Turn on Install view-through attribution.
4. [optional] Turn on Cross-platform equal attribution priority and set its lookback window. For more information, see Enable equal priority for cross-platform impressions.
5. Open the Attribution link tab.
6. Scroll to the View-through attribution section and set the view-through lookback window (up to 24 hours).
7. Click Save integration to apply your settings.

Installs are currently the only events that trigger automatic default postbacks for Snapchat Ads. For all other event types, you can create custom postbacks by mapping AppsFlyer events to Snapchat Ads events. These postbacks can be viewed in the Snapchat Ads manager.

To set in-app events postbacks, perform the following:

1. Turn on In-app event postbacks.
2. If required, set the In-app event postback window (read more about in-app event postback window configuration in general in In-app event postback configuration).
3. Click Add event to add an event to the list.
4. In the AppsFlyer event column, select the event name from the list. AppsFlyer receives the event's name either from the SDK integrated into your app or from server-to-server events.
5. In the Mapped to Partner Event column, select the most suitable predefined partner event from the list.
6. In the For Users From column, select This Partner Only to ensure that in-app event postbacks are sent only for events performed by users who originated from this partner.

7. In the including column, select whether to send events with their revenue values. See Data to include in the postbacks.

    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.
8. [Optional] Click the Add condition icon to set conditions for an event.
9. Click Save integration.
10. [Optional] After you save the integration, and while you remain on the configuration page, you can integrate additional apps with the partner:
    1. From the top-left corner, select the app name under the partner name to open the list of apps.
    2. Select a different app from the list.
    3. Repeat the above steps for the selected app.

You can choose any pre-defined INAPP event sent from AppsFlyer as your campaign goal, or choose “PAGE_VIEW” if you want to optimize for mobile App Installs.

1. Under Destination, in the Website URL field, enter the URL that serves as the destination for your ad. The URL should be for one of the following:

   • Web landing page: Using a landing page is recommended when:

     • You have an app on multiple platforms.
     • You want to use the landing page to give more information about your advertised product.
     • You want to use the landing page to collect more data.

     For all these use cases, create a landing page with a Smart Script or a Smart Banner.

   • AF attribution links: Using AF attribution links (OneLink, single platform, or cross-platform) is recommended when you want users to be redirected directly to the store to download the app without first visiting a landing page.
2. Click Build a URL parameter to add the URL parameters to the URL (whether it is a landing page URL or an AF attribution link).

3. Under Custom parameters, click Add parameter

   

4. Map the AppsFlyer parameters to their Snapchat values.

   • If your destination URL is a landing page, a OneLink attribution link, or a single platform attribution link, map the following AF parameters to their Snapchat counterparts:

     AF Parameter	Mapped Snapchat value
     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}}

     An example of the resulting URL should be:

     https://app.appsflyer.com/{app_id}?pid=snapweb_int&c=__campaign_name__&af_c_id=__campaign_id__&af_adset=__aid_name__&af_adset_id=__aid__&af_ad=__cid_name__&af_ad_id=__cid__&af_r={https://Add-your-store-url.com}

     • If your app’s APK is NOT hosted in Google Play Store, add the af_r parameter and map to it the store URL, e.g, https://Add-your-store-url.com

• If your destination URL is a PC or a console store, create the link by following the instructions in the table below. For additional information, see: CTV, PC, and console platform direct attribution links

  Attribution link structure
  Base URL	engagements.appsflyer.com/v1.0/c2s/click/app/
  Mandatory path parameters	▪ platformExample: steam ▪ app_idExample: 123456
  Mandatory query parameters	▪ af_media_source ▪ af_campaign_id ▪ af_r
  Other parameters	See all parameters
  URL structure	https://engagements.appsflyer.com/v1.0/c2s/click/app/{platform}/{app_id}?af_media_source={media_source}&af_campaign_id={campaign_id}&af_r={app_store_url}

  Map the following AppsFlyer parameters to their Snapchat counterparts:

  AF Parameter	Mapped Snapchat value
  af_media_source	snapweb_int
  af_campaign *	{{campaign.name}}*
  af_campaign_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 (e.g., campaign-name_web)

  An example of cross-platform URL:

  https://engagements.appsflyer.com/v1.0/c2s/click/app/steam/123456?af_media_source=snapweb_int&af_campaign_id={{campaign.id}}&af_campaign={{campaign.name}}&af_adset={{adSet.name}}&af_adset_id={{adSet.id}}&af_ad={{creative.name}}&af_ad_id={{ad.id}}&af_r=https%3A%2F%2Fstore.steampowered.com%2Fapp%2F440%2FTest_app2%2F%3Futm_term%3Dhello

   Note

  Snapchat adds the ScCid={{ScCid}} to the destination URL automatically when the ad is clicked

  For a comprehensive guide on the AF link parameters, see Attribution link parameters.

1. The Snapchat ad URL includes the pid=snapweb_int parameter. When the user clicks on the ad, an ScCid parameter is automatically appended to the clicked URL.
2. The User is redirected to the URL destination - a landing page containing a Smart Script.
3. When the landing page loads, Smart Script fires an impression to AppsFlyer containing the incoming URL parameters. The impression will allow view-through attribution from the web landing page. To learn about impressions and view-through attribution, see here.
4. Smart Script generates the outgoing URLs for the CTA buttons on the page based on the incoming URL parameters, including the ScCid parameter. The buttons can lead to:
   • Google Play and App Store via a OneLink attribution link.
   • Multiple platform stores (e.g., CTV, Epic, and Steam). In this use case, Smart Script generates a single platform attribution link for each platform, leading to the specified platform's store.
   • Downloading an APK file to the user's device.
5. When the user clicks the CTA button, the click is fired and registered in AppsFlyer.
6. The user is redirected to the store and downloads the app.
7. When the user opens the app, the install event is registered in AppsFlyer.
8. AppsFlyer attributes the install based on probabilistic modeling or deterministically if an install referrer is available.
9. A postback containing the ScCid parameters and other event parameters are generated and sent to Snapchat via the Events API. Snapchat uses the ScCid parameter to identify the specific click, while the other parameters help optimize the campaign.

To set up your smart script Snapchat Ads campaigns, perform the following:

1. Set up the template for the campaign’s OneLink attribution links. For more information, see How to create OneLink templates.

2. Create a smart script. For more information, see How to create a OneLink Smart Script.

    Note

   The instructions below outline the specific steps required to set up a Snapchat Ads campaign with Smart Script. For a comprehensive guide on how to set up Smart Script campaigns, see the How to create a OneLink Smart Script section of the OneLink Smart Script V2 setup article.

3. Make sure all relevant URL parameters are appended to the incoming URL. To review the parameters appended to the incoming URL, open Snapchat Ads Manager and check the URL parameters you set when creating the destination URL. For more information, see  Set destination URL.
4. Map the incoming URL parameters required for the Snapchat Ads campaign to the outgoing URL parameters. Those parameters are sent to AppsFlyer when the user clicks the CTA button:
   • PID: Make sure that Smart Script takes the pid=snapweb_int parameter value from the incoming URL and maps it to the corresponding parameters in the outgoing URL.

   • ScCid: The ScCid parameter is required for successfully sending in-app events postbacks to Snapchat. The ScCid parameter should be mapped manually in the URL parameter mapping section of the Smart Script page:

     1. In Mapping for, select Custom parameter.
     2. In the Outgoing URL parameter and the Incoming URL parameters, enter ScCid.

      Note

     To display in AppsFlyer raw data reports, you must also map the incoming ScCid parameter, separately from the outgoing ScCid parameter, to one of the outgoing af_sub[1–5] parameters.

To set up your smart script Snapchat Ads campaigns for cross-platform landing pages, perform the following:

1. Set up the template for the campaign’s OneLink attribution links. For more information, see How to create OneLink templates.
   • Enable your OneLink template for cross-platform attribution. For more information, see Create a OneLink template for cross-platform attribution.
2. Make sure all relevant URL parameters are appended to the incoming URL. To review the parameters appended to the incoming URL, open Snapchat Ads Manager and examine the URL parameters you set when building the destination URL. For more information, see Set destination URL.
3. Decide for each incoming parameter the outgoing parameter to which it will be mapped. for example, the incoming af_site_id parameter in the incoming URL will be mapped to the  af_site_id parameter in the outgoing URL.
4. Determine the default value for the mandatory outgoing parameters that cannot be left empty.
5. Send your developer the following information:
   • Your incoming - outgoing parameter mapping. The developer will create a script that generates an outgoing direct URL based on the incoming-outgoing parameter mapping.
   • The parameters’ default values. The script will populate the outgoing URL parameters with the default values whenever there are no corresponding incoming URL parameter values.
   • If you are using a OneLink attribution link, send the domain and template ID to your developer. The developer uses this to create the outgoing OneLink URL. For example: yourbrand.onelink.me/A1b2 or Branded domain example: click.yourbrand.com/A1b2
   • Send your developer the following Dev Hub links:
     • Instructions and code examples on how to create the outgoing direct URLs to the non-mobile platforms.
     • A demo and instructions for creating a cross-platform landing page.

• Remind your developer to include the incoming ScCid parameter in the outgoing URL.

   Note

  To display in AppsFlyer raw data reports, the incoming ScCid parameter must also be mapped (in addition to the outgoing ScCid parameter) to one of the outgoing af_sub[1-5] parameters.

1. The Snapchat ad URL includes the pid=snapweb_int parameter. When the user clicks on the ad, an ScCid parameter is automatically appended to the clicked URL.
2. The User is redirected to the URL destination - a landing page containing a Smart Banner.
3. When the landing page loads, the Smart Banner fires an impression event to AppsFlyer, which includes the incoming URL parameters. This impression enables view-through attribution for the landing page. To learn about impressions and view-through attribution, see Create a custom impression URL.
4. The Smart Banner generates the outgoing URL for the CTA button on the banner. The outgoing URL is based on the incoming URL parameters, including the ScCid parameter. The Smart banner can generate only OneLink-based links.
5. When the user clicks the Smart Banner CTA button, the click is fired and registered in AppsFlyer.
6. The user is redirected to the store and downloads the app.
7. When the user opens the app, the install event is registered in AppsFlyer.
8. AppsFlyer attributes the install based on probabilistic modeling or deterministically if the install referrer is available.
9. A postback containing the ScCid parameters and other event parameters are generated and sent to Snapchat via the Events API. Snapchat uses the ScCid parameter to identify the specific click, while the other parameters help optimize the campaign.

To set up your Smart Banners Snapchat Ads campaigns, perform the following:

1. Set up the template for the campaign’s OneLink attribution links. For more information, see How to create OneLink templates.

2. Create a Smart Banner.

    Note

   The instructions below outline the specific steps required to set up a Snapchat Ads campaign with Smart Banners. For a comprehensive guide on how to set up Smart Banners campaigns, see the setup section of the Smart Banners—mobile web-to-app (for marketers) article.

3. Set the Smart Banner parameters for Snapchat Ads campaigns:

   • Make sure all relevant URL parameters are appended to the incoming URL.
   • To review the parameters appended to the incoming URL, open Snapchat Ads Manager and review the URL parameters you set when creating the destination URL.

    Note

   Most importantly the pid=snapweb_int and ScCid are available in the incoming URL to allow the Smart Banner to collect them. These two parameters are necessary for attribution and for sending postbacks to Snapchat Ads.