TikTok Events API
TikTok Events API allows you to send event data (like CompletePayment, SubmitForm) directly from Konektor server to TikTok Ads Manager.
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 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.
| 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 to Get Token & 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.
- Go to Integrations > TikTok Ads.
- Enter Pixel ID and Access Token.
- Click Test Connection.
- Save.
Sync log statuses
When Konektor sends events to TikTok, it records detailed results in Sync Logs:
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.
Event Mapping
Konektor automatically maps lead status to standard TikTok events:
| Lead Status | TikTok Event |
|---|---|
new | ViewContent |
contacted | Contact |
qualified | InitiateCheckout |
won | CompletePayment / PlaceAnOrder |
Deduplication
Konektor sends a unique event_id parameter for each event. If you also manually install TikTok Pixel on your website, TikTok will automatically deduplicate events with the same ID between browser and server.
Next Steps
Need More Help?
Our team is ready to help you maximize ad tracking and business attribution.
© 2026 Konektor. All rights reserved.