TikTok Events API

Konektor.id mengirim event dari server ke TikTok lewat Events API. Anda mengisi Pixel Code dan Access Token dari TikTok Events Manager di Tracking Website. Klik iklan TikTok membawa ttclid ke landing page, lalu tiap perubahan status lead mengirim event seperti Lead atau Purchase. Tiap nama event bawaan terkirim satu kali untuk setiap lead.

TikTok Events API memungkinkan Anda mengirim data event (seperti Lead dan Purchase) langsung dari server Konektor ke TikTok Ads Manager.

Ringkasan event, syarat, dan batas pengiriman ke TikTok ada di software tracking iklan TikTok.

Identifier Minimum

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 memakai TikTok 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.

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

Bagaimana mengambil Access Token dan 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.
Buka Tracking Website, lalu klik Tambah platform iklan.
Pilih TikTok Ads.
Isi Pixel Code (ID) dan Access Token.
Klik Simpan.
Buka menu baris, lalu klik Uji kirim.

Status sinkronisasi di Log pengiriman

Saat event dikirim ke TikTok, Konektor mencatat hasil detail di Log pengiriman:

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.

Event TikTok apa yang dikirim untuk setiap status lead?

Konektor secara otomatis memetakan status lead ke event standar TikTok. Tabel berikut memuat pemetaan bawaan. Anda dapat mengubahnya di Pelacakan & Iklan > Konversi, pada tabel Event per status lead.

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

Apakah event bisa terhitung dua kali?

Bisa, bila Anda juga memasang Pixel TikTok sendiri. Konektor mengirim event_id yang unik untuk setiap event. TikTok menggabungkan event dari browser dan server hanya bila nama event dan event_id sama. Hindari mengirim event yang sama dari dua tempat.

Next Steps

Butuh Bantuan Lebih Lanjut?

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

support@konektor.idYouTube

Wulan bantu jawab dan kirim video panduan. Jadwal sesi tersedia lewat Wulan bila masih perlu.