TikTok Events API

This guide describes how to add and configure TikTok Events API integration.

The TikTok Events API is a Server-to-Server (S2S) integration that allows you to share website and app visitor events directly with TikTok. Integration is designed to use for Web-to-App (Web2App) campaigns.

Using TikTok Events API for Web-to-App campaigns

TikTok Events API is useful when running Web-to-App (or Web2App) campaigns in TikTok with event optimization.

Web-to-App campaign is a web campaign targeted to your app’s landing page which has a link to the App Store.

Getting Started

Integration is a part of Web-to-App solution. Please follow this link for details.

Requirements

  1. TikTok Pixel.
  2. Access Token for TikTok Pixel.
  3. Landing page with installed TikTok and Apphud scripts.

How to add integration?

Step 1

In TikTok Ads Manager create a Pixel as per documentation in a developer mode:

2426

Step 2

In Pixel settings generate an Access Token:

2426

Step 3

Go to Apphud integrations page and select TikTok Events API:

2430

Step 4

Enter Pixel ID and Access Token:

2430

Step 5

Edit your events configuration by disabling unnecessary ones or changing event names:

2518

Step 6

Click on Enable integration and Save:

2430

Step 7

When creating a campaign in TikTok Ads Manager, you must add URL query parameters that are displayed in TikTok integration page in Apphud:

2430

Track Attribution Data

Adding URL Query parameters to your advertising URL is mandatory. See the last step in How to Add Integration? for details.

campaign_name=__CAMPAIGN_NAME__&adset_name=__AID_NAME__&ad_name=__CID_NAME__&ttclid=__CLICKID__

In case you're using our landing page the final ad URL should look like this:

https://yourapp.siiites.com/?campaign_name=__CAMPAIGN_NAME__&adset_name=__AID_NAME__&ad_name=__CID_NAME__&ttclid=__CLICKID__

In case you're using your own landing the final ad URL should look like this:

https://yourownwebsite.com/?campaign_name=__CAMPAIGN_NAME__&adset_name=__AID_NAME__&ad_name=__CID_NAME__&ttclid=__CLICKID__

For more information visit this (the very bottom) and this links.

Add Query Parameters to your ad URL

Analyze TikTok campaigns in Apphud

Since integration is a part of Web-to-App solution, analytics is described in this guide.