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.

Ringkasan event, syarat, dan batas pengiriman ke Meta ada di software tracking iklan Meta.

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. Salin ID-nya dari kolom Dataset ID.
3. Masuk ke tab Settings.
4. Gulir ke bagian Conversions API, lalu ke Set up direct integration.
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. Masuk ke dashboard Konektor.
2. Buka Pelacakan & Iklan > Tracking Website.
3. Klik Tambah platform iklan.
4. Pada pertanyaan Iklan Anda tampil di mana?, pilih Meta Ads (Facebook dan Instagram).
5. Isi Nama Pixel, misalnya Pixel Utama.
6. Isi Meta Pixel ID dengan angka saja. Test Event Code bukan Pixel ID.
7. Tempel token yang tadi Anda salin ke kolom Access Token.
8. Klik Simpan. Status Menunggu tampil sampai event nyata pertama dari website atau chat iklan masuk.
9. Untuk menguji sekarang, buka menu baris Meta, lalu pilih Uji kirim. Tempel Kode event uji (Test Event Code) dari Meta Events Manager > Test events. Kode ini wajib untuk Meta. Lalu klik Kirim uji. Hasilnya tampil sebagai Uji berhasil, bukan Sehat. Sehat muncul setelah event nyata masuk.

Kenapa Pixel ID saya ditolak?

Satu Pixel ID hanya boleh ada di satu workspace. Konektor menolak Pixel ID yang sudah dipakai di tempat lain. Pesannya menunjukkan salah satu dari tiga kasus ini:

• Sudah ada di workspace ini: ubah pixel yang sudah ada di daftar. Jangan tambah dua kali.
• Ada di workspace lain milik Anda: Konektor menawarkan Pindahkan ke workspace ini. Setelah pindah, workspace lama berhenti mengirim konversi ke pixel itu. Jika website memakai kode tracking, ganti dengan kode dari workspace ini. Untuk memindahkan, pakai Tambah platform iklan.
• Ada di workspace orang lain: minta pemilik workspace itu menghapus pixel tersebut, atau kirim tiket di Bantuan > Tiket Saya.

Apa arti status Menunggu di Tracking Website?

Status Menunggu berarti pixel menyala, tetapi dalam 7 hari terakhir belum ada event nyata yang masuk dan belum ada uji kirim yang berhasil. Status ini normal tepat setelah Anda menyimpan pixel.

• Kirim event nyata dari website atau dari chat iklan, atau pakai Uji kirim di menu baris Meta.
• Uji kirim yang berhasil mengubah status menjadi Uji berhasil.
• Status Sehat muncul setelah event nyata masuk dalam 7 hari terakhir.

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 Access Token.

Hubungkan nomor WhatsApp yang menerima lead. Buka Koneksi > Nomor & CTWA, pilih Siapkan CTWA atau Kelola CTWA, isi WABA ID, lalu klik Login dengan Meta. Ikuti panduan Meta CTWA untuk langkah lengkap. Beda jalur chat dan jalur website dijelaskan di software CAPI WhatsApp.

Jika Log pengiriman menampilkan CTWA cadangan, periksa koneksi pada Koneksi > Nomor & CTWA > 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

• Siapkan Meta CTWA dengan Login Meta
• Optimasi Event Match Quality (EMQ)
• Lihat Customer Journey