Search documentation...

ChangelogBook a demoSign up


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

TypeDescriptionSupported Sync ModesAPI Reference
CRM SegmentsSync data from any source to StackAdapt CRM segmentsAddSegments docs
Pixel APISync data from any source to Pixel eventsAddPixel 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:

  • email
  • 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

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

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.

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: Apr 11, 2024

On this page

Supported syncingConnect to StackAdaptSync configurationSyncing segmentsHandling PII and hashingSyncing pixel eventsTips and troubleshootingCommon errorsLive debuggerSync alerts

Was this page helpful?