Snapchat Custom Audience matches data from your Snapchat customer list (email, phone number, or mobile advertiser ID) with the Snapchat community.

Getting started

RudderStack supports sending events to Snapchat Custom Audience via the following connection modes:

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

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

Connection settings

To successfully configure Snapchat Custom Audience as a destination, first authenticate your account by following the below steps:

1. Click Create Account in the Account Settings section.
2. From the modal, click the Sign in with Google button.
3. Choose the required account and grant RudderStack the required permissions.
4. Click Save to use the specified account, as shown:

In case you have authenticated multiple accounts, you can click Edit Credentials to select/delete any other authenticated account, as shown:

RudderStack gives an error if you try to delete an account used by any other connection set up for the same destination.

Next, configure the following settings:

• Segment ID: Enter your Snapchat segment ID. For more information on getting your segment ID, refer to the FAQ section below.
• Schema: Select the schema (EMAIL, MOBILE AD ID, or PHONE) from the dropdown.

• Disable hashing: By default, RudderStack hashes the email, phone, and mobileAdId in the SHA-256 format. If enabled, RudderStack will not perform the hashing.

audienceList event structure

The following code snippet shows a sample audienceList call:

Copy
{
  "type": "audiencelist",
  "event": "Order Created",
  "sentAt": "2022-06-14T12:34:53.514Z",
  "traits": null,
  "userId": "6201002000600",
  "context": {
    "library": {
      "name": "RudderStack Shopify Cloud",
      "version": "1.0.0"
    },
    "integration": {
      "name": "SHOPIFY"
    }
  },
  "rudderId": "b66112d4-a5af-4856-a6e4-2dbad7104c91",
  "messageId": "99a56bfb-45bf-4852-a911-03f73c3fdcdf",
  "timestamp": "2022-06-14T12:34:48.000Z",
  "properties": {
    "listData": {
      "add": [{
        "email": "alex@example",
        "phone": "+1-202-555-0146",
        "country": "USA",
        "lastName": "Keener",
        "firstName": "Alex ",
        "postalCode": "90009"
      },
        {
          "email": "alexis@example.com",
          "phone": "+1-202-555-0145",
          "country": "USA",
          "lastName": "Alexis",
          "firstName": "Keener",
          "postalCode": "90009"
        }
      ],
      "remove": [{
        "email": "jack@hotmail.com",
        "phone": "+1-202-555-0145",
        "country": "USA",
        "lastName": "Jack",
        "firstName": "Jackson ",
        "postalCode": "90009"
      }]
    }
  },
  "receivedAt": "2022-06-14T12:34:53.113Z",
  "request_ip": "35.231.104.198",
  "anonymousId": "760bf220-046f-4c2a-ad2b-3424be593740",
  "integrations": {
    "SHOPIFY": true
  },
  "originalTimestamp": "2022-06-14T12:34:53.514Z"
}

Schema fields mapping

The following table details the mapping of the schema fields (as specified in the RudderStack dashboard) and the Snapchat Marketing API.

RudderStack normalizes the raw identifiers by following the Snapchat-prescribed rules before SHA-256 hashing and sending them to Custom Audience.

FAQ

Where can I find my Snapchat Segment ID?

To get your Snapchat Segment ID, follow the steps below:

1. Log into your Snapchat Ads Manager dashboard.
2. Go to Assets > Audiences.
3. Under Audience Library, select the required audience.
4. Copy the ID after /audiences/custom-audience/ in the URL of the resulting page. This is your segment ID.

For example, consider the following URL:

Copy
https://ads.snapchat.com/cc9c3e81-8a7e-44c0/audiences/custom-audience/1234567890123456/

In the above case, 1234567890123456 is the segment ID.

How do I create a Customer List Audience in Snapchat?

For detailed steps on creating a Snapchat Customer List Audience, refer to the Snapchat support page.