Lewati navigasi utama
Platform & konversi

Apa itu Event ID? Kode unik yang membuat Meta mengenali satu kejadian

Event ID adalah kode unik yang dikirim bersama sebuah event ke Meta, bernama event_id di Conversions API dan eventID di Meta Pixel. Meta memakainya bersama nama event untuk mengenali dua kiriman yang sebenarnya satu kejadian, supaya hanya terhitung sekali. Nilainya bisa string apa saja yang unik, asalkan sama di kedua sisi untuk kejadian yang sama.

Disebut juga: event_id, eventID, ID event Meta

Event ID: Platform & konversi

01Arti event_id menurut Meta

Menurut halaman Server Event Parameters di dokumentasi developer Meta, event_id adalah parameter opsional berupa string unik yang dipilih pengiklan. Meta menandainya sebagai parameter yang disarankan untuk deduplikasi. Halaman itu menyebut nomor pesanan atau ID transaksi sebagai contoh yang cocok. Untuk kejadian tanpa nomor bawaan, angka acak boleh dipakai selama angka yang sama dikirim dari browser dan dari server.

Halaman Handling Duplicate Pixel and Conversions API Events menjelaskan kapan event ID dibutuhkan. Meta menyarankan Meta Pixel dan Conversions API dipasang bersamaan, yang disebutnya redundant setup. Bila kejadian yang sama sampai lewat kedua jalur, Meta harus bisa membedakan event yang tumpang tindih dari event yang memang berbeda. Cara yang direkomendasikan Meta adalah mencocokkan event ID dan nama event. Pengiklan yang tidak mengirim event yang sama dua kali lewat Pixel dan Conversions API tidak perlu menyiapkan deduplikasi untuk event itu.

BagianDi Meta PixelDi Conversions APIAturan Meta
ID eventeventID, argumen keempat pada fbq('track', ...)event_idHarus sama untuk event yang berpasangan.
Nama eventNama event Pixel, misalnya Leadevent_nameHarus sama untuk event yang berpasangan.
TujuanPixel ID tertentuPixel ID yang samaKombinasi ID dan nama dicocokkan pada Pixel ID yang sama.
Waktu terimaDiterima Meta dari browserDiterima Meta dari serverHanya dideduplikasi bila diterima dalam 48 jam sejak Meta menerima event pertama dengan ID itu.

Cara Meta memilih event yang dipertahankan, metode cadangan, dan cara mengujinya di Events Manager dibahas penuh di Deduplikasi Event Pixel dan CAPI.

02Ciri event_id yang baik

  • Unik untuk setiap kejadian. Dua pesanan berbeda harus punya ID berbeda, supaya Meta tidak mengira keduanya satu kejadian.
  • Sama di kedua sisi untuk kejadian yang sama. Menurut Meta, eventID dari browser harus sama dengan event_id pada event server yang berpasangan.
  • Dibuat satu kali saat kejadian terjadi, lalu dipakai ulang bila pengiriman diulang. Bila ID berganti pada setiap percobaan, tidak ada kunci yang menunjukkan bahwa kiriman-kiriman itu satu kejadian.
  • Bukan data pribadi. Jangan memakai email atau nomor telepon sebagai event ID. Event ID tidak di-hash, sedangkan Meta meminta data kontak di-hash, jadi ID semacam itu mengirim data pribadi dalam teks biasa. Cara hash dibahas di Hashing.

03Di alur iklan ke WhatsApp

Di Dalekta, event_id dibentuk di server untuk setiap event yang dikirim ke Meta lewat Conversions API. Bentuknya ID lead, tanda titik dua, lalu kode tahap, yaitu <id-lead>:<tahap>. ID lead adalah ID internal lead di database Dalekta, bukan kode [D-XXXXX] di pesan WhatsApp. ID lead dan kode tahap tidak berubah, jadi lead dan tahap yang sama selalu menghasilkan event_id yang sama, kapan pun dan berapa kali pun pengiriman dicoba. Nilainya terlihat di kolom Event ID pada halaman Event Logs.

Tahap leadKode tahapBentuk event_id
Visit LPVISIT_LP<id-lead>:VISIT_LP
Click CTACLICK_CTA<id-lead>:CLICK_CTA
Masuk WAMASUK_WA<id-lead>:MASUK_WA
MQLMQL<id-lead>:MQL
ProspekPROSPEK<id-lead>:PROSPEK
ClosingCLOSING<id-lead>:CLOSING

