قياس التطبيقات المكوّنة من صفحة واحدة باستخدام gtag.js

توضّح هذه الصفحة كيفية استخدام gtag.js لقياس التفاعلات مع صفحات على المواقع الإلكترونية التي تحمِّل المحتوى ديناميكيًا، بدون إجراء عمليات تحميل تقليدية للصفحة الكاملة.

نظرة عامة

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

تعمل علامة Google بشكل جيد مع المواقع الإلكترونية التقليدية لأنّ رمز المقتطف يتم تشغيله في كل مرة يُحمِّل فيها المستخدمون صفحة جديدة. ومع ذلك، بالنسبة إلى تطبيق مكوّن من صفحة واحدة حيث يحمّل الموقع الإلكتروني محتوى صفحة جديد ديناميكيًا بدلاً من عمليات تحميل صفحة كاملة، لا يتم تشغيل رمز مقتطف gtag.js مرة واحدة فقط. وهذا يعني أنّه يجب قياس مشاهدات الصفحة (الافتراضية) اللاحقة يدويًا أثناء تحميل محتوى جديد.

قياس عدد المشاهدات الافتراضية لصفحة الويب

عندما يحمّل تطبيقك المحتوى ديناميكيًا ويعدّل عنوان URL في شريط العناوين، يجب أيضًا تعديل عنوان URL للصفحة المُخزنة باستخدام gtag.js. ويمكنك أيضًا قياس التغييرات في العنوان على موقعك الإلكتروني كمشاهدات للصفحة.

لإعداد تقارير gtag.js للمسار، استخدِم الأمر set لتحديد قيمة للمَعلمة page_path:

gtag('set', 'page_path', page_path);
gtag('event', 'page_view');

مثال:

gtag('set', 'page_path', '/new-page.html');
gtag('event', 'page_view');

بعد إضافة القيمة الجديدة لـ page_path، ستستخدم جميع الأحداث اللاحقة المرسَلة إلى ذلك الموقع تلك القيمة الجديدة.

معالجة عناوين URL متعددة للمورد نفسه

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

على سبيل المثال، لنفترض أنّ موقعًا إلكترونيًا يمكن الوصول إلى الصفحة "لمحة عنّا" منه من خلال أيّ من عناوين URL التالية:

  • /about
  • /#/about
  • /home/#/about

لتجنّب التكرار في تقاريرك، من الأفضل تسجيل جميع هذه الصفحات باستخدام السمة /about من أجل page_path.