> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kawan.digital/llms.txt
> Use this file to discover all available pages before exploring further.

# Meta Pixel & Conversions API

> Lacak pengunjung toko dan konversi pembelian ke Meta Ads — lewat browser Pixel, server CAPI, atau keduanya.

Fitur Meta Pixel tersedia di paket yang menyertakan integrasi Meta. Kelola di [Dashboard → Pengaturan → Integrasi](https://kawan.digital/dashboard/settings/integrations).

## Apa itu Meta Pixel dan CAPI?

* **Meta Pixel (browser)** — skrip di halaman toko / landing page / checkout yang mengirim event dari browser pembeli ke Meta (contoh: lihat produk, keranjang, checkout, pembelian).
* **Conversions API / CAPI (server)** — event yang sama dikirim dari server Kawan Digital ke Meta. Lebih andal saat browser memblokir cookie atau pembeli menutup tab cepat.

Keduanya memakai **Pixel ID** yang sama dari Meta Events Manager. Kalau CAPI token diisi, event browser dan server memakai **ID event yang sama** agar Meta bisa mendeteksi duplikat dan tidak menghitung dua kali untuk satu aksi.

## Cara kerja di Kawan Digital

1. Anda menambahkan satu atau lebih Pixel ID di Integrasi (opsional: access token CAPI + test event code).
2. Di toko publik, Kawan Digital memuat Pixel untuk semua pixel **aktif**.
3. Event dari browser (PageView, ViewContent, AddToCart, AddPaymentInfo) dikirim lewat Pixel, dan — jika ada token — juga diantrekan ke CAPI.
4. **InitiateCheckout** (order dibuat) dan **Purchase** (order lunas) dikirim CAPI dari server. Browser juga mengirim event yang sama dengan ID `initiate:{order_id}` / `purchase:{order_id}` agar Meta bisa dedupe.

## Pixel saja vs Pixel + CAPI

| Pengaturan                  | Browser Pixel | Server CAPI              |
| --------------------------- | ------------- | ------------------------ |
| Pixel ID aktif, tanpa token | Ya            | Tidak                    |
| Pixel ID aktif + CAPI token | Ya            | Ya (dedupe via event ID) |
| Pixel nonaktif              | Tidak         | Tidak                    |

**Primary** hanya menandai pixel utama di profil toko (referensi default). Event tetap dikirim ke *semua* pixel yang aktif (dan ke CAPI untuk yang punya token).

## 1. Siapkan di Meta

1. Buka [Meta Events Manager](https://business.facebook.com/events_manager).
2. Buat atau pilih Pixel; salin **Pixel ID**.
3. (Disarankan) Buat **Conversions API** access token untuk pixel yang sama, lalu salin tokennya.
4. (Opsional) Ambil **Test Event Code** dari tab Test Events untuk uji sebelum iklan live.

## 2. Pasang di dashboard

1. Buka [Pengaturan → Integrasi](https://kawan.digital/dashboard/settings/integrations).
2. Isi Pixel ID. Token CAPI opsional — tanpa token = Pixel browser saja; dengan token = Pixel + CAPI.
3. Simpan, pastikan status **Aktif**.
4. Jika ada beberapa pixel, pilih mana yang **Primary** (untuk referensi toko).
5. Atur event yang dikirim (semua aktif, atau hanya atas funnel jika kategori bisnis Meta membatasi event tengah–bawah) dan sumber nilai konversi — pengaturan ini **per pixel**.

## 3. Event yang dilacak

| Kapan                                                  | Event Meta       |
| ------------------------------------------------------ | ---------------- |
| Buka halaman toko / LP (bukan funnel checkout)         | PageView         |
| Lihat detail produk / bundle                           | ViewContent      |
| Tambah ke keranjang / buka checkout / pilih item di LP | AddToCart        |
| Isi data pembeli + pilih metode bayar                  | AddPaymentInfo   |
| Order dibuat (menunggu bayar / gratis)                 | InitiateCheckout |
| Order lunas                                            | Purchase         |

Nilai Purchase dan InitiateCheckout bisa dipilih per pixel:

* **Subtotal produk** (default) — harga item, tanpa biaya gateway / kode unik.
* **Total dibayar pembeli** (`amount`) — termasuk biaya gateway jika ditanggung pembeli dan kode unik transfer ke rekening seller.
* **Bersih seller** (`seller_amount`) — setelah potongan platform (dan gateway jika ditanggung seller).

Event yang dimatikan tidak dikirim lewat Pixel maupun CAPI. ID event Purchase / InitiateCheckout mengikuti ID order di Kawan Digital agar unik per transaksi.

## 4. Uji event

1. Di Integrasi, isi Test Event Code dari Events Manager (opsional tapi berguna untuk CAPI).
2. Buka toko / landing page, lakukan alur beli (bisa produk Rp 0 jika ada).
3. Di Meta → Events Manager → Test Events / Overview, pastikan event muncul. Untuk pixel + CAPI, browser dan server dengan event ID sama biasanya digabung (deduplicated).

## Tips agar angka iklan tidak “dobel”

* Satu akun Ads idealnya mengoptimasi ke **satu Pixel ID** utama. Beberapa pixel aktif = beberapa aliran event (satu order bisa terlihat di tiap pixel).
* Jangan pasang Pixel Meta manual lagi di HTML landing page Kawan Digital — sudah otomatis dari Integrasi.
* Pastikan domain toko / custom domain / subdomain sudah diverifikasi di Meta sesuai domain yang dipakai di iklan.
* Bandingkan Purchase di Events Manager dengan order `paid` di dashboard untuk satu periode yang sama.

## Lanjut

* Setup toko & produk: [Mulai jualan](/mulai)
* Integrasi sistem eksternal: [Integrasi API](/integrasi)
* Bantuan: [Kontak](https://kawan.digital/kontak)