السمات والمقاييس المتوافقة مع طلبات البحث في طريقة تقارير الوصول إلى البيانات في واجهة برمجة التطبيقات Admin API لخدمة "إحصاءات Google"
الأبعاد
يمكن طلب السمات التالية في تقارير الوصول إلى البيانات. حدِّد "اسم واجهة برمجة التطبيقات" في حقل سمة name لملف موارد AccessDimension
لأعمدة السمة في ردّ ملف التقارير.
| اسم واجهة برمجة التطبيقات | اسم واجهة المستخدم | المواقع المسموح بها | الوصف |
|---|---|---|---|
accessDateHour |
تاريخ ووقت الوصول | جميع مواقع "إحصاءات Google" | يشير ذلك إلى الساعة والتاريخ اللذان وصل فيهما مستخدِم "إحصاءات Google" إلى بيانات التقارير في هذه الخدمة. منسَّق على هذا النحو: YYYYMMDDHH. |
accessMechanism |
آلية الوصول | مواقع "إحصاءات Google 360" | هي الآلية التي وصل من خلالها مستخدِم "إحصاءات Google" إلى بيانات التقارير في هذه الخدمة. تشمل القيم المحتمَلة ما يلي: "واجهة مستخدِم إحصاءات Google" و"Google Analytics API" و"Firebase" و"إعلانات Google" وغيرها. |
accessedPropertyId |
معرّف الموقع الذي تم الوصول إليه | جميع مواقع "إحصاءات Google" | رقم تعريف الموقع الذي تم الوصول فيه إلى بيانات تقارير "إحصاءات Google". لا تحتوي معظم تقارير "الوصول إلى البيانات" إلّا على موقع واحد، ولكن إذا كان الموقع المطلوب يتضمّن موقعًا فرعيًا، ستحتوي تقارير "الوصول إلى البيانات" على عمليات الوصول إلى كلّ من الموقع المصدر والموقع الفرعي. لمزيد من المعلومات، اطّلِع على المقالة لمحة عن المواقع الفرعية. |
accessedPropertyName |
اسم الموقع الذي تم الوصول إليه | جميع مواقع "إحصاءات Google" | هو الاسم المعروض للموقع الذي تم الوصول فيه إلى بيانات تقارير "إحصاءات Google". لا تحتوي معظم تقارير "الوصول إلى البيانات" إلّا على موقع واحد، ولكن إذا كان الموقع المطلوب يتضمّن موقعًا فرعيًا، ستحتوي تقارير "الوصول إلى البيانات" على عمليات الوصول إلى كلّ من الموقع المصدر والموقع الفرعي. لمزيد من المعلومات، اطّلِع على المقالة لمحة عن المواقع الفرعية. |
accessorAppName |
اسم التطبيق المستخدَم في الوصول | جميع مواقع "إحصاءات Google" | هو اسم التطبيق الذي وصل إلى بيانات تقارير "إحصاءات Google". أنت تمنح التطبيقات والخدمات التابعة لجهات خارجية الإذن بالوصول إلى بيانات تقاريرك في "إحصاءات Google". لمزيد من المعلومات، اطّلِع على المقالة إدارة عمليات الربط بين حسابك على Google والجهات الخارجية. |
costDataReturned |
عرض بيانات التكلفة | مواقع "إحصاءات Google 360" | تعرِض هذه السمة القيمة true إذا تم عرض بيانات التكلفة في هذا التقرير. وفي حال عدم عرض هذه البيانات، تعرِض هذه السمة القيمة false. لا يمكن لمستخدِمي "إحصاءات Google" الذين تم فرض القيّد "بدون مقاييس تكلفة" عليهم الاطّلاع على مقاييس التكلفة. وستظلّ هذه السمة تعرض القيمة false دائمًا ما دام هذا القيّد نشطًا. لمزيد من المعلومات، اطّلِع على المقالة إدارة أذونات الوصول والقيود المفروضة على البيانات. |
dataApiQuotaCategory |
فئة حصة Data API | جميع مواقع "إحصاءات Google" | فئة الحصة لطلب البيانات من واجهة Data API: تشمل القيم المحتمَلة ما يلي: "أساسية" و"الوقت الفعلي" و"مسار الإحالة الناجحة". |
epochTimeMicros |
الوقت بوحدات المايكروثانية | مواقع "إحصاءات Google 360" | تشير إلى عدد الميكروثانية على نظام التشغيل يونكس منذ بداية الفترة التي وصل فيها مستخدِم "إحصاءات Google" إلى بيانات التقارير في هذه الخدمة. على سبيل المثال، تمثل 1655220215027371 ثانية ميكروية في نظام التشغيل Unix التاريخ 14-06-2022 11:23:35 في المنطقة الزمنية America/New_York. |
mostRecentAccessEpochTimeMicros |
وقت آخر وصول بوحدة المايكروثانية | مواقع "إحصاءات Google 360" | الطابع الزمني لآخر عملية وصول إلى هذا الصف يتم عرضها بالميكرو ثانية في نظام التشغيل Unix منذ بدء حساب الفترة. تُستخدَم هذه السمة بشكل شائع مع "userEmail" والسمات المشابهة لتحديد أوقات الوصول الأخيرة لمستخدمي "إحصاءات Google". |
reportType |
نوع التقرير | مواقع "إحصاءات Google 360" | نوع بيانات التقارير التي وصل إليها مستخدِم "إحصاءات Google" تشمل القيم المحتمَلة ما يلي: "إعداد التقارير" و"الوقت الفعلي" و"الاستكشاف ذو التصميم المرن" و"استكشاف خطوات المستخدِمين" وغيرها. |
revenueDataReturned |
عرض بيانات الإيرادات | مواقع "إحصاءات Google 360" | تعرِض هذه السمة القيمة true إذا تم عرض بيانات الأرباح في هذا التقرير. وفي حال عدم عرض هذه البيانات، تعرِض هذه السمة القيمة false. لا يمكن لمستخدِمي "إحصاءات Google" الذين تم فرض القيّد "بدون مقاييس الأرباح" عليهم الاطّلاع على مقاييس الأرباح. وستظلّ هذه السمة تعرض القيمة false دائمًا ما دام هذا القيّد نشطًا. لمزيد من المعلومات، اطّلِع على المقالة إدارة أذونات الوصول والقيود المفروضة على البيانات. |
userCountry |
بلد المستخدم | مواقع "إحصاءات Google 360" | بلد مستخدِم "إحصاءات Google" الذي وصل إلى بيانات التقارير في هذه الخدمة. |
userCountryId |
معرّف بلد المستخدم | مواقع "إحصاءات Google 360" | رقم تعريف البلد لمستخدِم "إحصاءات Google" الذي وصل إلى بيانات التقارير في هذه الخدمة. تم تنسيقه وفقًا لمعيار ISO 3166-1 alpha-2. |
userEmail |
البريد الإلكتروني للمستخدم | جميع مواقع "إحصاءات Google" | عنوان البريد الإلكتروني لمستخدِم "إحصاءات Google" الذي وصل إلى بيانات التقارير في هذه الخدمة. تسمح بعض عمليات الدمج للمستخدِمين بالوصول إلى بيانات تقارير "إحصاءات Google" من خلال عملية الدمج بدون أن يتمكّن المستخدِم من الوصول مباشرةً إلى الموقع. وفي هذه الحالة، سيعرِض الحقل userEmail مثلاً "المستخدِم المرتبط بحساب إعلانات Google"، وذلك استنادًا إلى عملية الدمج. |
userIP |
عنوان IP للمستخدم | مواقع "إحصاءات Google 360" | عنوان IP لمستخدِم "إحصاءات Google" الذي وصل إلى بيانات التقارير في هذه الخدمة. |
المقاييس
يمكن طلب المقاييس التالية في تقارير الوصول إلى البيانات. حدِّد "اسم واجهة برمجة التطبيقات
" في حقل name مقياس موارد
AccessMetric
لعمود المقياس في ردّ
التقرير.
| اسم واجهة برمجة التطبيقات | اسم واجهة المستخدم | المواقع المسموح بها | الوصف |
|---|---|---|---|
accessCount |
عدد مرات الوصول | مواقع "إحصاءات Google 360" | عدد المرّات التي تمّ فيها الوصول إلى بيانات تقارير "إحصاءات Google". عند استخدام واجهة مستخدِم "إحصاءات Google"، يمكن أن تؤدّي كل بطاقة تقرير إلى حدث واحد أو أكثر من أحداث الوصول إلى البيانات. نتيجةً لذلك، يمكن أن يؤدّي التنقّل في واجهة مستخدِم "إحصاءات Google" إلى تسجيل المزيد من أحداث الوصول مقارنةً بعدد التقارير التي تمّ عرضها. |
dataApiQuotaPropertyTokensConsumed |
الرموز المميّزة المستخدَمة ضمن حصة Data API للموقع | جميع مواقع "إحصاءات Google" | تعرِض هذه السمة إجمالي الرموز المميّزة المستخدَمة ضمن حصة الموقع لطلبات البيانات من واجهة برمجة التطبيقات Data API. |