السمات والمقاييس في الوقت الفعلي

السمات والمقاييس المتاحة في طلبات البحث إلى طريقة الوقت الفعلي في Analytics Data API تقبل طرق إعداد التقارير الأساسية (RunReport على سبيل المثال) مجموعة مختلفة من السمات والمقاييس مقارنةً بطريقة "الوقت الفعلي".

الأبعاد

يمكن طلب السمات التالية في التقارير لأي موقع. حدِّد "اسم واجهة برمجة التطبيقات" في حقل name لمورد Dimension لعمود السمة في استجابة التقرير.

اسم واجهة برمجة التطبيقات اسم واجهة المستخدم الوصف
appVersion إصدار التطبيق versionName للتطبيق (Android) أو الإصدار القصير للحزمة (iOS).
audienceId رقم تعريف الجمهور المعرّف الرقمي لشريحة جمهور ويتم الإبلاغ عن المستخدمين في شرائح الجمهور التي كانوا ينتمون إليها خلال النطاق الزمني للتقرير. لا يؤثر سلوك المستخدمين الحالي في انتماءاتهم السابقة إلى شرائح الجمهور في التقارير.
audienceName اسم شريحة الجمهور الاسم المحدّد للجمهور ويتم الإبلاغ عن المستخدمين في شرائح الجمهور التي كانوا ينتمون إليها خلال النطاق الزمني للتقرير. لا يؤثر سلوك المستخدمين الحالي في انتماءاتهم السابقة إلى شرائح الجمهور في التقارير.
audienceResourceName اسم مورد الجمهور اسم المورد لهذا الجمهور تحتوي أسماء الموارد على معرّفات المجموعات والموارد لتحديد مورد بشكل فريد. لمزيد من المعلومات، يُرجى الاطّلاع على أسماء الموارد.
city المدينة المدينة التي نشأ منها نشاط المستخدِم.
cityId رقم تعريف المدينة المعرّف الجغرافي للمدينة التي نشأ منها نشاط المستخدم، والمستمد من عنوان IP الخاص به.
country البلد البلد الذي نشأ منه نشاط المستخدِم.
countryId رقم تعريف البلد المعرّف الجغرافي للبلد الذي نشأ منه نشاط المستخدم، والمستمد من عنوان IP الخاص به. يجب تنسيقها وفقًا لمعيار ISO 3166-1 alpha-2.
deviceCategory فئة الجهاز نوع الجهاز: جهاز كمبيوتر مكتبي أو لوحي أو جوّال.
eventName اسم الحدث اسم الحدث
minutesAgo قبل دقائق في الوقت الفعلي عدد الدقائق التي مضت منذ جمع حدث معيّن. ‫00 هي الدقيقة الحالية، و01 تعني الدقيقة السابقة.
platform النظام الأساسي النظام الأساسي الذي تم تشغيل تطبيقك أو موقعك الإلكتروني عليه، على سبيل المثال، ويب أو iOS أو Android. لتحديد نوع مصدر البيانات في تقرير، استخدِم كلاً من platform وstreamId.
streamId رقم تعريف مصدر البيانات المعرّف الرقمي لمصدر البيانات في تطبيقك أو موقعك الإلكتروني
streamName اسم مصدر البيانات اسم مصدر البيانات لتطبيقك أو موقعك الإلكتروني
unifiedScreenName عنوان الصفحة واسم الشاشة عنوان الصفحة (على الويب) أو اسم الشاشة (في التطبيق) التي تم تسجيل الحدث عليها

السمات المخصّصة

يمكن لواجهة Realtime Data API إنشاء تقارير عن السمات المخصّصة على مستوى المستخدِم. يمكنك الاطّلاع على خصائص المستخدمين المخصّصة لمعرفة المزيد عن السمات المخصّصة. يتم تحديد السمات المخصّصة في طلب تقرير واجهة برمجة التطبيقات من خلال اسم مَعلمة السمة ونطاقها. على سبيل المثال، يمكنك تضمين "customUser:last_level" في طلب البيانات من واجهة برمجة التطبيقات لإنشاء تقرير للسمة المخصّصة على مستوى المستخدم التي تحمل اسم المَعلمة "last_level". سيتعذّر طلب البيانات هذا من واجهة برمجة التطبيقات إذا لم يسجّل الموقع هذه السمة المخصّصة على مستوى المستخدم.

في ما يلي البنية العامة للسمات المخصّصة. يمكنك الاستعلام عن طريقة Metadata API لإدراج جميع السمات المخصّصة لموقع معيّن.

اسم واجهة برمجة التطبيقات العامة الوصف
customUser:parameter_name السمة المخصّصة على مستوى المستخدِم لـ parameter_name

لا تتوفّر السمات المخصّصة على مستوى الحدث في Realtime API.

المقاييس

يمكن طلب المقاييس التالية في التقارير لأي موقع. حدِّد "اسم واجهة برمجة التطبيقات" في حقل name لمورد Metric لعمود المقياس في ردّ التقرير.

اسم واجهة برمجة التطبيقات اسم واجهة المستخدم الوصف
activeUsers المستخدِمون النشطون عدد المستخدمين المختلفين الذين زاروا موقعك الإلكتروني أو تطبيقك.
eventCount عدد الأحداث عدد الأحداث
keyEvents الأحداث الرئيسية عدد الأحداث الرئيسية عند تصنيف حدث على أنّه حدث رئيسي، سيؤثّر ذلك في التقارير منذ وقت إنشائها. ولا يؤدّي ذلك إلى تغيير البيانات السابقة. يمكنك تصنيف أي حدث على أنّه حدث رئيسي في "إحصاءات Google"، كما أنّ بعض الأحداث (مثل first_open أو purchase) يتم تصنيفها تلقائيًا على أنّها أحداث رئيسية.
screenPageViews المشاهدات عدد شاشات التطبيق أو صفحات الويب التي اطّلع عليها المستخدمون. ويتم احتساب مرات المشاهدة المكرّرة لصفحة أو شاشة واحدة. (أحداث screen_view + page_view)

لا تتيح Realtime API استخدام المقاييس المخصّصة على مستوى الحدث.