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.
What You Need
- The Immutable Tracking Pixel or Web SDK installed on your marketing site, so
ttclidvalues from TikTok Ads clicks are captured - The Unity SDK, Web SDK, or REST API sending events from your game
- At least one active Conversion Goal for the game
- A TikTok Ads account with at least one pixel in TikTok Events Manager
- Admin access to the game in Audience Hub
Connect TikTok Ads
- In Audience Hub, navigate to Settings then Integrations then TikTok Ads.
- In the Conversion Postbacks section, click Connect.
- A TikTok authorization popup opens. Sign in to your TikTok Business account and grant the requested permissions.
- 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.
- Click Connect. Hub creates the postback configuration and the popup closes.
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.
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 |
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 withtest: 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.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
Conversion Goals
Define which player actions count as a conversion and control what triggers postbacks
Tracking Pixel
Make sure TikTok click IDs (
ttclid) are being captured on your marketing siteConversion Postbacks
Overview of all supported networks and event mapping
Attribution
How tracking data powers player attribution and Hub reports