Cara Setting Conversions API Meta: Pilih Jalur, Buat Token, Lalu Cek Event

01Jalur setup Conversions API Meta dan cara memilihnya

Setup Conversions API Meta (CAPI) bisa ditempuh lewat beberapa jalur, dan jalur yang Anda pilih menentukan hampir semua langkah sesudahnya. Per 14 Oktober 2026, halaman perbandingan di Pusat Bantuan Meta menyebut tiga kelompok: setup bawaan Meta, integrasi langsung dengan kode, dan integrasi partner. Halaman lain menjelaskan Conversions API Gateway sebagai opsi tanpa kode. Tabel ini merangkum keempatnya.

Setup bawaan dan Gateway ditujukan untuk event web dari bisnis yang sudah memakai Pixel. Chat masuk, lead berkualitas, dan closing di WhatsApp dicatat oleh sistem yang menerima chat, bukan oleh Pixel di browser, sehingga yang dibutuhkan adalah pengirim dari server dengan Pixel ID dan access token. Pilihannya menulis kodenya sendiri atau memakai alat yang menyusun dan mengirim payload untuk Anda. Dalekta termasuk yang kedua.

Event dari alat seperti itu tiba di edge /events milik Pixel Anda di Graph API, sama dengan integrasi langsung. Jadi langkah 1 sampai 6 di bawah berlaku untuk keduanya, dan bagian Dalekta di akhir merangkum apa yang dikerjakan Dalekta pada tiap langkah. Kalau sebagian penjualan Anda terjadi di luar website dan di luar chat, misalnya di toko fisik atau di aplikasi seluler, halaman perbandingan Meta menyebut integrasi langsung sebagai satu-satunya opsi untuk event aplikasi dan toko fisik lewat Conversions API. Halaman Meta lain, tentang event offline, menyebut integrasi partner tanpa kode dari sistem kasir atau CRM. Per 14 Oktober 2026 kedua halaman itu belum sejalan, jadi cek daftar partner di Events Manager Anda sebelum memutuskan. Bahasannya ada di offline conversion Meta.

02Langkah 1: siapkan Pixel ID dan hak akses

Sebelum event pertama, Conversions API meminta tiga hal: Pixel ID, Meta Business Suite, dan access token. Bila website Anda sudah memakai Meta Pixel, pakai Pixel ID yang sama untuk event browser dan event server. Di halaman bantuan terbaru Meta, sumber data ini juga disebut dataset.

• Buka Events Manager, pilih Pixel atau dataset yang dipakai campaign, lalu salin ID-nya. Bila belum ada, buat dulu.
• Pastikan akun Anda punya kontrol penuh atas business portfolio tempat Pixel itu berada, dan orang yang akan membuat token punya hak developer. Menurut Meta, tautan pembuat token disembunyikan dari pengguna tanpa hak itu.
• Catat event bisnis yang ingin dikirim. Mulai dari sedikit yang definisinya jelas. Definisi CAPI dan alasan memakainya ada di apa itu Meta CAPI.

03Langkah 2: buat access token Conversions API Meta

Access token dipasang sebagai parameter pada setiap permintaan ke Conversions API, dan cara yang direkomendasikan Meta adalah membuatnya langsung di Events Manager. Token itu adalah kunci yang mengizinkan server mengirim event ke Pixel Anda.

1. Di Events Manager, pilih Pixel yang akan dipakai.
2. Buka tab Settings.
3. Cari bagian Conversions API, klik tautan Generate access token di bawah Set up manually, lalu ikuti petunjuk di pop-up.
4. Salin token dan simpan di tempat aman. Anda memakainya di langkah 4, atau mengisikannya ke alat yang mengirim event untuk Anda.

Alternatifnya, bila Anda sudah punya app dan system user sendiri: buka pengaturan business, tetapkan Pixel ke system user, pilih system user itu, lalu klik Generate Token. Untuk kedua cara, Meta menyatakan app tidak perlu melewati App Review dan tidak perlu meminta izin tambahan.

04Langkah 3: tentukan event dan parameter yang dikirim

Tentukan event dan parameternya sebelum menulis atau mengisi apa pun. Events Manager punya panduan untuk ini: Anda memilih event dan parameter, lalu Meta membuatkan petunjuk personal yang bisa dikirim ke developer lewat email. Jalurnya di Datasets: pilih dataset, Add Events, Add new integration, Conversions API, Set up, lalu Set up manually. Minimal satu parameter customer information harus dipilih.

Dokumentasi developer Meta (dibaca 14 Oktober 2026) menetapkan aturan teknis berikut untuk setiap permintaan:

