Overview

TikTok is a social network platform that allows users to share short-form videos. Integrating Lytics with TikTok enables you to leverage Lytics audiences enriched with behavioral scores, affinities, and cross-channel data to more effectively target users via TikTok ad exchange.

Authorization

If you haven't already done so, you will need to set up a TikTok account before you begin the process described below.

In order to export Lytics audiences to TikTok, please make sure the TikTok user being authenticated has access to manage TikTok Custom Audiences. Please refer to TikTok's authorization documentation for more on how TikTok manages access to their API.

If you are new to creating authorizations in Lytics, see the Authorizations documentation for more information.

  1. Select TikTok from the list of providers.
  2. Select the TikTok Sign-In method for authorization.
  3. Enter your TikTok login credentials in the login popup and confirm the authorization.
  4. In the Label text box, enter a name for the authorization.
  5. (Optional) In the Description text box, enter a description for this authorization.
  6. Click Save Authorization.

Export Audiences

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

Integration Details

  • Implementation Type: Server-side Integration
  • Implementation Technique: [REST API Integration, Audience Trigger Integration
  • Frequency: Real-time Integration and Batch Integration (every hour).
  • Resulting data: TikTok Custom Audience matched with users from the selected Lytics audience.

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

📘

TikTok Custom Audience requirements

It might take a few hours for the audience matching to be completed in TikTok. After the initial file upload in a TikTok custom audience, a new file will not be appended until the custom audience is available to do so.

The resulting TikTok custom audience must have a minimum of 1,000 matched and opted-in users in order to be available for use. If this minimum has not been met the custom audience will be marked as Unavailable within TikTok.

We recommend sending at least 5,000 phone numbers or 10,000 emails, as phone numbers tend to have a higher match rate in TikTok. This suggestions is based on TikTok's requirement for 1000 matched trackable users within their platform.

Fields

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. You may send multiple ID types in a single file. Please refer to TikTok's file requirement documentation for more information on what can be sent to TikTok in a file.

Be sure to review TikTok's guidance on ID format for all ID types. These formats must be followed for data flowing into Lytics from your data sources. Lytics performs all hashing of raw data before exporting to TikTok.

Configuration

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

  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. In Field Encryption Mapping, map the Lytics fields its encryption type. You may select more than one field to map. If the user ID is unhashed, we will hash it based on the chosen encryption type. 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. (Optional) Select the Existing Users checkbox to send users who already exist in the selected Lytics audience.

  11. Click Complete.