Meta Conversions API (CAPI)

Meta Conversions API (CAPI) adalah tool wajib bagi pengiklan modern. Fitur ini memungkinkan Anda mengirim data konversi (seperti Leads, Purchases) langsung dari server Konektor ke Meta, melewati browser user.

Mengapa Harus Pakai CAPI?

Pixel browser biasa semakin tidak akurat karena:

1. Ad Blockers: Extension seperti uBlock Origin memblokir pixel.
2. Browser Privacy: Safari (ITP) dan Firefox membatasi masa hidup cookie.
3. Koneksi Tidak Stabil: Loading page yang lambat bisa gagal memicu pixel.
4. iOS14+: Tracking Transparency (ATT) mempersulit tracking app/web.

Dengan CAPI, data dikirim Server-to-Server, sehingga lebih kebal terhadap masalah di atas. Akurasi data bisa meningkat 10-30%.

Persyaratan Setup

Sebelum memulai, pastikan Anda memiliki:

• Akses Admin ke Meta Business Manager.
• Meta Pixel yang sudah dibuat.
• Akses Admin ke Dashboard Konektor.

Template URL Parameters (Meta Ads)

Meta mendukung auto-tagging ID seperti campaign_id, adset_id, dan ad_id. Tambahkan snapshot nama agar histori tetap konsisten, dan gunakan makro resmi di Ads Manager.

Template Rekomendasi (UTM + ID Stabil):

utm_source=meta&utm_medium=paid&utm_campaign={{campaign.name}}&utm_term={{adset.name}}&utm_content={{ad.name}}&campaign_id={{campaign.id}}&adset_id={{adset.id}}&ad_id={{ad.id}}&campaign_name={{campaign.name}}&adset_name={{adset.name}}&ad_name={{ad.name}}&site_source_name={{site_source_name}}&ad_meta={{placement}}&ad_account_id=YOUR_AD_ACCOUNT_ID

Isi ad_account_id dengan ID akun iklan Anda.

Cara Mengambil Token CAPI

1. Buka Meta Events Manager.
2. Pilih Pixel yang ingin digunakan.
3. Masuk ke tab Settings.
4. Scroll ke bawah hingga bagian Conversions API.
5. Klik Generate Access Token.
6. PENTING: Copy dan simpan token ini di tempat aman (Notepad/Password Manager). Meta tidak akan menampilkan token ini lagi.

Integrasi di Konektor

1. Login ke Dashboard Konektor.
2. Masuk ke menu Settings > Pixel & Tracking.
3. Pilih Meta / Facebook.
4. Masukkan Pixel ID Anda.
5. Paste Access Token yang tadi dicopy ke kolom CAPI Access Token.
6. Klik Test Connection untuk memastikan koneksi berhasil.
7. Klik Save.

Setup untuk Iklan Click-to-WhatsApp (CTWA)

Jika Anda menjalankan iklan Click-to-WhatsApp di Meta, ada konfigurasi tambahan yang diperlukan agar konversi dari percakapan WhatsApp bisa diatribusikan kembali ke iklan Anda.

Mengapa Perlu Konfigurasi Tambahan?

Saat user mengklik iklan CTWA dan masuk ke WhatsApp, Meta mengirimkan ctwa_clid (Click-to-WhatsApp Click ID) melalui webhook. Konektor otomatis menangkap ID ini dari partner integration (Qiscus, Qontak, dll).

Namun, saat mengirim event konversi kembali ke Meta via CAPI, Meta mewajibkan field whatsapp_business_account_id di payload. Tanpa field ini, event akan ditolak dengan error:

Missing Page ID Or WhatsApp Business account ID

Cara Mendapatkan WhatsApp Business Account ID

1. Buka Meta Business Suite.
2. Di sidebar kiri, klik Pengaturan Bisnis (Business Settings).
3. Navigasi ke Akun > Akun WhatsApp.
4. Pilih akun WhatsApp Business yang terhubung dengan iklan Anda.
5. Salin ID numerik yang ditampilkan (contoh: 123456789012345).

Memasukkan ID di Konektor

1. Buka menu Settings > Pixel & Tracking.
2. Edit pixel Meta Anda.
3. Isi field WhatsApp Business Account ID dengan ID yang sudah disalin.
4. Klik Save.

Lebih dari Satu WABA ID (Multi-Nomor)

Jika bisnis Anda menggunakan beberapa nomor WhatsApp yang terdaftar di akun WhatsApp Business berbeda (WABA ID berbeda), WABA ID di Pixel hanya berlaku sebagai fallback default.

Agar konversi CTWA terkirim ke akun Meta yang tepat sesuai nomor agent yang menangani lead, Anda perlu mengisi WABA ID per session:

1. Buka menu WhatsApp > Sessions.
2. Klik tombol Edit pada session yang ingin dikonfigurasi.
3. Isi field WhatsApp Business Account ID dengan WABA ID yang sesuai untuk nomor tersebut.
4. Klik Save.

Konektor akan otomatis mencocokkan nomor agent di lead dengan session yang terdaftar, lalu mengirim konversi menggunakan WABA ID dari session tersebut.

Urutan prioritas resolusi WABA ID:

1. WABA ID dari session yang cocok dengan nomor agent di lead.
2. WABA ID dari konfigurasi Pixel (fallback).

Data Apa yang Dikirim?

Konektor secara otomatis mengirim event standar berikut sesuai status lead:

Deduplikasi Event

Jika Anda memasang Pixel Browser dan CAPI bersamaan, Meta mungkin menerima 2 event untuk 1 kejadian yang sama (Double Counting).

Konektor mengirim event_id yang unik untuk event server-side. Agar deduplikasi browser + server benar-benar aktif, event browser Anda juga harus memakai event_id yang sama. Jika browser event tidak mengirim ID yang sama, Meta akan menganggap keduanya sebagai event terpisah.

Untuk flow Click-to-WhatsApp, ctwa_clid diperlakukan sebagai data dari webhook WhatsApp / metadata iklan, bukan dari browser tracker biasa.

Troubleshooting

Event Tidak Muncul? Cek Traffic Permissions

Masalah yang paling sering terjadi adalah event terblokir karena domain belum dimasukkan ke Allow List Meta. Biasanya muncul peringatan seperti:

If an error has been detected in the last 3 days it will appear here... Domain(s) recently started sending data. Confirm that they're yours by adding them to allowlist.

Solusi:

1. Buka Settings di Meta Events Manager.
2. Scroll ke bawah ke bagian Traffic Permissions.
3. Cek bagian Allow List.
4. Pilih domain Anda, lalu klik Add to Allow List.
5. Klik Confirm.

Setelah domain di-whitelist, event akan mulai masuk secara normal.

Next Steps

• Optimasi Event Match Quality (EMQ)
• Lihat Customer Journey