"إحصاءات Google" - كل التغييرات في واجهة برمجة تطبيقات الضبط

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

الاشتراك في سجلات التغييرات ذات الصلة

كل سجلّات التغييرات في واجهة برمجة تطبيقات "إحصاءات Google"
–
الاشتراك rss

يتضمن جميع واجهات برمجة التطبيقات للتجميع والضبط وإعداد التقارير.

جميع تغييرات واجهة برمجة تطبيقات الضبط
–
الاشتراك rss

ويتضمن ذلك واجهة برمجة تطبيقات الإدارة وواجهة برمجة تطبيقات إدارة الحسابات.

إعدادات الاحتفاظ ببيانات المستخدمين في Management API

ويمكن الآن ضبط إعدادات الاحتفاظ بالبيانات للمستخدمين آليًا باستخدام الحقلَين الجديدَين"dataالاحتفاظTtl"و"dataholdResetOnNewActivity"الذي تمت إضافته إلى مورد WebProperty.

هذا هو الإصدار الأولي من واجهة برمجة تطبيقات حذف بيانات المستخدم:

  • تسمح واجهة برمجة تطبيقات حذف بيانات المستخدِم لعميل "إحصاءات Google" بحذف بيانات مستخدم نهائي من مشروع أو موقع إلكتروني. يمكن تقديم طلبات حذف حسابات المستخدمين باستخدام مشاريع Firebase أو مواقع "إحصاءات Google". وللحصول على مزيد من التفاصيل، يمكنك الانتقال إلى نظرة عامة على واجهة برمجة تطبيقات حذف بيانات المستخدم.

كتابة العمليات في Management API

كتابة العمليات في واجهة برمجة تطبيقات الإدارة (مثل الإنشاء والتحديث والحذف والتصحيح) لموارد الويب والعرض (الملف الشخصي) وموارد الهدف لم تعد تتطلب القائمة البيضاء. الحد اليومي التلقائي لجميع عمليات الكتابة في Management API هو 50 كتابة في اليوم. لمزيد من المعلومات، يمكنك الاطّلاع على صفحة الحدود والحصص.

المقاييس المخصّصة

هذا إصدار مخصّص لإصلاح الخطأ، ويحدّد المشكلة التي يتعذّر فيها إنشاء مقياس مخصّص من النوع TIME في حال عدم ضبط السياسة min_value. تنشئ الآن الطلبات التي لا تحتوي على min_value مقياسًا مخصّصًا باستخدام القيمة التلقائية min_value في 0.

العملات

هذا إصدار مخصّص لإصلاح الخطأ: يُصلح مشكلة كانت تدعم مجموعة فرعية من العملات في واجهة ويب "إحصاءات Google" ولكن ليس في واجهة برمجة التطبيقات. يضيف هذا الإصدار توافقًا مع العملات التالية:

  • UAH، AED، BOB، CLP، COP، EGP، HRK، ILS، MAD، MYR، PEN، PKR، RON، RSD، SAR، SGD، VEF، LVL

لمزيد من المعلومات، يمكنك الاطّلاع على: مرجع الملفات الشخصية - مقالة مركز المساعدة مرجع العملة

يضيف هذا الإصدار شرائح جمهور تجديد النشاط التسويقي إلى Management API.

شهادات تجديد النشاط التسويقي

تسمح لك "واجهة برمجة تطبيقات الإدارة" باستخدام شرائح جمهور تجديد النشاط التسويقي create وget وlist وupdate وpatch لموقع إلكتروني على "إحصاءات Google". لمعرفة مزيد من المعلومات عن آلية عمل شرائح جمهور تجديد النشاط التسويقي، اطّلِع على مقالة مركز المساعدة لمحة عن شرائح جمهور تجديد النشاط التسويقي في "إحصاءات Google".

التقارير غير المستندة إلى عينات

لم تعد واجهة برمجة التطبيقات للتقارير غير المستندة إلى عينات لديها 100 تقرير في اليوم. تستخدم واجهة برمجة التطبيقات نفس رمز الرمز المميز لكل موقع في اليوم عند إنشاء تقرير غير مستند إلى عينات من خلال واجهة الويب.

التقارير غير المستندة إلى عينات

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

الملفات الشخصية (الملفات الشخصية)

يضيف هذا الإصدار الخاصية botFilteringEnabled إلى الملف الشخصي (الملف الشخصي). تشير هذه السمة إلى ما إذا كانت فلترة برنامج التتبُّع مفعّلة لملف شخصي. اطّلِع على عرض المستندات المرجعية (الملفات الشخصية) لمزيد من التفاصيل.

