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

# TikTok Ads Postbacks

> Connect TikTok Ads via OAuth to automatically forward attributed conversions to TikTok Events API

> [!NOTE]
>
> **Who is this for?** Marketers running paid acquisition on TikTok Ads who want to feed conversion data back to the platform to improve campaign optimisation.

TikTok Ads postbacks connect your game to the TikTok Events API. When a player who came from one of your TikTok ads completes a [Conversion Goal](https://docs.immutable.com/docs/products/attribution/conversion-goals.md), Immutable sends the conversion to TikTok, server to server. TikTok uses it to find more players like them and to improve ROAS reporting.

In this guide, you'll turn on conversions, choose what TikTok receives, put your ad link in your TikTok ads, and check that a test event arrives.

## What You Need

* A game linked to your project in [Audience Hub](https://hub.immutable.com), and admin access to it
* A TikTok Ads account with at least one pixel in TikTok Events Manager
* Players reaching your Game Page (see [Funnel Page](https://docs.immutable.com/docs/products/attribution/funnel-page.md)) through your TikTok ad link. On your own website, install the [Web SDK](https://docs.immutable.com/docs/products/audience/analytics/web-sdk.md) so TikTok click IDs (`ttclid`) are captured.
* For goals other than Game Page sign-ups, events from the [Unity SDK](https://docs.immutable.com/docs/products/audience/analytics/unity-sdk.md), [Web SDK](https://docs.immutable.com/docs/products/audience/analytics/web-sdk.md), or [REST API](https://docs.immutable.com/docs/products/audience/analytics/rest-api.md)

## The TikTok Ads Page

In Audience Hub, open **Connections** at the bottom of the sidebar, then **TikTok Ads**. The page has:

| Section | What it does |
| - | - |
| **Data sync** | Brings TikTok spend and results into Audience Hub. It's a separate connection from conversions. |
| **Setup** | Where your setup stands and what to do next |
| **Set up TikTok** | A guide with two tabs, **In Audience** and **In Ads Manager**, that follows the steps below |
| **Conversions sent to TikTok** | Your TikTok connection, and the goals TikTok receives |
| **Ad links** | The links to put in your TikTok ads |
| **Delivery logs** | Every attempt to send a conversion to TikTok |

## Set Up in Audience Hub

**1. Connect data sync**

Under **Data sync**, click **Connect** and follow the steps. Spend and results then come into Audience Hub through Fivetran.

**2. Turn on conversions**

Under **Conversions sent to TikTok**, click **Connect** and sign in to your TikTok Business account in the new tab. Back in Audience Hub, choose your **Advertiser account** and **Pixel**, then click **Connect**.

Once connected, Audience Hub switches on the **Email Captured** goal (Game Page sign-ups) for TikTok, and creates the goal if your game doesn't have it yet. It also adds the pixel to your Game Page. If the Game Page isn't published yet or has unpublished changes, the pixel is saved to its draft and you're asked to publish it.

**3. Choose what TikTok receives**

The table under **Conversions sent to TikTok** lists your active goals. Switch **On** each goal TikTok should receive. The **Sent to TikTok as** column shows the event name TikTok gets (see [Event Mapping](#event-mapping)). To change what counts as a conversion, go to **Settings › Goals**.

**4. Copy your ad links**

Under **Ad links**, copy the link for each destination. One link covers every TikTok ad that sends players there.

> [!NOTE]
>
> You can have one TikTok Ads postback connection per game. If you manage several TikTok ad accounts or pixels, choose the ones tied to the campaigns you run for this game. To switch them later, open the menu (⋮) on the connection and click **Reconnect**.

## Set Up in TikTok Ads Manager

**1. Paste the ad link as the destination URL**

At the ad level, paste the ad link as the ad's destination URL, exactly as it is.

**2. Keep the placeholders**

The link carries TikTok placeholders between double underscores, such as `__CAMPAIGN_NAME__` and `__CID__`. TikTok fills in the campaign, ad group and ad on every click, so leave them as they are.

**3. Optimise the ad group for the event TikTok receives**

In the ad group, choose the pixel you connected, and the event your goal is sent as. For Email Captured, that's `CompleteRegistration`.

## Check That It Arrives

1. In TikTok Events Manager, open your pixel's **Test events** tab and copy the test event code.
2. In Audience Hub, click **Send test event** under **Conversions sent to TikTok**. The first time, you're asked for the **Test event code**: paste it and click **Save**, and the test event is sent straight away.
3. The result shows under the button. **TikTok accepted the test event** means it's listed in **Events Manager › Test events** as a Complete registration event received from the server.

The test event code only applies to test events: real conversions always go to live reporting. Events your game sends with `test: true` also go to Test events while a code is set. To change or remove the code, open the menu (⋮) on the connection and click **Set test event code**.

## Track Your Setup

The **Setup** card shows a four-step strip (**Sync ad data**, **Send conversions**, **First click from an ad**, **First conversion accepted**) and a status that says whose turn it is.

| Status | What it means | What to do |
| - | - | - |
| **Your turn · Turn on conversions** | TikTok isn't connected for conversions | Connect under **Conversions sent to TikTok** |
| **Your turn · Choose conversions** | Conversions are on, but no active goal sends to TikTok | Switch a goal on in the table |
| **Your turn · Send ads to your Game Page** | Every ad click so far went to a store page, where no Game Page sign-up can follow | Use your Game Page ad link in your ads |
| **Your turn · Reconnect conversions** | The connection was disconnected or paused | Click **Reconnect** in the menu (⋮) on the connection |
| **Waiting on first conversion** | Everything is set up, and TikTok hasn't accepted a conversion yet | The first one arrives when a player from your TikTok ads completes a goal TikTok receives. Send a test event to check the connection meanwhile. |
| **Sending** | TikTok is accepting conversions | Nothing. The card shows how many TikTok accepted in the last 7 days. |
| **Not accepting** | TikTok rejected recent conversions | Check **Delivery logs** for the reason. If TikTok refused the sign-in, reconnect. |

## Event Mapping

Immutable maps Conversion Goal events to TikTok standard events as follows:

| Goal event | TikTok event |
| - | - |
| `sign_up` (Email Captured) | `CompleteRegistration` |
| `email_acquired` | `CompleteRegistration` |
| `purchase` | `Purchase` |
| `wishlist_add` | `AddToWishlist` |

Any other goal event, such as `wishlist_remove`, is forwarded as a custom event with its own name. You can create a custom conversion in TikTok Events Manager to track it.

For `purchase` conversions, Immutable forwards `value` and `currency` when both are present so TikTok can optimise for revenue (ROAS) rather than conversion count alone.

If your Game Page has the TikTok pixel, a sign-up there also fires the pixel with the same event ID, so TikTok counts each sign-up once.

## Verify Delivery

The table under **Conversions sent to TikTok** shows when TikTok last accepted each goal, and how many it accepted in the last 7 days. **Delivery logs**, at the bottom of the page, lists every attempt with its result. You can also check your pixel's activity in TikTok Events Manager.

For a description of log columns and status values, see [Monitoring Postback Delivery](https://docs.immutable.com/docs/products/attribution/postbacks/overview.md#monitoring-postback-delivery).

## Reconnecting

TikTok's sign-in renews on its own, so there's nothing to do on a schedule. If the connection is disconnected, or TikTok stops accepting the sign-in (for example because access was revoked), open the menu (⋮) on the connection under **Conversions sent to TikTok** and click **Reconnect**. Your goals and delivery history are kept.

***

## Next Steps

> [card] [Conversion Goals](https://docs.immutable.com/docs/products/attribution/conversion-goals.md)
>
> Define which player actions count as a conversion and control what triggers postbacks

> [card] [Conversion Postbacks](https://docs.immutable.com/docs/products/attribution/postbacks/overview.md)
>
> Overview of all supported networks and event mapping

> [card] [Attribution](https://docs.immutable.com/docs/products/attribution/overview.md)
>
> How tracking data powers player attribution and Hub reports


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.