การทำงานร่วมกันFinteza JavaScript Clientการส่งเหตุการณ์

วิธีการส่งเหตุการณ์

หลังจากการแทรก Finteza JavaScript Client คุณสามารถส่งเหตุการณ์การกระทำของผู้ใช้เว็บไซต์ไปที่ Finteza เพื่อทำสิ่งนี้ เพิ่มโค้ด JavaScript ต่อไปนี้ไปยังหน้าเว็บไซต์:

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

{EVENT_NAME} แทนชื่อเหตุการณ์ เช่น "Registration" (การลงทะเบียน)

ตรวจสอบการทำงานของโค้ดโดยการรันโค้ดผ่านคอนโซลของเบราว์เซอร์ ถ้าสำเร็จ คุณจะเห็นรายการที่สอดคล้องในรายงานเว็บไซต์ เหตุการณ์ ของ แผงควบคุม Finteza

เหตุการณ์ถูกบันทึกสำเร็จในแผงควบคุม Finteza

ข้อมูลเพิ่มเติมในพารามิเตอร์เหตุการณ์#

ในเหตุการณ์ซึ่งถูกส่งไปยัง Finteza คุณสามารถระบุข้อมูลเพิ่มเติมเป็นพารามิเตอร์ ตัวอย่างเช่น ประเภทของสินค้าที่ซื้อ ราคา สกุลเงิน ฯลฯ

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

ตั้งชื่อเหตุการณ์ใน {EVENT_NAME} พารามิเตอร์ต่อไปนี้ถูกระบุถัดไป:

พารามิเตอร์

ประเภท

คำอธิบาย

unit

string

หน่วยวัดของพารามิเตอร์ ตัวอย่างเช่น USD, รายการ ฯลฯ ความยาวสูงสุดคือ 32 สัญลักษณ์

value

จำนวน

ค่าพารามิเตอร์ ความยาวสูงสุดคือ 64 สัญลักษณ์

ตัวอย่าง:

fz( "event", {
  ชื่อ:  "Purchase",
  หน่วย:  "USD",
 ค่า: 100
});

ทางเลือกสำหรับการส่งเหตุการณ์จากหน้าเว็บ #

โค้ดการติดตามควรถูกแทรกใน tag ที่เจาะจงของหน้าเว็บ ขึ้นอยู่กับเหตุการณ์ที่ติดตาม

การส่งเหตุการณ์เมื่อกรอกแบบฟอร์ม:

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

การส่งเหตุการณ์เมื่อคลิกปุ่ม:

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

การส่งเหตุการณ์เมื่อคลิกบนลิงก์:

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

การส่งเหตุการณ์เมื่อโหลดหน้าเว็บ:

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

การจัดการอัตโนมัติสำหรับการคลิกลิงก์ #

เพิ่มคุณสมบัติ data-fz-event ไปยังลิงก์เว็บไซต์ของคุณและระบุชื่อของเหตุการณ์ที่จะส่งไปยัง Finteza เมื่อคลิก Finteza JavaScript Client ค้นหาและจัดการการคลิกโดยอัตโนมัติสำหรับทุกลิงก์บนหน้าเว็บ

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

ทางเลือกนี้สามารถใช้แทนการเพิ่มคุณสมบัติ onclick พร้อมกับการอธิบายอย่างสมบูรณ์ของการเรียก fz()  มันง่ายและสะดวกกว่า

สำหรับ Google AMP Instant Articles ซึ่งใช้เวอร์ชั่นโค้ดการติดตามเฉพาะ มีข้อกำหนดการตั้งชื่อคุณสมบัติเพิ่มเติม: ต้องเริ่มต้นด้วย prefix แบบ "data-vars" ดังนั้น คุณควรเพิ่มคุณสมบัติ data-vars-fz เพื่อเปิดใช้งานการประมวลผลอัตโนมัติของการคลิกลิงก์ดังกล่าว:

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

เพื่อหลีกเลี่ยงความสับสนในการตั้งชื่อ คุณสามารถใช้คุณสมบัติ data-vars-fz ได้ทุกที่ มันได้รับการรองรับไม่เพียงบนหน้า Google AMP แต่รวมถึงบนหน้าเว็บปกติซึ่งมีโค้ดการติดตามมาตรฐาน


เรียกกลับ #

ถ้าคุณต้องการจัดการเหตุการณ์ที่กำลังส่ง ตั้งฟังก์ชั่นเรียกกับในโค้ดเหตุการณ์ เปลี่ยน argument ที่สองของการเรียกในวิธีต่อไปนี้:

fz( "event", {
  name:  "Your Event Name",
  หน่วย:  "USD",
 ค่า: 100,
  เรียกกลับ: function() {
...
   // การส่งเหตุการณ์เสร็จสมบูรณ์แล้ว
  }
} );

มันจะเป็น object ที่ประกอบด้วยชื่อเหตุการณ์และลิงก์ไปยังฟังก์ชั่นที่จัดการ