Skip to contentSkip to navigationSkip to topbar
On this page
Looking for more inspiration?Visit the
(information)
You're in the right place! Segment documentation is now part of Twilio Docs. The content you are used to is still here—just in a new home with a refreshed look.

TikTok Audiences Destination


Destination Info
  • Accepts Track calls.
  • Refer to it as TikTok Audiences in the Integrations object

The TikTok Audiences destination enables advertisers to send Twilio Engage audiences to TikTok as custom audiences using TikTok's Audience API(link takes you to an external page).

By using Segment's TikTok Audiences destination, you can increase traffic and drive conversions with hyper-relevant ads that promote product discovery.


Getting started

getting-started page anchor

Legacy and native destination instances

legacy-and-native-destination-instances page anchor

If you created a TikTok Audiences destination instance before September 25th, 2023, your instance(s) and all subsequent instances are considered legacy instances. To create a new legacy instance, see the Create a TikTok audience (Legacy) documentation.

Users who created their first instance after September 25, 2023 are considered to have native instances. To create a new native instance, see the Configure the TikTok Audiences destination documentation.

Both legacy and native instances have the same set of features, but are configured differently. Legacy instances require you to create an audience or action manually, but native instances automatically create audiences and actions.

For more information about how to update from legacy to native instances, reach out to friends@segment.com.

Before connecting to the TikTok Audiences destination, you must have a TikTok Ads Manager(link takes you to an external page) account, with either Admin or Operator permissions to create and manage campaigns in TikTok.

For more details on account and access level permissions, refer to TikTok's documentation(link takes you to an external page).

Additional requirements

additional-requirements page anchor
  • If you update the events names from the default Audience Entered or Audience Exited, ensure that you also update them in the "Add to Audience" and "Remove from Audience" mappings.
  • The Email ID or Advertising ID of the user must be provided.
  • TikTok requires(link takes you to an external page) phone number to be formatted in E.164 form, for example +1231234567. If your phone number is missing country code, you can prepend +1 in the Action Mapping.

TikTok Audience Segments

tiktok-audience-segments page anchor

Send Engage audiences to an existing TikTok audience segment or create a new audience. Make note of the audience_id as this is required to send Engage audiences to TikTok.

Configure the TikTok Audiences destination

configure-the-tiktok-audiences-destination page anchor
  1. From the Segment web app, navigate to Engage > Audiences. Choose an existing Engage audience or create a new one. Ensure you are in the Engage space you plan to use with the TikTok Audiences destination.
  2. Navigate to Engage > Engage Settings and click Destinations.
  3. Search for "TikTok Audiences" and select the destination. Click Configure TikTok Audiences.
  4. On the Select Source screen, your Engage space should already be selected as the source. Click Confirm Source.
  5. On the Settings tab for the TikTok Audiences destination, name your destination and authenticate with TikTok Audiences using OAuth.
  6. Once authenticated, toggle "Enable Destination" on and click Save Changes.
  7. Navigate to the Mappings tab, click New Mapping, and select Add to Audience.
  8. Navigate to the Mappings tab, click New Mapping, and select Remove from Audience.
  9. Navigate back to Engage > Audiences and click on the audience from step 1.
  10. Click Add Destinations and select the TikTok Audiences destination you just created. In the settings that appear in the side panel, toggle the Send Track option on and Send Identify option off. Provide the Advertiser ID(link takes you to an external page) linked to the TikTok account that will receive the audience data. Click Save Settings.

The setup is complete and the audience will start syncing to TikTok. The audience will appear in your TikTok Ads Manager(link takes you to an external page) account under Assets > Audiences. It can take 24-48 hours for users to appear in TikTok.

Connect the TikTok Audiences (Legacy) destination

connect-the-tiktok-audiences-legacy-destination page anchor
(information)

Info

