Connecting with TikTok

The Data Activation connector for TikTok Audiences enables you to integrate your customer data with TikTok's advertising platform. Using this connector, you can retarget known customers with first-party identifiers such as email addresses, phone numbers, or mobile advertising IDs that TikTok recognizes.

This integration allows you to:

• Automate audience updates: Keep your TikTok Audiences automatically refreshed with up-to-date data, ensuring your targeting remains 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.

With this connector, you can combine several types of identifiers. Whenever profiles enter or leave a Data Activation audience or journey connected to TikTok, their identifiers are automatically sent to or removed from the connected TikTok custom audience.

Most of the configuration effort lies on the TikTok side. The Data Activation team handles the rest of the process.

Destination connector overview

Before you begin

You will need to set up a TikTok Business account before proceeding. We follow the steps documented in the TikTok for Developers documentation. These steps assume you already have a TikTok Business account set up.

Step 1: Create a TikTok for Developer Business account

1. Go to https://business-api.tiktok.com/portal.

2. Click Get Started and register as a developer. We suggest you use your company or team email address, or the same email address with which you have access to the TikTok Business account.

3. For the Business Information step, providing your phone number is not required.

4. For the question What best describes you or your company?, select Direct Advertiser.

5. For the Additional Information section, provide as much information about your company as possible.

6. For the final question about how you plan to use the APIs, fill in the following: "We want to use the TikTok APIs to ensure our CDP can share first-party data audiences with TikTok, so that we can use these audiences in our retargeting campaigns."

TikTok then needs to approve your developer registration request. You can already move forward with the next step while waiting for approval.

Step 2: Create a TikTok Developer App

1. Go to My Apps.

2. Create an App.

3. Enter a name. We suggest including "Supermetrics" in the name, for example: {Company_name}_Supermetrics.

4. Enter a description. Make sure you reference Supermetrics so the App's purpose is clear in the future.

5. Fill in the Advertiser redirect URL with: relay42.com.

6. In Scope of permission, select the Audience Management section.

7. Submit the App request.

Once submitted, the App appears on the My Apps page as pending. If you have an account manager at TikTok, reach out to inform them about your App request. Generally, the App request is approved within 12–24 hours.

Once your App is approved, the TikTok UI will contain an APP ID, a Secret, and the Advertiser Redirect URLs will be filled with https://relay42.com/

Step 3: Request Allowlist Management

1. Open the App and scroll down to Allowlist Management.

2. Click Apply, select the Streaming API, and provide the potential revenue impact. You can use your yearly TikTok marketing budget for this field. Click Submit.

3. TikTok support will review this request. If you can inform your account manager at TikTok to have this request approved manually, the integration will move faster. Include the App ID in your message so your account manager can locate your Allowlist request more easily.

Step 4: Authenticate and authorize

1. Open the Advertiser authorization URL in a new tab. The page will contain a permission request from Supermetrics to access your ad account for “Audience Management”

2. Click Confirm for the permission and complete the security steps.

3. You will be redirected to a URL with parameters at the end. It will look like this: https://relay42.com/callback?auth_code=bb00f02ee121e0467553a5edefddccb54c47013d&code=bb00f02ee121e0467553a5edefddccb54c47013d&state=your_custom_params

4. This URL contains the auth_code, which is only valid for 1 hour.

5. Supermetrics use an API endpoint to translate the auth_code into a permanent access_token. For this API call, we will require the Advertiser ID, App ID, App Secret, and the Auth Code retrieved from the redirect URL.

6. Once the auth_code is translated into a permanent access_token, share it with the Data Activation Solution Consultant to get the TikTok connector configured.

Note

We recommend completing the authentication and authorization steps together with a Data Activation team member on a call. The auth_code in the redirect URL is only valid for 1 hour, which means we can run the API call together in real time.

Instructions

Step 1: Configure TikTok destination

Once you have gathered the input information from the steps above, file a support ticket to support@relay42.com and include the collected information. The Data Activation team will handle the rest of the process and share the expected timeline for delivery.

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

Go to an Orchestration or an Audience in Data Activation. You can use the TikTok connector just like any other server to server connector.

Before using this connector, make sure the profile identifiers listed in the Destination connector overview are collected in Data Activation.

Error handling

Whenever API errors are raised, the Data Activation Consulting or Support team will contact you, especially if invalid credentials are provided initially.