ادغامارسال رویدادها

نحوه ارسال رویدادها

پس از وارد کردن Finteza JavaScript Client ، می توانید رویدادهای عملکرد کاربر وب سایت را به Finteza ارسال کنید. برای انجام این کار ، کد جاوا اسکریپت زیر را به صفحه وب سایت اضافه کنید:

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

{EVENT_NAME} مخفف نام یک رویداد خاص است ، به عنوان مثال "ثبت".

با اجرای آن از طریق کنسول مرورگر ، عملکرد کد را بررسی کنید. در صورت موفقیت آمیز ، مطلب مربوطه را در گزارش وب سایت رویدادها پانل Finteza مشاهده خواهید کرد.

رویداد با موفقیت در پنل Finteza ثبت شد

اطلاعات اضافی در پارامترهای رویداد # #

در رویدادهای ارسال شده به Finteza ، می توانید داده های اضافی را به عنوان پارامترها مشخص کنید ، به عنوان مثال نوع کالای خریداری شده ، قیمت ، ارز و غیره.

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

نام رویداد را در {EVENT_NAME} تنظیم کنید. پارامترهای زیر در مرحله بعد مشخص شده است:

پارامتر

نوع

توصیف

unit

رشته

واحدهای اندازه گیری پارامتر ، به عنوان مثال ، USD ، اقلام و غیره حداکثر طول 32 نماد است.

value

عدد

مقدار پارامتر. حداکثر طول 64 علامت است.

مثال:

fz( "event", {
  name:  "Purchase",
  unit:  "USD",
  value: 100
});

گزینه های ارسال رویدادها از صفحه وب # #

بسته به یک رویداد ردیابی ، کد رهگیری باید در برچسب های صفحه وب خاصی وارد شود.

ارسال رویداد هنگام پر کردن فرم:

<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 JavaScript Client با کلیک بر روی تمام لینک های موجود در صفحه وب به طور خودکار می یابد

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

به جای اضافه کردن خصوصیات onclick می توانید از این گزینه استفاده کنید و توضیحات کاملی در مورد fz() فراخوانی کنید. ساده تر و راحت تر است.

برای مقالات فوری Google AMP ، که در آن از یک نسخه کد رهگیری استفاده می شود ، یک مورد مورد نیاز برای نامگذاری ویژگی اضافی اعمال می شود: آنها باید با پیشوند "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 ، بلکه در صفحات معمولی با کد رهگیری استاندارد پشتیبانی می شوند .


Callback # #

اگر نیاز دارید که یک رویداد ارسال را انجام دهید ، عملکرد پاسخ به تماس را در کد رویداد تنظیم کنید. آرگومان دوم تماس را به روش زیر تغییر دهید:

fz( "event", {
  name:  "Your Event Name",
  unit:  "USD",
  value: 100,
  callback: function() {
...
   // ارسال رویداد کامل شد
  }
} );

این یک شیء خواهد بود که حاوی نام رویداد و پیوندی به عملکرد کنترل کننده است.