سجلّ التغييرات في واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي في "إحصاءات Google"

يدخل هذا الإصدار تغييرات على حصص وحدود واجهة برمجة التطبيقات في الوقت الفعلي في "إحصاءات Google".

طلبات بيانات من "واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي" في "إحصاءات Google" تساهم في الحد الأقصى اليومي البالغ 10,000 اتصال لكل ملف شخصي (الملف الشخصي) على قدم المساواة مع طلبات البيانات من واجهة برمجة التطبيقات الأخرى في "إحصاءات Google". يتم الآن احتساب طلبات البيانات من واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي في "إحصاءات Google" بشكل منفصل، ما يعني أنّه من الممكن إجراء 10,000 اتصال يوميًا لكل ملف شخصي باستخدام "واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي" في "إحصاءات Google" وإجراء 10,000 اتصال آخر يوميًا لكل ملف شخصي باستخدام أي واجهات برمجة تطبيقات أخرى لخدمة "إحصاءات Google". يمكنك الاطّلاع على صفحة الحدود والحصص لمزيد من المعلومات.

ويوفّر هذا التغيير منهجًا أكثر دقة وأمانًا من حيث الإخفاق لإدارة الحصص، بحيث لا تؤدي المكالمات المتكررة التي تستخدم واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي في "إحصاءات Google" إلى حظر جميع طلبات البيانات الأخرى من واجهة برمجة التطبيقات في "إحصاءات Google" لبقية اليوم لملف شخصي فردي.

هذا إصدار لإصلاح الخطأ:

• يعالج هذا الإصدار مشكلة تتعلّق بفرض قيود الفلترة في طلبات البحث في واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي. ستؤدي الطلبات التي تتضمّن السمة rt:activeUsers وفلترًا على سمة على مستوى الحدث إلى ظهور خطأ لسبب badRequest وستظهر رسالة تشير إلى OR operator not supported for a hit level filter. يُرجى الانتقال إلى دليل المطوّر حول واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي للاطّلاع على مزيد من التفاصيل حول قيود طلبات البحث.

يتضمّن هذا الإصدار سمة جديدة. راجِع مرجع المقاييس والسمات للحصول على القائمة الكاملة للتعريفات.

الوقت

• السمة - rt:minutesAgo - عدد الدقائق التي مضى على حدوثها نتيجة.

يتضمّن هذا الإصدار إعادة تسمية السمات والمقاييس. راجِع مرجع المقاييس والسمات للحصول على القائمة الكاملة للتعريفات.

السمات والمقاييس المُعاد تسميتها

تمت إعادة تسمية السمات والمقاييس التالية. يمكنك الاطّلاع على سياسة إيقاف البيانات نهائيًا للحصول على تفاصيل عن إعادة تسمية البيانات:

المستخدِم

• السمة - rt:visitorType - استخدِم rt:userType بدلاً منها.
• المقياس - rt:activeVisitors - استخدِم rt:activeUsers بدلاً منه.

تم إيقاف بادئة ga:

تم إيقاف البادئة ga: نهائيًا لجميع الأبعاد والمقاييس في الوقت الفعلي، وتم استبدالها بالبادئة rt: الجديدة. وستستمر طلبات البيانات من واجهة برمجة التطبيقات التي تستخدم البادئة ga: في العمل لمدة 6 أشهر، وبعدها سيظهر خطأ.

السمات والمقاييس الجديدة

يؤدي هذا التعديل إلى إضافة سمات ومقاييس جديدة إلى واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي. يمكنك الرجوع إلى مرجع المقاييس والسمات للاطّلاع على القائمة الكاملة.

تتبع الأحداث

• السمة - rt:eventAction - إجراء الحدث.
• السمة - rt:eventCategory - فئة الحدث.
• السمة - rt:eventLabel - تصنيف الحدث.
• السمة - rt:totalEvents - إجمالي عدد الأحداث للملف الشخصي في جميع الفئات.

تتبع الأهداف

• السمة - rt:goalId - سلسلة مطابقة لرقم تعريف الهدف.
• المقياس - rt:goalXXValue - إجمالي القيمة الرقمية لرقم الهدف المطلوب، حيث يمثل XX رقمًا بين 1 و20.
• المقياس - rt:goalValueAll - القيمة الرقمية الإجمالية لجميع الأهداف المحددة في ملفك الشخصي.
• المقياس - rt:goalXXCompletions - إجمالي عدد الأهداف المكتملة لرقم الهدف المطلوب، حيث يشكّل XX رقمًا بين 1 و20.
• المقياس - rt:goalCompletionsAll - إجمالي عدد الأهداف المكتملة لكل الأهداف المحددة لملفك الشخصي.

تتبع الصفحات

• المقياس - rt:pageViews - إجمالي عدد مشاهدات الصفحة.

تتبع التطبيق

• المقياس - rt:screenViews - إجمالي عدد مرات مشاهدة الصفحة في التطبيق.

هذا هو الإصدار الأولي من واجهة برمجة التطبيقات Real Time Reporting API المتوفّرة في إصدار تجريبي محدود:

• تتيح لك واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي إعداد تقارير عن النشاط الذي يحدث على موقعك في الوقت الفعلي. يمكنك استخدام واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي لطلب البحث عن السمات والمقاييس من أجل إنشاء لوحات بيانات وتطبيقات مصغّرة موجّهة للعملاء. لمزيد من التفاصيل، يُرجى الانتقال إلى مقالة نظرة عامة على واجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي.