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.

Getting started

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

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.

• Snap App ID: Enter your Snapchat App ID. This is required for sending the app events.

• App ID: Enter the unique ID associated with your application. This is required for sending the app events.

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

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

A sample track call is shown below:

Copy
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"

    }
  }
})

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

Copy
web -> "WEB",
mobile -> "MOBILE_APP",
mobile_app -> "MOBILE_APP",
offline -> "OFFLINE"

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:

Copy
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

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:

• 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 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 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, as shown:

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.