Snapchat Web - Web to App Campaigns

Follow
Avatar
Fernando Cabral
Updated
Setting Up Snapchat Ads
Web & Mobile 
Web-to-App 
Configure for Web & Mobile Web-to-App Campaigns

 

This article details how to configure Singular mobile, PC and Console install attribution for Snapchat web campaigns (non-app campaigns). For directions on configuring and attributing Snapchat app campaigns, see our Snapchat Ads Attribution guide.

Snapchat campaigns do not support MMP trackers URLs, so all conversions are measured with click-through attribution only, setting Singular Tracker in the Website URL. 

Overview

Singular’s web-to-app attribution solutions empower marketers to run web campaigns that drive app installs across Mobile, PC, and Console platforms. See more details on Web, Web-to-App, PC, & Console Campaign Optimization.

Add Snapchat Web Partner Configuration in Singular

Add Snapchat Web CAPI Partner Configuration in Singular

  1. Go to Singular > Attribution > Partner Configuration
  2. Click “Add a Partner”, and type and choose “Snapchat Web CAPI”
  3. In the dialog, choose your App and App site (platform) to configure. Mobile, PC, and console apps are supported with this integration
  4. Paste in your app's "Access Token" and "Pixel ID" (Web/PC/Console) or "Snap App ID" (Mobile) from your Snapchat Ads Manager dashboard.

    or

  5. Optionally configure any additional events to send to Snapchat and map it to a "Snapchat Event Name"


  6. Click "Save" to finish.
Create Singular Link for "Snapchat Web CAPI"

Create Singular Link for "Snapchat Web CAPI"

  1. Go to Singular > Attribution > Manage Links
  2. Select your mobile app from the list of apps on the left
  3. Select "Create Link" -> Link Type "Partner" -> Source Name "Snapchat Web CAPI"
  4. Continue through the step-by-step link creation. 
  5. Click "Generate"
  6. Copy the "Click-through Tracking Link" for the next step
Set up your Snapchat Web Campaign

Set up your Snapchat Web Campaign

  1. In Snapchat Ads Manager, create a campaign and select either the Sales or Traffic campaign objectives:
    • Sales - optimize from events that you've set up in your Singular Partner Configuration
    • Traffic - optimize to clicks
  2. Set Conversion location to Website
  3. Add Singular Link from the section above to the Destination Website URL

FAQ

Where can you find the Snapchat Pixel ID?
#
  1. Navigate to the Snapchat Ads Manager page.
  2. Navigate to the "Pixels" page
  3. Under "Pixels", copy your "Pixel ID"

    If this is a new pixel, follow Snapchat's step-by-step guide to create a "Pixel". Read more about How To Install Snap Pixel.
Where can you find the Snapchat App ID?
#
  1. Navigate to the Snapchat Ads Manager page.
  2. Navigate to the "Apps" page
  3. Under "Apps", copy your "App ID"

    If this is a new App, follow Snapchat's step-by-step guide to create an "App". Read more about How To Generate a Snap App ID.
Where can you find the Access Token?
#
  1. Navigate to the Snapchat Ads Manager page.
  2. Navigate to the "Business Dashboard" page
  3. Navigate to the "Business Details" menu
  4. Under "Conversions API Tokens", generate and copy your API Token
What data does Singular send via API?
#
Parameter Details
event_name
  • A standard Snapchat event. This value is used to assist Snapchat in the deduplication of events. The event_id parameter is also used in deduplication.
ScCid
  • Snapchat click ID
  • automatically passed
hashed email
  • Optional
  • Hashed email may be passed as a Singular instrumented event attribute "ehash"
  • Hashed email value must be normalized and SHA 256 hashed
hashed phone number
  • Optional
  • Hashed phone number may be passed as a Singular instrumented event attribute "phash"
  • Hashed phone number must be E164 normalized and SHA 256 hashed
hashed first name
  • Optional
  • Hashed first name may be passed as a Singular instrumented event attribute "fnamehash"
  • Using Roman alphabet a-z characters is recommended. Lowercase only with no punctuation. If using special characters, the text must be encoded in UTF-8 format.
  • Hashed first name be SHA 256 hashed
hashed last name
  • Optional
  • Hashed last name may be passed as a Singular instrumented event attribute "lnamehash"
  • Using Roman alphabet a-z characters is recommended. Lowercase only with no punctuation. If using special characters, the text must be encoded in UTF-8 format.
  • Hashed last name be SHA 256 hashed
event_tag
  • Optional
  • Event Tag may be passed as a Singular instrumented event attribute "etag"
event_source_url
  • Optional
  • Event Source URL may be passed as a Singular instrumented event attribute "page_url"
IP address
  • The Client IP Address
user agent
  • (For web only)The user agent for the browser corresponding to the event
For Deduplication of Events (Optional)  
event_id
  • Required Parameter for Deduplication
  • Pass the event_id value to Singular in the Event Arguments using an attribute name: "eventId".

Snapchat Requirements:

  • If using Snap Pixel, event_id must match the client_dedup_id for the matching event.
  • The event_id parameter is an identifier that can uniquely distinguish between similar events. Read more about the event_id parameter.
What are the limitations of Snapchat Conversions API?
#
  • Snapchat recommends that the Snapchat Conversion API be used to augment an existing Snapchat pixel implementation.
  • For mobile integrations, Meta and Singular recommend passing mobile conversion data through Singular's dedicated mobile attribution integration with Snapchat. If you are interested in passing mobile conversion data through Snapchat Conversions API, reach out to your Singular customer success manager.