IntegrasiMenghantar peristiwa

Bagaimana untuk menghantar peristiwa

Selepas memasukkan Finteza JavaScript Client, anda boleh menghantar peristiwa tindakan pengguna laman web ke Finteza. Untuk melakukan, tambahkan kod JavaScript berikut ke halaman laman web:

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

{EVENT_NAME} bermaksud nama peristiwa tertentu, sebagai contoh, "Pendaftaran".

Semak kod operasi dengan menjalankannya melalui konsol pelayar. Sekiranya berjaya, anda akan melihat catatan yang sepadan dalam laporan laman web Event pada panel Finteza.

Peristiwa berjaya didaftarkan di panel Finteza

Data tambahan dalam parameter peristiwa #

Dalam peristiwa yang dihantar ke Finteza, anda boleh menentukan data tambahan sebagai parameter, sebagai contoh, jenis belian barangan, harga, mata wang, dll.

fz( "event", {
  nama:  "{EVENT_NAME}",
  unit:  "{UNIT}",
  nilai: {VALUE}
});

Set nama peristiwa dalam {EVENT_NAME}. Parameter berikut ditentukan seterusnya:

Parameter

Jenis

Penerangan

unit

string

Unit pengukuran parameter, misalnya, USD, item, dll. Panjang maksimum ialah 32 simbol.

nilai

nombor

Nilai parameter. Panjang maksimum ialah 64 simbol.

Contoh:

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

Pilihan untuk menghantar peristiwa dari laman web #

Kod penjejakan mestilah dimasukkan ke dalam tag laman web tertentu bergantung pada peristiwa yang dijejaki.

Menghantar peristiwa apabila mengisi borang:

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

Menghantar peristiwa apabila mengklik butang:

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

Menghantar peristiwa dengan mengklik pada pautan:

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

Menghantar peristiwa apabila memuat laman web:

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

Pengendalian klik secara automatik mengikut pautan #

Tambah data-fz-event atribut ke pautan laman web anda dan tentukan nama-nama peristiwa yang akan dihantar ke Finteza apabila diklik. Finteza JavaScript Client secara automatik mencari dan mengendalikan mengklik semua pautan tersebut di laman web.

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

Pilihan ini boleh digunakan selain menambah onclick atribut dengan penerangan lengkap fz() panggilan.  Ia lebih ringkas dan mudah.

Untuk Google AMP Instant Articles, di mana versi kod penjejakan individu digunakan, tambahan keperluan penamaan atribut terpakai: ia mesti bermula dengan awalan "data-vars". Oleh itu, anda harus menambah data-vars-fz atribut padanya untuk membolehkan pemprosesan klik automatik pada pautan tersebut:

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

Untuk mengelakkan kekeliruan dalam penamaan, anda boleh menggunakan data-vars-fz atribut di mana sahaja. Ia disokong bukan sahaja pada halaman Google AMP, tetapi juga pada halaman biasa dengan standard kod penjejakan.


Panggilan kembali #

Sekiranya anda perlu mengendalikan peristiwa penghantaran, tetapkan fungsi panggilan kembali dalam kod peristiwa. Tukar argumen kedua panggilan dengan cara berikut:

fz( "event", {
  nama:  "Your Event Name",
  unit:  "USD",
  nilai: 100,
  panggilan kembali: fungsi() {
...
    // penghantaran peristiwa selesai
  }
} );

Ia akan menjadi objek yang mengandungi nama peristiwa dan pautan kepada fungsi pengendali.