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
- In TikTok Ads Manager, open Tools › Events › Web events and copy your Pixel code (e.g. C4ABCDEF12345).
- In the same Pixel's settings, under Events API, press Generate access token and copy the token.
- In Talkty, go to Settings › Channels & integrations › TikTok Events API, fill in Pixel code and Events API access token and press Save.
- 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.