التقارير غير المستندة إلى عينات

يضيف هذا الإصدار الطريقة delete إلى التقارير غير المستندة إلى عينات. لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات مرجعية عن التقارير غير المستندة إلى عينات.

الشرائح

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

الشرائح

هذا إصدار مخصّص لإصلاح الخطأ. يعمل هذا الإصدار على إصلاح مشكلة قد تتسبب في حصول المستخدمين الذين لديهم شرائح خاصة مثبتة على ملفات شخصية متعددة على استجابة خطأ 500 عند استدعاء طريقة قائمة الشرائح.

يضيف هذا الإصدار معلمة إضافية إلى عنوان URL لبنود خدمة واجهة برمجة تطبيقات إدارة الحسابات:

  • تؤدي إضافة معلّمة عنوان URL provisioningSignup=false إلى إصلاح مشكلة تحدث عند إدارة حسابات "إحصاءات Google" لمستخدم بدون أي حساب على "إحصاءات Google". وعلى مطوّري البرامج تعديل الرمز لإضافة هذه المعلّمة إلى عنوان URL لبنود الخدمة.

الملفات الشخصية (الملفات الشخصية)

باستخدام هذا الإصدار، سيتم تلقائيًا ضبط قيمة السمة currency (الملف الشخصي) currency على USD إذا لم يتم ضبطها أثناء عملية insert. ستعرض أيضًا عمليات get وlist القيمة USD على الملفات الشخصية التي تم إنشاؤها سابقًا بدون السمة currency.

الفلاتر

يُحدِّد هذا الإصدار الإزالة النهائية لحقلَي الفلتر IS_MOBILE المتوقفَين وIS_TABLET، اللذين يجب استبدالهما بكلٍّ من DEVICE_CATEGORY=mobile وDEVICE_CATEGORY=tablet. ستظهر رسالة خطأ عندما تُدرج طلبات التعديل والتصحيح والضبط التي تعمل على ضبط حقول الفلاتر لاستخدام IS_MOBILE وIS_TABLET.

  • يُرجى الاطّلاع على دليل مطوّري الفلاتر للحصول على تفاصيل عن استخدام الفلاتر في Management API.

  • يُرجى الاطّلاع على مرجع الفلاتر للحصول على قائمة كاملة بالمَعلمات لمورد الفلتر.

الفلاتر

يضيف هذا الإصدار دعمًا لاستخدام مكوّن مخصّص لحقل فلتر من خلال إضافة سمة fieldIndex إلى جميع أقسام تفاصيل الفلتر. على سبيل المثال، يمكن الآن ضبط تعبير الفلتر باستخدام "field": "CUSTOM_DIMENSION" و"fieldIndex": "1" لكي يعمل الفلتر على المكوّن المخصّص الأول.

  • يُرجى الاطّلاع على دليل مطوّري الفلاتر للحصول على تفاصيل عن استخدام الفلاتر في Management API.

  • يُرجى الاطّلاع على مرجع الفلاتر للحصول على قائمة كاملة بالمعلّمات لمورد الفلتر.

الأهداف

يُثبِّت هذا الإصدار أيضًا مشكلة عند إنشاء هدف مع "comparisonValue": "0".

  • يُرجى الاطّلاع على دليل مطوّري الأهداف للحصول على تفاصيل عن استخدام الأهداف في Management API.

  • يُرجى الاطلاع على مرجع الأهداف للحصول على قائمة كاملة بالمعلّمات لمورد الهدف.

تشير هذه النسخة إلى إيقاف العمل نهائيًا وإزالة مصدر dailyUpload. تم إيقاف المورد dailyUpload رسميًا في 20 حزيران (يونيو) 2014، ومن المفترض أن يتم الآن جميع استيراد بيانات التكلفة باستخدام مورد التحميلات.

يضيف هذا الإصدار مجموعتَين جديدتَين إلى Management API والمكوّنات المخصّصة والمقاييس المخصّصة.

المقاييس والمكوّنات المخصّصة

أصبح من الممكن الآن إنشاء المكونات المخصّصة والمقاييس وإدراجها والحصول عليها وتصحيحها وتحديثها باستخدام واجهة برمجة تطبيقات الإدارة.

