Set up TikTok Events API so closings reach TikTok Ads, in 1 minute (Indonesian narration)

1:10

Set up TikTok Events API so closings reach TikTok Ads, in 1 minute (Indonesian narration) • 1:10

TikTok Events API

Konektor.id sends events from its server to TikTok through the Events API. You enter the Pixel Code and Access Token from TikTok Events Manager in Website Tracking. A TikTok ad click carries ttclid to your landing page, and each lead status change sends an event such as Lead or Purchase. Each built-in event name goes out once for each lead.

TikTok Events API allows you to send event data (like Lead and Purchase) directly from Konektor server to TikTok Ads Manager.

A summary of the events, requirements, and limits for sending to TikTok is in TikTok ads tracking software.

Minimum Identifier Requirement

Konektor prioritizes ttclid and ttp for TikTok matching. If those identifiers are missing and user data is still insufficient, the event will be marked as skipped instead of being reported as a false success.

Why use the TikTok Events API?

Browser-based TikTok Pixel is vulnerable to network issues and ad blockers. With Events API, data is sent via a stable server-to-server channel.

Benefits:

Real-time Data: Events sent instantly when lead status changes.
Anti Ad-Blocker: Not affected by browser extensions.
Advanced Matching: Send email/phone for better user matching.

URL Parameters Template (TikTok Ads)

Paste this into the Tracking Parameters field or append it to your landing page URL. Ensure there is only one ? in the final URL.

?utm_source=tiktok&utm_medium=paid&utm_campaign=__CAMPAIGN_NAME__&utm_term=__AID_NAME__&utm_content=__CID_NAME__&campaign_id=__CAMPAIGN_ID__&campaign_name=__CAMPAIGN_NAME__&ad_group_name=__AID_NAME__&ad_name=__CID_NAME__&ad_group_id=__AID__&ad_id=__CID__&ttclid=__CLICKID__&ad_account_id=YOUR_AD_ACCOUNT_ID

Fill ad_account_id with your TikTok ad account ID.

TikTok Macros

Macro	Description
`__CAMPAIGN_NAME__`	Campaign Name
`__AID_NAME__`	Ad Group Name
`__CID_NAME__`	Ad/Creative Name
`__AID__`	Ad Group ID
`__CID__`	Ad/Creative ID
`__CLICKID__`	TikTok Click ID

How do you get the Access Token and Pixel Code?

Open TikTok Ads Manager.
Go to Tools > Events.
Select Web Events and click the Pixel you want to use.
Go to the Settings tab.
Scroll to Events API.
Click Generate Access Token.
Copy that Token.
On the same tab, also copy your Pixel ID.

Integration in Konektor

Login to Konektor Dashboard.
Open Website Tracking, then click Add ad platform.
Select TikTok Ads.
Enter Pixel Code (ID) and Access Token.
Click Save.
Open the row menu, then click Test send.

Sync log statuses

When Konektor sends events to TikTok, it records detailed results in Delivery log:

accepted: TikTok accepted the payload.
partial_failure: the request was accepted, but some data needs review.
failed: the request failed before TikTok accepted it.
skipped: Konektor did not send the event because the minimum identifier or configuration was not sufficient.

Which TikTok event goes out for each lead status?

Konektor automatically maps lead status to standard TikTok events. The table below shows the default mapping. You can change it in Tracking & Ads > Conversions, in the Event per lead status table.

Lead Status	TikTok Event
`new`	`ViewContent`
`contacted`	`Contact`
`qualified`	`Lead`
`won`	`Purchase`

Can an event be counted twice?

It can, if you also install your own TikTok Pixel. Konektor sends a unique event_id for each event. TikTok merges a browser event and a server event only when the event name and the event_id match. Avoid sending the same event from two places.

Next Steps

Need More Help?

Our team is ready to help you maximize ad tracking and business attribution.

support@konektor.idYouTube

Wulan answers your questions and sends tutorial videos. Session scheduling is available through Wulan if you still need it.