Mengukur keberhasilan formulir, bukan klik tombol

Mengklik tombol kirim, mengirim formulir, dan menyelesaikan pemrosesannya merupakan peristiwa berbeda. Klik dapat diikuti kesalahan validasi, permintaan gagal, atau penolakan server. Stats4U menyediakan kategori kontak otomatis, pengiriman bertanda, dan peristiwa keberhasilan formulir eksplisit; pilihan ini menentukan makna sebenarnya dari laporan.

Aktifkan hanya pengukuran yang diperlukan

1. Buka penghitung yang dimiliki melalui Penghitung saya, lalu buka Dasbor dan alat dan Tindakan kontak.
2. Di Pengaturan pengukuran, aktifkan Hitung klik telepon, email, dan unduhan secara otomatis untuk kategori klik tersebut, atau Hitung pengiriman formulir yang ditandai dan keberhasilan formulir yang dikonfirmasi untuk pengiriman bertanda dan keberhasilan terkonfirmasi.
3. Pilih Simpan dan pastikan situs menggunakan integrasi JavaScript yang dihasilkan.

Kategori kontak otomatis memakai nama tindakan seperti contact-email, contact-phone, dan download. Nama tersebut menggambarkan klik, bukan email terkirim, panggilan terjawab, atau unduhan selesai. Peristiwa tidak mengirim alamat, nomor telepon, atau isi kolom formulir.

Tandai pengiriman formulir

Tambahkan nama formulir yang stabil dan tidak bersifat pribadi pada elemen formulir. Nama harus menggambarkan tujuannya, bukan mengidentifikasi pengunjung. Contoh ini menandai formulir kontak:

<form data-s4u-form="contact">
  <!-- Existing form controls and submission handling -->
</form>

Penanda menghasilkan form-submitted-contact saat browser mengirim formulir. Ini tidak membuktikan bahwa server menerima atau memprosesnya. Pertahankan kode validasi dan pemrosesan formulir yang ada; penambahan penanda pengukuran tidak mengimplementasikan penanganan formulir.

Konfirmasikan keberhasilan pada titik keberhasilan sebenarnya

Untuk formulir khusus, panggil fungsi keberhasilan hanya setelah aplikasi mengonfirmasi pemrosesan berhasil. Respons HTTP yang tiba, klik tombol, atau promise fetch yang selesai saja tidak cukup: aplikasi harus menafsirkan respons server dan status kesalahannya sendiri.

if (window.s4u && typeof window.s4u.formSuccess === 'function') {
  window.s4u.formSuccess('contact');
}

Pemanggilan ini menghasilkan form-success-contact ketika pengukuran formulir aktif dan pelacak tersedia. Tempatkan di cabang keberhasilan terkonfirmasi yang sudah ada, bukan sebelum permintaan atau dalam penangan penyelesaian tanpa syarat. Contact Form 7 dapat menggunakan integrasi peristiwa pengiriman email berhasil yang didukung; formulir umum memerlukan sinyal keberhasilan aplikasi yang eksplisit.

Periksa keberhasilan dan kegagalan

1. Pada instalasi pengujian yang dimiliki, coba pengiriman valid dan pengiriman yang ditolak aplikasi. Hanya keberhasilan yang dikonfirmasi yang boleh mengirim peristiwa keberhasilan.
2. Gunakan Debugger pengukuran untuk memeriksa apakah kategori dan nama peristiwa yang diharapkan akan diterima, tanpa menghitung peristiwa nyata.
3. Bandingkan nama peristiwa yang dihasilkan dalam laporan. Jumlah pengiriman yang melebihi jumlah keberhasilan dapat menjadi sinyal berguna, tetapi bukan bukti satu kesalahan tertentu.

Debugger memeriksa kelayakan, bukan keberhasilan pengiriman formulir nyata. Periksa respons aplikasi dan permintaan pelacak normal secara terpisah. Jangan masukkan nama dan isi formulir ke label peristiwa atau properti diagnostik.

Langkah berikutnya

Periksa panduan integrasi sebelum menambahkan pemanggilan keberhasilan ke aplikasi.

Buka panduan pemasangan