قياس تطبيقات الصفحة الواحدة

هذا المستند مخصّص للمطوّرين الذين يريدون قياس عدد مشاهدات الصفحات على تطبيقاتهم من صفحة واحدة باستخدام "إحصاءات Google".

التطبيقات من صفحة واحدة (SPA) هي مواقع إلكترونية تحمّل مستند HTML مرة واحدة وتجلب أي محتوى إضافي باستخدام واجهات برمجة تطبيقات JavaScript.

مثال: لنفترض أنّ لديك نموذجًا للحصول على بعض العملاء المحتملين. يتضمّن النموذج ثلاث شاشات: > * الشاشة الأولى لتسجيل معلومات العميل * الشاشة الثانية التي يشير فيها العملاء إلى اهتمامهم بخدمات معيّنة * صفحة الشاشة الثالثة للاشتراك في البرامج التعليمية على الويب ذات الصلة باهتمامات العميل

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

قبل البدء

تفترض هذه الصفحة أنّك تملك ما يلي:

• حساب وموقع على "إحصاءات Google" لموقعك الإلكتروني كيفية إعداد "إحصاءات Google"

• "علامة تتبُّع من Google" يتم تنفيذها على موقعك الإلكتروني ويتم تنشيطها عند تحميل الصفحة في البداية كيفية إعداد علامة التتبُّع من Google

تنفيذ قياس التطبيقات من صفحة واحدة

لتنفيذ قياس دقيق لتطبيق من صفحة واحدة (SPA)، استخدِم إحدى الإجراءات التالية لتشغيل مشاهدة صفحة على الويب افتراضية جديدة:

• تغييرات سجلّ المتصفّح (يُنصح بها): إذا كان تطبيق من صفحة واحدة يستخدم واجهة برمجة التطبيقات للسجلّ، وتحديدًا الإجراء pushState() وreplaceState() لتحديث الشاشات، استخدِم هذا الخيار.

• الأحداث المخصّصة: إذا كان موقعك الإلكتروني يستخدم العنصر DocumentFragment لعرض شاشات مختلفة، استخدِم هذا الخيار.

تنفيذ تغيير سجلّ المتصفّح

إذا كان تطبيق الصفحة الواحدة يستخدم History API، يمكنك تفعيل ميزة "القياس المحسّن" في "إحصاءات Google" لتتبُّع مشاهدات الصفحة تلقائيًا استنادًا إلى أحداث سجلّ المتصفّح.

تفعيل ميزة "القياس المحسَّن" في "إحصاءات Google"

لقياس page_views تلقائيًا استنادًا إلى سجلّ المتصفّح:

1. افتح إحصاءات Google.

2. في قسم المشرف، ضمن جمع البيانات وتعديلها، انقر على "مصادر البيانات" > "الموقع الإلكتروني".

3. ضِمن القياس المحسَّن، اضبط مفتاح التبديل على تفعيل لتفعيل كل الخيارات.

4. انقر لتعديل الخيارات الفردية. ضمن مشاهدات الصفحة، انقر على عرض الإعدادات المتقدّمة. تأكَّد من تفعيل كلّ من عمليات تحميل الصفحة وتغييرات الصفحة استنادًا إلى أحداث سجلّ المتصفّح.

   

5. احفظ التغييرات.

التحقّق من إعدادات القياس

للتأكّد من أنّ تطبيقك من صفحة واحدة يقيس مشاهدات الصفحة بشكل صحيح، اتّبِع الخطوات التالية:

1. فعِّل وضع تصحيح الأخطاء لكل علامة في إعدادات قياس تطبيق الصفحة الواحدة. كيفية مراقبة الأحداث في DebugView

2. انقر على تطبيق الصفحة الواحدة. عند النقر على شاشة افتراضية جديدة، من المفترض أن يظهر لك حدث page_view جديد في DebugView. قارِن بين مَعلمات الحدث page_view والحدث page_view السابق للتحقّق مما إذا تم تعديل المُحيل إلى الصفحة وموقع الصفحة بشكل صحيح.

