Overview

Destination Type:

Client-side
and
Server-side


Installation Instructions

  1. Navigate to your Snapchat Ads > Events Manager (under assets).

  2. From your Events Manager, click on the Snapchat Pixel you would like to connect or create a new one through ‘New Event Source’.

  3. Under the name of the pixel, you can find the Pixel ID, copy it and save it for later.

  4. Go to the business dashboard > Business details > Conversions API tokens. Click the ‘Generate Token’ button and copy the new API token and save it for later.

  5. In the Converge sidebar, click on

    Event streams
    and then click Create new Destination.

  6. Select the Snapchat destination and click Next.

  7. Give your destination a name (e.g. Snapchat Destination) and click Next.

  8. Fill in the Pixel ID and API Token you copied from Snapchat and click Next.

  9. Enter the main URL of your website. Be sure to include the https:// prefix as well. Then click Next.

  10. Select Use default mapping and click Next.

You can find the Default mapping for the Snapchat destination here. For more information on setting up Custom mappings, look here.
  1. Select the sources you want to forward events from, then click Next.

  2. Review any issues and click Submit.

Once you have installed your Converge Destination, you should pause or remove all existing Snapchat tracking. Leaving these on will lead to duplicate tracking. Check the Turn off your old tracking setup guide for additional instructions.

Modify your Content ID

The Converge Snapchat Destination will use the Default content mode to define the Content ID forwarded by default. However, you can configure the destination to use explicitly the Product ID, the Variant ID or SKU instead.

  1. Navigate to your Snapchat Destination, click on Configuration.
  2. Click on the Configuration-subtab
  3. Open the Advanced configuration (optional) section
  4. Pick your desired Content ID, and click on Save

List of Content ID Modes

Content ID ModeBehavior
DefaultUse the variant_id if available, otherwise use the product_id
Product IdAlways use the product_id
Variant IdAlways use the variant_id
SKUAlways use the sku

Converge functionality

This integration supports the following Converge destination functionality.

Converge FeatureSupported
Custom Events
Filters
Server-side Conversions
Snapchat does not support multiple pixels on the same website. Installing multiple Snapchat destinations will lead to duplicate tracking.

Event Mapping

Converge automatically maps the following events from the Converge Event Spec to the Snapchat spec.

Converge Event NameSnapchat Event Name
$page_loadPAGE_VIEW
Viewed ProductVIEW_CONTENT
Viewed CollectionLIST_VIEW
Added To CartADD_CART
Added To WishlistADD_TO_WISHLIST
Started CheckoutSTART_CHECKOUT
Added Payment InfoADD_BILLING
Placed OrderPURCHASE
Started SubscriptionSUBSCRIBE
Logged InLOGIN
Signed UpSIGN_UP
SearchedSEARCH

You can only configure up to 5 custom events for Snapchat. These events must be named CUSTOM_EVENT_1 through CUSTOM_EVENT_5.