تتضمّن استجابة الطريقة list لجميع المجموعات الآن قائمة فارغة للسمة items عندما لا تحتوي المجموعة على أي موارد. في السابق، كان يتم حذف السمة items من الاستجابة. اطّلع على مرجع واجهة برمجة التطبيقات للحصول على تفاصيل كاملة عن طلبات البحث والردود على بيانات إعداد "إحصاءات Google".

تمت إضافة حقل DEVICE_CATEGORYفلاتر جديد وتم إيقاف IS_MOBILE وIS_TABLET نهائيًا الآن. استخدِم DEVICE_CATEGORY=mobile وDEVICE_CATEGORY=tablet.

يتضمّن مورد الملف الشخصي الآن موقع enhancedECommerceTracking يشير إلى ما إذا كانت التجارة الإلكترونية المحسّنة مفعّلة (true) أو غير مفعّلة (false).

يتضمّن هذا الإصدار أنواعًا جديدة لاستيراد البيانات وإيقاف مورد dailyUpload.

استيراد البيانات

اطّلع على دليل مطوّري برامج استيراد البيانات للحصول على تفاصيل عن كيفية استخدام Management API لاستيراد البيانات إلى حسابك على "إحصاءات Google".

الفيديوهات المحمّلة

  • يتيح مورد upload الآن أنواع التحميل التالية:
    • بيانات الحملات
    • بيانات المحتوى
    • بيانات التكلفة
    • بيانات المنتج
    • بيانات رد الدفعة
    • بيانات المستخدمين
  • يتضمّن المورد upload طريقة migrateDataImport جديدة لنقل بيانات التكلفة الحالية customDataSources.

إيقاف عمليات التحميل اليومية

  • لقد تم إيقاف مورد dailyUpload. يُرجى الاطّلاع على دليل نقل البيانات لمعرفة تفاصيل حول نقل البيانات لاستخدام ميزة استيراد البيانات.
  • سيستمر عمل مورد dailyUpload لمدة ستة أشهر إضافية، وعندها سيتم نقل أي customDataSources متبقٍ تم ضبط الخاصية uploadType عليه إلى analytics#dailyUploads تلقائيًا ولن يعمل إلا مع المورد upload.
  • على المستخدمين الحاليين للمورد dailyUpload تحديث الرموز ونقلهم لاستخدام مورد التحميل في أقرب وقت ممكن.

هذا هو الإصدار الأولي من إدارة الحسابات:

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

يضيف هذا الإصدار واجهتَي برمجة تطبيقات جديدتَين.

الفلاتر

التقارير غير المستندة إلى عينات: واجهة برمجة تطبيقات الإدارة

تتم إضافة مورد جديد إلى واجهة برمجة التطبيقات للإدارة باسم التقارير غير المستندة إلى عينات. التقارير غير المستندة إلى عينات هي تقارير "إحصاءات Google" (GA) التي تم إنشاؤها باستخدام بيانات غير مستندة إلى عينات.تتوفّر التقارير غير المستندة إلى عينات حاليًا فقط لمستخدمي "إحصاءات Google Premium".

الشرائح: الإصدار 2.4 &amp من Management API، الإصدار 3.0

تم إجراء التغييرات التالية على مجموعة الشرائح:

  • تتوفّر الآن شرائح المستخدمين والتسلسل في واجهة برمجة التطبيقات.
  • تعرض مجموعة الشرائح الآن جميع الشرائح المضمّنة ومخصصة في مستوى الجلسة ومستوى المستخدم.
  • وستستخدِم السمة definition للشرائح بنية الشرائح الجديدة. ويتضمّن ذلك تعريفات الشرائح على مستوى الجلسة الحالية التي ستتغيّر من definition: "" إلى definition: "sessions::condition::".
  • تمت إضافة موقع type جديد إلى المورد الشريحة للإشارة إلى ما إذا كانت الشريحة CUSTOM (أي أنشأها المستخدم في واجهة الويب) أو BUILT_IN (أي أرسلها "إحصاءات Google").

التجارب

يمكن الآن استخدام مقاييس AdSense التالية كأهداف للتحسين:

  • ga:adsenseAdsClicks: عدد المرات التي تم فيها النقر على إعلانات AdSense على موقعك الإلكتروني.
  • ga:adsenseAdsViewed — عدد إعلانات AdSense التي تمت مشاهدتها. يمكن عرض عدّة إعلانات ضمن وحدة إعلانية.
  • ga:adsenseRevenue — إجمالي الأرباح من إعلانات AdSense.

