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:
- Ad Blockers: Extension seperti uBlock Origin memblokir pixel.
- Browser Privacy: Safari (ITP) dan Firefox membatasi masa hidup cookie.
- Koneksi Tidak Stabil: Loading page yang lambat bisa gagal memicu pixel.
- iOS14+: Tracking Transparency (ATT) mempersulit tracking app/web.
CAPI mengirim event dari server sehingga lebih tahan terhadap pembatasan browser. Hasil aktual bergantung pada kualitas data, konfigurasi, dan kebijakan Meta.
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.
Catatan Penting
Jika Anda mengisi kolom URL Parameters di Meta Ads, jangan tambahkan tanda tanya (?). Meta akan menambahkannya otomatis.
Daftar Makro Dinamis Meta
| Macro | Deskripsi | Contoh |
|---|---|---|
{{campaign.name}} | Nama Campaign | Promo_Lebaran |
{{adset.name}} | Nama Ad Set | Jawa_Bali_25-50 |
{{ad.name}} | Nama Iklan | Video_Testimoni_1 |
{{placement}} | Penempatan Iklan | Instagram_Stories |
{{site_source_name}} | Sumber Platform | fb, ig, an, msg |
Cara Mengambil Token CAPI
- Buka Meta Events Manager.
- Pilih Pixel yang ingin digunakan.
- Masuk ke tab Settings.
- Scroll ke bawah hingga bagian Conversions API.
- Klik Generate Access Token.
- PENTING: Copy dan simpan token ini di tempat aman (Notepad/Password Manager). Meta tidak akan menampilkan token ini lagi.
Integrasi di Konektor
- Login ke Dashboard Konektor.
- Masuk ke menu Settings > Pixel & Tracking.
- Pilih Meta / Facebook.
- Masukkan Pixel ID Anda.
- Paste Access Token yang tadi dicopy ke kolom CAPI Access Token.
- Klik Test Connection untuk memastikan koneksi berhasil.
- Klik Save.
Setup untuk Iklan Click-to-WhatsApp (CTWA)
CTWA memakai dataset WABA dan izin yang berbeda dari token CAPI untuk Pixel website. Jangan tempel token CTWA ke kolom CAPI Access Token.
Simpan Session WhatsApp yang menerima lead. Pilih Siapkan CTWA atau Kelola CTWA, lalu isi WABA ID dan pilih metode koneksi pada modal CTWA. Ikuti panduan koneksi Meta CTWA dengan Token App Meta untuk langkah lengkap dan cara menjaga token.
Jika Log Sinkronisasi menampilkan CTWA fallback, periksa koneksi pada WhatsApp > Sessions > Kelola CTWA. Jalankan Periksa koneksi, lalu buat satu konversi baru. Penerimaan event oleh Meta tidak menjamin Ads Manager akan melaporkan atau mengatribusikannya.
Data Apa yang Dikirim?
Konektor secara otomatis mengirim event standar berikut sesuai status lead:
| Status Lead | Event Meta |
|---|---|
new | Lead |
qualified | InitiateCheckout |
won | Purchase |
resubscribed | Subscribe |
em), No HP (ph), Nama Depan (fn), dan Kota (ct).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:
- Buka Settings di Meta Events Manager.
- Scroll ke bawah ke bagian Traffic Permissions.
- Cek bagian Allow List.
- Pilih domain Anda, lalu klik Add to Allow List.
- Klik Confirm.
Setelah domain di-whitelist, event akan mulai masuk secara normal.
Next Steps
Butuh Bantuan Lebih Lanjut?
Tim kami siap membantu Anda memaksimalkan tracking iklan dan atribusi bisnis.
Coba atau lanjutkan
© 2026 Konektor. Seluruh hak cipta dilindungi.
