Syncing data from your warehouse to StackAdapt to enable data-driven advertising decisions and optimized targeting by leveraging comprehensive customer insights.
View StackAdapt's documentation.
Supported syncing
| Type | Description | Supported Sync Modes | API Reference |
|---|---|---|---|
| CRM Segments | Sync data from any source to StackAdapt CRM segments | Add | Segments docs |
| Pixel API | Sync data from any source to Pixel events | Add | Pixel API docs |
For more information about sync modes, refer to the sync modes docs.
Connect to StackAdapt
Go to the Destinations overview page and click the Add destination button. Select StackAdapt and click Continue. You can then authenticate Hightouch to StackAdapt by entering the following StackAdapt tokens:
- Pixel ID: (Only necessary for using Pixel API). If you don't have a Pixel ID, create one in StackAdapt.
- GraphQL API token: (Only necessary for segment syncs). If you don't have an API token, please reach out to your account manager.
Sync configuration
Once you've set up your StackAdapt 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 StackAdapt destination you want to sync to.
Syncing segments
Sync data from any source to StackAdapt CRM Segments
Record matching
You can match rows from your model to segment in StackAdapt on any column in your model and any field in StackAdapt. Ensure the data types of the model column and StackAdapt field you select match. Refer to the record matching docs for more information.
StackAdapt accepts the following fields: address, city, email, first name, last name, phone number, state, and zip code. For hashed PII data, you must select one of the following valid combinations of these identifiers:
- first name, last name, email
- first name, last name, phone number
- first name, last name, zip code
If you do not provide at least one of the possible combinations, StackAdapt will be unable to find matches. You can learn more here: StackAdapt CRM Audience Creation.
Handling PII and hashing
You can sync data to StackAdapt in one of two formats: either as a list of strings containing hashed PII data or as a list of objects containing users' information.
Currently, StackAdapt only supports SHA_1 as the hashing algorithm. For more information, refer to the StackAdapt documentation on hashed PII data.
Syncing pixel events
Sync data from any source to StackAdapt pixel events
Field mapping
Hightouch lets you map model columns to event properties. The required event properties are:
- IP address
- Page title
- User agent
- URL of target website
Event args
You can also map additional event data that Hightouch sends to StackAdapt via the args property which can be used for pixel rule matching.
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.