يوضِّح هذا الدليل كيفية إعداد قياس أحداث الشاشة باستخدام analytics.js.
نظرة عامة
تمثّل الشاشات في "إحصاءات Google" المحتوى الذي يطّلع عليه المستخدمون داخل أحد التطبيقات. والمفهوم المكافئ للموقع الإلكتروني هو الصفحات. يتيح لك قياس مرات مشاهدة الشاشة معرفة المحتوى الذي يشاهده المستخدمون كثيرًا، وكيفية تنقلهم بين أجزاء مختلفة من المحتوى.
التنفيذ
يمكن إرسال نتائج الشاشة باستخدام الأمر send
وتحديد hitType لـ screenview
. يتضمن الأمر send
التوقيع التالي لنوع نتيجة screenview
:
ga('send', 'screenview', [fieldsObject]);
حقول الشاشة
اسم الحقل | نوع القيمة | مطلوبة | الوصف |
---|---|---|---|
screenName |
text | نعم | اسم الشاشة. |
وعادة ما يتم إرسال بيانات الشاشة إلى الملفات الشخصية في "إحصاءات Google" من النوع "تطبيق" (بدلاً من "ويب")، ما يعني أنه بالإضافة إلى إرسال screenName
، يجب أيضًا إرسال الحقل appName
على الأقل.
يسرد الجدول التالي حقول التطبيقات التي يمكن إرسالها إلى الملفات الشخصية للتطبيقات.
اسم الحقل | نوع القيمة | مطلوبة | الوصف |
---|---|---|---|
appName |
text | نعم | اسم التطبيق. |
appId |
text | لا | رقم تعريف التطبيق. |
appVersion |
text | لا | إصدار التطبيق. |
appInstallerId |
text | لا | رقم تعريف أداة تثبيت التطبيق. |
لمزيد من التفاصيل عن الفرق بين الملفات الشخصية للويب والتطبيقات في "إحصاءات Google"، راجِع مقالة الاختلافات بين الملفات الشخصية للويب والملفات الشخصية في مركز مساعدة "إحصاءات Google".
أمثلة
يُرسِل الأمر التالي نتيجة مشاهدة صفحة في التطبيق إلى "إحصاءات Google" لتطبيق باسم "myAppName" والشاشة "Home":
ga('send', 'screenview', {
'appName': 'myAppName',
'screenName': 'Home'
});
نظرًا لأنه يجب إرسال الحقل appName
مع جميع نتائج التطبيق، من الأفضل غالبًا ضبط هذا الحقل باستخدام الأمر set
:
ga('create', 'GA_MEASUREMENT_ID', 'auto');
ga('set', 'appName', 'myAppName');
// The `appName` field is now set, so
// screenview hits don't need to include it.
ga('send', 'screenview', {screenName: 'Home'});
استخدام الفلاتر لمشاهدات التطبيق فقط أو الويب فقط
وإذا أرسلت بيانات الويب والتطبيقات للموقع نفسه (UA-XXXXX-Y)، ستعرِض "إحصاءات Google" مجموعتَي البيانات في الملفات الشخصية لذلك الموقع. يتيح ذلك جمع مشاهدات التطبيقات والويب.
إذا كنت تريد إرسال بيانات التطبيق والويب للموقع نفسه مع الاحتفاظ بملف شخصي و/أو تطبيق منفصل للويب، يمكنك إنشاء فلاتر. على سبيل المثال، يمكنك استخدام عرض مجمّع (تلقائي)، وعرض ويب، وملف شخصي للتطبيق.
فلتر الملفات الشخصية للتطبيق
أنشئ فلترًا مخصّصًا لتضمين بيانات التطبيق فقط عن طريق ضبط Application?
على yes
.
فلتر عرض الويب
أنشئ فلترًا مخصّصًا لتضمين بيانات الويب فقط عن طريق ضبط Application?
على no
.