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.
Import tag into sGTM
Go to the Templates tab of the server container, then, in the Tag templates section, click on New.
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:
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.
Next step
Now that you've finished configuring Addingwell's Tiktok Events API tag, it's time to check received data.