Empower your marketing team to run highly granular campaigns on Snapchat
Supported syncing
| Type | Description | Supported Sync Modes | API Reference |
|---|---|---|---|
| Segments | Create and keeps audience segments up-to-date in Snapchat | Add, Remove | Audience segment docs |
| Conversion Events | Create and send conversion events to Snapchat | Insert | Conversions 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:
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:
- Phone
- Mobile ID
Syncing conversion events
Snapchat's Conversions API requires the following event parameters:
- event name (named
event_typein 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.
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:
| Name | Values |
|---|---|
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.