Daftar isi
Ringkasan cepat
- Event dikirim ke endpoint v1.3 memakai access token dan Pixel Code dari Events Manager
- Satu event_id dipakai bersama pixel dan server, jadi satu pesanan tidak terhitung dua kali
- Email dan nomor telepon di-hash SHA-256, nomor lokal diubah ke format +62 lebih dulu
- Klik WhatsApp dikirim sebagai Contact, pesanan yang jadi dikirim sebagai CompletePayment
- Termasuk di semua paket website, mulai Rp2.000.000 per tahun, revisi tanpa batas satu tahun
Yang dipasang, bukan sekadar satu potong skrip
TikTok pixel yang ditempel di head hanya melapor dari browser pengunjung, dan jalur itu memakai perangkat orang lain, jadi pemblokir iklan serta browser bawaan aplikasi memotongnya tanpa pemberitahuan. Events API menambah jalur kedua, yaitu server Anda yang memanggil TikTok, dan panggilan itu tidak bisa dihalangi ekstensi di ponsel.
Pemasangan yang utuh butuh empat hal: Pixel Code dari Events Manager sebagai event_source_id beserta access token berizin Events API, endpoint versi 1.3, nama event baku seperti ViewContent, Contact, dan CompletePayment, lalu field wajib di setiap kiriman yaitu event_time dalam detik Unix, event_id, blok user, dan properties dengan value angka serta currency IDR. Nama event karangan sendiri tetap diterima, tapi tidak bisa dipilih sebagai tujuan optimasi di Ads Manager.
Deduplikasi dan pencocokan identitas pembeli
Satu pembelian memang dikirim dua kali, sekali dari pixel dan sekali dari server, supaya satu jalur menambal jalur lainnya. TikTok baru membuang salinannya kalau nama event dan event_id persis sama, jadi event_id harus dibuat di satu tempat, biasanya nomor pesanan Anda, lalu dibawa kedua jalur tanpa diubah.
Kualitas pencocokan ditentukan isi blok user. Email dirapikan dulu, huruf kecil dan spasi dibuang, baru di-hash SHA-256, sedangkan nomor telepon diubah ke format internasional, 0812 jadi +62812, baru di-hash. external_id dari CRM di-hash dengan cara sama di semua jalur, karena dua resep hash berbeda membuat satu orang dibaca sebagai dua. Empat field berikut paling sering tertinggal:
- ttclid dari URL pendaratan, disimpan sebelum pengunjung berpindah halaman
- cookie _ttp dari pixel, dikirim sebagai parameter ttp di kiriman server
- ip dan user_agent milik pengunjung, bukan milik server Anda
- alamat halaman lengkap dengan parameter kampanyenya
Konversi yang selesai di WhatsApp, bukan di halaman
Di Indonesia sebagian besar penjualan tidak selesai di situs. Pengunjung datang dari TikTok, membaca halaman, menekan tombol WhatsApp, lalu kesepakatannya berjalan di ruang obrolan yang tidak bisa dilihat pixel mana pun. Tanpa pemasangan khusus, yang dipelajari TikTok cuma ada orang membuka halaman lalu menghilang.
Kami mencatat klik tombol WhatsApp sebagai event Contact dengan konteks halamannya. Ketika lead itu jadi pesanan di CRM atau ERP, server mengirim CompletePayment bernilai transaksi asli dengan event_id dari nomor pesanan dan event_time dari waktu kejadiannya, supaya atribusinya jatuh di hari yang benar. Pemicu dari sisi CRM dikerjakan sebagai modul aplikasi, Rp5.000.000 per modul per tahun termasuk server.
Kesalahan yang sering kami temukan, dan cara memeriksanya
Masalah terbanyak bukan Events API yang rumit, tapi pixel yang terpasang dua kali, sekali di tema dan sekali lagi lewat tag manager. ViewContent lalu membengkak dua kali lipat, biaya per hasil terlihat murah, dan tidak ada angka yang bisa dipakai memutuskan belanja iklan. Di sisi server, kesalahannya berulang soal bentuk data:
Pemeriksaannya butuh setengah jam. Ambil kode uji di tab Test Events, lakukan satu klik WhatsApp sungguhan, lalu lihat apakah event browser punya pasangan dari server. Baca tab diagnostik untuk field yang hilang dan event yang gagal terdeduplikasi. Terakhir bandingkan tujuh hari CompletePayment di Ads Manager dengan daftar pesanan Anda: laporan yang jauh lebih kecil berarti event server tidak cocok, dan yang jauh lebih besar hampir selalu berarti pixel kembar.
- event_time dalam milidetik padahal diminta detik Unix, event jatuh di tahun yang salah
- email dikirim apa adanya atau di-hash dua kali, keduanya membuat pencocokan gagal
- IP server yang terkirim, sehingga semua pembeli terlihat di satu lokasi
- respons endpoint tidak pernah dibaca, padahal kode non-nol menyebut field yang bermasalah
- test_event_code tertinggal di produksi, event hanya masuk Test Events
Lingkup pekerjaan, waktu, dan harga
Pemasangan pixel, pemetaan event, dan penyambungan Events API termasuk di setiap paket website: landing page mulai Rp2.000.000 per tahun siap 3 sampai 5 hari kerja, company profile mulai Rp3.000.000 per tahun siap 7 sampai 14 hari kerja, dan e-commerce mulai Rp12.000.000 per tahun. Hosting, SSL, server, grup WhatsApp, dan revisi tanpa batas satu tahun sudah termasuk, sedangkan domain dibeli terpisah dan tetap atas nama Anda.
Satu catatan dari lapangan: pada sebuah distributor bahan bangunan, laporan TikTok memperlihatkan lead hampir dua kali isi buku pesanan karena pixel terpasang lewat tema sekaligus tag manager. Setelah salinannya dicabut dan CompletePayment dikirim dari server, laporannya bisa dibandingkan langsung dengan rekap penjualan mingguan. Kami berbasis di Gunung Putri, Bogor.
TikTok Pixel di browser dibandingkan Events API di server
| Hal yang dibandingkan | TikTok Pixel | Events API |
|---|---|---|
| Tempat event dibuat | Browser pengunjung | Server atau Worker Anda |
| Risiko terpotong | Pemblokir iklan, mode privasi | Hampir tidak ada |
| Data pencocokan | Cookie, ttclid, hash browser | CRM, hash email, telepon, ttp |
| Nilai transaksi | Sebatas yang diketahui halaman | Angka final dari pesanan |
| Kunci deduplikasi | event_id dari UUID halaman | event_id dari nomor pesanan |
Pertanyaan yang sering diajukan
Apa bedanya TikTok Pixel dengan TikTok Events API?
TikTok Pixel adalah kode di browser pengunjung yang melaporkan tindakan mereka, sedangkan TikTok Events API mengirim laporan yang sama dari server Anda lewat endpoint v1.3. Pemasangan yang benar memakai keduanya dengan event_id identik.
Apakah mengirim event dari dua jalur membuat konversi terhitung dua kali?
Hitungan ganda dicegah deduplikasi: TikTok membuang salinan kalau nama event dan event_id persis sama di kiriman pixel dan kiriman server. Masalah muncul hanya kalau event_id dibuat terpisah di tiap jalur, misalnya UUID acak di satu sisi dan nomor pesanan di sisi lain.
Berapa lama instalasi TikTok Events API sampai bisa dipakai?
Pengerjaan selesai di dalam masa pembangunan situs, 3 sampai 5 hari kerja untuk landing page dan 7 sampai 14 hari kerja untuk website company profile. Pembuatan access token dan pengujian di Test Events biasanya menambah satu hari.
Apakah klik tombol WhatsApp bisa dikirim sebagai konversi TikTok?
Klik tombol WhatsApp bisa dikirim sebagai event Contact, dan di situs yang kami bangun hal itu terpasang standar pada tombol melayang maupun tombol di kartu produk. Kalau pesanan dicatat di CRM, server menyusul dengan CompletePayment bernilai transaksi asli.
Kenapa jumlah konversi di TikTok Ads Manager beda jauh dengan catatan pesanan saya?
Selisih besar punya tiga sebab umum. Laporan yang jauh lebih kecil berarti konversi yang selesai di WhatsApp tidak pernah dikirim sebagai event, atau event server ditolak karena field bermasalah. Laporan yang jauh lebih besar hampir selalu berarti pixel terpasang dua kali.
Apakah Events API butuh server sendiri, atau bisa lewat tag manager sisi server?
Events API bisa dijalankan dari dua tempat: langsung dari backend situs Anda, atau dari container tag manager sisi server yang meneruskan event. Keduanya memakai access token dan Pixel Code yang sama, dan servernya sudah termasuk di paket website kami.