• Event website wajib membawa client_user_agent, action_source, dan event_source_url. Event non-web hanya wajib action_source. Nilai action_source harus akurat, karena dengan memakai API Anda menyatakan nilainya benar.
• event_time boleh sampai 7 hari sebelum waktu kirim. Satu event yang lebih tua membuat seluruh permintaan ditolak dan tidak ada event yang diproses.
• Satu permintaan memuat sampai 1.000 event, tetapi Meta menyarankan mengirim begitu kejadian terjadi, idealnya dalam satu jam.
• Kirim event_id di setiap event. Bila Meta menerima event_id dan event_name yang sama lebih dari sekali, hanya salinan pertama yang disimpan.
• Email, telepon, nama, kota, provinsi, kode pos, dan negara wajib di-hash SHA-256 setelah dinormalkan, sedangkan client_ip_address, client_user_agent, fbc, dan fbp tidak. Untuk external_id, hash dianjurkan. Aturan normalisasi tiap field ada di tabel kunci pencocokan offline conversion Meta.

Cara menyiapkan data pencocokan dibahas di advanced matching, dan cara membaca skornya di Event Match Quality Meta.

05Langkah 4: kirim event pertama

Event dikirim sebagai permintaan POST ke edge /events milik Pixel Anda di Graph API, dengan access token sebagai parameter. Nilai di dalam tanda kurung sudut adalah placeholder, dan <versi> diganti dengan versi Graph API yang didukung Meta saat Anda membaca ini.

POST https://graph.facebook.com/<versi>/<PIXEL_ID>/events?access_token=<TOKEN>
Content-Type: application/json

{
  "data": [
    {
      "event_name": "Lead",
      "event_time": 1790000000,
      "event_id": "<id-unik-event>",
      "action_source": "website",
      "event_source_url": "https://contoh.id/promo",
      "user_data": {
        "ph": ["<sha256 nomor telepon>"],
        "client_user_agent": "<user agent browser>"
      }
    }
  ],
  "test_event_code": "<kode dari tab Test Events>"
}

• test_event_code hanya untuk pengujian. Salin kodenya dari tab Test Events, dan hapus sebelum payload produksi.
• Event yang dikirim dengan test_event_code tidak dibuang. Menurut Meta, event itu tetap masuk ke Events Manager dan dipakai untuk targeting dan pengukuran iklan.
• Bila Anda memakai alat yang mengirim untuk Anda, langkah ini dikerjakan alatnya. Bentuknya tetap perlu dikenali supaya pesan error di log mudah dibaca.

06Langkah 5: cegah hitungan ganda bila Pixel ikut mengirim

Deduplikasi hanya perlu bila event yang sama dikirim dari Pixel dan dari server. Menurut Pusat Bantuan Meta, bila kedua sumber mengirim event yang berbeda, misalnya AddToCart dari browser dan Purchase dari server, tidak ada yang perlu dideduplikasi.

• Untuk event yang sama, event_name dan event_id harus identik di Pixel dan di server.
• Bila event_id tidak ada, Meta bisa memakai event_name bersama external_id atau fbp.
• Bila kedua event mirip, Meta lebih memilih event yang diterima lebih dulu.

Aturan paling aman untuk bisnis WhatsApp adalah membagi tugas: Pixel mengirim event halaman, server mengirim kejadian sesudah klik, sehingga event dari dua sumber memang berbeda. Penjelasan lengkap ada di deduplikasi event Pixel dan CAPI, dan perbandingan kedua jalur di Meta Pixel vs Conversions API.

07Langkah 6: verifikasi di Events Manager

Setelah event pertama terkirim, pastikan Meta menerimanya, lalu baca tab pemantauan secara berkala. Meta menyebut event umumnya bisa diverifikasi dalam 20 menit sejak Anda mulai mengirim.

1. Buka Events Manager, lalu Data sources, dan klik Pixel yang ID-nya sama dengan yang ada di permintaan Anda.
2. Buka Overview. Meta menampilkan jumlah event raw, matched, dan attributed, dan kolom Connection Method menunjukkan jalur pengirimannya.
3. Klik sebuah event untuk membuka rinciannya. Untuk event website lewat Conversions API, halaman pemantauan Meta menyebut tab yang dirangkum di tabel berikut.
4. Untuk menguji payload sendiri, buka Test Events dan kirim event dengan test_event_code. Aktivitas di jendela itu baru tampil setelah event dikirim dengan kode tersebut.

Meta menghitung Event coverage terhadap event browser unik dari Pixel, dan tab Event deduplication menunjukkan kunci deduplikasi yang dikirim. Keduanya dibuat untuk setup redundan, yaitu event yang sama dikirim lewat Pixel dan server. Bila hanya server yang mengirim sebuah event, seperti tahap chat WhatsApp, tidak ada event browser sebagai pembanding, jadi target 75 persen itu tidak berlaku untuk event tersebut.

