Mengatur Event WooCommerce Meta Pixel dan CAPI (LarisTurbo)

Daftar event browser dan server per halaman WooCommerce, pemetaan unpaid/paid purchase, deduplikasi event_id, dan kapan CAPI dikirim.

Tutorial ini melengkapi panduan dasar Meta Pixel & CAPI dan fokus ke bagian WooCommerce Integration di Meta Pixel & CAPI Integration → Settings.

Prasyarat: Pixel ID valid, Meta Pixel aktif, dan (untuk server) Conversion API dikonfigurasi di tutorial 01. Nonaktifkan plugin pixel Facebook lain agar event tidak dobel.

Bagian WooCommerce Integration

Deskripsi di admin:

You can customize the event for every WooCommerce page, just in case you run conversion with custom event. Other parameters (value, currency) will be populated automatically.

Setiap baris adalah field teks {Label} Event dengan placeholder nama event standar Meta.

Key internal	Label field	Event default	Halaman / pemicu
`search`	Product Search Event	`Search`	Shop dengan query pencarian
`shop`	Shop Page Event	`ViewCategory`	Shop, kategori, tag produk
`product`	Single Product Page Event	`ViewContent`	Halaman produk tunggal
`cart`	Cart Page Event	`AddToCart`	Halaman keranjang + AJAX add to cart (CAPI)
`checkout`	Checkout Page Event	`InitiateCheckout`	Halaman checkout
`purchase_pending`	Unpaid Purchase Event	`AddPaymentInfo`	Thank you / CAPI order belum lunas
`purchase`	Paid Purchase Event	`Purchase`	Thank you / CAPI order lunas

Kosongkan field = memakai default di kolom “Event default”. Isi nama custom jika kampanye memakai custom event Meta.

Parameter otomatis per konteks

Plugin mengisi custom_data tanpa input manual:

Konteks	Parameter utama
Produk	`value`, `currency`, `content_ids` (prefix `wc_` + parent product ID), `content_type: product`
Keranjang / checkout	`value`, `currency`, `content_ids`, `variation_ids` jika ada
Order (thank you / CAPI)	`order_id`, `value`, `currency`, `content_ids` dari line items

user_data di browser diisi dari customer session checkout jika tersedia (email, nama, telepon, alamat).

Event browser (pixel) per halaman

Kondisi	Event
`is_shop()` / kategori / tag	Shop Page Event; jika `is_search()` → Product Search Event + `content_category` / `content_name`
`is_product()`	Single Product Page Event
`is_cart()`	Cart Page Event + `event_id` persisten session `lt_meta_cart_event_id`
`is_checkout()`	Checkout Page Event + `event_id` session `lt_meta_checkout_event_id`
Thank you (≤ 48 jam sejak order dibuat)	Unpaid atau Paid Purchase Event + `event_id` dari meta order

Setelah thank you, session cart/checkout event ID di-clear (clear_event_ids).

Event server (CAPI) dan status order

CAPI hanya jika Conversion API enabled dan pixel + access token terisi.

Kapan dikirim

Pemicu	Event status	Nama event
`woocommerce_checkout_order_created`	`unpaid`	Unpaid Purchase Event
`woocommerce_store_api_checkout_order_processed`	`unpaid`	Sama (block checkout)
`woocommerce_order_status_changed`	`paid` atau `unpaid`	Sesuai pemetaan status
AJAX add to cart	—	Cart Page Event (server-side)

Order dibuat via admin atau REST API tidak memicu CAPI otomatis pada create (menghindari order manual).

Pemetaan paid vs unpaid

Status order	Payment	Event status
`completed`	apa pun	`paid` → Paid Purchase Event
`processing`	bukan COD	`paid`
`processing`	COD (`cod` di method)	`unpaid`
`pending`, `on-hold`, `processing-cod`	—	`unpaid` → Unpaid Purchase Event

Perubahan status memicu kirim ulang ke status yang relevan; history per pixel disimpan di meta order _lt_meta_capi_history.

Deduplikasi browser + server

Saat order dibuat, plugin menyimpan di meta _lt_meta_capi_data:

event_ids.unpaid dan event_ids.paid (unik per order)
user_data dari billing order (+ _fbp / _fbc cookie jika tersedia saat checkout)
custom_data dari total dan produk

Thank you page mem-fire pixel dengan event_id yang sama agar Meta bisa deduplicate dengan CAPI.

content_ids memakai prefix wc_ (misalnya wc_123) untuk katalog Meta.

Buka LarisTurbo → For Integrations → Meta Pixel & CAPI Integration → Settings.
Pastikan pixel dan CAPI dasar sudah benar (tutorial 01).
Scroll ke WooCommerce Integration; biarkan default kecuali Anda memang memakai custom event di Ads Manager.
Buat order uji BACS (unpaid) → cek Events Manager: AddPaymentInfo / custom unpaid.
Ubah order ke Processing atau Completed → cek Purchase.
Bandingkan event_id di browser (Meta Pixel Helper) dengan log CAPI di kolom order admin.