Tiktok Events API tag setup

As mentioned in our documentation, integration of the TikTok Events API is now a must for advertisers. It is the most effective solution for optimizing the number of conversions attributed to your advertising campaigns. If implementing the TikTok Events API seems complex, don't worry: the tag developed by Addingwell makes the process much simpler! Follow our detailed guide to the optimal configuration of the TikTok Events API...

Import tag

Download tag

Click here (opens in a new tab) to download the Tiktok Events API tag and click on the download icon to retrieve the file.

Download Tiktok Events API Addingwell tag

Import tag into sGTM

Go to the Templates tab of the server container, then, in the Tag templates section, click on New.

Create a new tag for Tiktok CAPI Addingwell

Then click on the three small dots in the top right-hand corner, and select Import.

Save the new imported tag

Then select the newly uploaded template.tpl file, and click Save.

Configure tag

Create a new tag in Google Tag Manager Server-Side and select the recently created Tiktok Events API tag.

To configure the tag, two pieces of information are required:

The Tiktok pixel ID on which to send data.
The Access Token enabling communication with the Events API.

Once you've retrieved the access token and pixel ID, configure the Tiktok Events API tag.

Event Name Setup Method

Setup Method	Description
Inherit from client	Tell tag to map GA4 events received from client-side container to standard Tiktok events.
Override	Manually associate GA4 events with those to be sent to TikTok. You can choose to send either a standard event or a custom event.

Access Token

Enter the access token retrieved from the event manager.

Pixel ID

Enter the pixel ID retrieved from the event handler.

Test Event Code

Enter here the test code for test sending events to Tiktok

⚠️

It's not recommended to leave test code in the TikTok Events API tag in production. Be sure to remove it before publishing your server container.

Triggering the tag

Trigger the Tiktok Events API tag on relevant GA4 events using the tag mapping table.

For example, for an e-commerce website, the following events are generally used:

Event name
page_view
view_item
add_to_cart
begin_checkout
add_payment_info
purchase

💡

This list of events is of course not exhaustive and depends on your situation.

For optimal organization, create a Lookup Table variable configured as follows:

Configuring a lookup table in Google Tag Manager Server-Side

In the Tiktok Events API tag, create a custom trigger verifying that the events come from GA4 (Client Name = GA4) and that the previously configured Lookup Table returns true.

Configuring a custom trigger in Google Tag Manager Server-Side

Next step

Now that you've finished configuring Addingwell's Tiktok Events API tag, it's time to check received data.