08Mengirim tahap chat WhatsApp lewat Dalekta

Dalekta tidak memasang Meta Pixel di website Anda. Ia mengerjakan sisi server saja: menyusun event dari status lead, lalu mengirimnya ke Pixel ID Anda dengan access token yang Anda simpan. Langkah 1 dan 2 di Events Manager tetap Anda kerjakan sendiri. Selebihnya, urutan ini yang berjalan di Dalekta.

1. Ambil Pixel ID dan buat access token di Events Manager, seperti pada langkah 1 dan 2.
2. Buka Tracking Ads → Platform. Di kartu Meta Ads klik Hubungkan, atau Kelola bila Meta sudah terhubung. Isi Pixel ID dan Access Token, lalu simpan. Hanya owner dan admin workspace yang bisa mengubah koneksi ini.
3. Buka tab Event Mapping dan pilih event Meta untuk tiap tahap. Tombol Pakai rekomendasi mengisi Visit LP dengan ViewContent, Click CTA dengan Contact, Masuk WA dengan Lead, Prospek dengan Schedule, dan Closing dengan Purchase. MQL sengaja dikosongkan supaya satu orang tidak terkirim sebagai dua Lead. Klik Simpan Meta, karena tombol itu hanya mengisi di layar.
4. Pasang script dari tab Tracking Code di landing page, salin template dari tab UTM ke iklan, dan ganti tombol WhatsApp dengan link rotator. Detailnya ada di dokumentasi Tracking Ads.
5. Buat satu lead percobaan, ubah statusnya sampai tahap yang dipetakan, lalu baca Tracking → Event Logs.

Kolom Event Meta di Event Mapping hanya menerima standard event Meta, jadi nama event buatan sendiri tidak bisa disimpan. Bila Pixel di landing page Anda sudah mengirim ViewContent atau Contact, kosongkan Visit LP atau Click CTA di Event Mapping. Event Dalekta tidak memakai event_id yang sama dengan event Pixel, dan penggabungan cadangan Meta lewat fbp atau external_id tidak bisa Anda kendalikan. Tabel berikut mencocokkan bagian setup Meta di atas dengan yang dikerjakan Dalekta.

Lead dari iklan Click to WhatsApp tanpa landing page ikut terkirim bila tahapnya dipetakan, tetapi tanpa data klik website dan tanpa ctwa_clid, sehingga pencocokannya lebih lemah. Payload, data pencocokan yang di-hash, dan batas lengkapnya ada di pilar Meta CAPI untuk WhatsApp. Cara memakai tahap lead sebagai sinyal untuk memperbaiki kualitas lead dibahas di leads WhatsApp tidak berkualitas. Langkah di sisi Dalekta ada di dokumentasi Meta CAPI dan dokumentasi Event Mapping.

09Memeriksa event Dalekta: Event Logs dulu, lalu Events Manager

Event Dalekta tidak muncul di tab Test Events karena Dalekta tidak menambahkan test_event_code. Periksa lewat dua catatan: Event Logs untuk apa yang dikirim, dan Events Manager untuk apa yang diterima Meta.

1. Buka URL iklan percobaan yang membawa utm_source=meta, klik tombol WhatsApp rotator, lalu kirim pesan yang membawa kode [D-...] dari nomor WhatsApp lain.
2. Ubah status lead ke tahap yang dipetakan. Untuk Closing, isi nominal kecil yang mudah dikenali.
3. Buka Tracking → Event Logs dan sesuaikan rentang tanggalnya. Cari baris lead itu, lalu baca Event name, Event ID, Status, Attempts, dan Error. Success berarti Meta membalas sukses. Pada Failed, perbaiki penyebab di kolom Error, seperti token, Pixel ID, atau permission, baru pakai Retry.
4. Di Events Manager, buka Overview pada Pixel yang ID-nya sama dengan yang tersimpan di Dalekta, lalu cari nama event dari mapping Anda.

Success belum berarti event dicocokkan ke akun Meta dan dihitung sebagai hasil iklan. Itu dibaca terpisah, lewat tab Event matching dan Ads Manager. Urutan debug lengkapnya ada di dokumentasi Event Logs.

10Kesalahan setup dan cara memperbaikinya

Kalau Anda baru mulai, kirim dua atau tiga tahap yang definisinya paling jelas, baca Event Logs beberapa hari, lalu tambahkan tahap berikutnya.

11Bacaan lanjutan

12Pertanyaan umum