> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zeotap.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok

> TikTok data refers to data collected directly by TikTok from its users. Integrated with Zeotap this data can be used by marketers to better understand and target their audiences, create custom audiences and more personalisation for the targeted audience on the platform.

<Note>
  **Note:**

  *The integration with TikTok uses the TikTok Marketing API to send
  custom audiences to the ad account of clients.*
</Note>

### Pre-requisites

Ensure that the following points are taken care of before you proceed with this integration:

* The client has a TikTok Ad Account.
* A business centre account is set up for the client. The Ad Account must be added to the business centre account. The steps for adding the Ad Account to the business centre account are documented [here](https://ads.tiktok.com/help/article?aid=12786).

### Supported Identifiers

This integration supports `Email addresses`, `Hashed cellphone numbers` and `MAIDs`. Note that TikTok recommends sending hashed cellphone numbers in <Tooltip tip="e164 is an international standard that assigns globally unique numbers to devices in the worldwide Public Switched Telephone Network (PSTN). A cellphone number in e164 format is represented as [+] [country code] [Cellphone number including area code]. For example, a subscriber from the United States with the phone number 6171339687 (country code: 1) is represented in e164 format as +16171339687.">e164 format</Tooltip>.

## Available Actions and Supported Features

The following table lists the available action types for the integration and the supported features for each action type:

| Action Name                | [ID EXTENSION](/articles/segment-customer/extend-your-audience#id-extension) | [DELETE](https://docs.zeotap.com/articles/#!integrate-customer/delta-upload-and-delete-functions) | [DELTA UPLOAD](https://docs.zeotap.com/articles/#!integrate-customer/delta-upload-and-delete-functions) |
| :------------------------- | :--------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------------ |
| Send identifiers to TikTok | ✅                                                                            | ✅                                                                                                 | -                                                                                                       |

## Components of TikTok

Ensure that you have details about the below components of TikTok available before creating a Destination:

### Advertiser ID

This is your `TikTok Ad Account ID`. Ensure you have a valid Ad Account without which you cannot proceed with this integration. You can find the Advertiser ID in the TikTok Ads Manager from any of the two places shown below.

<Frame>
  <img src="https://mintcdn.com/zeotap/IaZjYE7XwRssOe8Q/articles/integrate-customer/Storage/integrate-customer/tiktok/tiktok_ad_id.png?fit=max&auto=format&n=IaZjYE7XwRssOe8Q&q=85&s=b5164feba8bcfd61dff3f9de244c39c0" width="3550" height="1400" data-path="articles/integrate-customer/Storage/integrate-customer/tiktok/tiktok_ad_id.png" />
</Frame>

### Access Token

The access token is an important component of this integration. It can be obtained once you authorise the the Zeotap CDP App to push segments to TikTok on your behalf. The steps to generate the access token are mentioned below:

<Steps>
  <Step>
    Navigate to the URL - [https://business-api.tiktok.com/portal/auth?app\_id=7010666682221854722\&state=your\_custom\_params\&redirect\_uri=https%3A%2F%2Fads.tiktok.com%2Fmarketing\_api%2Fdocs](https://business-api.tiktok.com/portal/auth?app_id=7010666682221854722\&state=your_custom_params\&redirect_uri=https%3A%2F%2Fads.tiktok.com%2Fmarketing_api%2Fdocs) or copy the link below and paste it in your browser. You will be redirected to a login page as shown in the image below.

    ```bash theme={null}
    https://business-api.tiktok.com/portal/auth?app_id=7010666682221854722&state=your_custom_params&redirect_uri=https%3A%2F%2Fads.tiktok.com%2Fmarketing_api%2Fdocs
    ```

    <Frame>
      <img src="https://mintcdn.com/zeotap/IaZjYE7XwRssOe8Q/articles/integrate-customer/Storage/integrate-customer/tiktok/tiktok-2024-09-05.png?fit=max&auto=format&n=IaZjYE7XwRssOe8Q&q=85&s=09426b76af667bbc9e0c9bf69ba3fb3e" width="3504" height="1654" data-path="articles/integrate-customer/Storage/integrate-customer/tiktok/tiktok-2024-09-05.png" />
    </Frame>
  </Step>

  <Step>
    Enter the appropriate credentials and a permissions dialog box appears. Grant the relevant permissions to the the Zeotap CDP App as shown below.

    <Frame>
      <img src="https://mintcdn.com/zeotap/IaZjYE7XwRssOe8Q/articles/integrate-customer/Storage/integrate-customer/tiktok-1p/tiktok_2.png?fit=max&auto=format&n=IaZjYE7XwRssOe8Q&q=85&s=bd4bbe3e7e267f5a5adc9652b96c3446" width="2828" height="1334" data-path="articles/integrate-customer/Storage/integrate-customer/tiktok-1p/tiktok_2.png" />
    </Frame>
  </Step>

  <Step>
    Click **Confirm**. You are redirected to a different page.
  </Step>

  <Step>
    Go to the address bar in your browser and find the `auth_code` in the callback URL as shown in the image below.

    <Frame caption="You will be redirected here after clicking Confirm. Copy the value carefully against the auth_code">
      <img src="https://mintcdn.com/zeotap/IaZjYE7XwRssOe8Q/articles/integrate-customer/Storage/integrate-customer/tiktok-1p/tiktok_3.png?fit=max&auto=format&n=IaZjYE7XwRssOe8Q&q=85&s=e194cdd5ee549b9bb8a74e313764dc5d" width="2858" height="1132" data-path="articles/integrate-customer/Storage/integrate-customer/tiktok-1p/tiktok_3.png" />
    </Frame>
  </Step>

  <Step>
    Immediately provide this `auth_code` along with your Advertiser ID to your respective CSM/TAM. As the `auth_code` expires in 10 minutes only, ensure that you pass on this code immediately and not through an email. Once expired, you have to repeat the entire process again. Your Zeotap POC will generate an access token using this `auth_code` which they will share with you for the destination setup.
  </Step>
</Steps>

## Create a Destination for TikTok

TikTok can have Private Destinations only. To create a private destination for TikTok, log into the Zeotap CDP App and perform the following steps:

<Steps>
  <Step>
    Log into the Zeotap CDP App and go to the **DESTINATIONS** application.
  </Step>

  <Step>
    Click **+ Create Destination.**

    <Frame>
      <img src="https://mintcdn.com/zeotap/sBMx_EDYCwiX_b1v/articles/integrate-customer/Storage/integrate-customer/s4m/Destinations_all_1.png?fit=max&auto=format&n=sBMx_EDYCwiX_b1v&q=85&s=85001cf85ca95a235510bbae0ef36d2f" width="3520" height="772" data-path="articles/integrate-customer/Storage/integrate-customer/s4m/Destinations_all_1.png" />
    </Frame>
  </Step>

  <Step>
    Under **All Destinations**, search for **TikTok.**

    <Frame>
      <img src="https://mintcdn.com/zeotap/sBMx_EDYCwiX_b1v/articles/integrate-customer/Storage/integrate-customer/s4m/Destinations_all_2.png?fit=max&auto=format&n=sBMx_EDYCwiX_b1v&q=85&s=0754c153bcfb10821185d9ecc8920122" width="3510" height="1144" data-path="articles/integrate-customer/Storage/integrate-customer/s4m/Destinations_all_2.png" />
    </Frame>
  </Step>

  <Step>
    Click **TikTok.** A screen appears displaying details about the particular destination towards the left. On the right-hand side of the screen find a list of fields that are required for the integration to be established. Enter the required details as mentioned in the following steps:

    a. Enter a name for the Destination.

    b. Enter the [**Advertiser ID**](#advertiser-id) of your TikTok Ad Account.

    c. Enter the [**Access Token**](#access-token) that is provided by your Zeotap POC.

    d. Click **Next** to Proceed to mapping.
  </Step>

  <Step>
    In the new screen that appears, choose the appropriate Action and mapping as explained below.

    a. Choose the desired [action](/articles/integrate-customer/destinations#actions) under **Choose your Action** and then choose the corresponding identifiers under **Map the Fields**. By default, the [Output Identifiers](https://docs.zeotap.com/articles/segment-customer/choose-the-output-identifiers) that are accepted by the platform such as, MAIDs, Cookies, email Ids and more are displayed. However, you can edit, add or remove an identifier from the list. To do so, refer [here](/articles/integrate-customer/destinations#mappings).

    b. Click **Create Destination**. The created Destination gets listed in the **Target** and **Audiences** applications, which can be linked to an Audience/segment.

    <Frame>
      <img src="https://mintcdn.com/zeotap/IaZjYE7XwRssOe8Q/articles/integrate-customer/Storage/integrate-customer/tiktok/tiktok-2023-11-09.png?fit=max&auto=format&n=IaZjYE7XwRssOe8Q&q=85&s=47d6a4c7fcf29ee033ae74d16d237ce1" width="3572" height="1804" data-path="articles/integrate-customer/Storage/integrate-customer/tiktok/tiktok-2023-11-09.png" />
    </Frame>
  </Step>
</Steps>

## Link an Audience to the TikTok Destination

For information about how to link an Audience or segment to the created Destination in **Audiences** and **Target** applications, refer [here](/articles/integrate-customer/link-an-audience-to-the-destination).

<Note>
  **Note:**

  Ensure that the following points are taken care of, while creating a segment:

  * It can take up to three business days for segments to be available at the TikTok seat.
  * You can apply Zeotap Graph extension to obtain more identifiers from your first-party identifiers such as `email`, `phone`, `cookies` and `device Ids`. This helps brands to get the online identifiers of their users for the corresponding offline identifiers and eventually activate their users on multitude of channels.
</Note>

## View Audiences on TikTok

Once the segment is pushed, it will appear in TikTok Ads Manager under **Tools** → **Audience manager**.

<Note>
  **Note:**

  *Do not expect the entire volume of users to show up on TikTok. Only the matched TikTok users are displayed after the final matching is done. Hence, depending on the segment, this number can be quite low as well.*
</Note>

## User Disqualification from Audiences

This integration supports user disqualification from audiences. That is, a user can be disqualified from an audience (segment) for various reasons, such as not meeting audience criteria, consent requirements or other conditions set for a particular audience.

* When a user disqualifies from an audience, Zeotap CDP initiates a user deletion request in the next refresh cycle. These requests are sent to the audiences linked to the specific destination.
* The disqualified users are excluded from the audiences based on the configured refresh frequency for a particular audience.
* User disqualification is a programmatic process that works automatically. You do not need to specify anything to trigger the disqualification and exclusion of users from audiences.