تمكين القياسات الاختيارية

نحن فخورون بامتلاكنا أحد أخف أجزاء JavaScript في صناعة التحليلات.

نحقق ذلك من خلال الحد بشكل جذري من عدد الخيارات في البرنامج النصي الافتراضي. بدلاً من ذلك، نقدم قياسات محسّنة كملحقات نصية اختيارية مصممة خصيصًا لكيفية استخدامك لـ Histat. يضمن هذا النهج تحميل الكود الذي سيتم استخدامه فعليًا على موقع الويب الخاص بك فقط.

يمكنك تمكين هذه القياسات الاختيارية عند إضافة موقع جديد إلى حساب Histat الخاص بك أو في منطقة "تثبيت الموقع" في قسم "عام" في "إعدادات الموقع"

تتغير القطعة وفقًا لاختيارك للقياسات

لاحظ أن قطعة التتبع التي تحتاج إلى إدراجها في موقعك تتغير وفقًا لاختيارك للقياسات المحسنة. عند إجراء تغييرات على القياسات الاختيارية، تأكد من إدراج أحدث قطعة في موقعك لكي تعمل جميع عمليات التتبع كما هو متوقع

إليك قائمة القياسات الاختيارية لدينا:

القياس الاختياري	شرح
الروابط الصادرة	تتبع النقرات على الروابط الصادرة تلقائيًا
تنزيلات الملفات	تتبع تنزيلات الملفات تلقائيًا
صفحات الخطأ 404	تتبع صفحات الخطأ 404 تلقائيًا
مسارات الصفحات المجزأة	تتبع مسارات الصفحات التي تستخدم "#" في عنوان URL "التوجيه القائم على التجزئة"
الأحداث المخصصة	تتيح لك "تتبع الأحداث المخصصة" مثل نقرات الروابط وإرسال النماذج وأي نقرات أخرى على عناصر HTML
الخصائص المخصصة	تتيح لك إرفاق "الخصائص المخصصة" (المعروفة أيضًا باسم الأبعاد المخصصة في Google Analytics) عند إرسال عرض صفحة أو حدث مخصص لإنشاء مقاييس مخصصة
إيرادات التجارة الإلكترونية	تتيح لك تعيين "قيم نقدية" ديناميكية للأحداث المخصصة وتتبع نسب الإيرادات

خيارات التتبع المتقدمة

بالإضافة إلى القائمة أعلاه (script.outbound-links.js وscript.file-downloads.js وscript.hash.js وscript.tagged-events.js وscript.pageview-props.js وscript.revenue.js)، لدينا أيضًا بعض خيارات التتبع الأكثر تقدمًا المتاحة. لاحظ أن هذه الخيارات غير مضمنة في قائمة إعداد الموقع، لذا ستحتاج إلى إدراجها في مقتطف التتبع يدويًا.

الامتداد	الشرح
script.compat.js	وضع التوافق لـ تتبع المستخدمين على Internet Explorer (≥IE11)
script.local.js	السماح للتحليلات بالتتبع على localhost أيضًا وهو أمر مفيد في التطبيقات الهجينة
script.manual.js	لا يتم تشغيل عدد مرات عرض الصفحة تلقائيًا. كما يسمح لك بتحديد المواقع المخصصة لحذف عناوين URL باستخدام المعرفات. يمكنك أيضًا استخدامه لتتبع معلمات الاستعلام المخصصة

كيفية تغيير مقتطف التتبع يدويًا

على سبيل المثال، اسم البرنامج النصي الافتراضي في مقتطفنا هو script.js. إذا كان موقع الويب الخاص بك موجودًا على مضيف محلي وترغب في تتبع هذه الزيارات، فلديك خيار تحميل البرنامج النصي بامتداد مختلف: script.local.js.

في هذه الحالة، تكون القطعة التي تحتاج إلى إدراجها في موقعك على النحو التالي (تأكد من تغيير سمة data-domain إلى المجال الذي أضفته إلى Histat):

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.local.js"></script>

يمكنك المزج والمطابقة والجمع بين هذه الامتدادات بأي طريقة تريدها. على سبيل المثال، إذا كنت تريد استخدام كل من التوجيه القائم على التجزئة وتتبع نقرات الروابط الصادرة، فيمكنك الجمع بينهما على النحو التالي: script.hash.outbound-links.js.

