Snapchat Conversion

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.

Connection compatibility

Destination info
Status: Generally Available Supported sources: Android, iOS , Web, Unity, AMP , Cloud, Warehouse, React Native , Flutter, Cordova, Shopify Refer to it as SNAPCHAT_CONVERSION in the Integrations object.

Connection modes
Source	Cloud mode	Device mode	Hybrid mode
AMP
Android
Cloud
Cordova
Flutter
iOS
React Native
Shopify
Unity
Warehouse
Web

Supported message types
Source	Identify	Page	Track	Screen	Group	Alias
Cloud mode
Supported sources

Get started

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 Continue.

Connection settings

To successfully configure Snapchat Conversion as a destination, configure the following 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 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:

Event mapping

This destination does not strictly adhere to the RudderStack Ecommerce Event Spec.

RudderStack maps the following ecommerce events to the corresponding Snapchat Conversion events:

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

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

Page

The page call lets you record your website’s page views with any additional relevant information about the viewed page.

RudderStack processes page calls as track calls with the Snapchat event set to page_view.

Hence, all the required fields for track events are required here as well.

A sample page call sent to Snapchat:

rudderanalytics.page("Help", "Help Page", {
  name: "Contact Customer Care",
  request_ip: "203.0.113.0",
  context: {
    userAgent: "ABC"
  }
})

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 Create Ads option in the top left section of the dashboard and go to Business Details > Conversions API Tokens. You will find all API tokens associated with your account listed here.
3. To generate a new Conversions API token, click Generate 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 Create Ads option in the top left section of the dashboard and go to Events Manager.
3. Then, click Setup Snap Pixel. You will see the following options:

4. Select Pixel Code and click Continue.
5. You will see the Snap Pixel ID at the top left of the resulting window:

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 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 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 Continue to finish the setup.

Questions? Contact us by email or on Slack