Menguji piksel tersuai

Selepas anda mencipta piksel tersuai, anda perlu mengujinya bagi memastikan piksel anda menghantar data dengan betul apabila peristiwa berlaku pada laman web anda.

Anda boleh menggunakan Shopify Pixel Helper untuk menguji sama ada peristiwa piksel anda dimuatkan dan anda melanggan peristiwa Shopify dengan betul. Shopify Pixel Helper membolehkan anda menguji piksel tersuai anda pada kedai dalam talian untuk melihat peristiwa yang diterima dalam masa nyata, bersama-sama dengan data untuk peristiwa tersebut.

Jika piksel tersuai anda disepadukan dengan platform pihak ketiga yang mempunyai alat pembantu pikselnya sendiri, anda boleh menggunakan pembantu piksel pihak ketiga sebagai tambahan kepada Shopify Pixel Helper untuk menguji sama ada peristiwa piksel anda diproses dan diterima oleh platform pihak ketiga. Contohnya, jika anda menambahkan piksel TikTok tersuai pada kedai anda, anda boleh menggunakan kedua-dua Shopify Pixel Helper dan pembantu piksel TikTok untuk menguji piksel anda.

Anda boleh menggunakan Shopify Pixel Helper dalam sesi pelayar yang sama seperti pembantu piksel pihak ketiga untuk menguji peristiwa bagi kedua-dua platform pada masa yang sama.

Berikut ialah skrip piksel tersuai yang akan mencetuskan semua peristiwa standard kepada kotak pasir dan mengelog data peristiwa pada konsol. Peristiwa standard akan kelihatan dalam Shopify Pixel Helper. Selain itu, anda boleh melanggan langganan pukal lain, all_events, all_custom_events dan all_dom_events, untuk menemui semua yang dapat diberikan oleh piksel web. Lawati API piksel web untuk mendapatkan maklumat lanjut.

analytics.subscribe("all_standard_events", event => {
   console.log("Event data ", event?.data);
});

Pada halaman ini

Pastikan bahawa piksel tersuai disambungkan

Sebelum anda menguji piksel tersuai anda, pastikan piksel tersuai tersebut disambungkan.

Langkah-langkah:

Daripada pentadbir Shopify anda, pergi ke Tetapan > Peristiwa pelanggan.
Di sebelah piksel yang ingin anda uji, sahkan piksel anda mempunyai status Disambungkan yang dipaparkan dalam lajur Status.
Jika piksel tidak disambungkan, klik ..., kemudian klik Sambungkan.

Uji piksel tersuai menggunakan Shopify Pixel Helper

Selepas anda mengesahkan bahawa piksel tersuai anda disambungkan, anda boleh menggunakan Shopify Pixel Helper untuk menguji sama ada piksel tersuai anda menghantar data dan menerima data kedai anda. Anda boleh menguji satu piksel tersuai pada satu-satu masa.

Langkah-langkah:

Daripada pentadbir Shopify anda, pergi ke Tetapan > Peristiwa pelanggan.
Klik piksel tersuai yang ingin anda uji.
Klik Uji untuk membuka piksel tersuai pada laman web anda untuk pengujian.
Pilihan: Bergantung pada tetapan keizinan kedai anda dan tetapan privasi pelanggan piksel tersuai, dialog Pembantu piksel mungkin memaparkan Piksel sedang menunggu keizinan. Lakukan salah satu perkara berikut untuk meneruskan pengujian:
- Terima penjejakan pada sepanduk kuki atau keutamaan kedai anda.
- Klik Berikan keizinan untuk meneruskan ujian.
- Jika piksel anda masih tidak dimuatkan, semak tetapan privasi pelanggan anda.
Untuk melihat peristiwa yang dimuatkan, lawati setiap halaman yang ingin anda uji pikselnya dan semak dialog Pembantu piksel untuk memastikan bahawa peristiwa berjaya dilanggan dan fungsi panggil balik berjaya dalam bahagian Peristiwa yang diterima:
- Pergi ke halaman baharu untuk menguji peristiwa page_viewed.
- Klik produk untuk menguji peristiwa product_viewed.
- Tambahkan produk ke troli anda untuk menguji peristiwa product_added_to_cart.
- Pergi ke pembayaran anda untuk menguji peristiwa checkout_started.
- Masukkan maklumat pengiriman anda di bahagian pembayaran untuk menguji bahawa peristiwa checkout_shipping_info_submitted menggantikan peristiwa checkout_started.
- Lengkapkan pembayaran untuk menguji bahawa peristiwa checkout_completed menggantikan peristiwa checkout_shipping_info_submitted. Ketahui lebih lanjut tentang membuat pesanan ujian.
Untuk melihat data peristiwa yang diterima, klik untuk mengembangkan dialog pembantu piksel.

Melihat bahagian Peristiwa yang diterima

Apabila anda menguji peristiwa yang dimuatkan dalam langkah 5, salah satu status berikut dipaparkan dalam bahagian Peristiwa yang diterima pada dialog Pembantu piksel:

Titik hijau menunjukkan bahawa peristiwa berjaya dilanggan dan fungsi panggil balik berjaya.
Titik merah menunjukkan bahawa peristiwa berjaya dilanggan, tetapi fungsi panggil balik gagal. Ketahui cara menyelesaikan masalah piksel tersuai anda.
Pembantu piksel memaparkan ralat yang tidak ditangkap yang berlaku pada peringkat atas atau dalam fungsi panggil balik. Ralat peringkat atas dipaparkan apabila pembantu piksel dimuatkan. Mesej ralat panggil balik dipaparkan apabila anda mengklik untuk mengembangkan peristiwa yang mempunyai titik merah.
Sampel kod berikut mengandungi ralat panggil balik dan ralat peringkat atas. Bergantung pada lokasi ralat peringkat atas, piksel mungkin berfungsi separa.

