Send conversion web events to Twitter and run campaigns with custom audiences, retargeting, and lookalikes directly from your warehouse
Overview
Build more robust campaigns on Twitter with up-to-date customer data from your data warehouse.
Getting Started
Connect to Twitter
Add Twitter as a destination in Hightouch
- Log in to Hightouch or create a free Hightouch account
- Click on Destinations in the left sidebar
- Click on Add destination in the top right corner
- Select Twitter in the destination catalog and click Continue to proceed
- Proceed with the OAuth steps until you are redirected to the Hightouch website.
- Give your destination a name and unique slug (e.g., Twitter Production” and
Twitter-production) - Click Finish to create your Twitter destination!
Sync Configuration
Syncing Custom Audiences
This integration supports Segment Mode. New users in the model will be inserted into the Twitter Custom Audience. Users that are removed from the model will be removed from the Custom Audience.
Twitter Account Selection
In this section, select the Twitter account you would like to sync your data to.
Audience Selection
This integration supports syncing to an existing audience or creating a new audience.
To use an existing segment:
- Select
Use existing audiencefrom the radio buttons. - Select the name of the audience from the dropdown menu.
To create a new audience:
- Select
Create a new audiencefrom the radio buttons. - Specify a custom name for this audience in the input field. Otherwise Hightouch will use the name of the model as the audience's name.
Field Mapping
Hightouch allows you to sync columns from your source to the supported Twitter fields.
Twitter allows mapping to various user identifiers, such as Email, Device ID, Twitter Handle, etc. Twitter requires all fields for users to be both normalized and hashed using SHA256 (with the exception of Partner User ID).
You can achieve this in your model with a function
by using the encode(digest(value, 'sha256'),'hex') function in Postgres, or refer to the Template Mappings Section in this documentation to learn about how Hightouch can handle hashing these records for you.
Syncing Conversion Events
This integration supports syncing Web Conversion Events.
Twitter Account Selection
In this section, select the Twitter account you would like to sync your data to.
Pixel ID (Universal Website Tag) Account Section
If the Pixel ID exist in your model, toggle Use Column, and select the appropriate column from the dropdown menu.
To retrieve your Pixel ID:
- Navigate to your Events Manager page.
- Copy the ID and paste it in the Hightouch sync form.
Event Selection
Given the correct Pixel ID, Hightouch will filter for the eligible events that allow conversion events to be synced to.
Select the event you'd like to sync to from the dropdown menu. If the ID for these events exist in your model, toggle Use Column, and select the appropriate column from the dropdown menu.
Identifier Section
When syncing conversion events, Twitter expects one identifier at minimum, or you can provide both.
Select your choice for the sync from the radio buttons. This will render the fields in the mappings section, which you can map to from your model.
Field Mapping
Hightouch allows you to sync columns from your source to the supported Twitter fields.
If you wish to use the Email Address as an identifier, Twitter expects it to be hashed using SHA256. You can achieve this in your model with a function by using the encode(digest(value, 'sha256'),'hex') function in Postgres, or refer to the Template Mappings section in this documentation to learn about how Hightouch can handle hashing these records for you.
Template Mappings
You can leverage Hightouch's Template Mappings feature to allow Hightouch to handle hashing certain fields for you automatically.
To use this feature:
- Select Template in the mappings window.
- Select the column you would like to hash from the Variables section.
- Select sha256 from the Functions section.
- Click Apply to save.
To find out more about Template Mapping and other Mapping features, visit our Mapping Data section.
Troubleshooting
Common errors
To date, our customers haven't experienced any errors while using the Twitter destination. If you run into any issues, please reach out to us. We are here to help!
Use the Hightouch debugger
Hightouch provides full visibility into the Twitter API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks.
Set up sync alerts
Hightouch can alert you of any sync issues via Slack, PagerDuty, SMS, and/or email. For details, please visit our article on alerting.