التكاملإرسال الأحداث

كيفية إرسال الأحداث

بعد إدراجFinteza JavaScript Client، يمكنك إرسال أحداث إجراء مستخدم الموقع الإلكتروني إلى Finteza. للقيام بذلك، أضف رمز JavaScript التالي إلى صفحة الموقع الإلكتروني:

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

{EVENT_NAME}تعني اسم حدث معين، على سبيل المثال، "التسجيل".

حقق من عملية الرمز عن طريق تشغيله من خلال وحدة تحكم المتصفح. إذا نجحت، سترى الإدخال المقابل في تقرير الموقع عن الأحداث الخاص بـ لوحة Finteza.

تم تسجيل الحدث بنجاح في لوحة Finteza

بيانات إضافية في معلمات الحدث #

في الأحداث المرسلة إلى Finteza، يمكنك تحديد بيانات إضافية كمعلمات، على سبيل المثال، نوع من السلع المشتراة أو السعر أو العملة، إلخ.

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

قم بتعيين اسم الحدث في {EVENT_NAME}. المعلمات التالية محددة بعد ذلك:

المعلمات

النوع

الوصف

unit

السلسلة

وحدات قياس المعلمة، على سبيل المثال، الدولار الأمريكي، البنود، إلخ. الحد الأقصى للطول هو 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 عند النقر عليها. يقوم Finteza JavaScript Client تلقائيًا بالعثور على كل هذه الروابط في صفحة الويب ويتعامل مع النقر عليها.

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

يمكن استخدام هذا الخيار بدلاً من إضافة سمات عند النقر مع الوصف الكامل للاتصال fz(). إنه أبسط وأكثر ملاءمة.

بالنسبة إلى Google AMP Instant Articles، حيث يتم فيها استخدام إصدار رمز تتبع فردي، شرط تسمية سمة إضافية ينطبق: يجب أن تبدأ بالبادئة "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، ولكن أيضًا على الصفحات العادية التي بها رمز التتبع المعياري.


إعادة الاتصال #

إذا كنت بحاجة إلى التعامل مع حدث إرسال، فاضبط وظيفة إعادة الاتصال في رمز الحدث. قم بتغيير المُعامل الثاني للاتصال بالطريقة التالية:

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

سيكون موضوعًا يحتوي على اسم حدث ورابط لوظيفة المعالج.