analytics.subscribe("all_standard_events", event => {
  console.log("Event data ", event?.data);
  throw new Error("callback error");
});

throw new Error("top level error")

Untuk mengetahui lebih lanjut tentang pembaikan ralat JavaScript, lawati Penyelesaian masalah JavaScript.

Menyelesaikan masalah piksel tersuai anda

Jika piksel anda tidak dimuatkan atau dicetuskan semasa pengujian dan anda telah pun menyemak ralat pada data peristiwa serta kod piksel anda, cuba langkah penyelesaian masalah berikut.

Semak tetapan privasi pelanggan anda

Jika piksel anda tidak dimuatkan atau dicetuskan semasa pengujian, mungkin terdapat tetapan privasi pelanggan yang menghalangnya daripada dimuatkan.

Dari pentadbir Shopify anda, pergi ke Tetapan > Privasi pelanggan untuk menyemak tetapan privasi pelanggan dalam pentadbir Shopify anda yang mungkin terpakai pada sesi anda. Bergantung pada tetapan privasi pelanggan anda, ambil langkah berikut:

Jika anda mempunyai tetapan privasi pelanggan yang memerlukan keizinan di rantau anda, pastikan anda telah memberikan keizinan melalui sepanduk kuki anda.
Jika anda tidak mempunyai sebarang tetapan privasi pelanggan yang menyekat piksel daripada dimuatkan, kosongkan kuki pelayar anda untuk menetapkan semula sepanduk kuki anda dan memberikan keizinan.

Jika anda menggunakan alat pihak ketiga untuk mengurus keizinan, hubungi penyedia pihak ketiga anda untuk mendapatkan sokongan.

Penyelesaian masalah tambahan

Jika masih tidak jelas sama ada piksel tersuai anda dilanggan dengan betul pada peristiwa pelanggan, cuba langkah penyelesaian masalah berikut:

Kosongkan kuki pelayar anda.
Jika anda menguji peristiwa standard, semak dokumentasi pembangun perihalan peristiwa standard Shopify untuk memastikan anda melaksanakan langkah yang diperlukan bagi mencetuskan peristiwa tersebut.

Pengujian pembantu piksel pihak ketiga

SDK (kit pembangunan perisian) piksel mengandungi alat untuk piksel anda mengumpulkan maklumat tentang tingkah laku pelanggan. Anda boleh menggunakan pembantu piksel penyedia piksel pihak ketiga anda untuk menguji tingkah laku piksel anda yang berikut dan memastikan bahawa SDK piksel berfungsi seperti yang dijangkakan:

Uji sama ada SDK piksel pihak ketiga dimuatkan

Langkah untuk menyemak tab rangkaian anda bergantung pada pelayar web yang anda gunakan. Sebagai contoh, untuk mengetahui cara menyemak tab rangkaian anda pada Google Chrome, rujuk dokumentasi Inspect network activity Chrome for Developers.

Untuk menguji bahawa SDK piksel pihak ketiga dimuatkan, anda mula-mula perlu mengambil semula kod penyedia pihak ketiga anda untuk URL SDK agar anda boleh menambahkannya pada kod piksel anda. Untuk mendapatkan sokongan, hubungi penyedia piksel pihak ketiga anda.

Langkah-langkah:

Daripada pentadbir Shopify anda, pergi ke Tetapan > Peristiwa pelanggan.
Klik piksel tersuai yang ingin anda uji.
Dalam bahagian Kod, masukkan SDK piksel yang disediakan oleh penyedia pihak ketiga anda pada hujung kod piksel anda.
Klik Simpan.
Lawati kedai dalam talian anda, kemudian semak tab rangkaian anda untuk memastikan bahawa URL SDK penyedia pihak ketiga sedang dimuat turun.
Pilihan: Jika SDK piksel pihak ketiga tidak dimuatkan, semak ralat masa jalan JavaScript dalam kotak pasir. Sebagai contoh, pada Chrome, anda boleh memilih iFrame yang khusus untuk disemak log konsolnya dan kemudian mengecilkan carian log kepada piksel khusus yang sedang anda uji. Untuk mengetahui lebih lanjut tentang penyemakan ralat masa jalan JavaScript pada Chrome, rujuk dokumentasi Debug JavaScript Chrome.

Jika SDK piksel pihak ketiga tidak dimuatkan semasa pengujian, hubungi penyedia piksel pihak ketiga anda untuk mendapatkan sokongan.

Pengujian SDK piksel pihak ketiga yang lain

Untuk menguji sama ada SDK piksel pihak ketiga dimulakan atau mengumpulkan peristiwa, rujuk dokumentasi penyedia piksel pihak ketiga anda.

Untuk menguji sama ada SDK piksel mengumpulkan peristiwa, anda mungkin diarahkan untuk menyemak tab rangkaian pelayar anda. Langkah untuk menyemak tab rangkaian anda bergantung pada pelayar web yang anda gunakan. Sebagai contoh, untuk mengetahui cara menyemak tab rangkaian anda pada pelayar Google Chrome untuk Google Chrome, rujuk dokumentasi Inspect network activity Chrome for Developers.