TikTok Audiences Connector Setup Guide
This article describes how to set up the TikTok Audiences connector.
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
Connector Actions
| Action Name | AudienceStream | EventStream |
|---|---|---|
| Add Visitor to 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:
- App ID Required. The App ID applied by the developer.
- App Secret Required. The private key of the Developer’s App.
- Advertiser ID Required. The advertiser ID.
Click Done when you are finished configuring the connector.
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 type 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 email address that is a cleartext (must include an @) and has already been SHA256 hashed. |
| Email Address (apply SHA256 hash) | Provide an email address thay is a cleartext (must include an @) and has been already SHA256 hashed. |
| Email Address (already SHA256 hashed) | Provide a plain text email address and the connector will whitespace trim, lowercase, and hash this value using SHA256 hash. |
| Phone Number (apply SHA256 hash) | Provide a plain text phone number and the connector will whitespace trim, lowercase, 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: November 7, 2022