Kolom [LT] CAPI dan Metabox Meta CAPI di Order (LarisTurbo)

Cara membaca status CAPI di daftar order WooCommerce dan HPOS, mengirim ulang Purchase manual, serta memeriksa parameter User Data dan Custom Data.

Tutorial ini melengkapi Mengatur Event WooCommerce Meta Pixel dan fokus pada antarmuka admin order: kolom [LT] CAPI dan metabox LarisTurbo: Meta CAPI.

Fitur admin ini hanya muncul jika Meta Conversion API aktif di pengaturan Meta Pixel.

Di mana UI muncul?

Tidak ada pengaturan tambahan di Settings untuk menampilkan kolom; otomatis saat CAPI aktif.

Kolom [LT] CAPI (daftar order)

Kolom disisipkan setelah Status.

Setiap Pixel ID yang dikonfigurasi (Meta Pixel bisa multi-pixel) punya satu ikon dashicons:

Kirim ulang dari daftar order

Jika ada ikon clock/dismiss yang bisa dikirim ulang, seluruh sel kolom bisa diklik (class lt-trigger-purchase-capi-list, title Click to send Purchase event to Meta CAPI).

1. Klik ikon di kolom [LT] CAPI.
2. Konfirmasi dialog: Are you sure you want to send Purchase event to Meta CAPI for this order?
3. AJAX laristurbo_wc_manual_trigger_purchase_capi mengirim event paid (Purchase).
4. Sukses → ikon berubah hijau; gagal → alert pesan error.

Hanya user dengan kapabilitas edit_shop_orders yang boleh memicu.

Metabox LarisTurbo: Meta CAPI

Judul metabox: LarisTurbo: Meta CAPI (side, default priority).

Ringkasan per Pixel ID

Untuk setiap pixel dengan Pixel ID + access token:

Pixel ID: 1234567890
✓ Purchase event sent
2026-06-25 14:30:00
(2 hours ago)

Status alternatif:

• Purchase event failed + pesan error API
• Purchase event not sent

Jika gagal atau belum terkirim, tombol Send Purchase Event Now (#lt-trigger-purchase-capi-edit) muncul. Klik → konfirmasi → AJAX sama seperti kolom daftar → area #lt-capi-result menampilkan sukses/gagal → reload setelah ~2 detik jika sukses.

Show CAPI Data Parameters

Tombol Show CAPI Data Parameters menampilkan data mentah dari meta order _lt_meta_capi_data:

User Data (contoh key): em, fn, ln, ph, ct, st, zp, country, client_ip_address, client_user_agent, fbp, fbc

Custom Data: order_id, value, currency, content_type, content_ids, variation_ids

Nilai di metabox = pra-hash untuk debugging internal. Saat dikirim ke Meta, field PII (em, ph, dll.) di-hash SHA-256 lowercase.

Jika meta kosong: pesan Invalid CAPI Data (order dibuat sebelum integrasi atau data tidak terbentuk).

History pengiriman

Setiap attempt CAPI per pixel dan per status (unpaid / paid) disimpan di _lt_meta_capi_history:

• success (boolean)
• message (respons API)
• timestamp (unix)

Metabox fokus menampilkan status paid / Purchase; history unpaid ada di meta tetapi UI utama menekankan konversi Purchase.

Alur debugging order tunggal

1. Buka order di admin setelah checkout uji.
2. Lihat kolom [LT] CAPI di daftar—cepat scan semua pixel.
3. Buka order → metabox LarisTurbo: Meta CAPI.
4. Jika merah, baca pesan error (token, test event, dll.).
5. Klik Show CAPI Data Parameters—pastikan value, currency, content_ids masuk akal.
6. Jika perlu, Send Purchase Event Now (hanya jika belum hijau).
7. Verifikasi di Meta Events Manager dengan Test Events atau test_event_code dari Settings.

HPOS

Hook manage_woocommerce_page_wc-orders_columns dan manage_woocommerce_page_wc-orders_custom_column memastikan kolom dan konten sama antara legacy post order dan HPOS.

Script admin (order_capi_scripts) dimuat di screen:

• edit-shop_order
• shop_order
• woocommerce_page_wc-orders

Batasan

• Tombol manual selalu mengirim event status paid (Purchase), bukan unpaid.
• Jika Purchase sudah sukses untuk semua pixel, tombol manual disembunyikan / AJAX menolak “Purchase event already sent”.
• Order status pending, on-hold, failed, cancelled, refunded, checkout-draft menampilkan ikon minus (tidak dianggap siap Purchase di list).