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.

Daftar Makro Dinamis Meta

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:

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.

Kenapa event saya tidak muncul di Events Manager?

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.

Kenapa event kustom saya berstatus Blocked by Meta?

Event dengan nama buatan sendiri, misalnya SpamLead dari class k-event-SpamLead, bisa ditahan Meta sampai pemilik bisnis mengonfirmasinya. Selama ditahan, event itu belum bisa dipakai untuk custom conversion, custom audience, maupun optimasi iklan. Event standar seperti Lead atau Purchase tidak terkena aturan ini.

Syarat: akun Facebook Anda punya akses penuh ke pixel tersebut di Business Manager pemiliknya.

Solusi:

1. Buka Meta Events Manager, lalu klik Datasets di menu kiri.
2. Pilih pixel Anda, lalu buka tab Settings.
3. Gulir ke bagian Data restrictions. Di bawah Manage event blocking, klik Review.
4. Jika muncul jendela Acknowledge to continue, baca isinya lalu klik I acknowledge. Anda menyatakan hanya mengirim data yang sesuai aturan Meta: tanpa data kesehatan, keuangan, atau data sensitif lain, termasuk pada nama event.
5. Di tab Action required, centang nama event yang Anda kenali, lalu klik Next.
6. Periksa nama event dan nama pixel di jendela Event details. Pilih Confirm the custom event, lalu klik Confirm.
7. Klik Done. Event pindah ke tab Confirmed dengan status Confirmed by you.

Catatan:

• Nama tombol di atas memakai bahasa Inggris. Jika Facebook Anda berbahasa Indonesia, letak menunya sama.
• Proses ini tidak meminta kategori event. Cukup pilih Confirm the custom event.
• Tulisan Inactive di bawah nama event berarti event itu belum diterima lagi belakangan ini. Statusnya berubah sendiri setelah event masuk lagi.
• Salah memblokir event? Buka tab Blocked, buka detail event tersebut, lalu ajukan review ke Meta.
• Tombol tidak bisa diklik berarti akses Anda ke pixel belum cukup. Minta admin Business Manager menambahkan akses penuh ke pixel itu.

Apakah event standar juga perlu dikonfirmasi?

Tidak. Aturan itu hanya berlaku untuk nama event buatan sendiri. Event standar seperti Lead, Contact, dan Purchase sudah dikenal Meta, jadi langsung bisa dipakai untuk custom conversion dan optimasi iklan.

Apa bedanya event kustom dan custom conversion?

Event kustom adalah nama kejadian yang dikirim sistem Anda. Custom conversion adalah aturan yang Anda susun di atas event itu, misalnya hanya menghitung Lead yang datang dari satu halaman. Satu event bisa dipakai oleh banyak custom conversion, dan aturan itu baru bisa dibuat setelah eventnya tidak lagi ditahan.

Next Steps

• Hubungkan Meta CTWA dengan Token App Meta
• Optimasi Event Match Quality (EMQ)
• Lihat Customer Journey