Documentation Index

Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt

Use this file to discover all available pages before exploring further.

TikTok Audience setup for Data Activation

Prev Next

The Data Activation connector for TikTok Audiences integrates your customer data with TikTok's advertising platform. Use it to retarget known customers and website visitors with first-party identifiers, such as hashed email addresses, phone numbers, or mobile advertising IDs, that TikTok can match to its users.

This integration allows you to:

  • Automate audience updates: Keep your TikTok Audiences automatically refreshed with up-to-date data, so your targeting stays relevant and impactful.

  • Boost campaign ROI: Optimize ad spend by focusing on the most relevant segments, such as high-value customers, recent purchasers, or users likely to churn.

  • Enhance cross-channel consistency: Align your messaging and offers on TikTok with other channels to deliver cohesive and personalized customer experiences.

Whenever profiles enter or leave a Data Activation audience or journey connected to TikTok, their identifiers are automatically added to or removed from the connected TikTok Custom Audience. Each connector syncs one identifier type, so create a separate connector for each identifier you want to use.

You set up and authorize the connection yourself in Data Activation. You do not need to create a TikTok developer account or developer app, request Streaming API access, or exchange tokens manually as Supermetrics manages all of that for the connector.

Destination connector overview

Attribute

Value

Platform type

Social

PartnerType slot

Hashed email (7001), Hashed phone (7002), Hashed IDFA (7007), Hashed AAID (7008)

Cookie sync

No

Connecting protocol

HTTPS

API Version

v1.3

Syncs data on

Add, Remove

Allowed setting multiple connectors

Yes

ProfileVars Support

No

Connector type

Audiences/Journey Orchestration

Before you begin

Make sure you have the following in place:

  • A TikTok Business account with a TikTok Ads Manager advertiser account.

  • Permission to grant third-party Audience Management access for that advertiser, so you can authorize the connection.

  • The identifier you want to match — hashed email, phone, IDFA, or AAID — collected in Data Activation.

Instructions

Step 1: Configure TikTok destination

  1. On the Data Activation platform, select Connectors in the left-side navigation bar.

  2. Open Data connections, select the Destinations tab, and click New destination.

  3. Select TikTok Ads and click Next.

  4. Click Authenticate with TikTok. A TikTok window opens.

  5. Sign in to TikTok and grant the Audience Management permission for the advertiser you want to use. The window closes automatically when authorization succeeds, and the button changes to Reconnect.

  6. Select the Advertiser account to connect. The list shows the advertisers your authorization can access.

  7. Select the Payload type, which is the identifier this connector sends: Hashed email, Hashed phone, Hashed IDFA, or Hashed AAID. Identifiers are sent to TikTok as SHA-256 hashes.

  8. Save the connector.

Step 2: Add the destination connector to an Audience or Journey

  1. On the Data Activation platform, go to Orchestration.

  2. Select a journey or an audience, and click Edit.

  3. Click the pencil icon in a connector step to edit the connectors.

  4. Click Add connector to add the TikTok Ads connector as a destination, the same way you add any other server-to-server connector.

  5. Select an existing audience, or click + to add a new audience to create a TikTok Custom Audience to sync to.

  6. Save your changes.

Before using this connector, make sure that the profile identifier listed in the Destination connector overview is collected in Data Activation.

Connector limitations and known issues

  • Each connector syncs a single identifier type. To sync more than one identifier, create a separate connector for each.

  • The connector adds and removes audience members only. It does not update profile attributes.

  • ID matching is asynchronous and can take up to 48 hours. An audience needs about 1,000 matched users before it can be targeted in campaigns, and its size stays hidden until it reaches that threshold.

  • A TikTok advertiser account supports up to 400 Custom Audiences.

  • TikTok Custom Audience names can be up to 70 characters.

Error handling

Delivery errors appear in the data exchange view of the audience or journey that uses the connector.

If your authorization expires or is revoked, the connector reports an authorization error and stops syncing. To restore access, open the connector and click Reconnect to authorize again.

For the full list of TikTok API error codes, see the TikTok Marketing API documentation.