Search documentation...

K
ChangelogBook a demoSign up

Snapchat

Empower your marketing team to run highly granular campaigns on Snapchat

Supported syncing

TypeDescriptionSupported Sync ModesAPI Reference
SegmentsCreate and keeps audience segments up-to-date in SnapchatAdd, RemoveAudience segment docs
Conversion EventsCreate and send conversion events to SnapchatInsertConversions API docs

For more information about sync modes, refer to the sync modes docs.

Connect to Snapchat

Go to the Destinations overview page and click the Add destination button. Select Snapchat and click Continue. You can then authenticate Hightouch to Snapchat.

For the Authentication method, select Log in to Snapchat and log into your Snapchat account. Then, authorize Hightouch to access your Snapchat account:

OAuth flow for Snapchat

Once successful, you will be redirected back to Hightouch. There, select the Snapchat business organization you want to sync data to. Finally enter a descriptive name for your destination to complete setup.

Sync configuration

Once you've set up your Snapchat destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the Snapchat destination you want to sync to.

Syncing segments

You can use Hightouch to create and keep audience segments in Snapchat up-to-date using Snapchat's Ads API. Begin by selecting the Snapchat Ad Account your audience segments should belong to.

Select an existing audience or create a new one

You can create a new audience segment or use an existing one. When creating a new audience, you can optionally enter a name; otherwise, Hightouch defaults to the name of the associated model. To use an existing audience, select the desired audience from the dropdown.

Audience member retention

You can specify a custom retention period that an audience segment should retain members. Snapchat's default is 9,999 days. You can only set custom values when first creating an audience segment. If you want to set a new retention period, you need to create a new sync.

User identifiers

To identify which users to add or update in an audience, select model columns and the corresponding Snapchat fields. You can match on any of the following Snapchat fields:

  • Email
  • Phone
  • Mobile ID
Increase match rates in Snapchat audience segments by enabling Match Booster.

Syncing conversion events

Snapchat's Conversions API requires the following event parameters:

  • event name (named event_type in Snapchat's Conversions API)
  • event conversion type (event_conversion_type)
  • event tag (event_tag)
  • timestamp

The sync configuration form ensures all these are set and provides some additional options. For more information about Snapchat's Conversions API and it's prerequisites, check out Snapchat's API help article.

To ensure syncs send each event, your event model must use a truly unique primary key. See the events syncs documentation for more information.

Event name and conversion type

Providing an event name is required to send an event to the Conversions API. You can either provide a static value or select to use a column from your model. You can select your event conversion type in the same way.

Snapchat's Conversions API accepts the following values:

NameValues
event_type"PURCHASE," "SAVE," "START_CHECKOUT," "ADD_CART," "VIEW_CONTENT," "ADD_BILLING," "SIGN_UP," "SEARCH," "PAGE_VIEW," "SUBSCRIBE," "AD_CLICK," "AD_VIEW," "COMPLETE_TUTORIAL," "INVITE," "LOGIN," "SHARE," "RESERVE," "ACHIEVEMENT_UNLOCKED," "ADD_TO_WISHLIST," "SPENT_CREDITS," "RATE," "START_TRIAL," "LIST_VIEW," "APP_INSTALL," "APP_OPEN," "CUSTOM_EVENT_1," "CUSTOM_EVENT_2," "CUSTOM_EVENT_3," "CUSTOM_EVENT_4," "CUSTOM_EVENT_5"
event_conversion_type"OFFLINE," "WEB," "MOBILE_APP"

See the Snapchat Marketing API documentation for more information about event parameters.

Event timestamp

You can optionally select a column that contains timestamps of when events occurred. If this field is empty, Hightouch uses the time the event arrives at the server.

If you select a column, it should be in UNIX timestamp, calculated in seconds or milliseconds.

Field mapping

Hightouch lets you sync event properties via field mapping. You must include the event tag field that Snapchat's Conversions API requires for each event. Event tags are custom values you create, for example, "in-store," "weekend sales," "back-to-school campaign," etc.

Check out Snapchat's Conversion parameters documentation for more information about the parameters you can map.

PII hashing

Snapchat requires identity information to be normalized and hashed using a SHA256 hash. Enable PII hashing if you wish for Hightouch to normalize and hash these values for you. If you turn off PII hashing, you must ensure your model data is hashed before sending it to Snapchat.

Tips and troubleshooting

Common errors

To date, our customers haven't experienced any errors while using this destination. If you run into any issues, please don't hesitate to . We're here to help.

Live debugger

Hightouch provides complete visibility into the API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks to learn more.

Sync alerts

Hightouch can alert you of sync issues via Slack, PagerDuty, SMS, or email. For details, please visit our article on alerting.

Ready to get started?

Jump right in or a book a demo. Your first destination is always free.

Book a demoSign upBook a demo

Need help?

Our team is relentlessly focused on your success. Don't hesitate to reach out!

Feature requests?

We'd love to hear your suggestions for integrations and other features.

Last updated: May 23, 2023

On this page

Supported syncingConnect to SnapchatSync configurationSyncing segmentsSyncing conversion eventsPII hashingTips and troubleshootingCommon errorsLive debuggerSync alerts

Was this page helpful?