السمات والمقاييس المتوافقة مع طلبات البحث في طريقة الوقت الفعلي لواجهة برمجة التطبيقات لبيانات "إحصاءات Google" تقبل methods (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"
في طلب Data API لإنشاء تقرير عن
السمة المخصّصة على مستوى المستخدِم التي تحمل اسم المَعلمة "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.