Documentation / Product / Integrations / Twitter

Twitter: Export Audience

Use this export job to send Lytics user to Twitter Custom audience.

Integration Details

This integration utilizes Twitter Ads API to send the Lytics audience users. Once the job is started, it will:

  1. Create a new Twitter Custom Audience with the name format Lytics {audience_slug} {YYYYMMDD_hhmmss} if it does not already exist.
  2. For every user entering the selected Lytics audience, the job adds the user's selected identifiers and adds them to the add queue. Similarly, for every user exiting the selected Lytics audience, the selected user's identifiers will be placed on remove queue.
  3. Both the add and remove queue are sent to Twitter using its Custom Audience Users API.
  4. The export job will run continuously. The add/remove queue of users are sent to Twitter every 5 minutes or when the batch reaches 1,000 users.


The export job gives you an option to select to send Email, Device ID, Twitter Handle and Twitter ID as part of job configuration. Please refer to Twitter documentation to learn more about each type of identifier. Identifiers already SHA-256 hashed are accepted, otherwise plain user-identifier data will be SHA-256 hashed before being exported to Twitter.


Follow these steps to set up and configure an export job for Twitter in the Lytics platform. If you are new to creating jobs in Lytics, see the Jobs Dashboard documentation for more information.

  1. Select Twitter from the list of providers.
  2. Select the Export Audience from the list.
  3. Select the Authorization you would like to use or create a new one.
  4. Enter a Label to identify this job you are creating in Lytics.
  5. (Optional) Enter a Description for further context on your job.
  6. Complete the configuration steps for your job. twitter-export
  7. From the Twitter Ad Account input, select the Twitter Ad Account.
  8. (Optional) From the Twitter Custom Audience input, select an existing Twitter custom audience to export Lytics users to. If no audience is selected, a new custom audience will be created with the name format Lytics {audience_slug} {YYYYMMDD_hhmmss}.
  9. From the Identifier Fields Mapping input, map the value from Lytics field to Twitter Identifier field. At least one of Email, Device ID, Twitter Handle or Twitter ID must be mapped. Identifiers already SHA-256 hashed are accepted, otherwise plain user-identifiers will be SHA-256 hashed.
  10. Click the Start job button to start the job.