Search documentation...

K

Twitter Ads

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

  1. Log in to Hightouch or create a free Hightouch account
  2. Click on Destinations in the left sidebar
  3. Click on Add destination in the top right corner
  4. Select Twitter in the destination catalog and click Continue to proceed
  5. Proceed with the OAuth steps until you are redirected to the Hightouch website.
  6. Give your destination a name and unique slug (e.g., Twitter Production” and Twitter-production)
  7. 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 audience from the radio buttons.
  • Select the name of the audience from the dropdown menu.

To create a new audience:

  • Select Create a new audience from 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:

Where to find Pixel ID

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

Template Mappings Instruction

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.

    Need help?

    Our team is relentlessly focused on your success. We're ready to jump on a call to help unblock you.

    • Connection issues with your data warehouse?
    • Confusing API responses from destination systems?
    • Unsupported destination objects or modes?
    • Help with complex SQL queries?

    Feature Requests?

    If you see something that's missing from our app, let us know and we'll work with you to build it!

    We want to hear your suggestions for new sources, destinations, and other features that would help you activate your data.

On this page

OverviewGetting StartedConnect to TwitterSync ConfigurationSyncing Custom AudiencesSyncing Conversion EventsTemplate MappingsTroubleshootingCommon errorsUse the Hightouch debuggerSet up sync alerts

Was this page helpful?