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

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

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

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

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

قبل البدء

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

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

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

  • تغييرات سجلّ المتصفّح (يُنصح بها): إذا كان تطبيقك من صفحة واحدة (SPA) يستخدم History API، وتحديدًا الطريقتَين 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، ننصحك بمراعاة الجوانب الإضافية التالية لتحقيق تكامل قوي بين الصفحات الأحادية مع "إحصاءات Google" وتقديم تجربة أفضل للمستخدمين:

إدارة موضع التمرير

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

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

// 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) بعد تحميل صفحة افتراضية، قد يشير ذلك إلى طريقة تعديل تطبيقك ذي الصفحة الواحدة (SPA) لنموذج المستند (DOM).

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

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

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

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

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

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

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