في هذه الحالة، تكون القطعة التي تحتاج إلى إدراجها في موقعك على النحو التالي (تأكد من تغيير سمة data-domain إلى المجال الذي أضفته إلى Histat):

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.hash.outbound-links.js"></script>

أو لنقل أنك تريد استخدام ملحق script.revenue.js الخاص بنا لتتبع إيرادات التجارة الإلكترونية وملحق script.local.js الخاص بنا لتتبع حركة مرور localhost، فيجب أن تبدو القطعة الخاصة بك على هذا النحو:

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.revenue.local.js"></script>

ولن تحتاج إلا إلى إدراج هذه القطعة في موقعك، ولا حاجة إلى أي شيء آخر.

script.compat.js

لن يعمل البرنامج النصي Histat الافتراضي على Internet Explorer لأنه يستخدم واجهة برمجة التطبيقات document.currentScript لقراءة خيارات التكوين. يمكنك تشغيل Histat في وضع التوافق من خلال تضمين امتداد script.compat.js وتحديد id="plausible" على علامة البرنامج النصي حتى يتمكن من العثور على نفسه. لاحظ أن هذا يعمل فقط على ≥ IE11. إليك كيف يجب أن يبدو:

<script id="plausible" defer data-domain="yourdomain.com" src="https://histat.com/js/script.compat.js"></script>

script.manual.js

افتراضيًا، يقوم البرنامج النصي Histat بتشغيل عرض الصفحة عند تحميله لأول مرة. كما أنه يربط المستمعين بواجهة برمجة التطبيقات History وسيقوم تلقائيًا بتشغيل مشاهدات الصفحات عندما تستخدم history.pushState. وهذا مفيد لمعظم مواقع الويب ولكننا نقدم أيضًا وضعًا يدويًا في حالة رغبتك في التحكم الكامل في وقت تشغيل مشاهدات الصفحات على موقع الويب الخاص بك.

إحدى حالات الاستخدام لهذا هي عندما تستخدم Turbo (المعروف سابقًا باسم Turbolinks). في هذه الحالة، تريد تشغيل مشاهدات صفحات Histat يدويًا في حدث المتصفح turbo:load أو turbolinks:load حسب المكتبة التي تستخدمها. إليك كيفية القيام بذلك:

<script defer data-domain="yourdomain.com" src="https://histat.com/js/script.manual.js"></script>
<!-- define the `plausible` function to manually trigger events -->
<script>window.plausible = window.plausible || function() { (window.plausible.q = window.plausible.q || []).push(arguments) </script>
<!-- trigger pageviews on turbolinks navigation -->
<script>
document.addEventListener("turbo:load", function() {
plausible('pageview')
})
</script>

عند استخدام turbolinks، يجب التأكد من عدم تحميل نص Histat وتنفيذه أثناء التنقل باستخدام turbo. قد تحتاج إلى نقل البرنامج النصي إلى قسم <head> في موقع الويب الخاص بك أو استخدام السمة data-turbo-eval="false" للقيام بذلك.

ملاحظة

عند استخدام manual.js، فإن كل استدعاء للبرنامج النصي مع 'pageview' يؤدي إلى احتساب عرض صفحة منفصل حتى إذا تم استدعاؤه على نفس الصفحة

تحديد مواقع مخصصة لعناوين URL الخاصة بصفحاتك

بالإضافة إلى ذلك، يسمح لك ملحق البرنامج النصي اليدوي بتوفير خيار خاص يسمى u مع أحداثك. يتيح لك هذا تحديد عنوان URL للصفحة ويمكن استخدامه لتحديد مواقع مخصصة.

من المفيد بشكل خاص تحرير وتجميع صفحات متعددة تحتوي عناوين URL الخاصة بها على معرّفات خاصة بالمستخدمين.

تتبع معلمات الاستعلام المخصصة لعناوين URL للصفحات الكاملة

افتراضيًا، يزيل Histat جميع معلمات الاستعلام لأغراض الخصوصية ref وsource وutm_source وutm_medium وutm_campaign وutm_content وutm_term.

هذا يعني أن الصفحات مثل yoursite.com/blog/index.php?article=some_article&page=11 سيتم الإبلاغ عنها على أنها yoursite.com/blog/index.php في تقرير "أهم الصفحات" في لوحة معلومات Histat الخاصة بك.