TikTok Events API

TikTok Events API memungkinkan Anda mengirim data event (seperti CompletePayment, SubmitForm) langsung dari server Konektor ke TikTok Ads Manager.

Konektor memprioritaskan ttclid dan ttp untuk matching TikTok. Jika identifier ini tidak tersedia dan user data tidak cukup, event akan ditandai skipped agar tidak tercatat sebagai sukses palsu.

Mengapa Events API?

Pixel TikTok berbasis browser rentan terhadap kendala jaringan dan ad blocker. Dengan Events API, data dikirim melalui jalur server-to-server yang stabil.

Benefit:

Data Real-time: Event dikirim instan saat status lead berubah.
Anti Ad-Blocker: Tidak terpengaruh extension browser.
Advanced Matching: Mengirim email/HP untuk pencocokan user yang lebih baik.

Template URL Parameters (TikTok Ads)

Tempelkan template ini ke kolom Tracking Parameters atau gabungkan dengan URL landing page. Pastikan hanya ada satu tanda ? di URL akhir.

?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

Isi ad_account_id dengan ID akun iklan TikTok Anda.

Lihat Daftar Makro TikTok

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

Cara Mengambil Token & Pixel Code

Buka TikTok Ads Manager.
Pergi ke Tools > Events.
Pilih Web Events dan klik Pixel yang ingin digunakan.
Masuk ke tab Settings.
Scroll ke Events API.
Klik Generate Access Token.
Copy Token tersebut.
Di tab yang sama, copy juga Pixel ID Anda.

Integrasi di Konektor

Login ke Dashboard Konektor.
Masuk ke Integrasi > TikTok Ads.
Masukkan Pixel ID dan Access Token.
Klik Test Connection.
Simpan.

Status sinkronisasi di Sync Logs

Saat event dikirim ke TikTok, Konektor mencatat hasil detail di Sync Logs:

accepted: TikTok menerima payload.
partial_failure: request diterima, tetapi ada sebagian data yang perlu dicek.
failed: request gagal sebelum diterima TikTok.
skipped: event tidak dikirim karena identifier minimum atau konfigurasi belum cukup.

Mapping Event

Konektor secara otomatis memetakan status lead ke event standar TikTok:

Status Lead	Event TikTok
`new`	`ViewContent`
`contacted`	`Contact`
`qualified`	`InitiateCheckout`
`won`	`CompletePayment` / `PlaceAnOrder`

Deduplikasi

Konektor mengirimkan parameter event_id yang unik untuk setiap event. Jika Anda juga memasang Pixel TikTok di website secara manual, TikTok akan secara otomatis mendeduplikasi event yang memiliki ID sama antara browser dan server.

Next Steps

Butuh Bantuan Lebih Lanjut?

Tim kami siap membantu Anda memaksimalkan potensi tracking iklan dan atribusi bisnis Anda.

Email Supportsupport@konektor.id

YouTubeYouTube

Jadwalkan Sesi

Onboarding Demo Meeting Technical Support