Daftar isi
ToggleTerakhir diperbarui pada 1 November 2026 pukul 11.21
Sebelum mengubah konfigurasi pelacakan, ikuti satu transaksi pelanggan yang catatannya dapat Anda temukan. Pesanan toko, peristiwa yang diterima Meta, dan pembelian yang diatribusikan ke iklan merupakan catatan berbeda. Panduan ini membantu menemukan peristiwa yang hilang atau ganda serta parameter pembelian yang keliru. Verifikasi perbaikannya tanpa menambah integrasi pengiriman data yang bisa bertumpang tindih dengan integrasi saat ini.
Ditinjau 1 November 2026. Pengaturan Meta dan platform bisa berubah. Mulailah dari panduan aset Meta jika kepemilikan atau koneksi belum jelas; lihat panduan pemula untuk dasar kampanye. Target Anda adalah mencatat satu pesanan uji dan menjelaskan apa yang terjadi pada setiap pengiriman data dengan bukti yang tersimpan.
1. Cari tahap yang bermasalah
“Meta melewatkan penjualan” belum menjelaskan penyebabnya. Catat pesanan, status pembayaran, waktu transaksi, dan mata uang. Lalu cari tahap pertama ketika datanya tidak lagi dapat ditelusuri. Jangan membangun ulang kampanye untuk memperbaiki permintaan browser yang hilang, atau memasang integrasi CAPI kedua hanya karena Pengelola Iklan mengatribusikan lebih sedikit pembelian daripada toko.
| Lapisan | Pertanyaan | Bukti |
|---|---|---|
| Toko | Apakah transaksi yang dimaksud terjadi? | Pesanan, status pembayaran, dan jumlah yang ditetapkan. |
| Pengiriman data | Apakah setiap integrasi yang seharusnya mengirim data benar-benar melakukannya? | Permintaan browser atau respons server dan log. |
| Parameter | Apakah peristiwa menjelaskan tindakan itu dengan benar? | Nama, waktu, ID, nilai, mata uang, dan item. |
| Deduplikasi | Apakah salinan browser dan server dikenali sebagai pembelian yang sama? | Kunci yang cocok dan diagnostik Meta. |
| Pencocokan | Dapatkah pengenal yang diizinkan menghubungkan peristiwa dengan seseorang? | Parameter informasi pelanggan yang tersedia dan diagnostik. |
| Atribusi | Apakah aturan laporan memberikan kredit kepada iklan? | Pengaturan atribusi pilihan, tanggal, dan definisi laporan. |
Panduan verifikasi Meta menjelaskan bahwa Ringkasan dapat menampilkan peristiwa diterima sebelum deduplikasi dan pemrosesan lain. Dua salinan diterima saja tidak membuktikan dua pembelian dihitung. Periksa detail dan metode koneksi. Tindakan yang sengaja hanya dikirim server tidak memiliki salinan browser untuk dipasangkan.
Pelatihan optimasi CAPI Meta memeriksa pencocokan, cakupan, deduplikasi, dan ketepatan waktu secara terpisah. Skor kualitas pencocokan yang tinggi tidak membuktikan bahwa pendapatan dan deduplikasi sudah benar, atau bahwa bisnis memperoleh laba.
2. Daftarkan jalur pengiriman data yang aktif sebelum mengubahnya
Daftarkan ID set data/piksel tujuan, pemilik, nama peristiwa, pengirim browser dan server, versi aplikasi atau plugin, ketergantungan persetujuan, dan uji berhasil terakhir. Sertakan kode tema, pengelola tag, piksel khusus, ekstensi checkout, aplikasi mitra, dan layanan server. Catat komponen yang bertanggung jawab atas Purchase; “terpasang” tidak membuktikan bahwa itulah satu-satunya implementasi aktif.
Jalur Shopify
Buka kanal resmi Facebook & Instagram dan periksa Pengaturan → Pengaturan berbagi data, piksel terhubung, serta konfigurasi peristiwa pelanggan. Dokumentasi berbagi data terkini Shopify membedakan Standard, Enhanced, dan Maximum; dua terakhir mencakup CAPI. Pengaturan dapat berbeda menurut riwayat pemasangan. Periksa juga piksel khusus dan kode lama tema atau pengelola tag; jangan memasang pengirim server lain hanya karena alat bantu browser tidak melihat peristiwa server.
Jalur WooCommerce
Catat ekstensi dan versi terpasang, aset terhubung, status pesanan, dan log relevan. Dokumentasi resmi Meta for WooCommerce menyatakan integrasi CAPI disertakan. Periksa apakah plugin piksel lain, cuplikan tema, atau pengelola tag juga mengirim Purchase. Bandingkan versi terpasang dengan dokumentasinya sendiri, bukan mengikuti menu Shopify.
Ekspor atau catat konfigurasi sebelum mengubahnya. Tunjuk seorang penanggung jawab uji dan tuliskan cara kembali ke pengaturan semula. Hapus hanya jalur pengiriman yang sudah terbukti berlebihan. Jika beberapa komponen dimatikan sekaligus, Anda akan sulit mengetahui perubahan mana yang memperbaiki masalah.

