Meta Logo With A Topic Icon For Meta Pixel And Conversions Api Troubleshooting

Pemecahan Masalah Meta Pixel dan Conversions API: Pembelian Hilang dan Ganda

Terakhir 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.

Pertanyaan berbeda memerlukan bukti berbeda
LapisanPertanyaanBukti
TokoApakah transaksi yang dimaksud terjadi?Pesanan, status pembayaran, dan jumlah yang ditetapkan.
Pengiriman dataApakah setiap integrasi yang seharusnya mengirim data benar-benar melakukannya?Permintaan browser atau respons server dan log.
ParameterApakah peristiwa menjelaskan tindakan itu dengan benar?Nama, waktu, ID, nilai, mata uang, dan item.
DeduplikasiApakah salinan browser dan server dikenali sebagai pembelian yang sama?Kunci yang cocok dan diagnostik Meta.
PencocokanDapatkah pengenal yang diizinkan menghubungkan peristiwa dengan seseorang?Parameter informasi pelanggan yang tersedia dan diagnostik.
AtribusiApakah 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.

Contoh Publik Shopify Tentang Ringkasan Pengelola Peristiwa Meta Dengan Id Set Data Disorot
Contoh publik Shopify menyoroti ID set data di Pengelola Peristiwa. Sebelum menyelidiki peristiwanya, pastikan pengirim browser, pengirim server, dan konfigurasi iklan pilihan mengarah ke aset yang dimaksud. Pengenal pada gambar milik contoh sumber, bukan ID untuk disalin. Sumber: Shopify.

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.

Catatan perbandingan fiktif, bukan pesanan nyata
KolomYang diharapkan dalam contoh iniBukti aktual yang disimpan
Referensi pesananDEMO-1042, status transaksi terkonfirmasiCatatan toko dan zona waktu.
Transaksi pembelian PurchaseSatu pembelian, bukan setiap kali halaman konfirmasi dibukaPemicu dan waktu pembelian pertama kali terjadi.
ID peristiwa browser/serverPurchase dan demo-purchase-1042Pixel ID, kedua nama dan ID peristiwa.
Jumlah2 unit × 32.00 = 64.00 USDKomponen yang termasuk dalam nilai pesanan dan parameter yang diterima.
ItemDEMO-TEE-BLU-M, jumlah 2Pengenal katalog aktual dan varian.
KonteksPerangkat diketahui, versi integrasi, dan status persetujuanPermintaan, 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.

BEECOMMERCER / Diagram 01
Contoh pembelajaran
Satu pembelian bisa dikirim melalui dua jalur
Pesanan DEMO-1042 · Piksel / dataset yang sama
Browser · Pixel
event
Purchase
eventID
demo-purchase-1042
value / currency
64.00 / USD
Server · Conversions API
event_name
Purchase
event_id
demo-purchase-1042
value / currency
64.00 / USD
eventID
=
event_id
ID peristiwa yang sama menandai satu pembelian yang sama. Hal ini berbeda dari mencocokkan pelanggan atau mengatribusikan pembelian ke iklan.

5. 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.

BEECOMMERCER / Diagram 02
Contoh pembelajaran
Telusuri peristiwa yang hilang mulai dari pemicunya
01
Peristiwa tidak dibuat
Periksa pemicu dan status persetujuan.
02
Permintaan ditolak
Baca respons dan perbaiki kolom yang ditandai.
03
Diterima tetapi tidak terlihat
Periksa dataset, rentang tanggal, dan lingkungan pengujian.
Catatan ilustratif, bukan tangkapan layar akun nyata atau hasil iklan. Cocokkan dengan integrasi dan catatan bisnis Anda.

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.
Pilih pemeriksaan sesuai gejala duplikasi
PengamatanPemeriksaan berikutnyaBukti perbaikan
Purchase tambahan muncul setelah halaman dimuat ulangApakah halaman konfirmasi membuat peristiwa pembelian baru, bukan mengenali pesanan yang sudah ada?Membuka kembali halaman tidak menghasilkan transaksi pembelian baru.
ID browser dan server berbedaKomponen 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 aplikasiVersi 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.

BEECOMMERCER / Diagram 03
Contoh pembelajaran
Periksa nilai, mata uang, dan identitas item secara terpisah
Nilai2 × 32.00 = 64.00 USD
Pesanan DEMO-1042
Jumlah
2
Mata uang
USD
Produk
DEMO-TEE-BLU-M
Periksa
value
64.00
currency
USD
content_ids
["DEMO-TEE-BLU-M"]
content_type
product
Catatan ilustratif, bukan tangkapan layar akun nyata atau hasil iklan. Cocokkan dengan integrasi dan catatan bisnis Anda.

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.

BEECOMMERCER / Diagram 05
Contoh pembelajaran
Kirim ulang data tanpa membuat pembelian baru
Periksa
Waktu pengiriman
event_id
event_time
Pesanan
12:00:00
demo-purchase-1042
12:00:00
Percobaan ulang
12:00:03
demo-purchase-1042
12:00:00
Percobaan ulang
12:00:15
demo-purchase-1042
12:00:00
Pembelian baru
12:10:00
demo-purchase-1043
12:10:00
Waktu hanya menggambarkan urutan; ini bukan permintaan API lengkap.
Catatan ilustratif, bukan tangkapan layar akun nyata atau hasil iklan. Cocokkan dengan integrasi dan catatan bisnis Anda.

10. 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.

BEECOMMERCER / Diagram 06
Contoh pembelajaran
Lakukan pemeriksaan secara berurutan
01
Bukti toko
Pastikan transaksi dan jumlah yang diharapkan.
02
Pengiriman data
Temukan permintaan yang dimaksud dan respons diterima.
03
Parameter
Bandingkan waktu, nilai, mata uang, dan produk.
04
Deduplikasi
Periksa pengiriman berpasangan dan kunci bersama.
05
Pencocokan
Tinjau parameter informasi pelanggan yang diizinkan.
06
Atribusi
Bandingkan aturan dan periode laporan setelah pemeriksaan sebelumnya.
Mengubah atribusi tidak memperbaiki permintaan hilang atau pengenal produk keliru.

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.

Kembali ke atas