TikTok Audiences Connector Setup Guide
This article describes how to set up the TikTok Audiences connector.
This connector has been deprecated. Tealium recommends 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. |
This page was last updated: August 4, 2023