اعتبارات إضافية لتطبيقات الصفحة الواحدة

بالإضافة إلى إرسال أحداث page_view، ننصحك بمراعاة هذه الجوانب الإضافية لدمج تطبيقات الصفحة الواحدة (SPA) بشكل فعّال مع "إحصاءات Google" وتحسين تجربة المستخدم:

إدارة موضع الانتقال

عندما يتنقّل المستخدمون بين طرق العرض في تطبيق SPA، يحتفظ المتصفّح عادةً بموضع الانتقال الحالي. وقد يعني ذلك أنّ المستخدمين لا يرون الجزء العلوي من الصفحة الافتراضية الجديدة، ويمكن أن يؤثر ذلك في تتبُّع عمق التنقل في الصفحة.

اقتراح: يمكنك إعادة ضبط موضع الانتقال إلى أعلى الصفحة أو حاوية المحتوى الرئيسي آليًا بعد كل انتقال افتراضي للصفحة.

// Example: Reset window scroll position on a route change in your SPA
window.scrollTo(0, 0);

// Or, if your content is within a specific element:
// document.getElementById('main-content').scrollTo(0, 0);

من خلال هذا التغيير، سيبدأ المستخدمون من أعلى المحتوى الجديد، ما يتيح لميزة تتبُّع الانتقال للأسفل في "إحصاءات Google" قياس التفاعل على الصفحة الافتراضية الجديدة بدقة.

ضمان سهولة الوصول إلى المحتوى لميزات المتصفّح

إذا أبلغ المستخدمون عن مشاكل في ميزات المتصفّح، مثل عدم عمل ميزة البحث في الصفحة (Ctrl+F) بعد تحميل صفحة افتراضية، قد يشير ذلك إلى كيفية تحديث تطبيق الصفحة الواحدة لنموذج DOM.

نصيحة: تأكَّد من أنّ إطار عمل تطبيق الصفحة الواحدة ومنطق التوجيه يحدّثان الأجزاء ذات الصلة من نموذج DOM بشكل كامل ومتزامن مع محتوى الصفحة الجديدة. قد لا تتمكّن وظيفة البحث في المتصفّح من فهرسة المحتوى الذي يتأخر عرضه أو المحتوى المخفي من شجرة نموذج العناصر في المستند الرئيسية على الفور. اختبِر البحث على الصفحة بعد عمليات التنقّل الافتراضية للتأكّد من إمكانية الوصول إلى المحتوى.

التأثير في الأحداث التلقائية

إذا نفّذت قياس مشاهدات الصفحات الافتراضية بشكل صحيح في تطبيق من صفحة واحدة، ستتعامل "إحصاءات Google" مع الأحداث التلقائية الأخرى بشكل مناسب. إذا لم يتم تسجيل مشاهدات الصفحات الافتراضية عند تغيير الشاشات، ستتعامل "إحصاءات Google" مع تطبيق من صفحة واحدة كصفحة واحدة، ما يؤدي إلى مقاييس غير دقيقة.

على سبيل المثال، يقيس الحدث user_engagement الوقت الذي يقضيه المستخدم بشكل نشط على صفحة معيّنة. بدون مشاهدات الصفحات الافتراضية، يتمّ تحديد مصدر كلّ وقت التفاعل على أنّه تحميل الصفحة الأوّلي، ما يجعل من المستحيل تحليل الوقت المستغرَق في الشاشات الفردية.

عند تنفيذ قياس عدد المشاهدات الافتراضية لصفحة الويب بشكلٍ صحيح:

• يتم إرسال الحدث user_engagement عندما ينتقل المستخدم من صفحة افتراضية إلى أخرى.
• يتم احتساب مدة التفاعل للصفحة الافتراضية السابقة وإرسالها مع الحدث user_engagement، عادةً قبل معالجة الحدث page_view للصفحة الافتراضية الجديدة.
• ترتبط الأحداث الأخرى، مثل النقرات أو الانتقال إلى محتوى معيّن، بالسمة page_location للصفحة الافتراضية التي يشاهدها المستخدم حاليًا.

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