TikTok Events API Tag for Google Tag Manager Server Container

The TikTok Events API tag for Google Tag Manager server container allows sending site or app events and parameters directly to TikTok server using TikTok Events API.

It can be used to track conversion events, collect custom audiences, dynamic product ads, campaigns optimization.

How to use TikTok tag

The TikTok Events API tag for GTM Server Side allows sending user data (email, phone number, user ID, user IP, and user agent), properties, objects, and event parameters.
It automatically converts the required information to lowercase and hashes it using SHA-256.

Getting started

  1. Add TikTok Events API tag to the Google Tag Manager server container.
  2. Create a Data Source in TikTok Events Manager.
  3. Add the required parameters to the TikTok Events API tag tag inside the server GTM.

More detailed description of setting up the TikTok events API tag in the sGTM.

Supported events

  • AddPaymentInfo
  • AddToCart
  • AddToWishlist
  • ApplicationApproval
  • CompleteRegistration
  • Contact
  • CustomizeProduct
  • Download
  • FindLocation
  • InitiateCheckout
  • Lead
  • Pageview
  • Purchase
  • Schedule
  • Search
  • StartTrial
  • SubmitApplication
  • Subscribe
  • ViewContent
  • CompletePayment (legacy - Use Purchase instead)
  • SubmitForm (legacy - Use Lead instead)
  • ClickButton (deprecated)
  • PlaceAnOrder (deprecated)

Useful Resources

Open Source

The TikTok Events API Tag for GTM Server Side is developed and maintained by the Stape Team under the Apache 2.0 license.

GTM Gallery Status

:green_circle: Listed

stape-io/tiktok-tag — updated: view commit

  • Rebranded tag description to clarify support for GA4 Client and Data Client only
  • Added multiple automap checkboxes for Common Event Data, Page Data, App Data, Ad Data, User Data, and Custom Data with default mappings
  • Replaced manual ID fetching and cookie setting with centralized functions for Click ID (ttclid) and Browser ID (_ttp) handling
  • Enhanced event mapping logic to conditionally apply automapping and improve property extraction from event and ecommerce data
  • Removed all logging and BigQuery logging options for a cleaner configuration and improved performance

GTM Gallery Status

:green_circle: Listed

stape-io/tiktok-tag — updated: view commit

  • Added automatic Customer Type mapping from eventData.customer_type, supporting new and returning values

GTM Gallery Status

:green_circle: Listed