مجموعة جديدة لملخّصات الحساب

  • تمت إضافة مجموعة AccountSummries إلى Management API. توفّر هذه الميزة ملخّصًا لمعلومات كل حساب وموقع وملف شخصي يمتلك مستخدمًا مفوّضًا حق الوصول إليه في طلب واحد سريع. اطّلِع على دليل مطوّري ملخصات الحسابات للحصول على التفاصيل.

تم إجراء التغييرات التالية على الشرائح التلقائية بسبب إيقاف السمتَين ga:isMobile وga:isTablet:

  • تمت إعادة تسمية الشريحة gaid::-11 من زيارات الأجهزة الجوّالة إلى زيارات الأجهزة الجوّالة والأجهزة اللوحية. تم تغيير تعريف هذه الشريحة من ga:isMobile==Yes إلى ga:deviceCategory==mobile,ga:deviceCategory==tablet. تجدر الإشارة إلى أن ga:isMobile أدرجت زيارات الجهاز اللوحي، وهو ما ينعكس في التعريف الجديد. إذا كنت تريد فقط الزيارات الواردة من الأجهزة الجوّالة، باستثناء الأجهزة اللوحية، يمكنك التبديل إلى شريحة زيارات الأجهزة الجوّالة الجديدة (gaid::-14).
  • تم تغيير تعريف الشريحة gaid::-13 من ga:isTablet==Yes إلى ga:deviceCategory==tablet. ويستمر هذا تمثيل زيارات الجهاز اللوحي.
  • تمت إضافة الشريحة gaid::-14. واسم الشريحة هو زيارات الأجهزة الجوّالة والتعريف هو ga:deviceCategory==mobile.

إصلاح الأخطاء:

  • تم تحديث معلومات المنطقة الزمنية للملفات الشخصية. التفاصيل: قبل هذا الإصلاح، في بعض الحالات عند عرض الملف الشخصي (الملفات الشخصية) في Management API، تم عرض معلومات منطقة زمنية غير صحيحة لملف شخصي. تتوافق معلومات المنطقة الزمنية للملفات الشخصية الآن مع ما تم إعداده في واجهة مشرف "إحصاءات Google".

يقدم هذا الإصدار عمليات الكتابة لمراجع الويب، والملف الشخصي، والأهداف، ومجموعة من 3 موارد جديدة تتيح إدارة أذونات المستخدمين.

واجهات برمجة تطبيقات إعداد الحساب وإعداده

  • يمكن الآن إنشاء الملفات الشخصية (الملفات الشخصية) وتعديلها وتصحيحها وحذفها. راجِع مرجع الملفات الشخصية للاطّلاع على تفاصيل عن الطرق الجديدة.
  • يمكن الآن إنشاء المواقع الإلكترونية والأهداف وتعديلها وتصحيحها. راجع مرجع مواقع الويب ومرجع الأهداف للحصول على تفاصيل عن الطرق الجديدة.
  • يمكن الآن طلب موقع إلكتروني واحد، أو ملف شخصي واحد، أو هدف واحد باستخدام طريقة get.
  • تتوفّر هذه الميزات حاليًا كمعاينة لمطوّر البرامج في إصدار تجريبي محدود. وفي حال أردت الاشتراك، يمكنك طلب الوصول إلى الإصدار التجريبي.

أذونات المستخدم في Management API

  • يتيح مورد accountUserLinks الجديد إدارة أذونات الحساب للمستخدمين.
  • يتيح مورد webpropertyUserLinks الجديد إدارة أذونات الموقع الإلكتروني للمستخدمين.
  • يتيح مورد profileUserLinks الجديد إدارة أذونات الملفات الشخصية للمستخدمين.
  • تتوفر الآن أذونات لمستخدم مُعتمَد كجزء من موارد الحساب وWeb وعرض (الملف الشخصي).
  • تم طرح نطاق جديد وهو مطلوب لإدارة أذونات المستخدم. https://www.googleapis.com/auth/analytics.manage.users.
  • يُرجى الاطّلاع على دليل مطوّري أذونات المستخدمين للحصول على تفاصيل إضافية.

كجزء من إطلاق شرائح جديدة، سنطرح التغييرات التالية في مجموعة الشرائح:

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

يضيف هذا الإصدار موقعَين جديدَين إلى مورد الموقع الإلكتروني:

  • profileCount: تعرض عدد الملفات الشخصية لأحد المواقع. ويسمح لك ذلك بفلترة المواقع التي لا تتضمّن أي ملفات شخصية (أي: profileCount = 0).
  • industryVertical: تعرض فئة/فئة الصناعة المحدّدة للموقع الإلكتروني.

