---
title: Integrate TikTok Audience Sync
slug: data-platform/docs/integrate-tiktok-audience-sync
docTags: 
createdAt: 2026-08-10T12:05:18.000Z
---

:::hint{type="info"}
**Note**

The terms *audiences* and *segments* are interchangeable. Optimizely has updated all *segments* to *audiences* on the **Audiences** page and is updating the UI on other pages. See  [Understand audiences](docId\:v-gHiL9jfINBey-4QNtFM) to get information on audiences.
:::

Sync customer email addresses or phone numbers from Optimizely Data Platform (ODP) to TikTok for more relevant ad targeting in TikTok.

## Prerequisites

- TikTok account
- ODP account

## Update API app consent setting

You only need to complete the instructions in this section if your app consent setting for the API channel is set to **Opted Out**. This setting must be set to **Opted In** for this app to successfully send data.

1. Go to **Settings > App Consent Settings** in ODP.
2. Set the **Api** app's **Default Consent** to **Opted In**.

::Image[]{src="https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ReEqOwz9ep8rHhK3HVmLw_odp-app-consent-setting.png" size="90" width="1054" height="909" isUploading="false" darkWidth="1054" darkHeight="909" showCaption="false"}

3. Click **Update Consent** in the confirmation prompt.

## Configure the integration

1. Go to **Data Setup >** **App Directory** in ODP.
2. Select the **TikTok Audience Sync** app.
3. Click **Install App**.
4. Go to the **Settings** tab.
5. Click **Authorize**. ODP redirects you to the TikTok for Business login page. Follow the prompts to authorize your TikTok business account, which should redirect you back to ODP when complete.
6. Enter your TikTok **Ad Account ID** and click **Verify**.

## Sync data from ODP to TikTok

1. Go to **Activations > Overview > Create New Campaign** and click one of the following:
   - **One-Time** – Syncs your audiences and data once.
   - **Behavioral** – Sets up an automated, recurring sync.
2. Click **Create From Scratch**. If you do not have recipes, you are automatically directed to the campaign editor.
3. Enter a name for your activation representing the data you are syncing to TikTok.

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/PD73LsNbejy0Px8Vd_mwP-20260720-145703.png)
4. Select your desired audience and click **Apply**, or click **Create New Segment**, select your desired audience conditions, and click **Save**. This is where you control which customers you want to send to TikTok.

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/curBOsm_xkNaZEdXXpdIp-20260720-145703.png)
5. Expand **Enrollment Rules** and adjust as desired.
6. Expand **Touchpoints**.
7. Click to edit **Touchpoint 1** and select **TikTok Audience Sync**.
8. Expand **Targeting** and select your desired target identifier. ODP sends this identifier (hashed) to TikTok to match customer profiles.

   ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ufjqFg3NvwancL6pm6Add-20260720-145703.png)
9. Complete the following settings in the **Configure** section:
   - **Segment Name** – Enter a name for the audience. When you start syncing data, TikTok creates an audience using the name you specified here.

     :::hint{type="warning"}
     **Important**

     The audience name you enter is used to create an audience in TikTok or update an existing one. If you want to map multiple ODP syncs to the same TikTok audience, you must use the same audience name.
     :::
   - **Retention** – Enter the number of days you want the TikTok audience to retain the audience from ODP. The minimum is 1, and the maximum is 365.
     The expiration date is the specified number of retention days from the date the audience was created. Any operations to the audience cannot reset the expiration date.
     If you do not enter a value for this field, the expiration date is 365 days from the last time the audience was applied to an active ad group or modified. Applying the audience to an active ad group or modifying the audience resets the expiration date. To learn about the actions that reset the expiration date, see TikTok's [Audience Expiration Policy](https://ads.tiktok.com/help/article/audience-expiration-policy) article.
   - **Segment Action** – Select one of the following options.
     - **Replace** – Replaces all audience members with audience members in the last sync.
     - **Append** – Adds any audience members that were not included in the original sync that created the audience.
     - **Remove** – Removes the audience members in the audience from the TikTok audience.

       ![](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/aFDTAdTuF6s-Xota-VpVT-20260720-145703.png)
10. Click **Save** and then click your activation name in the breadcrumb trail.
11. Click **Select start time and schedule** in the **Touchpoints** section.
12. For a recurring sync (behavioral campaign), complete the following settings, then click **Apply**:
    - **Recurring or Continuous** – Select **Recurring**.
    - **Start Date** – Enter the date you want to send the data to TikTok.
    - **End** – Defaults to **Never**. You can set a date to end the TikTok data sync.
    - **Repeats** – Set to **Daily**.
    - **Repeat Every** – Set to **1 day**.
    - **Timing** – Enter the time you want to send the data to TikTok.
    - **Time Zone** – Select the time zone in which you want to send this data.
13. For a one-time sync (one-time campaign), complete the following settings, then click **Apply**:
    - **Send Date** – Enter the date you want to send the data to TikTok.
    - **Send Time** – Enter the time you want to send the data to TikTok.
    - **Time Zone** – Select the time zone in which you want to send this data.
14. Click **Save** and then click **Go Live**. Your sync starts at your designated start date and time.

:::hint{type="info"}
**Note**

The first sync can take up to 48 hours for TikTok to run its matching process.
:::

## Troubleshoot the data sync

To ensure data is syncing as expected from ODP to TikTok:

1. Go to **Settings > Event Inspector** in ODP.
2. Click **Start Inspector**.
3. When data is available in the inspector, a number displays next to **Refresh**. Click to view the data.
4. The raw data that ODP sends to TikTok displays. Click **View Details** to see the formatted version of that raw data.

You can also check the details of each data sync in the [ODP activity log](docId\:iFvVHEUE8tk4PlyXWw4Ro):

1. Go to **Settings > Activity Log**.
2. Filter the categories by **tiktok\_audience\_sync**.
3. Click **View Details** for a formatted view of the log details, including the number of matches.
