Skip to content

Ads

TikTok Events API

Report leads and sales from TikTok ads back to TikTok so it learns which audience brings sales.

When someone who clicked a TikTok ad reaches your site and a deal is opened in the Sales CRM, Talkty sends a Lead event to your TikTok Pixel. When the deal is won, a Purchase event goes with its amount. This tells TikTok which ads actually bring sales, so it shows them to similar people.

What you need

  • Talkty's web tracking code on your site. It captures the TikTok click ID (ttclid), which is matched to the deal when the person writes from the WhatsApp button on your site.
  • A web Pixel in TikTok Ads Manager.

Setup

  1. In TikTok Ads Manager, open Tools › Events › Web events and copy your Pixel code (e.g. C4ABCDEF12345).
  2. In the same Pixel's settings, under Events API, press Generate access token and copy the token.
  3. In Talkty, go to Settings › Channels & integrations › TikTok Events API, fill in Pixel code and Events API access token and press Save.
  4. Optionally, enter the code from TikTok's Test events tab in Test event code and press Send test event. The event shows up in TikTok within a few minutes. Remove the test code afterwards; while it is saved, real events are also sent as tests.

How it works

  • Events are sent only for deals that came from a TikTok ad (click ID or utm_source=tiktok).
  • Lead and Purchase are each sent once per deal. If TikTok cannot be reached, the next deal update tries again.
  • Along with the click ID, the deal's phone and email are sent for matching; both are SHA-256 hashed as TikTok requires, never in plain text.
  • Leads from TikTok form ads (Instant Form) do not go through this path.