Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

TikTok Ads app events

Send app conversions to TikTok through the Events API.

Status: outline. This page is largely open. What is certain is what goes wrong when you do nothing, which is described in section 7.

1. What TikTok needs for app events

TikTok separates web events and app events in its Events API. An app event identifies the app rather than a page, and expects device level information and an identifier.

Open: record exactly which fields TikTok requires for a server-side app event, and which of them the GA4 App client can supply.

2. What you set up on the TikTok side

Open: confirm what has to exist in TikTok Ads Manager before app events are accepted, and where the corresponding id is found. Also confirm whether an app that is not registered on the TikTok side causes a rejection or silent discarding.

3. Tag configuration

Field
Value

Tag type

TikTok Events API (Stape)

Trigger

Client Name equals the App client, plus the event name

Event source

app, not web

App information

Open

User data

The identifier agreed with the app developer

4. Identifiers this platform accepts

Open: confirm which of IDFA, GAID, hashed email address and external id TikTok accepts on the app path.

5. How to test

  • The event testing tool in TikTok Events Manager.

  • The container's outgoing requests.

6. Known errors

Open: fill in from practice.

7. Limits and pitfalls

The pitfall here is not an error but a silent one. A web TikTok tag with a Custom Event trigger on the event name also fires for app traffic and then sends the event with source web, an empty page object and nothing but an IP address. TikTok answers with a 200, so nothing looks wrong, while the event is worthless.

Check this whenever a container that already sends TikTok events starts receiving app traffic.

Was this helpful?