TikTok Ads
Set up TikTok conversion postbacks in token mode, and connect your own OAuth app for spend and click reporting.
TikTok Ads supports token mode for server-side conversion postback via the TikTok Events API. OAuth mode, for ad account discovery and spend/click reporting, is also built into the core.
Prerequisites
- A TikTok for Business account with an Events (pixel) created
- An Events API access token for that pixel
- For OAuth mode: your own TikTok app with the Ads Management API enabled (see the note below on why the hosted relay does not work here)
Token mode setup
Token mode sends conversion events to TikTok’s Events API when an order is paid.
Generate an access token
- Open TikTok Ads Manager.
- Go to Tools → Events → Web Events.
- Select your pixel.
- Under Events API, click Generate access token.
- Copy the token.
The Pixel ID (also called Pixel Code in TikTok’s UI) is shown on the pixel overview page.
Add the platform in autonnel
- Go to Ads in the autonnel admin.
- Click Add platform → TikTok.
- Select Token mode.
- Enter a display name, your Pixel ID, and the access token.
- Save.
Testing events
TikTok provides a test event mode to verify delivery before going live.
- In TikTok Events Manager, open your pixel and go to the Test Events tab.
- Copy the test event code.
- In autonnel’s TikTok platform settings, enter the code in the Test event code field and save.
- Complete a test purchase in your funnel.
- The event should appear in TikTok’s Test Events view.
Remove the test event code after confirming delivery.
Event mapping defaults
| Internal event | TikTok event |
|---|---|
PURCHASE | CompletePayment |
PURCHASE → CompletePayment is non-editable. You can add mappings for the remaining internal events. Available TikTok events include:
ViewContent, CompletePayment, AddToCart, InitiateCheckout, PlaceAnOrder, SubmitForm
Common additional mappings:
| Internal event | Suggested TikTok event |
|---|---|
PAGE_VIEW | ViewContent |
CHECKOUT_VIEW | InitiateCheckout |
INITIATE_PAYMENT | PlaceAnOrder |
OAuth mode and ad reporting
Go to Settings → Ads, register your own TikTok app with its App ID and Secret, and click Connect.
The hosted relay (“Use our app”) does not work for TikTok. The relay’s TikTok integration only grants creator-content scopes, not the Ads Marketing API, so a token obtained through it cannot read ad spend or clicks. This is the one platform where you must bring your own app; Facebook and Google Ads can both use the relay.
Once connected with your own app:
- Every ad account your token can reach is discovered and connected as a separate account.
- An hourly job pulls ad-level spend, impressions, clicks, and conversions per account, stored per day in that account’s own reporting timezone.
- The first connection backfills 30 days of history; after that, use Refresh now for an on-demand sync.
- Ads are attributed to a funnel by matching their destination URL’s path to one of your pages. Ads that don’t resolve to exactly one funnel land in the assignment list at Analytics → Ads.
- Reported spend and clicks appear next to your own funnel data at Analytics → Ads and in the Ad Performance panel on each funnel’s Analytics tab.
OAuth mode does not replace token mode for postback, it adds ad reporting on top.
Click-ID routing
The ttclid URL parameter identifies TikTok traffic. If ttclid is present when an order is created, the purchase postback is routed to the TikTok adapter.
Caveats
- TikTok’s default attribution window is 7 days from click. Postbacks sent after the window expires are accepted by the API but will not be attributed to a campaign.
- Client-side TikTok Pixel events (ViewContent, AddToCart) are not sent by autonnel. Inject the TikTok Pixel script via Settings → Scripts if you need those events.
- Ad spend and click reporting requires your own TikTok app; there is no zero-setup relay path for this platform.