Snap Pixel

Snap Pixel is a piece of JavaScript code that lets you measure the cross-device impact of your advertising campaigns. It enables you to understand how many Snapchat users interact with your website after seeing the ads.

Connection compatibility

Destination info
Status: Generally Available Supported sources: Web Refer to it as SNAP_PIXEL in the Integrations object.

Connection modes
Source	Cloud mode	Device mode	Hybrid mode
Web

Supported message types
Source	Identify	Page	Track	Screen	Group	Alias	Record
Device mode
Web

In the web device mode integration, that is, using JavaScript SDK as a source, RudderStack loads the Snap Pixel native SDK from the https://sc-static.net/ domain.

Based on your website’s content security policy, you might need to allowlist this domain to load the Snap Pixel SDK successfully.

Get started

1. From your RudderStack dashboard, add the source. From the list of destinations, select Snap Pixel.
2. Assign a name to the destination and click Continue.

Connection settings

Identify

You can use the identify call to initialize the Snap Pixel code.

RudderStack checks the cookies for the user parameter (email or phone) before loading the Snap Pixel snippet. If the parameter is present, RudderStack loads the snippet. Otherwise, it loads the snippet without passing the user parameter.

Snapchat strongly recommends passing a user parameter (either email or phone) through the Snap Pixel, as it lets you get better insights into your tracked conversions and creates more robust Pixel Custom Audiences. For more information, refer to the Snap Pixel FAQ.

A sample identify call is as shown:

rudderanalytics.identify({
  email: "alex@example.com",
  phone: "+1-202-555-0146"
});   

The following table lists the user parameters along with the corresponding mapping to the Snap Pixel parameters:

Page

When you make a page call, RudderStack sends the following call to Snap Pixel:

snaptr("track", "PAGE_VIEW")

You can make a page call with or without the event payload.

A sample page call is as shown:

rudderanalytics.page();

Track

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

You can use the track call to send Snap Pixel events. Refer to the Snapchat documentation for more information on the Snap Pixel events.

A sample track call is as shown below:

rudderanalytics.track('Order Completed', {
  'currency': 'USD',
  'price': 333.33,
  'order_id': '11111111'
});

You can also send the following RudderStack ecommerce events:

RudderStack maps order_id to Snap Pixel’s transaction_id only in case of the Order Completed event.

Snap Pixel supports up to 5 custom events, listed below:

• CUSTOM_EVENT_1
• CUSTOM_EVENT_2
• CUSTOM_EVENT_3
• CUSTOM_EVENT_4
• CUSTOM_EVENT_5

Set custom client deduplication key

RudderStack lets you define the client deduplication key for event deduplication. Turn on the Customize Client Deduplication Key setting in the dashboard to use this feature.

The following scenarios describe the different ways RudderStack sets the custom deduplication key:

Scenario 1: Pass the key in event properties

Suppose you turn on the Customize Client Deduplication Key setting and set the Client Deduplication Field to properties.dedup. RudderStack then sets the client deduplication ID with the value associated with properties.dedup, as shown in the following snippet:

rudderanalytics.track(
  "SHARE", {
    dedup: "mydedupid",
    checkout_id: "12345",
    product_name: "Red T-shirt",
    product_url: "http://www.sampledomain.com/products/myred-t-shirt",
  }, {
    integrations: {},
  }
);

In this case, RudderStack sets mydedupid as the client deduplication ID.

Scenario 2: Pass messageId as the deduplication key

Suppose you turn on Customize Client Deduplication Key and leave the Client Deduplication Field empty. In this case, RudderStack sets the event’s messageId as the client deduplication ID.

Scenario 3: Wrong/missing field in the dashboard settings

Suppose you turn on Customize Client Deduplication Key and set the Client Deduplication Field, but the field is either missing or has a different name in the event. In this case, RudderStack does not set the client deduplication ID.

For example, if you set Client Deduplication Field to properties.dedup and the event contains properties.deduplication instead, then RudderStack sends the event to Snap Pixel without setting the client deduplication ID.

FAQ

Where can I find the Snap Pixel ID?

To get your Snap Pixel ID, follow these steps:

1. Go to your Snap Ads Manager account.
2. Under Events Manager, go to View Pixel Details > Setup Pixel. You can find the Pixel ID under Set Up Your Snap Pixel:

Questions? Contact us by email or on Slack