Cara Mengatur Meta Pixel & CAPI di WordPress (LarisTurbo)
Panduan lengkap Meta Pixel & CAPI Integration: mengaktifkan pixel browser-side dan server-side Conversion API, hingga 5 Pixel ID, event WooCommerce otomatis, dan pengaturan lanjutan.
Meta Pixel & CAPI Integration memasang Meta Pixel (Facebook Pixel) di situs WordPress Anda tanpa plugin tambahan, termasuk dukungan server-side Conversion API (CAPI) untuk pelacakan konversi yang lebih andal. Saat WooCommerce aktif, fitur ini juga mengirim event standar (view produk, add to cart, checkout, purchase) secara otomatis.
Tutorial ini membahas cara mengaktifkan fitur, mengisi Pixel ID dan token CAPI, memahami opsi di layar Settings, serta memverifikasi pixel sudah berjalan. Nama field mengikuti label asli di plugin (bahasa Inggris).
Yang dilakukan fitur ini
Setelah aktif, LarisTurbo:
- Memuat script Meta Pixel di
<head>dan fallback<noscript>di footer (kecuali Anda menonaktifkannya) - Mengirim event PageView di setiap halaman frontend
- Jika WooCommerce aktif, mengirim event e-commerce otomatis (shop, produk, keranjang, checkout, thank you) dengan value dan currency terisi dari data toko
- Mengirim event CAPI ke server Meta jika Conversion API Access Token diisi untuk Pixel ID terkait
- Mendukung hingga 5 Meta Pixel ID berbeda di satu situs
Prasyarat
- Plugin LarisTurbo For WooCommerce by TokoPressID terpasang dan lisensi aktif
- Sudah punya Pixel ID dari Meta Events Manager
- (Opsional, untuk CAPI) Conversion API Access Token dari Meta Events Manager
- Untuk event WooCommerce otomatis: WooCommerce aktif
- Tidak ada plugin pixel Meta pihak ketiga yang aktif bersamaan (lihat bagian konflik di bawah)
Cara membuka pengaturan
- Login ke WordPress Admin.
- Buka LarisTurbo → For Integrations.
- Buka Meta Pixel & CAPI Integration, lalu klik Settings.
Opsi detail muncul setelah Enable Meta Pixel Integration dicentang.
Opsi yang tersedia
Aktivasi
| Label di plugin | Jenis | Fungsi |
|---|---|---|
| Enable Meta Pixel Integration | Checkbox | Menyalakan seluruh integrasi Meta Pixel dan CAPI |
Deskripsi di plugin: mendukung hingga 5 Meta Pixel ID berbeda untuk semua halaman situs.
Meta Pixel #1 sampai #5
Setiap blok Meta Pixel #N berisi:
| Label di plugin | Jenis | Fungsi |
|---|---|---|
| Pixel ID | Teks | ID pixel Meta (contoh: 123456789012345) |
| Conversion API Access Token | Textarea | Token CAPI server-side. Opsional — wajib diisi jika ingin CAPI aktif untuk pixel ini |
| Testing Code | Teks | Kode uji CAPI. Opsional — hanya untuk fase testing implementasi CAPI |
Catatan dari deskripsi plugin (muncul di Meta Pixel #1):
- CAPI bersifat opsional; isi token hanya jika Anda ingin pelacakan server-side
- IMPORTANT! Meta CAPI membutuhkan hosting/server yang baik untuk hasil dan performa terbaik
Advanced Settings
| Label di plugin | Jenis | Fungsi |
|---|---|---|
| Disable Meta Pixel <noscript> code | Checkbox | Menonaktifkan tag fallback <noscript> di footer. Berguna jika Anda ingin sedikit mengurangi beban halaman |
WooCommerce Integration
Bagian ini muncul jika WooCommerce aktif. Anda bisa mengganti nama event per halaman WooCommerce (placeholder menunjukkan default Meta):
| Label di plugin | Event default (placeholder) | Halaman / kondisi |
|---|---|---|
| Product Search Event | Search |
Pencarian produk di shop |
| Shop Page Event | ViewCategory |
Halaman shop, kategori, atau tag produk |
| Single Product Page Event | ViewContent |
Halaman produk tunggal |
| Cart Page Event | AddToCart |
Halaman keranjang |
| Checkout Page Event | InitiateCheckout |
Halaman checkout |
| Unpaid Purchase Event | AddPaymentInfo |
Order belum lunas (pending, on-hold, COD processing) |
| Paid Purchase Event | Purchase |
Order lunas (completed, atau processing non-COD) |
Kosongkan field = plugin memakai nama default di placeholder. Value, currency, dan content_ids produk diisi otomatis dari data WooCommerce.
Detail event per halaman dan alur CAPI order dibahas di tutorial lanjutan:
Langkah-langkah setup
1. Pastikan tidak ada konflik plugin
Jika plugin pixel Meta lain sudah aktif (misalnya PixelYourSite, Facebook for WooCommerce, Pixel Cat), LarisTurbo menampilkan pesan peringatan dan Enable Meta Pixel Integration tidak bisa digunakan. Nonaktifkan plugin tersebut terlebih dahulu, atau gunakan plugin itu untuk mengelola pixel.
2. Aktifkan dan isi Pixel ID
- Buka Settings Meta Pixel & CAPI Integration.
- Centang Enable Meta Pixel Integration.
- Di Meta Pixel #1, isi Pixel ID dari Meta Events Manager.
- (Opsional) Tambahkan pixel kedua, ketiga, dst. di Meta Pixel #2–#5 jika Anda menjalankan beberapa akun iklan.
- Simpan pengaturan.
3. (Opsional) Aktifkan CAPI
- Di Meta Pixel #1 (atau pixel lain), tempel Conversion API Access Token dari Events Manager.
- Saat testing, isi Testing Code lalu verifikasi di tab Test Events Meta.
- Hapus Testing Code setelah implementasi dinyatakan benar.
- Simpan pengaturan.
CAPI otomatis mengirim event saat order dibuat dan saat status order berubah (misalnya dari pending ke processing/completed). Riwayat pengiriman bisa dicek di admin order (kolom [LT] CAPI).
4. Sesuaikan event WooCommerce (opsional)
Jika kampanye Anda memakai custom event name, ubah field di bagian WooCommerce Integration (misalnya ganti Paid Purchase Event dari Purchase ke nama custom). Biarkan kosong jika standar Meta sudah cukup.
5. Verifikasi di Meta
- Instal ekstensi browser Meta Pixel Helper (Chrome).
- Buka halaman depan toko — seharusnya terdeteksi PageView.
- Buka halaman produk — seharusnya terdeteksi event produk (default ViewContent).
- Jika CAPI aktif, buka Events Manager → Test Events dan lakukan order uji.
Troubleshooting
Checkbox Enable tidak bisa dicentang / ada pesan plugin aktif
- Nonaktifkan plugin pixel Meta lain yang terdeteksi di pesan peringatan
- Plugin yang dikenali antara lain: PixelYourSite, Facebook for WooCommerce, Meta pixel for WordPress, Kliken, Pixel Cat, Pixel Manager for WooCommerce, Pixel Tag Manager for WooCommerce
Pixel Helper tidak mendeteksi pixel
- Pastikan Enable Meta Pixel Integration tersimpan dan lisensi LarisTurbo aktif
- Pastikan Pixel ID terisi minimal di Meta Pixel #1
- Coba nonaktifkan plugin cache/optimasi yang memblokir script di
<head> - Pastikan tidak ada duplikasi pixel dari tema atau plugin lain
CAPI tidak mengirim event
- Pastikan Conversion API Access Token terisi untuk Pixel ID yang sama
- CAPI membutuhkan data order lengkap (email, nama, dll.) — order dari admin tanpa data pelanggan bisa gagal
- Cek kolom [LT] CAPI di daftar order atau metabox Meta CAPI di detail order
- Hosting lambat atau firewall bisa memblokir request keluar ke API Meta
Event Purchase tidak muncul di thank you
- Halaman thank you hanya memuat event browser dalam 48 jam setelah order dibuat (proteksi reload lama)
- Status order harus masuk kategori unpaid atau paid sesuai mapping plugin (bukan cancelled/refunded)
- Lihat tutorial event WooCommerce untuk detail status order
Ingin mematikan tag noscript
- Centang Disable Meta Pixel <noscript> code di Advanced Settings
Ringkasan
Alur paling umum: Enable Meta Pixel Integration → isi Pixel ID → (opsional) token CAPI → simpan → verifikasi dengan Pixel Helper. WooCommerce menambahkan event otomatis tanpa konfigurasi tambahan; ubah nama event hanya jika kampanye Anda memerlukannya.