TikTok Audiences Connector Setup Guide

This connector has been deprecated. We recommend that you use the TikTok Audiences (Tealium-Provided Credentials) Connector instead.

API Information

This connector uses the following vendor API:

API Name: TikTok HTTP API
API Version: v1.3
API Endpoint: https://business-api.tiktok.com/open_api/v1.3
Documentation: TikTok Audience segment

Batch Limits

This connector uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:

Max number of requests: 1000
Max time since oldest request: 30 minutes
Max size of requests: 1 MB

Connector Actions

Action Name	AudienceStream	EventStream
Add Visitor to Audience	✓	✗
Remove Visitor from Audience	✓	✗

Configure Settings

Navigate to the Connector Marketplace and add a new connector. For general instructions on how to add a connector, see the About Connectors article.

After adding the connector, configure the following settings:

Advertiser ID

(Required) The advertiser ID. Click Establish Connection to test the connection to TikTok.

To create an audience for this connector, follow these steps:

Click Create Audience.
Under Custom Audience Name, enter the audience name for this connector to use.
From the Encryption Type drop-down list, select the encryption type to use when populating the audience.
Click Create, then click Done.

To remove an audience, follow these steps:

Click Remove Audience.
From the Audience ID drop-down list, select the audience to remove.
Click Remove, then click Done.

When you are finished configuring the connector, click Done.

Action Settings — Parameters and Options

Click Continue to configure the connector actions. Enter in a name for the action and then select the action type from the drop-down menu.

The following section describes how to set up parameters and options for each action.

Action — Add Visitor to Audience

Parameters

Parameter	Description
Audience ID	Select audience or enter audience ID.
IDFA (apply MD5 hash)	Provide a plain text iOS IDFA. The connector will whitespace trim, lowercase, and hash this value using MD5 hash.
IDFA (already MD5 hashed)	Provide an iOS IDFA that has already been MD5 hashed.
AAID (apply MD5 hash)	Provide a plain text Ad identifier for Android devices. The connector will whitespace trim, lowercase, and hash this value using MD5 hash.
AAID (already MD5 hashed)	Provide an Ad identifier for Android devices that has already been MD5 hashed.
IDFA (apply SHA256 hash)	Provide a plain text iOS IDFA. The connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
IDFA (already SHA256 hashed)	Provide an iOS IDFA that has already been SHA256 hashed.
AAID (apply SHA256 hash)	Provide a plain text Ad identifier for Android devices. The connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
AAID (already SHA256 hashed)	Provide an Ad identifier for Android devices which has already been SHA256 hashed.
Email Address (apply SHA256 hash)	Provide a plain text email address (must include an `@`). The connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Email Address (already SHA256 hashed)	Provide an email address that has already been SHA256 hashed.
Phone Number (apply SHA256 hash)	Provide a plain text phone number. The connector will whitespace trim and hash this value using SHA256 hash.
Phone Number (already SHA256 hashed)	Provide a phone number that has already been SHA256 hashed.

Action - Remove Visitor from Audience

Parameters

Parameter	Description
Audience ID	Select audience or enter audience ID.
IDFA (apply MD5 hash)	Provide a plain text iOS IDFA. The connector will whitespace trim, lowercase, and hash this value using MD5 hash.
IDFA (already MD5 hashed)	Provide an iOS IDFA which has already been MD5 hashed.
AAID (apply MD5 hash)	Provide a plain text Ad identifier for Android devices. The connector will whitespace trim, lowercase, and hash this value using MD5 hash.
AAID (already MD5 hashed)	Provide an Ad identifier for Android devices which has already been MD5 hashed.
IDFA (apply SHA256 hash)	Provide a plain text iOS IDFA. The connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
IDFA (already SHA256 hashed)	Provide an iOS IDFA which has already been SHA256 hashed.
AAID (apply SHA256 hash)	Provide a plain text Ad identifier for Android devices. The connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
AAID (already SHA256 hashed)	Provide an Ad identifier for Android devices which has already been SHA256 hashed.
Email Address (apply SHA256 hash)	Provide a plain text email address (must include an `@`). The connector will whitespace trim, lowercase, and hash this value using SHA256 hash.
Email Address (already SHA256 hashed)	Provide an email address that has already been SHA256 hashed.
Phone Number (apply SHA256 hash)	Provide a plain text phone number. The connector will whitespace trim and hash this value using SHA256 hash.
Phone Number (already SHA256 hashed)	Provide a phone number that has already been SHA256 hashed.