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.

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

MacroDeskripsiContoh
{{campaign.name}}Nama CampaignPromo_Lebaran
{{adset.name}}Nama Ad SetJawa_Bali_25-50
{{ad.name}}Nama IklanVideo_Testimoni_1
{{placement}}Penempatan IklanInstagram_Stories
{{site_source_name}}Sumber Platformfb, ig, an, msg

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)

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 LeadEvent Meta
newLead
qualifiedInitiateCheckout
wonPurchase
resubscribedSubscribe
Agar event CAPI match dengan user Facebook, kami mengirimkan data user yang di-hash (SHA256) seperti Email (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:

  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

Butuh Bantuan Lebih Lanjut?

Tim kami siap membantu Anda memaksimalkan tracking iklan dan atribusi bisnis.

© 2026 Konektor. Seluruh hak cipta dilindungi.