IntegrasiCara mengirim peristiwa

Cara mengirim peristiwa

Setelah menyisipkan Klien JavaScript Finteza, anda dapat mengirim peristiwa tindakan pengguna situs web ke Finteza. Untuk melakukan ini, tambahkan kode JavaScript berikut ke halaman situs web:

fz( "event""{EVENT_NAME}" );

{EVENT_NAME} singkatan dari sebuah nama peristiwa tertentu, misalnya, "Registrasi".

Periksa operasi kode dengan menjalankannya melalui konsol browser. Jika berhasil, anda akan melihat entri yang sesuai di laporan situs web peristiwa panel Finteza.

Peristiwa berhasil terdaftar di panel Finteza

Data tambahan dalam parameter peristiwa #

Dalam peristiwa yang dikirim ke Finteza, anda dapat menentukan data tambahan sebagai parameter, misalnya, sebuah jenis barang yang dibeli, harga, mata uang, dll.

fz( "event", {
  name:  "{EVENT_NAME}",
  unit:  "{UNIT}",
  value: {VALUE}
});

Atur nama peristiwa di {EVENT_NAME}. Parameter berikut ditentukan berikutnya:

Parameter

Jenis

Deskripsi

satuan

rangkaian

Satuan pengukuran parameter, misalnya, USD, item, dll. Panjang maksimum adalah 32 simbol.

nilai

jumlah

Nilai parameter. Panjang maksimum adalah 64 simbol.

Contoh:

fz( "event", {
  nama:  "Membeli",
  unit:  "USD",
 nilai: 100
});

Opsi untuk mengirim peristiwa dari halaman web #

Kode pelacakan harus disisipkan ke dalam tag halaman web tertentu tergantung pada peristiwa yang dilacak.

Mengirim sebuah peristiwa ketika mengisi formulir:

<form action="" method="get" onsubmit="fz('event', 'Form+Order+Submit'); return true;">
    ...
</form>

Mengirim sebuah peristiwa ketika mengklik tombol:

<form action="">
    ...
    <input type="button" onclick="fz('event', 'Form+Order+Submit'); return true;" value="Order" />
</form>

Mengirim sebuah peristiwa dengan mengklik tautan:

<a href="https://www.example.com/" onclick="fz('event', 'Click+Link'); return true;">www.example.com</a>

Mengirim sebuah peristiwa ketika memuat sebuah halaman web:

<body>
...
<script type="text/javascript">
  fz("event","Page+Order+Load");
</script>
...
</body>

Penanganan klik oleh tautan secara otomatis #

Tambahkan atribut data-fz-event ke tautan situs web anda dan tentukan di dalamnya nama peristiwa yang akan dikirim ke Finteza ketika diklik. Klien JavaScript Finteza secara otomatis menemukan dan menangani mengklik semua tautan tertentu seperti itu di halaman web.

<a data-fz-event="Click+Link" href="https://www.example.com/">www.example.com</a>

Opsi ini dapat digunakan daripada menambahkan atribut diklik dengan deskripsi lengkap panggilanfz(). Ini lebih sederhana dan lebih nyaman.

Untuk Artikel Instan Google AMP, di mana versi kode pelacakan individual digunakan, tambahan persyaratan penamaan atribut berlaku: mereka harus mulai dengan awalan "data-vars". Oleh karena itu, anda harus menambahkan atribut data-vars-fz ke mereka untuk mengaktifkan pemrosesan klik otomatis pada tautan tersebut:

<a data-vars-fz="Click+Link" href="https://www.example.com/">www.example.com</a>

Untuk menghindari kebingungan dalam penamaan, anda dapat menggunakan atribut data-vars-fz dimana pun. Mereka didukung tidak hanya pada halaman Google AMP, tetapi juga pada halaman reguler dengan kode pelacakan standar.


panggilan balik #

Jika anda perlu menangani sebuah peristiwa pengiriman, atur fungsi panggilan balik dalam kode peristiwa. Ubah argumen panggilan kedua dengan cara berikut:

fz( "event", {
  name:  "Your Event Name",
  unit:  "USD",
  value: 100,
  callback: function() {
...
   // pengiriman peristiwa selesai
  }
} );

Ini akan menjadi obyek yang berisi nama peristiwa dan tautan ke fungsi penangan.