Snapchat's Conversions API lets you send your web, mobile, and offline events to Snapchat via a S2S (server-to-server) integration. You can then leverage this data to optimize your Snapchat ad campaigns and measure user conversions effectively.

RudderStack supports Snapchat Conversion as a destination where you can send your event data seamlessly.

The events should be generated at least 28 days before to be eligible for reporting via the Conversions API.
Find the open source transformer code for this destination in the GitHub repository.

Getting started

Before configuring Snapchat Conversion as a destination in RudderStack, verify if the source platform is supported by referring to the table below:

Connection ModeWebMobileServer
Device mode---
Cloud modeSupportedSupportedSupported
To know more about the difference between cloud mode and device mode in RudderStack, refer to the RudderStack Connection Modes guide.

Once you have confirmed that the source platform supports sending events to Snapchat Conversion, follow these steps:

  1. From your RudderStack dashboard, add the source. Then, from the list of destinations, select Snapchat Conversion.
  2. Assign a name to your destination and click on Continue.

Connection settings

To successfully configure Snapchat Conversion as a destination, configure the following settings:

Snapchat Conversion connection settings Snapchat Conversion connection settings
  • API Token: Enter your API token generated from your Snapchat dashboard.
  • Pixel ID: Enter your Snap Pixel ID. This is required for sending the web and offline events.
For more information on getting your API token and Snap Pixel ID, refer to the FAQ section below.
  • Snap App ID: Enter your Snapchat App ID. This is required for sending the app events.
Refer to the Generate your Snap App ID guide for more information on generating the Snap App ID.
  • App ID: Enter the unique ID associated with your application. This is required for sending the app events.
The App ID is different from Snap App ID. It should be numeric for iOS and in the human-interpretable string format in case of Android.

For more information, refer to the Conversions API reference.

  • Map your events with Snapchat Standard Events: Enter the event name and select the corresponding Snapchat standard event from the dropdown to be triggered when that event is called.
You can specify multiple standard events for one event name and vice versa.
  • Enable Event Deduplication: Enable this setting to deduplicate the events. If enabled, you need to enter the following:
    • Deduplication key: Enter the field/property name to be mapped to a standard Snapchat Conversion property client_dedup_id, using which Snapchat Conversion deduplicates the events.

Track

The track event lets you capture user events along with the properties associated with them.

RudderStack tracks and sends the web, mobile, and offline events to Snapchat via the conversion endpoint.

RudderStack uses Bearer authentication leveraging the Snap API token for authenticating all the requests. OAuth is not supported currently.

A sample track call is shown below:

rudderanalytics.track("Order Completed", {
order_id: "1234",
currency: "USD",
products: [{
product_id: "345676543",
price: 7.99
},
],
}, {
context: {
traits: {
email: "alex@example.com",
phone: "+1-202-555-0146"
}
}
})
Make sure to pass at least one of the required fields from the below:
  • email
  • phone
  • idfa
  • ip and userAgent

RudderStack checks the eventConversionType event property to determine the type of event to send to Snap Conversion (web, mobile, or offline) as specified below:

web -> "WEB",
mobile -> "MOBILE_APP",
mobile_app -> "MOBILE_APP",
offline -> "OFFLINE"
Make sure you specify the values in the exact format.

If eventConversionType is not found in the event, RudderStack checks if channel is present. If channel is absent too, RudderStack automatically sets eventConversionType to OFFLINE.

An example highlighting the use of eventConversionType is shown below:

rudderanalytics.track("Products Searched", {
query: "HDMI cable",
eventConversionType: "mobile"
});

RudderStack tracks the following properties and maps them to the corresponding Snapchat Conversion properties:

RudderStack propertySnapchat Conversion property
properties.order_id
properties.checkout_id
transaction_id
context.page.url
properties.url
page_url
properties.eventevent_type
properties.event_tagevent_tag
properties.eventConversionTypeevent_conversion_type
properties.quantitynumber_items
properties.currencycurrency
properties.categorycategory
properties.querysearch_string
properties.products.price
properties.price
properties.value
properties.revenue
price
properties.product_id
properties.products.product_id
item_ids
properties.SignUpMethod
properties.sign_up_method
sign_up_method
properties.client_dedup_idclient_dedup_id

Event mapping

RudderStack maps the following e-commerce events to the corresponding Snapchat Conversion events:

RudderStack eventSnapchat Conversion event
Products SearchedSEARCH
Product List ViewedVIEW_CONTENT
Promotion ViewedAD_VIEW
Promotion ClickedAD_CLICK
Product ViewedVIEW_CONTENT
Product AddedADD_CART
Checkout StartedSTART_CHECKOUT
Payment Info EnteredADD_BILLING
Order CompletedPURCHASE
Product Added to WishlistADD_TO_WISHLIST

RudderStack does not map the following events and passes their properties as is, without any modification:

  • SIGN_UP
  • APP_OPEN
  • APP_INSTALL
  • SAVE
  • SUBSCRIBE
  • COMPLETE_TUTORIAL
  • INVITE
  • LOGIN
  • SHARE
  • RESERVE
  • ACHIEVEMENT_UNLOCKED
  • SPENT_CREDITS
  • RATE
  • START_TRIAL
  • LIST_VIEW
  • PAGE_VIEW

FAQ

Where can I find the Conversions API token?

To get your Snap Conversions API token, follow these steps:

  1. Go to your Snap Ads Manager account.
  2. Click on Create Ads option in the top left section of the dashboard and go to Business Details > Conversions API Tokens. You will find all the API tokens associated with your account listed here.
  3. To generate a new Conversions API token, click on Generate Token.
Snap Conversions API token

Where can I find the Pixel ID associated with my account?

To get your Snap Conversions Pixel ID, follow these steps:

  1. Go to your Snap Ads Manager account.
  2. Click on Create Ads option in the top left section of the dashboard and go to Events Manager.
  3. Then, click on Setup Snap Pixel. You will see the following options:
Snap Conversions set up Pixel
  1. Select Pixel Code and click on Continue.
  2. You will see the Snap Pixel ID at the top left of the resulting window, as shown:
Snap Conversions Pixel ID

Where can I find the App ID associated with my application?

To get your Snap Conversions Pixel ID, follow these steps:

  1. Go to your Snap Ads Manager account.
  2. Click on Create Ads option in the top left section of the dashboard and go to Apps. You will find the App ID associated with all your apps listed here.

To add a new app, follow these steps:

  1. Click on Add an App.
  2. You can either create a new Snap App ID or importing an existing App ID.
  3. Then, enter your App Name and the relevant app ID/URL depending on your app's platform.
  4. Finally, add any postbacks and click on Continue to finish the setup.
Snap Conversions add new app

Contact us

For more information on the topics covered on this page, email us or start a conversation in our Slack community.

Contents