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

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

الأبعاد

يمكن طلب الأبعاد التالية في التقارير لأيّ موقع. حدِّد "اسم واجهة برمجة التطبيقات" في حقل 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	عنوان الصفحة واسم الشاشة	عنوان الصفحة (الويب) أو اسم الشاشة (التطبيق) الذي تم تسجيل الحدث عليه.

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

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

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

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

لا تتوافق واجهة برمجة التطبيقات Realtime مع السمات المخصّصة على مستوى الحدث.

المقاييس

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

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

لا تتوافق واجهة برمجة التطبيقات Realtime مع المقاييس المخصّصة على مستوى الحدث.