Documentation / Product / Integrations / TikTok

TikTok: Export Audiences

Sync Lytics audiences with TikTok to identify and target users to improve the performance of your ad campaigns.

Integration Details

This integration uses the TikTok's Audience API to send the Lytics audience users. Once the job is started, it will:

  1. Create a new TikTok Custom Audience with the name format Lytics {audience_slug} {current_time} if it does not already exist.
  2. Scan the selected Lytics audience getting the selected TikTok user ID and writing it to a file. It will then use TikToks's Upload File endpoint to upload the file. TikTok will return the file path for the uploaded file.
  3. Everytime the file is uploaded in TikTok, the job will modify the TikTok custom audience to append/remove the returned TikTok file path.
  4. The export job will run continuously. As users enter the Lytics audience, their TikTok user UID will be written in the file. The file will be sent to TikTok every hour or when the file reaches 50 MB in size or the batch reaches 500,000 users.
    Similarly, as users exits the Lytics audience, their UID will be written in the file and then will be sent to TikTok to remove them from TikTok segment.


The export job gives you an option to send Users ID to TikTok. You can send Apple IDFA (Identifier for Advertisers), GAID (Google Advertising ID), Email or Phone Number as part of job configuration. Please refer to TikTok's file requirement documentation for more information on what can be sent to TikTok in a file.


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

  1. Select TikTok 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. tiktok-export
  7. Select the Lytics audience to export.
  8. From the TikTok Advertiser input, select the TikTok Advertiser where you would like to create TikTok Custom Audience.
  9. From the User ID Field Type input, select the type of user ID that you would like to send to TikTok. NOTE: For email and phone number, please contact your TikTok account manager as it is still in testing phase as per TikTok's API documentation on file requirements.
  10. From the User ID Field input, select the User ID field in Lytics for the above selected ID type.
  11. From the Hash User ID input, select the hash type if you want to encrypt the user ID. If the ID is already hashed, we send it as it is. For an unhashed ID, we will create its hash if you choose the hash type.
  12. (Optional) Select the Existing Users checkbox to send users who already exist in the selected Lytics audience.
  13. Click Start Export.