Add User and Remove User are considered legacy actions.

  1. From the Segment web app, navigate to Engage > Audiences. Ensure you are in the Engage space you plan to use with the TikTok Audiences destination. Either choose an existing Engage audience or create a new one. This is the audience you plan to send to TikTok.
  2. Navigate to Engage > Engage Settings and click Destinations. Ensure you are still in the correct Engage space.
  3. Search for "TikTok Audiences" and select the destination. Click Configure TikTok Audiences.
  4. On the Select Source screen, your Engage space should already be selected as the source. Click Confirm Source.
  5. On the Destination Settings tab, name your destination and authenticate with TikTok Audiences using OAuth.
  6. Once authenticated, toggle "Enable Destination" on and click Save Changes.
  7. Follow the steps in the Create a TikTok Audience section to create an audience. Once complete, make sure to note the audience_id obtained during this process, then proceed to Step 8.
  8. Navigate to the Mappings tab, click New Mapping, and select Add Users.
  9. Under Select mappings, select the TikTok "Advertiser ID" of the audience segment you want to add users to. Input the audience_id of that audience segment under "Audience ID." A separate mapping must be created for each audience segment you plan to send Engage audiences to. Once you've created the audience using the name of Segment's audience key, you can get the Audience ID from TikTok's Assets>Audiences page. You'll also find the Advertised ID, noted by aadvid, over the TikTok URL.
  10. Repeat steps 7 and 8 to also set up a Remove Users mapping.
  11. Navigate back to Engage > Audiences and click on the audience from Step 1.
  12. Click Add Destinations and select the TikTok Audiences destination you just created. In the settings that appear in the side panel, toggle the Send Track option on and do not change the Audience Entered/Audience Exited event names. Click Save Settings.

The setup is complete and the audience will start syncing to TikTok. The audience will appear in your TikTok Ads Manager(link takes you to an external page) account under Assets > Audiences. It can take 24-48 hours for users to appear in TikTok.

To sync additional audiences from your Engage space, create a separate mapping in the TikTok Audiences destination. Navigate to Connections > Destinations, search and select the TikTok Audiences destination, and follow steps 7-11 above.

Create a TikTok Audience (Legacy)

create-a-tiktok-audience-legacy page anchor

To create an audience in Segment:

  1. Navigate to New Mapping and select Create Audience.
  2. On the Add test event panel, click Load Sample Event.
  3. Fill in the mappings on the Select mappings panel accordingly.
  4. On the Send test event panel, click Test Mapping.
  5. You've created your audience. Copy the audience_id from the response as you will need it to create additional mappings.

You can use the same mapping to create as many audiences as you'd like. To create another audience, change the audience name and click Test Mapping.

You can create a duplicate audience since TikTok doesn't restrict users from having multiple audiences with the same name. If you click Test Mapping multiple times, you will create audiences with the same name. However, each audience will have its own unique audience_id.

You do not need to update the status of the mapping to enabled.

For instructions on how to create a TikTok audience segment, see TikTok's documentation on how to Create/Delete an audience segment(link takes you to an external page).


Build your own Mappings. Combine supported triggers with the following TikTok Audiences-supported actions:

(information)

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Add contacts from an Engage Audience to a TikTok Audience Segment.

Add Users (Legacy) is a Cloud action. The default Trigger is event = "Audience Entered"

Property nameTypeRequiredDescription
Advertiser IDSTRING
required

The advertiser ID to use when syncing audiences.


Audience IDSTRING
required

Audience ID for the TikTok Audience you want to sync your Engage audience to. This is returned after you create an audience and can also be found in the TikTok Audiences dashboard.


User EmailSTRING

Optional

The user's email address to send to TikTok. If not hashed, Segment will hash this value.


User Phone NumberSTRING

Optional

The user's phone number to send to TikTok. If not hashed, Segment will hash this value.


User Advertising IDSTRING

Optional

The user's mobile advertising ID to send to TikTok. This could be a GAID, IDFA, or AAID. If not hashed, Segment will hash this value.


Send Email?BOOLEAN

Optional

Send email to TikTok. Segment will hash this value before sending


Send Phone Number?BOOLEAN

Optional

Send phone number to TikTok. Segment will hash this value before sending


Send Mobile Advertising ID?BOOLEAN

Optional

Send mobile advertising ID (IDFA, AAID or GAID) to TikTok. Segment will hash this value before sending.

