Send query results to Snapchat

Snapchat is a social media platform that allows users to access pictures and messages for a short time. Snapchat provides a self-serve platform from which brands can manage ads and advertising campaigns.


Amperity requires access to Snapchat. This access may expire or be removed periodically, depending on how OAuth is managed at Snapchat. If Amperity is unable to send data to Snapchat ask your DataGrid Operator to reauthorize access to Snapchat.

This topic describes the steps that are required to send email addresses, phone numbers, and mobile advertiser IDs to Snapchat from Amperity:

  1. Build a query

  2. Add orchestration

  3. Run orchestration


Snapchat must be enabled before you can configure an orchestration to send query results. Ask your DataGrid Operator or Amperity representative to enable Snapchat for your tenant.

Build query

The default audience list in Snapchat requires only an email address. This requires a simple SELECT statement that returns only the Amperity ID and its associated email address:

  ,amperity_id AS "Amperity ID"
  ,email AS "Email"
FROM Customer360

Notes about sending data to Snapchat

  1. Snapchat allows the following fields: email, mobile_id, and phone.

  2. You may send only one of only one email, mobile_id, or phone.

  3. Amperity ensure that fields are mapped correctly to the schema types required by Snapchat.

  4. Amperity applies SHA-256 hashing automatically.

  5. Audience targeting in Snapchat requires at least 1000 unique customers. Be sure your query returns at least 1000 unique customers.

Use email addresses

The following example shows how to send results using an email address:

  email AS email
FROM Merged_Customers

Use mobile advertiser IDs

The following example shows how to send results using a mobile advertising ID:

  mobile_id_field AS mobile_id
FROM MobileID_Table
WHERE mobile_id_field IS NOT NULL


mobile_id_field represents a field in Amperity that contains the mobile advertising ID and MobileID_Table represents the table in which that field is located.

Use phone numbers

The following example shows how to send results using a phone number:

  phone AS phone
FROM Merged_Customers

Add orchestration

An orchestration defines the relationship between query results and a destination, including the location to which those query results will be sent and the frequency at which the orchestration will be run.

To add an orchestration

  1. From the Destinations tab, click Add Orchestration. This opens the Add Orchestration dialog box.

  2. From the Object Type drop-down, select Query.

  3. From the Object drop-down, select the query for which results will be sent to Snapchat.

  4. From the Destination drop-down, select a destination that is configured for sending data to Snapchat.

  5. From the Data Template drop-down, select a data template.

  6. Verify all settings.

  7. Set the workflow to Manual. (You can change this to automatic later, after verifying the end-to-end workflow.)

  8. Click Save.

Run orchestration

Run the orchestration manually to validate that it works.

To run the orchestration

  1. From the Destinations tab, under Orchestrations, open the    menu for the Snapchat orchestration, and then select Run.

  2. The Status column for the orchestration will update to say “Waiting to start…”, after which the notifications pane will update to include a notification that shows the current status.

  3. When the orchestration has run successfully, the status is updated to “Completed”.

Snapchat schema types

The following Amperity columns may be mapped to the corresponding schema type to add users using Snap Audience Match .


A row that contains a NULL value is automatically filtered out and will be shown in the error logs.

Amperity Column

Snapchat Schema Type




For this key, the connector:

  • Trims leading and trailing whitespace

  • Converts to lower-case

  • Hashes data as SHA-256



For this key, the connector:

  • Trims leading and trailing whitespace

  • Converts to lower-case

  • Keeps hyphens

  • Hashes data as SHA-256



Converts each phone number to E.164 format which represents a phone number as a number up to fifteen digits in length (without spaces) that starts with a + symbol. For example: +12061234567.

For this key, the connector:

  • Trims leading and trailing whitespace

  • Removes symbols, letters, and any leading zeros

  • Hashes data as SHA-256