السمات والمقاييس المتاحة في طلبات البحث إلى طريقة "الوقت الفعلي" في Analytics Data API. تقبل
طرق إعداد التقارير الأساسية (RunReport`
على سبيل المثال) مجموعة مختلفة من السمات والمقاييس
عن طريقة "الوقت الفعلي".
الأبعاد
يمكن طلب السمات التالية في تقارير أيّ موقع. حدِّد "اسم واجهة برمجة التطبيقات" في حقل name لمورد Dimension لعمود السمة في استجابة التقرير.
| اسم واجهة برمجة التطبيقات | اسم واجهة المستخدم | الوصف |
|---|---|---|
| appVersion | إصدار التطبيق | versionName للتطبيق (Android) أو الإصدار القصير للحزمة (iOS). |
| audienceId | رقم تعريف الجمهور | المعرّف الرقمي لشريحة جمهور معيّنة. ويتمّ الإبلاغ عن المستخدِمين في شرائح الجمهور التي كانوا ينتمون إليها خلال النطاق الزمني للتقرير. لا يؤثر سلوك المستخدمين الحالي في انتماءاتهم السابقة إلى شرائح الجمهور في التقارير. |
| audienceName | اسم شريحة الجمهور | الاسم المحدّد لشريحة جمهور. ويتمّ الإبلاغ عن المستخدِمين في شرائح الجمهور التي كانوا ينتمون إليها خلال النطاق الزمني للتقرير. لا يؤثر سلوك المستخدمين الحالي في انتماءاتهم السابقة إلى شرائح الجمهور في التقارير. |
| مدينة | المدينة | المدينة التي نشأ منها نشاط المستخدِم. |
| cityId | رقم تعريف المدينة | رقم التعريف الجغرافي للمدينة التي نشأ منها نشاط المستخدِم، المستمد من عنوان IP الخاص بجهاز المستخدم. |
| بلد | البلد | البلد الذي نشأ منه نشاط المستخدِم. |
| countryId | رقم تعريف البلد | رقم التعريف الجغرافي للبلد الذي نشأ منه نشاط المستخدِم، المستمد من عنوان IP الخاص بجهاز المستخدم. يتم تنسيقه وفقًا لمعيار ISO 3166-1 alpha-2. |
| deviceCategory | فئة الجهاز | نوع الجهاز: جهاز كمبيوتر مكتبي أو لوحي أو جوّال. |
| eventName | اسم الحدث | اسم الحدث |
| minutesAgo | قبل دقائق في الوقت الفعلي | عدد الدقائق قبل جمع الحدث. 00 هو الدقيقة الحالية، ويعني 01 الدقيقة السابقة. |
| platform | النظام الأساسي | النظام الأساسي الذي تم تشغيل تطبيقك أو موقعك الإلكتروني عليه، على سبيل المثال، ويب أو iOS أو Android. لتحديد نوع مصدر بيانات في أحد التقارير، استخدِم كلاً من النظام الأساسي ومعرّف مصدر البيانات. |
| streamId | رقم تعريف مصدر البيانات | المعرّف الرقمي لمصدر البيانات لتطبيقك أو موقعك الإلكتروني. |
| streamName | اسم مصدر البيانات | اسم مصدر البيانات لتطبيقك أو موقعك الإلكتروني. |
| unifiedScreenName | عنوان الصفحة واسم الشاشة | عنوان الصفحة (الويب) أو اسم الشاشة (التطبيق) التي تم تسجيل الحدث عليها |
السمات المخصّصة
يمكن لواجهة برمجة تطبيقات البيانات في الوقت الفعلي إنشاء تقارير عن السمات المخصّصة على مستوى المستخدم. اطّلِع على
خصائص المستخدِمين المخصّصة
لمعرفة المزيد عن السمات المخصّصة. يتمّ تحديد الأبعاد المخصّصة في طلب تقرير واجهة برمجة التطبيقات
بواسطة اسم معلمة السمة ونطاقها. على سبيل المثال، يمكنك تضمين
"customUser:last_level" في طلب Data API لإنشاء تقرير
للسمة المخصّصة على مستوى المستخدم مع اسم المَعلمة "last_level". سيتعذّر تنفيذ طلب البيانات من واجهة برمجة التطبيقات هذا إذا لم يسجّل الموقع هذه السمة المخصّصة على مستوى المستخدم.
في ما يلي البنية العامة للمكوّنات المخصّصة. يمكنك إجراء طلب بحث عن طريقة واجهة برمجة تطبيقات البيانات الوصفية لإدراج جميع السمات المخصّصة لموقع ما.
| الاسم العام لواجهة برمجة التطبيقات | الوصف |
|---|---|
| customUser:parameter_name | السمة المخصّصة على مستوى المستخدِم للمَعلمة parameter_name |
لا يمكن استخدام السمات المخصّصة على مستوى الحدث في الوقت الفعلي في واجهة برمجة التطبيقات.
المقاييس
يمكن طلب المقاييس التالية في تقارير أي موقع. حدِّد "اسم واجهة برمجة التطبيقات" في حقل name لمورد Metric لعمود من المقياس في استجابة التقرير.
| اسم واجهة برمجة التطبيقات | اسم واجهة المستخدم | الوصف |
|---|---|---|
| activeUsers | المستخدِمون النشطون | عدد المستخدمين المختلفين الذين زاروا موقعك الإلكتروني أو تطبيقك. |
| الإحالات الناجحة | الإحالات الناجحة | عدد أحداث الإحالات الناجحة. يتمّ وضع علامة على الأحداث كإحالات ناجحة في وقت جمع البيانات، ويتمّ تطبيق التغييرات على علامة الإحالة الناجحة للحدث من الآن فصاعدًا. يمكنك وضع علامة على أي حدث لتصنيفه كإحالة ناجحة في "إحصاءات Google"، كما يمكنك تلقائيًا وضع علامة على بعض الأحداث (مثل first_open وpurchase) كإحالات ناجحة. للمزيد من المعلومات، اطّلِع على المقالة لمحة عن الإحالات الناجحة. |
| eventCount | عدد الأحداث | عدد الأحداث. |
| screenPageViews | مشاهدة | عدد صفحات التطبيق أو الويب التي شاهدها المستخدِمون. ويتم احتساب مرات المشاهدة المكرّرة لصفحة أو شاشة واحدة. (أحداث screen_view + page_view). |
لا تتوفّر المقاييس المخصَّصة على مستوى الحدث في واجهة برمجة التطبيقات 'الوقت الفعلي'.