إصلاح الأخطاء:

  • أصبحت السمة eCommerceTracking في مورد الملف الشخصي متوافقة الآن مع إعدادات التجارة الإلكترونية في قسم المشرف من واجهة الويب. عرض true عند تفعيل تتبُّع التجارة الإلكترونية وfalse في حال عدم تفعيله
  • تمت إضافة نقطة نهاية جديدة إلى الإصدار 3 من واجهة برمجة التطبيقات Management API للوصول إلى موارد التجارب وتعديلها.
  • يتضمّن مورد الملف الشخصي الآن السمة type لتحديد ما إذا تم ضبط الملف الشخصي لموقع إلكتروني أو تطبيق ويب. القيمتان المحتملتان هما: WEB أو APP.

يضيف هذا الإصدار ردودًا مفيدة على الخطأ إلى Management API.

  • تمت إضافة رموز الخطأ والأسباب والأوصاف الجديدة إلى نص الردود على الأخطاء عبر واجهة برمجة التطبيقات. تم توثيق جميع الرموز لكلا الإصدارين - الإصدار 2.4 والإصدار 3.0 - من Management API.

يضيف هذا الإصدار بيانات ويغيّر الوظائف الحالية ويصلح خطأً.

البيانات الجديدة

التغييرات

  • تم تغيير نوع بيانات max-results إلى integer.

  • تم تغيير القيمة التلقائية والقصوى للسمة max-results إلى 1000.

إصلاح الأخطاء

  • لم تعد الحسابات ومواقع الويب والملفات الشخصية لتجارب محسّن المواقع الإلكترونية من Google مضمّنة في المجموعات المقابلة لها.

يضيف هذا الإصدار إصدارَين جديدَين من واجهة برمجة التطبيقات يتضمّنان العديد من الميزات الجديدة، كما يوقف الإصدار القديم. تؤثّر هذه التغييرات في طريقة طلب البيانات ومعالجتها من واجهة برمجة التطبيقات.

الإصدار ‎‏‎3.0

  • وهذا هو أحدث إصدار رئيسي من واجهة برمجة التطبيقات ولا يتوافق مع الإصدارات القديمة. وسيتم إجراء كل عمليات التطوير المستقبلية لواجهة برمجة التطبيقات على هذا الإصدار.

  • البيانات الجديدة

    • التمثيل الكامل لأهداف الحدث
    • رقم تعريف موقع إلكتروني داخلي يمكن استخدامه للربط بصفحة معيّنة في واجهة مستخدم "إحصاءات Google"
    • عمليات ضبط الملف الشخصي للمعلَمات التلقائية لطلب البحث في الموقع الإلكتروني والصفحة

  • التغييرات

الإصدار 2.4

  • وهذه ترقية بسيطة تتوافق مع الإصدارات الأقدم من الإصدار 2.3 الحالي.

  • التغييرات

    • سياسة عروض أسعار جديدة
    • الدمج مع وحدة التحكم في واجهات Google API لإدارة الوصول إلى واجهة برمجة التطبيقات وطلب المزيد من الحصص
    • دعم مستمر لآليات التفويض الحالية وOAuth 2.0
    • عنوان URL الجديد لتقديم الطلبات: https://www.googleapis.com/analytics/v2.4/management/…
    • الردود بتنسيق XML فقط
    • عدم توفّر مكتبة برامج JavaScript الخاصة ببيانات Google
    • ذلك أن الناتج بتنسيق XML متوافق مع الإصدار 2.3، بحيث تستمر مكتبات عملاء "بيانات Google" الأخرى في العمل.

الإيقاف

  • نعلن عن إيقاف الإصدار 2.3 القديم من Management API. وسيستمر العمل لمدة شهرين، وبعد ذلك ستعرض جميع طلبات الإصدار 2.3 استجابة للإصدار 2.4.

هذا هو الإصدار التجريبي من واجهة برمجة التطبيقات لإدارة "إحصاءات Google".

خلاصات جديدة

مكتبات العملاء المُعدّلة

  • يتم إصدار واجهة برمجة تطبيقات الإدارة في المكتبة نفسها مثل واجهة برمجة تطبيقات تصدير بيانات "إحصاءات Google". تم تحديث كلٍّ من مكتبات بيانات Google وJavaScript المستندة إلى JavaScript. ويمكن الوصول إلى كل خلاصة من خلال تحديد معرّف الموارد المنتظم (URI) للخلاصة المناسبة للمكتبة getManagementFeed().

الوثائق الجديدة