01Conversions API adalah jalur server, bukan script di browser
Conversion API adalah cara bagi server Anda untuk melaporkan kejadian bisnis ke Meta secara langsung. Nama resminya Conversions API, dengan huruf s, dan singkatannya CAPI. Di dokumentasi Meta, event dari jalur ini disebut server events. Istilah server-side tracking atau server-to-server merujuk pada hal yang sama: yang mengirim data adalah server, bukan browser pengunjung.
Bandingkan dengan Meta Pixel. Pixel adalah script yang berjalan di browser dan melaporkan apa yang terjadi di halaman web. CAPI bekerja dari arah sebaliknya. Sistem Anda, misalnya server website, CRM, atau alat seperti Dalekta, membuat permintaan HTTP ke Meta setiap kali ada kejadian yang layak dilaporkan. Event dari kedua jalur masuk ke tujuan yang sama, yaitu Pixel ID (kini sering disebut dataset) di Events Manager, dan diproses dengan cara serupa.
Karena berangkat dari server, CAPI bisa melaporkan kejadian yang tidak pernah terlihat browser: form yang diproses di backend, pesanan yang dikonfirmasi lewat telepon, atau closing yang disepakati di chat WhatsApp.
02Cara kerja CAPI dari kejadian sampai muncul di Events Manager
Alurnya sama di semua implementasi, entah Anda menulis kodenya sendiri atau memakai alat jadi.
- Sesuatu terjadi di bisnis Anda: form terkirim, chat masuk, atau closing dicatat sales.
- Sistem Anda menyusun event berisi nama event, waktu kejadian, sumber kejadian, dan data untuk mencocokkan pelanggan ke akun Meta.
- Data pelanggan seperti nomor telepon dan nama dibersihkan lalu di-hash dengan SHA-256 sebelum keluar dari sistem Anda.
- Server mengirim permintaan POST ke endpoint
/{pixel_id}/eventsdi Graph API Meta, dengan access token sebagai kunci. - Meta mencoba mencocokkan event ke akun pengguna dan iklan yang memicu kunjungannya, lalu menampilkannya di Events Manager dan memakainya untuk pelaporan serta optimasi.
Kerangka permintaannya seperti ini. Nilai di dalam tanda kurung sudut adalah placeholder.
POST https://graph.facebook.com/<versi>/<PIXEL_ID>/events?access_token=<TOKEN>
Content-Type: application/json
{ "data": [ { ...satu atau lebih event... } ] }Balasan sukses dari Meta hanya berarti permintaan diterima. Event masih perlu diproses sebelum terlihat di Events Manager, jadi jangan menyimpulkan gagal hanya karena angkanya belum muncul beberapa menit setelah kirim.
03Kenapa CAPI dibutuhkan: iOS 14.5, ad blocker, dan pembatasan browser
Pixel tidak rusak. Yang berubah adalah jalur browser makin sering terputus di tengah jalan, dan pemasang iklan kehilangan sebagian sinyal tanpa menyadarinya. Berikut hambatan utamanya dan apa yang bisa dilakukan jalur server untuk masing-masing.
| Hambatan | Efek pada pixel | Peran CAPI |
|---|---|---|
| App Tracking Transparency (iOS 14.5 ke atas) | Pengguna iPhone bisa menolak dilacak lintas aplikasi dan situs. Meta membatasi pengukuran untuk mereka, sehingga sebagian aksi di situs Anda tidak terhubung ke iklan. | Server tetap bisa melaporkan kejadian yang Anda catat sendiri. Pencocokan ke akun tetap tunduk pada pilihan privasi pengguna. |
| Ad blocker dan ekstensi privasi | Script pixel bisa diblokir, sehingga event tidak pernah terkirim. | Event dikirim dari server, jadi tidak melewati ekstensi di browser pengunjung. |
| Pembatasan cookie di browser seperti Safari dan Firefox | Cookie bisa dibatasi atau dihapus lebih cepat, sehingga pengunjung yang kembali sulit dikenali. | Server bisa menyertakan data pencocokan yang Anda miliki, misalnya nomor telepon yang di-hash, tanpa bergantung pada cookie. |
| Koneksi putus atau halaman ditutup sebelum script selesai | Event yang belum sempat terkirim hilang begitu saja. | Kejadian dicatat di server lebih dulu, sehingga pengiriman bisa dicatat di log dan diulang jika gagal. |
| Kejadian di luar halaman web | Pixel tidak melihat chat, telepon, atau pembayaran yang terjadi di luar situs. | Sistem apa pun yang mencatat kejadian itu bisa mengirimkannya ke Meta. |
CAPI punya batas. Ia bukan celah untuk melacak orang yang menolak dilacak. Consent tetap tanggung jawab Anda, dan Meta hanya bisa mencocokkan event ke akun pengguna dari data yang Anda kirim. CAPI memperbaiki kelengkapan data, bukan otomatis membuat iklan lebih murah.
04Apa isi sebuah event CAPI
Satu event adalah objek JSON dengan beberapa kelompok field. Tabel ini merangkum yang paling sering Anda temui.
| Field | Fungsi | Catatan |
|---|---|---|
| event_name | Nama kejadian, misalnya Lead, Contact, Purchase, atau nama custom. | Standard event lebih mudah dipakai untuk pelaporan dan optimasi. |
| event_time | Waktu kejadian dalam detik Unix. | Meta menerima event hingga 7 hari sebelum dikirim. Lebih lama dari itu, permintaan ditolak. |
| action_source | Tempat kejadian berlangsung. | Nilainya antara lain website, app, chat, phone_call, physical_store, dan business_messaging. |
| event_source_url | Halaman tempat kejadian. | Dipakai untuk event website. |
| event_id | Pengenal unik satu event. | Dipakai untuk mencegah hitungan ganda jika event yang sama juga dikirim pixel. Meta membandingkan event_id sekaligus event_name. |
| user_data | Data untuk mencocokkan event ke pengguna Meta. | Email, telepon, nama, kota, kode pos, dan negara di-hash SHA-256. fbc, fbp, IP, dan user agent dikirim tanpa hash. |
| custom_data | Detail tambahan seperti value, currency, dan content_name. | Untuk Purchase, sertakan value dan currency agar nilai penjualan terbaca. |
Berikut contoh ringkas event Purchase. Semua nilai adalah ilustrasi dengan placeholder, bukan data pelanggan.
{
"data": [
{
"event_name": "Purchase",
"event_time": 1790000000,
"event_id": "<id-unik-event>",
"action_source": "website",
"event_source_url": "https://www.example.com/promo",
"user_data": {
"ph": ["<sha256 nomor telepon>"],
"fbc": "<fbc dari klik iklan>",
"client_user_agent": "<user agent browser>"
},
"custom_data": {
"currency": "IDR",
"value": 2500000
}
}
]
}05CAPI dan pixel: bukan pilihan salah satu
| Aspek | Meta Pixel | Meta CAPI |
|---|---|---|
| Berjalan di | Browser pengunjung. | Server atau sistem Anda. |
| Yang bisa dilihat | Aktivitas di halaman yang memasang script. | Kejadian apa pun yang dicatat sistem Anda, di dalam maupun di luar website. |
| Rentan terhadap | Ad blocker, pembatasan cookie, dan koneksi putus. | Data yang salah atau tidak lengkap dari sisi Anda. |
| Data pencocokan | Cookie dan data yang tersedia di browser. | Data yang Anda simpan, seperti nomor telepon, ditambah fbc dan fbp jika sempat ditangkap. |
| Setup | Memasang script di halaman. | Butuh Pixel ID, access token, dan sistem yang menyusun serta mengirim event. |
Untuk event di website, praktik yang umum adalah menjalankan keduanya dan memberi event_id serta event_name yang sama supaya Meta menghapus duplikat. Untuk kejadian setelah pengunjung meninggalkan website, seperti closing di WhatsApp, hanya jalur server yang realistis. Perbandingan yang lebih dalam ada di Meta Pixel vs Conversions API.
06Syarat dan persiapan sebelum memakai CAPI
Tidak ada syarat teknis yang aneh, tetapi beberapa hal harus lengkap sebelum event pertama terkirim.
| Yang perlu disiapkan | Penjelasan |
|---|---|
| Pixel ID (dataset) | Tujuan event. Diambil dari Events Manager pada data source yang dipakai campaign. |
| Access token | Kredensial untuk mengirim event ke Pixel itu. Dibuat di Events Manager, Settings, bagian Conversions API. |
| Sumber event | Server website, CRM, atau alat yang sudah terintegrasi. Harus ada sistem yang menyusun event dan mengirimnya. |
| Data pencocokan | Nomor telepon, email, nama, atau ID klik (fbc, fbp) yang memang Anda miliki dan boleh dipakai. |
| Mapping event | Aturan yang menentukan kejadian bisnis mana yang menjadi event Meta apa. |
| Dasar hukum dan consent | Hak Anda membagikan data pelanggan ke Meta, sesuai hukum setempat dan ketentuan Meta. |
| Waktu pengiriman | Kirim dalam 7 hari sejak kejadian, karena event yang lebih tua ditolak. |
Kalau Anda tidak punya developer, opsinya adalah alat atau integrasi yang sudah mengurus penyusunan dan pengiriman event, sehingga Anda cukup memasukkan Pixel ID dan token lalu memetakan event.
07Kenapa CAPI penting untuk bisnis yang closing di WhatsApp
Bagi bisnis yang menutup penjualan lewat chat, pixel berhenti di klik tombol WhatsApp. Tawar-menawar, bukti transfer, dan konfirmasi pesanan terjadi di aplikasi lain yang tidak terlihat browser. Meta hanya tahu ada chat masuk, bukan chat mana yang menjadi pembeli. CAPI memungkinkan closing dilaporkan setelah tim sales mencatatnya.
Begini alurnya di Dalekta untuk lead dari Meta Ads yang lewat landing page dan rotator:
- Iklan membawa fbclid dan parameter campaign ke landing page. Tracker Dalekta menyimpannya, lalu pengunjung menekan tombol WhatsApp lewat rotator dengan kode tracking
[D-XXXXX]di pesan awal. - Pesan masuk ke nomor WhatsApp yang terhubung, dan lead tercatat sebagai Masuk WA, terhubung ke klik dan parameter campaign tadi.
- Status lead naik lewat Rules atau update manual di halaman Leads. Untuk Closing, nominal wajib diisi.
- Dalekta menyusun event dari mapping yang sudah disimpan, memberinya event_id, lalu mengirimnya ke Meta lewat CAPI.
- Hasil SUCCESS atau FAILED beserta pesan error tercatat di Event Logs.
| Hal | Perilaku di Dalekta |
|---|---|
| Lead yang dikirim | Hanya lead yang terdeteksi berasal dari Meta Ads, misalnya dari fbclid atau utm_source yang mengarah ke Meta. Lead organik atau dari platform lain dilewati. |
| Event yang dikirim | Hanya tahap yang sudah dipetakan dan disimpan di Tracking Ads. Contoh umum: Masuk WA sebagai Lead dan Closing sebagai Purchase. |
| event_id | ID lead diikuti tahap bisnisnya, sehingga satu lead hanya berhasil terkirim satu kali per tahap. Mengoreksi nominal closing setelah event terkirim tidak mengirim ulang. |
| action_source | Selalu website, termasuk untuk status yang terjadi di WhatsApp. event_source_url berisi URL landing page atau rotator yang tercatat pada klik. |
| Data pencocokan | Nomor WhatsApp, nama, ID pengunjung, dan perkiraan lokasi klik (kota, provinsi, kode pos, negara) di-hash. fbc, fbp, IP klien, dan user agent dari klik dikirim tanpa hash, sesuai aturan Meta. |
| Nilai | currency ikut dengan default IDR. value hanya ikut jika nominal closing lebih dari 0. Detail deskriptif seperti status, kode lead, dan parameter utm juga dikirim di custom_data. |
| Lead Click-to-WhatsApp tanpa landing page | Lead berkode CTWA- tidak punya klik di landing page, sehingga event dikirim tanpa data klik website: event_source_url, fbc, fbp, IP, dan user agent. Kualitas pencocokannya lebih rendah dan Meta bisa menganggap event itu belum lengkap. Periksa hasilnya di Event Logs. |
| Belum dilakukan | ctwa_clid belum ikut dikirim, dan jalur business messaging milik Meta belum dipakai. |
Detail payload, mapping tiap tahap, dan cara verifikasi ada di pilar Meta CAPI untuk WhatsApp. Untuk gambaran dari iklan sampai closing, baca tracking closing WhatsApp dari iklan. Cara memilih event yang dikirim dijelaskan di dokumentasi Event Mapping.
08Salah kaprah tentang CAPI
- CAPI menggantikan pixel. Untuk event website, keduanya umumnya berjalan berdampingan. CAPI berdiri sendiri hanya untuk kejadian yang memang tidak pernah dilihat pixel.
- Semua event pasti masuk. Permintaan bisa ditolak Meta karena token atau Pixel ID salah, atau event_time lebih dari 7 hari. Di Dalekta, event juga dilewati jika tahap itu belum dipetakan. Event yang diterima pun belum tentu cocok ke akun pengguna. Baca log pengiriman, seperti dijelaskan di dokumentasi Event Logs.
- Hash membuat data bebas aturan privasi. Hash bukan anonimisasi. Perlakukan tetap sebagai data pribadi dan jelaskan penggunaannya di kebijakan privasi. Panduan umumnya ada di halaman privasi dan retensi data.
- Kirim semua tahap sebagai Purchase. Purchase harus berarti transaksi yang benar-benar terjadi. Chat masuk atau klik tombol sebaiknya dipetakan ke Lead atau Contact.
- Cukup setup sekali. Token bisa berganti saat tim berubah, dan definisi lead berkualitas bisa bergeser. Periksa mapping dan log secara berkala.
09Langkah berikutnya
Setelah paham konsepnya, urutan bacaan yang masuk akal adalah pilar WhatsApp, lalu perbandingan dengan pixel, lalu setup di dokumentasi. Istilah lain seperti event_id dan CTWA dirangkum di glossary Dalekta.
10Pertanyaan umum
Apa itu Conversions API di Meta Ads?
Conversions API adalah jalur server-to-server untuk mengirim event conversion, seperti lead atau pembelian, langsung dari sistem Anda ke Meta. Event masuk ke Pixel ID atau dataset yang sama dengan pixel browser, lalu dipakai untuk pelaporan dan optimasi iklan. Pengirimannya tidak bergantung pada browser pengunjung.
Apakah Meta CAPI menggantikan Meta Pixel?
Tidak selalu. Untuk event di website, banyak pemasang iklan menjalankan pixel dan CAPI berdampingan, lalu memberi event_id dan event_name yang sama agar Meta menghapus duplikat. CAPI berdiri sendiri hanya untuk kejadian yang tidak terlihat browser, seperti closing yang disepakati di chat WhatsApp.
Apakah memakai Meta CAPI harus bisa coding?
Integrasi langsung butuh developer untuk menyusun payload dan mengirimnya ke Graph API Meta. Alternatifnya alat yang sudah mengurus itu, sehingga Anda cukup memasukkan Pixel ID dan access token lalu memetakan event. Dalekta memakai jalur kedua untuk lead WhatsApp yang berasal dari Meta Ads.
Apakah CAPI bisa dipakai untuk closing di WhatsApp?
Bisa, selama ada sistem yang mencatat status lead dan nominal closing lalu mengirimnya ke Meta. Chat WhatsApp tidak terlihat pixel, jadi event closing harus dikirim dari server. Dalekta melakukannya untuk lead dari Meta Ads setelah Pixel ID, access token, dan mapping event tersimpan.
Apakah data yang dikirim lewat CAPI aman dan sesuai aturan privasi?
Meta mewajibkan data pelanggan tertentu, seperti nomor telepon dan nama, di-hash dengan SHA-256 sebelum dikirim. Namun hash bukan anonimisasi. Anda tetap perlu dasar hukum atau persetujuan untuk membagikan data itu dan menjelaskannya di kebijakan privasi. Ini bukan nasihat hukum.
