السمات والمقاييس المتوافقة مع طلبات البحث في طريقة تقارير الوصول إلى البيانات في واجهة برمجة التطبيقات Admin API لخدمة "إحصاءات Google"
الأبعاد
يمكن طلب السمات التالية في تقارير الوصول إلى البيانات. حدِّد
"اسم واجهة برمجة التطبيقات" في حقل name لسمة AccessDimension لعمود السمة في استجابة التقرير.
| اسم واجهة برمجة التطبيقات | اسم واجهة المستخدم | المواقع المسموح بها | الوصف |
|---|---|---|---|
accessDateHour |
تاريخ ووقت الوصول | جميع مواقع "إحصاءات Google" | تاريخ ووقت وصول مستخدِم "إحصاءات Google" إلى بيانات تقارير "إحصاءات Google". منسَّق على هذا النحو: YYYYMMDDHH. |
accessMechanism |
آلية الوصول | مواقع "إحصاءات Google 360" | الآلية التي من خلالها وصل مستخدم "إحصاءات Google" إلى بيانات تقارير "إحصاءات 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" إلى بيانات إعداد تقارير "إحصاءات Google". على سبيل المثال، تمثل دقة الميكرو ثانية في نظام التشغيل Unix التي تبلغ 1655220215027371 التاريخ 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" الذي وصل إلى بيانات تقارير "إحصاءات Google". |
userCountryId |
معرّف بلد المستخدم | مواقع "إحصاءات Google 360" | رقم تعريف البلد لمستخدم "إحصاءات Google" الذي وصل إلى بيانات تقارير "إحصاءات Google". تم تنسيقها وفقًا لمعيار ISO 3166-1 alpha-2. |
userEmail |
البريد الإلكتروني للمستخدم | جميع مواقع "إحصاءات Google" | عنوان البريد الإلكتروني لمستخدم "إحصاءات Google" الذي وصل إلى بيانات تقارير "إحصاءات Google". تسمح بعض عمليات الدمج للمستخدمين بالوصول إلى بيانات إعداد تقارير "إحصاءات Google" من خلال عملية الدمج بدون أن يتمكّن المستخدم من الوصول مباشرةً إلى الموقع. وفي هذه الحالة، سيعرض العمود userEmail مثلاً "مستخدم مرتبط في "إعلانات Google"، وذلك استنادًا إلى عملية الدمج. |
userIP |
عنوان IP للمستخدم | مواقع "إحصاءات Google 360" | عنوان IP الخاص بمستخدم "إحصاءات Google" الذي وصل إلى بيانات تقارير "إحصاءات Google". |
المقاييس
يمكن طلب المقاييس التالية في تقارير الوصول إلى البيانات. حدِّد "اسم واجهة برمجة التطبيقات" في حقل name لمقياس مورد AccessMetric لعمود المقياس في استجابة التقرير.
| اسم واجهة برمجة التطبيقات | اسم واجهة المستخدم | المواقع المسموح بها | الوصف |
|---|---|---|---|
accessCount |
عدد مرات الوصول | مواقع "إحصاءات Google 360" | عدد المرّات التي تمّ فيها الوصول إلى بيانات تقارير "إحصاءات Google". عند استخدام واجهة مستخدم "إحصاءات Google"، يمكن أن تؤدي كل بطاقة تقرير إلى حدث واحد أو أكثر من أحداث الوصول إلى البيانات. ونتيجةً لذلك، فإنّ التنقّل عبر واجهة مستخدم "إحصاءات Google" يمكن أن يؤدي إلى أحداث وصول أكبر من عدد التقارير التي تم عرضها. |
dataApiQuotaPropertyTokensConsumed |
الرموز المميّزة المستخدَمة ضمن حصة Data API للموقع | جميع مواقع "إحصاءات Google" | تعرِض هذه السمة إجمالي الرموز المميّزة المستخدَمة ضمن حصة الموقع لطلبات Data API. |