Nama event di sisi Meta, misalnya Lead atau Purchase, ditentukan oleh Event Mapping workspace dan tidak mengubah event_id. Event hanya dikirim bila tahap itu sudah dipetakan, Pixel ID dan Access Token sudah tersimpan, dan lead terdeteksi berasal dari Meta. Satu lead mengirim satu event per tahap, sehingga satu tahap tidak terkirim dua kali.

SituasiYang dilakukan Dalekta
Tahap yang sama dipicu dua kali bersamaanPengirim pertama mencatat log berstatus Pending. Pengirim kedua melihat log itu dan melewati pengiriman.
Tahap disimpan ulang setelah log berstatus SuccessDilewati. Tidak ada event baru ke Meta, termasuk bila nominal Closing diubah setelah event terkirim.
Pengiriman sebelumnya FailedBoleh dikirim lagi dengan event_id yang sama. Retry dari halaman Event Logs juga memakai event_id yang sama.
Log Pending yang sudah lebih dari sekitar dua menitDianggap sisa proses yang berhenti. Pengiriman berikutnya mengambil alih dan jumlah Attempts bertambah.
Event Dalekta tidak berpasangan dengan Pixel milik AndaDalekta tidak memuat Meta Pixel di landing page Anda. ID lead dibuat di server Dalekta dan tidak diteruskan ke halaman, jadi eventID dari Pixel Anda sendiri tidak mungkin sama dengan event_id Dalekta. Bila Pixel Anda mengirim event bernama sama dengan hasil mapping, Meta tidak bisa memasangkan keduanya lewat event ID dan kejadian itu bisa terhitung dua kali. Bagi tugasnya lewat nama event, misalnya Pixel untuk perilaku di halaman dan Dalekta untuk kejadian setelah klik WhatsApp.

04Kesalahan yang sering terjadi

  • Membuat ID sendiri-sendiri di browser dan di server, misalnya angka acak atau Date.now() yang dipanggil terpisah. Nilainya pasti berbeda, jadi eventID dan event_id tidak cocok dan Meta tidak bisa memasangkan keduanya.
  • Mengganti event ID setiap kali pengiriman diulang. Retry yang membawa ID baru tidak bisa dikenali sebagai pengulangan dari kiriman yang lama.
  • Mengira event ID Dalekta bisa dipasangkan dengan event dari Pixel milik Anda. Keduanya tidak berbagi ID, sehingga event dengan nama yang sama bisa terhitung dua kali.
  • Menyangka dua tahap yang dipetakan ke satu nama event saling menggantikan. Masuk WA dan MQL yang sama-sama dipetakan ke Lead punya event_id berbeda, jadi Meta menerima dua Lead untuk satu lead.

05Pertanyaan umum

Apa bedanya event_id dan eventID?

Keduanya event ID yang sama dengan nama berbeda di tiap jalur. eventID adalah opsi di Meta Pixel, dikirim sebagai argumen keempat pada fbq('track', ...), sedangkan event_id adalah parameter di Conversions API. Menurut Meta, eventID dari browser harus sama dengan event_id pada event server yang berpasangan agar bisa dideduplikasi.

Apakah event_id wajib dikirim?

Tidak wajib. Meta menandai event_id sebagai parameter opsional, tetapi menyarankannya untuk deduplikasi. Bila Anda tidak mengirim event yang sama lewat Pixel dan Conversions API, Meta menyebut deduplikasi untuk event itu tidak perlu disiapkan. Dalekta tetap mengirim event_id di setiap event, dan memakainya sebagai kunci untuk mencegah kiriman ganda dari sisi Dalekta sendiri.

Seperti apa bentuk event_id yang dikirim Dalekta?

ID lead diikuti tanda titik dua dan kode tahap, misalnya <id-lead>:MASUK_WA. Setiap kombinasi lead dan tahap punya satu event_id yang tetap. Nilainya tampil di kolom Event ID pada halaman Event Logs, sehingga Anda bisa mencocokkan satu baris log dengan lead dan tahapnya.

Apakah satu tahap lead bisa terkirim dua kali ke Meta?

Dalam keadaan normal tidak. Sebelum mengirim, Dalekta mencatat satu log untuk event_id itu, dan selama log berstatus Pending atau Success masih ada, pengiriman baru untuk lead dan tahap yang sama dilewati. Log Failed boleh dikirim ulang dengan event_id yang sama. Event dari Pixel Anda sendiri tidak ikut diperiksa dan bisa menambah hitungan.

06Istilah terkait

Semua istilah

Coba Dalekta

Lihat campaign mana yang benar-benar closing di WhatsApp.

Masuk dengan Google untuk mencoba Signal Lite 7 hari tanpa kartu kredit. Trial Lite tidak mencakup AI Agent.