> ## 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

<Warning>
  Conversion Postbacks are currently in **alpha**. Behavior and supported networks may change between releases.
</Warning>

<Info>
  **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.
</Info>

TikTok Ads postbacks connect your Immutable game to the TikTok Events API. When a player clicks your TikTok Ads campaign, installs the game, and completes a [Conversion Goal](/docs/products/audience/conversion-goals), Immutable sends a server-to-server postback to TikTok automatically. TikTok's algorithm uses this signal to improve campaign optimisation and ROAS reporting.

## What You Need

* The Immutable [Tracking Pixel](/docs/products/audience/tracking-pixel) or [Web SDK](/docs/products/audience/web-sdk) installed on your marketing site, so `ttclid` values from TikTok Ads clicks are captured
* The [Unity SDK](/docs/products/audience/unity-sdk), [Web SDK](/docs/products/audience/web-sdk), or [REST API](/docs/products/audience/rest-api) sending events from your game
* At least one active [Conversion Goal](/docs/products/audience/conversion-goals) for the game
* A TikTok Ads account with at least one pixel in TikTok Events Manager
* Admin access to the game in [Audience Hub](https://hub.immutable.com)

## Connect TikTok Ads

1. In [Audience Hub](https://hub.immutable.com), navigate to **Settings** then **Integrations** then **TikTok Ads**.
2. In the **Conversion Postbacks** section, click **Connect**.
3. A TikTok authorization popup opens. Sign in to your TikTok Business account and grant the requested permissions.
4. Once authorized, Hub shows an account and pixel picker if your account has multiple options. Select the ad account and pixel you want to send postbacks for.
5. Click **Connect**. Hub creates the postback configuration and the popup closes.

<Note>
  If you manage multiple TikTok ad accounts or pixels, make sure you select the one tied to the campaigns you're running against this game. You can only have one TikTok Ads postback configuration per game.
</Note>

## Event Mapping

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

| Goal event        | TikTok event                        |
| ----------------- | ----------------------------------- |
| `purchase`        | `Purchase`                          |
| `wishlist_add`    | `AddToWishlist`                     |
| `wishlist_remove` | `wishlist_remove` (forwarded as-is) |
| `email_acquired`  | `CompleteRegistration`              |

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

TikTok has no standard event for `wishlist_remove`. It is forwarded as a custom event with the raw name `wishlist_remove`. You can create a custom conversion in TikTok Events Manager to track it.

## Test Events

If you want to route test conversions to TikTok's Test Events environment rather than live reporting, open the postback config and set a **Test event code** from TikTok Events Manager. Test events are only routed this way when the SDK or Pixel sends them with `test: true`. Normal production conversions are never affected by the test code.

## Verify Delivery

Once a real attributed conversion arrives (a player who clicked your TikTok Ads campaign and then matched an active Goal), it appears in the **Delivery logs** section on the TikTok Ads integration page. You can also check **TikTok Events Manager** under your pixel's event activity.

For a description of log columns and status values, see [Monitoring Postback Delivery](/docs/products/audience/conversion-postbacks#monitoring-postback-delivery).

## Reconnecting

If your TikTok authorization expires or is revoked, Hub shows a credential warning on the postback config. Open the config menu and click **Reconnect** to re-authorize without losing your existing configuration.

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Conversion Goals" icon="bullseye-arrow" href="/docs/products/audience/conversion-goals">
    Define which player actions count as a conversion and control what triggers postbacks
  </Card>

  <Card title="Tracking Pixel" icon="crosshairs" href="/docs/products/audience/tracking-pixel">
    Make sure TikTok click IDs (`ttclid`) are being captured on your marketing site
  </Card>

  <Card title="Conversion Postbacks" icon="arrow-right-arrow-left" href="/docs/products/audience/conversion-postbacks">
    Overview of all supported networks and event mapping
  </Card>

  <Card title="Attribution" icon="route" href="/docs/products/audience/attribution">
    How tracking data powers player attribution and Hub reports
  </Card>
</CardGroup>