3. Periksa opsi 2026 sebelum memutuskan mengganti integrasi
Pengumuman Meta pada 15 April 2026 memperkenalkan opsi CAPI sederhana yang disediakan Meta dan menyatakan konfigurasi CAPI mitra atau khusus yang sudah ada tidak berubah. Secara terpisah, pengumuman itu menjelaskan peningkatan Pixel dengan pemberitahuan dan masa peninjauan 30 hari sebelum aktivasi. Keduanya pembaruan berbeda; pengumuman tidak membuktikan konfigurasi akun saat ini atau mewajibkan penggantian integrasi mitra yang berfungsi.
Periksa implementasi langsung. Kode resmi templat GTM Meta v2.0.9 yang ditinjau untuk panduan ini mencakup pilihan ikut serta CAPI dari Meta secara default dan menganggap nilai tidak terdefinisi sebagai ikut serta. Jadi versi dan pengaturan penting. Setelah pembaruan, periksa metode koneksi dan ID aktual; jangan menganggap opsi baru mati atau aktivasinya otomatis berkoordinasi dengan pengirim khusus.
4. Buat pesanan uji dan catat kondisinya
Gunakan prosedur uji yang didukung platform dan sesi browser baru dengan pilihan persetujuan dicatat. Uji checkout nyata memerlukan otorisasi serta prosedur penyedia pembayaran yang didukung. Jangan tempel token akses atau data pelanggan nyata ke dokumen pemecahan masalah publik.
| Kolom | Yang diharapkan dalam contoh ini | Bukti aktual yang disimpan |
|---|---|---|
| Referensi pesanan | DEMO-1042, status transaksi terkonfirmasi | Catatan toko dan zona waktu. |
| Transaksi pembelian Purchase | Satu pembelian, bukan setiap kali halaman konfirmasi dibuka | Pemicu dan waktu pembelian pertama kali terjadi. |
| ID peristiwa browser/server | Purchase dan demo-purchase-1042 | Pixel ID, kedua nama dan ID peristiwa. |
| Jumlah | 2 unit × 32.00 = 64.00 USD | Komponen yang termasuk dalam nilai pesanan dan parameter yang diterima. |
| Item | DEMO-TEE-BLU-M, jumlah 2 | Pengenal katalog aktual dan varian. |
| Konteks | Perangkat diketahui, versi integrasi, dan status persetujuan | Permintaan, respons, dan hasil diagnostik dengan data sensitif disamarkan. |
Contoh rekaan ini memakai nilai barang setelah diskon, tanpa pajak dan ongkos kirim, agar perbandingannya mudah diikuti. Tentukan komponen nilai yang benar untuk integrasi Anda sendiri; jangan memaksa semua platform mengikuti contoh ini atau cara GA4 menghitung nilai.
DEMO-1042 · Piksel / dataset yang samaPurchasedemo-purchase-104264.00 / USDPurchasedemo-purchase-104264.00 / USDeventIDevent_id5. Telusuri peristiwa yang hilang mulai dari pemicunya
Jika salinan browser hilang, periksa ID piksel terpublikasi, perilaku persetujuan, eksekusi piksel halaman atau aplikasi, pemicu pilihan, dan galat permintaan. Ekstensi membantu memeriksa peristiwa browser, tetapi tidak mengesahkan integrasi server. Bandingkan penerimaan dengan penolakan atau penarikan yang berlaku, tanpa mematikan kontrol privasi demi diagnostik hijau.
Jika salinan server hilang, ikuti pesanan ke antrean dan log integrasi. Periksa status pesanan yang diperlukan pemicu, ID piksel tujuan, kredensial dan izin, respons, serta status percobaan ulang. “Tidak ada galat di halaman terima kasih” tidak menjelaskan pekerjaan latar yang gagal. Samarkan kredensial dan kolom pribadi saat berbagi log.
Cari titik pertama pengiriman data yang gagal. Jika peristiwa tidak dibuat, perbaiki pemicunya. Jika validasi permintaan gagal, perbaiki kolom yang disebutkan dalam pesan kesalahan. Jika permintaan diterima tetapi peristiwa tidak terlihat, periksa dataset, rentang waktu, dan lingkungan uji atau produksi sebelum mengirim ulang secara massal.
6. Periksa duplikasi dengan membandingkan ID peristiwa
Dokumentasi deduplikasi Meta menjelaskan pencocokan nama dan ID sama ke piksel yang sama: eventID browser berpasangan dengan event_id server. Pengiriman terkait harus tiba dalam jendela 48 jam. Jangan menjadikan jendela itu keterlambatan rutin.
Pada pesanan fiktif, bandingkan kedua ID asli karakter demi karakter. Dua ID acak yang dibuat terpisah tidak menandai pembelian yang sama. Sebaliknya, memakai satu ID untuk pembelian berbeda bisa membuat peristiwa sah tidak dihitung. Buat atau ambil ID pembelian satu kali, lalu bagikan kepada integrasi yang mengirim salinan transaksi tersebut.
- Dua pengiriman browser: periksa tag ganda, peristiwa otomatis, kode khusus, dan pemuatan ulang konfirmasi.
- Dua pengiriman server: periksa aplikasi tumpang tindih, pemrosesan webhook, dan percobaan ulang.
- Browser ditambah server: bandingkan piksel, nama, ID, dan waktu sebelum menyatakan deduplikasi rusak.
| Pengamatan | Pemeriksaan berikutnya | Bukti perbaikan |
|---|---|---|
| Purchase tambahan muncul setelah halaman dimuat ulang | Apakah halaman konfirmasi membuat peristiwa pembelian baru, bukan mengenali pesanan yang sudah ada? | Membuka kembali halaman tidak menghasilkan transaksi pembelian baru. |
| ID browser dan server berbeda | Komponen mana yang membuat pengenal dan apakah komponen lain menerima nilai itu. | Kedua salinan memakai ID yang diharapkan; pesanan berikutnya memiliki ID berbeda. |
| Duplikasi dimulai setelah pembaruan aplikasi | Versi terpublikasi, metode koneksi, dan pengirim baru yang aktif. | Penanggung jawab setiap jalur pengiriman sudah jelas dan pengujian telah diulang. |
Metode cadangan dokumentasi dengan fbp dan/atau external_id memiliki batasan urutan. Utamakan rancangan ID bersama yang eksplisit saat mengendalikan integrasi; jangan menganggap semua payload berulang otomatis dideduplikasi.
7. Periksa nilai, mata uang, dan identitas item secara terpisah
Bandingkan nilai yang diterima dengan perhitungan pesanan yang dicatat: diskon, pajak, ongkos kirim, mata uang yang digunakan pelanggan, dan status pesanan saat peristiwa dipicu. Kesalahan yang umum adalah menganggap sen sebagai satuan utama, mengirim teks berformat alih-alih angka, mencampur nilai dari mata uang berbeda, atau memakai perhitungan berbeda di browser dan server. Jumlah peristiwa bisa benar sementara pendapatannya salah.
Untuk integrasi khusus, contoh data tingkat produk dapat berisi content_ids: ["DEMO-TEE-BLU-M"] dan content_type: "product". Periksa data yang benar-benar dikirim penyedia dan catatan katalog sebelum mengubahnya. Pada peristiwa tingkat grup, pengenal dan jenis konten harus sama-sama merujuk ke grup; jangan memasangkan ID varian dengan jenis grup.
Model data khusus SDK resmi membedakan nilai, mata uang, ID konten, dan jenisnya. Pertahankan pengenal sebagai string katalog terhubung, termasuk awalan dan kapitalisasi. SKU internal tidak otomatis menjadi ID item Meta. Gunakan tutorial iklan katalog untuk memeriksa pencocokan item versus grup.
DEMO-TEE-BLU-M64.00USD["DEMO-TEE-BLU-M"]product8. Perbaiki pencocokan hanya dengan data yang boleh digunakan
Deduplikasi mengenali salinan tindakan; pencocokan memakai parameter pelanggan yang diizinkan untuk menghubungkan peristiwa dengan seseorang. Atribusi kemudian menerapkan aturan laporan pada interaksi iklan yang memenuhi syarat. Memperbaiki satu aspek tidak membuktikan aspek lain benar.
Tinjau kolom yang benar-benar diterima dan diizinkan untuk dikirim. Ikuti aturan normalisasi dan hashing khusus kolom; hashing bukan mekanisme persetujuan. Jangan merekayasa pengenal klik atau mengisi informasi pelanggan kosong dengan nilai rekaan. Model data pelanggan Meta memperlakukan informasi pelanggan dan pengenal browser/klik sebagai parameter terpisah.
Pada antarmuka yang dikelola Shopify, Customer Privacy API menyediakan izin pemrosesan. Uji juga aplikasi dan jalur server nyata. Pengiriman server bukan izin mengabaikan pilihan pelanggan. Jangan masukkan isi formulir sensitif dan parameter URL pengenal ke kolom peristiwa umum.
9. Kirim ulang data tanpa membuat pembelian baru
Untuk integrasi khusus, simpan kunci pembelian, waktu pertama transaksi terjadi, dan status pengiriman sebelum memasukkannya ke antrean. Percobaan ulang harus memakai ID untuk transaksi yang sama, bukan membuat ID pembelian baru. Model peristiwa Meta mendefinisikan event_time sebagai waktu tindakan pelanggan terjadi, bukan waktu pengiriman ulang.
Atur pemrosesan webhook agar notifikasi yang sama tidak membuat pembelian baru; inilah pemrosesan idempoten. Notifikasi berulang untuk perubahan status pesanan yang sama tidak boleh terus menambah peristiwa baru ke antrean. Catat percobaan dan respons, batasi pengulangan sesuai jenis kesalahan, dan periksa pekerjaan lama yang tertunda. Deduplikasi Meta tidak menggantikan kontrol antrean Anda; mengirim pesanan lama dengan ID baru dapat merusak laporan.
demo-purchase-1042demo-purchase-1042demo-purchase-1042demo-purchase-104310. Verifikasi perbaikan melampaui Uji Peristiwa
Gunakan alur Uji Peristiwa yang didukung integrasi. Dalam implementasi CAPI langsung, test_event_code adalah parameter permintaan alat tersebut, seperti ditunjukkan model permintaan peristiwa Meta. Terlihatnya uji membuktikan penerimaan dalam konteks itu, bukan pengumpulan produksi atau atribusi iklan.
Hapus pengaturan khusus uji jika diperlukan, lalu periksa alur pembelian nyata yang telah diizinkan sesuai prosedur penyedia. Pastikan transaksi awal, pengiriman yang diharapkan, ID yang cocok, parameter, dan hasil diagnostiknya. Buka kembali halaman konfirmasi dan uji pengiriman ulang yang didukung untuk mencari duplikasi. Jangan membuat klik iklan buatan demi memaksakan atribusi.
Sebelum menutup masalah, simpan hasil yang diharapkan, bukti sebenarnya, pengaturan yang diubah, penanggung jawab, cara pemulihan, dan tanggal uji ulang. Jika peristiwa yang diterima sudah benar tetapi Pengelola Iklan berbeda, periksa definisi laporan dan atribusi secara terpisah. Panduan rekonsiliasi GA4–Shopify menjelaskan mengapa membandingkan pendapatan yang dihitung dengan dasar berbeda bisa membuat pelacakan seolah-olah bermasalah.
11. Keputusan pemecahan masalah yang umum
Apakah CAPI memulihkan semua peristiwa browser yang hilang?
Tidak. Jalur server hanya mengirim peristiwa dan data yang benar-benar diterima serta diproses implementasinya menurut pilihan yang berlaku. Periksa pemicu dan bukti; jangan menjanjikan pemulihan penuh sinyal browser yang hilang.
Haruskah saya menempel cuplikan piksel baru di samping aplikasi mitra?
Jangan menambahkannya sebagai jalan pintas. Cari tahu dahulu apa yang dikirim aplikasi mitra dan komponen yang bertanggung jawab atas setiap peristiwa. Untuk menghapus duplikasi yang sudah dipastikan, ubah satu hal yang dapat dibatalkan lalu bandingkan hasilnya. Jangan menumpuk integrasi baru di atas konfigurasi yang belum Anda pahami.
Apa isi dokumen serah terima?
Simpan daftar jalur pengiriman, catatan uji tanpa data sensitif, cara menghitung nilai yang disetujui, komponen pembuat ID, uji persetujuan, aturan pengiriman ulang, dan bukti perbaikan. Tuliskan masalah yang masih terbuka. Satu uji berhasil bukan jaminan bahwa semua pesanan berikutnya akan selalu tercatat dengan benar.