Remove Users (Legacy)

remove-users-legacy page anchor

Remove contacts from an Engage Audience to a TikTok Audience Segment.

Remove Users (Legacy) is a Cloud action. The default Trigger is event = "Audience Exited"

Property nameTypeRequiredDescription
Advertiser IDSTRING
required

The advertiser ID to use when syncing audiences.


Audience IDSTRING
required

Audience ID for the TikTok Audience you want to sync your Engage audience to. This is returned after you create an audience and can also be found in the TikTok Audiences dashboard.


User EmailSTRING

Optional

The user's email address to send to TikTok. If not hashed, Segment will hash this value.


User Phone NumberSTRING

Optional

The user's phone number to send to TikTok. If not hashed, Segment will hash this value.


User Advertising IDSTRING

Optional

The user's mobile advertising ID to send to TikTok. This could be a GAID, IDFA, or AAID. If not hashed, Segment will hash this value.


Send Email?BOOLEAN

Optional

Send email to TikTok. Segment will hash this value before sending


Send Phone Number?BOOLEAN

Optional

Send phone number to TikTok. Segment will hash this value before sending


Send Mobile Advertising ID?BOOLEAN

Optional

Send mobile advertising ID (IDFA, AAID or GAID) to TikTok. Segment will hash this value before sending.

Create Audience (Legacy)

create-audience-legacy page anchor

Use this action to create a new audience in TikTok Audience Segment. This is required for legacy instances of the TikTok Audience destination to create a partner audience within TikTok for syncing Engage audiences to.

Create Audience (Legacy) is a Cloud action. The default Trigger is event = "Create Audience"

Property nameTypeRequiredDescription
Advertiser IDSTRING
required

The advertiser ID to use when syncing audiences.


Custom Audience NameSTRING
required

Custom audience name of audience to be created. Please note that names over 70 characters will be truncated to 67 characters with "..." appended.

Add records from an Engage Audience to a TikTok Audience Segment.

Add to Audience is a Cloud action. The default Trigger is event = "Audience Entered"

Property nameTypeRequiredDescription
User EmailSTRING

Optional

The user's email address to send to TikTok. If not hashed, Segment will hash this value.


User Phone NumberSTRING

Optional

The user's phone number to send to TikTok. If not hashed, Segment will hash this value.


User Advertising IDSTRING

Optional

The user's mobile advertising ID to send to TikTok. This could be a GAID, IDFA, or AAID. If not hashed, Segment will hash this value.


Send Email?BOOLEAN

Optional

Send email to TikTok. Segment will hash this value before sending


Send Phone Number?BOOLEAN

Optional

Send phone number to TikTok. Segment will hash this value before sending


Send Mobile Advertising ID?BOOLEAN

Optional

Send mobile advertising ID (IDFA, AAID or GAID) to TikTok. Segment will hash this value before sending.

Remove contacts from an Engage Audience to a TikTok Audience Segment.

Remove from Audience is a Cloud action. The default Trigger is event = "Audience Exited"

Property nameTypeRequiredDescription
User EmailSTRING

Optional

The user's email address to send to TikTok. If not hashed, Segment will hash this value.


User Phone NumberSTRING

Optional

The user's phone number to send to TikTok. If not hashed, Segment will hash this value.


User Advertising IDSTRING

Optional

The user's mobile advertising ID to send to TikTok. This could be a GAID, IDFA, or AAID. If not hashed, Segment will hash this value.


Send Email?BOOLEAN

Optional

Send email to TikTok. Segment will hash this value before sending


Send Phone Number?BOOLEAN

Optional

Send phone number to TikTok. Segment will hash this value before sending


Send Mobile Advertising ID?BOOLEAN

Optional

Send mobile advertising ID (IDFA, AAID or GAID) to TikTok. Segment will hash this value before sending.


Why is my audience considered too small in TikTok?

why-is-my-audience-considered-too-small-in-tiktok page anchor

TikTok(link takes you to an external page) requires a minimum audience size of 1,000 to target Custom Audiences in an ad group.