TikTok Ads

The TikTok integration reads spend and engagement from your TikTok ad accounts into the SignalSeal dashboard, and writes events to TikTok's Events API so app campaigns optimize against installs, trials and purchases.

You'll need admin access to the TikTok Business Center that owns the advertiser, plus the ability to create Events API access tokens.

What's exchanged

SignalSeal pulls spend, impressions, clicks and (where TikTok supports it) reach per advertiser.

For the write side, you map your SignalSeal source events to TikTok event names in Event mapping:

Source events - the SDK events (INSTALL, LOGIN, SIGN_UP, REGISTER, START_TRIAL, SUBSCRIBE, ADD_TO_CART, …), plus the rc_* / sw_* events if you've connected RevenueCat or SuperWall.
TikTok side - the Events API standard codes: app_install, CompleteRegistration, StartTrial, Subscribe, Purchase, AddToCart, InitiateCheckout, AddPaymentInfo, ViewContent, Search, and more. Anything off-list is sent as a custom event.

Connect TikTok

Start the connection

In SignalSeal: app → Ad Networks → Add ad network → TikTok → Connect with TikTok. Sign in with an account that has admin access to the advertiser.

Pick the advertiser

After the redirect, pick the advertiser this app spends from. The wizard then asks you to choose an Events pixel and paste its access token - set those up next.

Create a TikTok Events pixel

SignalSeal lists the pixels under your advertiser automatically - you just pick one and paste its access token. Use a fresh pixel so SignalSeal's events aren't mixed in with other traffic.

If you don't have an Events API pixel yet, create one: TikTok Business Center → Assets → Add a pixel → New pixel, enter your website URL, then Manual setup → Events API only, and name it. Open it in Events Manager → Settings → Events API and generate an access token (TikTok shows it once). Make sure the pixel is linked to the advertiser you connected.

Back in the SignalSeal wizard, pick the pixel from the dropdown, paste the access token, and click Validate.

Optionally, also paste a test event code (from the pixel's Test Events tab in Events Manager). While it's set, SignalSeal tags every event with it so you can confirm them in TikTok's Test Events tab before going live. Clear the field when you're done.

Once an event has been set up and tested, TikTok can take up to 6 hours before it's marked ready to use as a campaign optimization event.

Map your events

Last wizard step: for each source event you want forwarded, pick the TikTok event name. A common setup:

SignalSeal source event	TikTok event
`INSTALL`	`app_install`
`SIGN_UP` / `REGISTER`	`CompleteRegistration`
`START_TRIAL`, `rc_trial_started`, `sw_trial_started`	`StartTrial`
`SUBSCRIBE`, `rc_subscription_started`, `sw_subscription_started`	`Subscribe`
`rc_trial_converted`, `rc_renewal`, `sw_trial_converted`	`Subscribe`

Run your TikTok campaign

Like Meta, SignalSeal reports to TikTok on the web surface, so you run a website-conversion campaign whose ad link is a SignalSeal link that redirects to the store.

Objective and destination

Objective: Sales to optimize on Purchase / Subscribe, or Lead generation to optimize on StartTrial / CompleteRegistration - TikTok only allows those events on the Lead generation objective. Set the destination to Website, not App. Campaign type: Manual.

Optimization (ad set level)

Pick the pixel you connected in SignalSeal and the in-app event to optimize for, with Conversion (or Value) as the optimization goal. Placements: TikTok only - turn off automatic placement. Target a single operating system (iOS or Android), since the ad link routes to one store.

Ad link (ad level)

Copy the SignalSeal ad link from Ad Networks → TikTok in SignalSeal and paste it into the Website URL box. Don't put any parameters in the Tracking section.

TikTok optimizes only on standard events - custom events can't be optimization goals. Forwarded events take 30-90 minutes to show in the dataset.

Test it

Trigger a mapped event on a real device - it shows in Live Feed within seconds. Check Audit → Postback log filtered by TikTok: a SUCCESS row means TikTok accepted it. In Events Manager, the pixel's Activity tab shows events within a few minutes.

Troubleshooting

Token rejected at validation - the access token only works for the pixel it was generated from. Generate it from the pixel you picked in SignalSeal.
Connection went red - TikTok tokens expire and SignalSeal refreshes them, but if SignalSeal's app was revoked from your Business Center you'll need to reconnect from Settings → Ad Accounts.
Attribution window - TikTok credits events to clicks within 28 days. Later events are still forwarded but won't be credited to a campaign.

Error	Meaning	Fix
`40100 Authentication failed`	The Events API token is wrong or revoked.	Generate a new one in Events Manager and paste it in.
`40002 Permission denied`	The OAuth connection lost access to this advertiser.	Reconnect TikTok from Settings → Ad Accounts.
`40005 Event source mismatch`	The picked pixel doesn't belong to the connected advertiser.	Pick a pixel that sits under the advertiser you connected.

On this page