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

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

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

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

جميع سجلات التغييرات في Google Analytics API
–
اشتراك rss

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

جميع سجلّات التغييرات في واجهة برمجة التطبيقات Reporting API
–
اشتراك rss

يتضمّن الإصدار Core Reporting API وواجهة برمجة التطبيقات لإعداد تقارير المسارات المتعدّدة القنوات وواجهة برمجة التطبيقات لإعداد التقارير في الوقت الفعلي.

سجلّ التغييرات في Core Reporting API
–
اشتراك rss

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

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

يؤدي هذا الإصدار إلى زيادة الحدّ الأقصى لعدد الصفوف التي يتم عرضها في مجموعة نتائج الإصدار 4 من Analytics Reporting API.

تتم زيادة الحدّ الأقصى لعدد الصفوف التي يتمّ عرضها في عنصر Analytics Reporting API v4 ReportData من 10,000 إلى 100,000.

يضيف هذا الإصدار معاينة لنظام الحصص استنادًا إلى الموارد للإصدار 4 من Google Analytics Reporting API، ما يسمح باستخدام حدود أعلى لأخذ العينات لعملاء "إحصاءات Google 360" (الإصدار Premium).

سيوقِف هذا الإصدار نهائيًا ميزة المنتجات ذات الصلة والأبعاد والمقاييس المرتبطة بها. يُرجى مراجعة مرجع السمات والمقاييس للحصول على القائمة الكاملة للتعريفات. يُرجى الاطّلاع على سياسة إيقاف البيانات نهائيًا للحصول على تفاصيل عن إزالة البيانات:

سيوقف هذا الإصدار السمات والمقاييس التالية:

  • ga:correlationModelId
  • ga:queryProductId
  • ga:queryProductName
  • ga:queryProductVariation
  • ga:relatedProductId
  • ga:relatedProductName
  • ga:relatedProductVariation
  • ga:correlationScore
  • ga:queryProductQuantity
  • ga:relatedProductQuantity

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

الوقت

  • السمة الجديدة ga:dateHourMinute التي تجمع بين ga:date وga:hour وga:minute.

إزالة البيانات

يزيل هذا الإصدار السمات والمقاييس التالية المتوقّفة نهائيًا:

  • ga:socialactivities
  • ga:socialactivityaction
  • ga:socialactivitydisplayname
  • ga:socialactivityendorsingurl
  • ga:socialactivitynetworkaction
  • ga:socialactivitypost
  • ga:socialactivitytagssummary
  • ga:socialactivitytimestamp
  • ga:socialactivityuserhandle
  • ga:socialactivityuserphotourl
  • ga:socialactivityuserprofileurl
  • ga:socialinteractionspervisit

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

مقاييس سلوك المستخدمين

تم تعديل طريقة احتساب مقياسَي المستخدمون والمستخدمون النشطون لحساب عدد المستخدمين بكفاءة أكبر. قد تلاحظ تغييرًا طفيفًا في المقاييس. لمزيد من المعلومات، يُرجى الاطّلاع على كيفية تحديد المستخدِمين لمقاييس المستخدِمين.

مقاييس سلوك المستخدمين المتأثرة بتعديل العملية الحسابية:

  • ga:users: إجمالي عدد المستخدمين للفترة الزمنية المطلوبة.
  • ga:1dayusers - إجمالي عدد المستخدمين النشطين خلال يوم واحد عن كل يوم في الفترة الزمنية المطلوبة.
  • ga:7dayusers - إجمالي عدد المستخدمين النشطين خلال 7 أيام لكل يوم في الفترة الزمنية المطلوبة.
  • ga:14dayusers - إجمالي عدد المستخدمين النشطين خلال 14 يومًا لكل يوم في الفترة الزمنية المطلوبة.
  • ga:30dayusers - إجمالي عدد المستخدمين النشطين خلال 30 يومًا لكل يوم في الفترة الزمنية المطلوبة.

الأحداث الفريدة

نحن نقترب من نهاية الفترة الزمنية لإيقاف ga:uniqueEvents. بعد 26 آذار (مارس) 2017، سيتم تعديل تعريف ga:uniqueEvents وإزالة مقياس ga:uniqueEventsTemporary الخاص من واجهة برمجة التطبيقات. لمزيدٍ من المعلومات، اطّلِع على مستندات المساعدة بشأن الأحداث الفريدة.

يضيف هذا الإصدار سمة جديدة إلى واجهة برمجة التطبيقات ويحسِّن رسائل الخطأ ويبدأ في تنفيذ التغييرات التي تم الإعلان عنها سابقًا لسمات ومقاييس AdSense.

سمات المستخدم

  • السمة ga:userBucket - بالنسبة إلى أي مستخدم، تشير سمة مجموعة بيانات المستخدم (القيم من 1 إلى 100) إلى مجموعة البيانات التي تم تعيين المستخدم لها. اطّلع على مقالة اختبار حملات تجديد النشاط التسويقي لمزيد من التفاصيل.

رسائل الخطأ

عندما كانت واجهة برمجة التطبيقات تعرض في السابق رسالة خطأ خاطئة، مثل Unknown dimension(s): أو Unknown metric(s): عند طلب بيانات بشروط لم يتم استيفاؤها، تعرض واجهة برمجة التطبيقات الآن الرسالة التالية: Restricted metric(s): ... can only be queried under certain conditions.

السمات والمقاييس في AdSense

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

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

السمات والمقاييس في AdSense

يعمل هذا الإصدار على إصلاح مشكلة بدأت في 7/1/2017، وفيها سيؤدي طلب البحث عن السمات والمقاييس في AdSense إلى عرض خطأ "مقياس غير معروف" للملفات الشخصية المرتبطة غير التابعة لبرنامج AdSense.

التغييرات القادمة

في 31 كانون الأول (ديسمبر) 2017 أو بعد هذا التاريخ، سيتم حظر الطلبات المرتبطة بالملفات الشخصية المرتبطة خارج AdSense من الاستعلام عن أبعاد ومقاييس AdSense. وسيؤدي طلب البحث عن هذه السمات والمقاييس مع ملفات شخصية مرتبطة خارج AdSense إلى حدوث خطأ.

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

المقاييس المحسوبة

ويتيح هذا الإصدار استخدام المقاييس المحسوبة.

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

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

تتبع الأحداث

سيتغير تعريف ga:uniqueEvents ليعكس عدد الأحداث الفريدة بدقة أكبر. للتأثير في هذا التغيير، سنوقف نهائيًا مقياس ga:uniqueEvents الحالي تقنيًا بما يتوافق مع سياسة إيقاف البيانات نهائيًا. إذا كنت ترغب في تجربة التعريف الجديد، يمكنك الرجوع إلى المقياس الخاص ga:uniqueEventsTemporary، الذي يحسب عدد الأحداث الفريدة بشكل أكثر دقة. سنقدِّم أيضًا مقياسًا جديدًا ga:uniqueDimensionCombinations ما يحافظ على التعريف الحالي لـ ga:uniqueEvents. بعد انقضاء الفترة الزمنية المناسبة للإيقاف (6 أشهر تقريبًا)، ستتم إزالة المقياس الخاص ga:uniqueEventsTemporary وسيمثّل المقياس الأصلي ga:uniqueEvents عدد الأحداث الفريدة بشكل صحيح. لمزيد من المعلومات، اطّلِع على مستندات المساعدة بشأن الأحداث الفريدة.

الأحداث الفريدة

  • المقياس - ga:uniqueEvents - سيتم تغيير تعريف ga:uniqueEvents قريبًا ليعكس عدد الأحداث الفريدة بشكل أكثر دقة. يُرجى استخدام ga:uniqueDimensionCombinations بدلاً من ذلك إذا كنت تريد الاحتفاظ بالتعريف الحالي. لمزيدٍ من المعلومات، اطّلِع على مستندات المساعدة بشأن الأحداث الفريدة.
  • المقياس - ga:uniqueDimensionCombinations - تحسب مجموعات السمات الفريدة عدد مجموعات قيم السمات الفريدة لكل سمة في التقرير. ويتيح لك هذا إمكانية إنشاء مرحلة ما بعد المعالجة للأبعاد (المتصلة) المجمّعة، مما يسمح بإعداد تقارير أكثر مرونة دون الحاجة إلى تحديث عملية تنفيذ التتبع أو استخدام شرائح أبعاد مخصصة إضافية. لمزيدٍ من المعلومات، اطّلِع على مستندات المساعدة بشأن الأحداث الفريدة.

اختبار الانتقال - خاص

  • المقياس - ga:uniqueEventsTemporary - عدد الأحداث الفريدة، وسيكون هذا التعريف الجديد لـ ga:uniqueEvents. يمكنك استخدام هذا المقياس لفهم التعريف الجديد قبل التغيير. تجدر الإشارة إلى أنّ هذا المقياس خاص ولن يظهر في مرجِع المقاييس والسمات.

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

DoubleClick Bid Manager

  • السمة - ga:dbmClickAdvertiser - اسم معلن DBM للنقر في DBM الذي يتطابق مع جلسة "إحصاءات Google" (يتطلب "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmClickAdvertiserId - الرقم التعريفي لمعلن DBM للنقر في DBM الذي يتطابق مع جلسة "إحصاءات Google" (يتطلّب "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmClickCreativeId - رقم تعريف تصميم إعلان DBM للنقرة في DBM التي تتطابق مع جلسة "إحصاءات Google" (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmClickExchange - اسم تبادل DBM للنقرة في DBM التي تتطابق مع جلسة "إحصاءات Google" (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmClickExchangeId - رقم تعريف تبادل DBM لنقرّة DBM التي تتطابق مع جلسة "إحصاءات Google" (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmClickInsertionOrder - اسم طلب إدراج DBM للنقر في DBM الذي يتطابق مع جلسة "إحصاءات Google" (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmClickInsertionOrderId - مُعرّف طلب إدراج DBM للنقر في DBM الذي يتطابق مع جلسة "إحصاءات Google" (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmClickLineItem - اسم عنصر DBM للنقر في DBM الذي تتطابق مع جلسة "إحصاءات Google" (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmClickLineItemId - رقم تعريف العنصر في DBM للنقر في DBM الذي تتطابق مع جلسة "إحصاءات Google" (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmClickSite - اسم موقع الويب لـ DBM الذي تم فيه عرض تصميم إعلان DBM والنقر عليه للنقر في DBM الذي يطابق جلسة "إحصاءات Google" (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmClickSiteId - رقم تعريف موقع DBM الذي تم فيه عرض تصميم إعلان DBM والنقر عليه للنقر في DBM الذي يطابق جلسة "إحصاءات Google" (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmLastEventAdvertiser - اسم معلن DBM لآخر حدث في DBM (الظهور أو النقرة ضمن فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmLastEventAdvertiserId - رقم تعريف معلِن DBM لحدث DBM الأخير (مرّة الظهور أو النقرة خلال فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" (تتطلب خدمة "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmLastEventCreativeId - رقم تعريف تصميم إعلان DBM لآخر حدث في DBM (مرّة الظهور أو النقرة خلال فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" (يتطلّب استخدام "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmLastEventExchange - اسم تبادل DBM لآخر حدث في DBM (الظهور أو النقرة ضمن فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmLastEventExchangeId - رقم تعريف تبادل DBM لآخر حدث في DBM (مرّة الظهور أو النقرة خلال فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" (يتطلّب استخدام "إحصاءات Google 360" فقط الدمج مع DBM).
  • السمة - ga:dbmLastEventInsertionOrder - اسم طلب إدراج DBM لآخر حدث في DBM (الظهور أو النقرة ضمن فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmLastEventInsertionOrderId - مُعرّف طلب إدراج DBM لحدث DBM الأخير (مرّة الظهور أو النقرة ضمن فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmLastEventLineItem - اسم عنصر DBM لآخر حدث في DBM (الظهور أو النقرة خلال فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmLastEventLineItemId - رقم تعريف عنصر DBM لآخر حدث في DBM (مرّة الظهور أو النقرة خلال فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" (يتطلّب ذلك دمج "إحصاءات 360" فقط مع DBM).
  • السمة - ga:dbmLastEventSite - اسم موقع DBM الإلكتروني الذي تم فيه عرض تصميم إعلان DBM والنقر عليه لآخر حدث في DBM (مرة ظهور أو نقرة ضمن فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" (تتطلب خدمة "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dbmLastEventSiteId - رقم تعريف موقع DBM الذي تم فيه عرض تصميم إعلان DBM والنقر عليه لآخر حدث في DBM (مرة ظهور أو نقرة ضمن فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" (تتطلب خدمة "إحصاءات 360" فقط الدمج مع DBM).
  • المقياس - ga:dbmCPA - أرباح التكلفة الفعلية للإجراء في DBM ("إحصاءات Google 360" فقط، يجب دمجها مع DBM)
  • المقياس - ga:dbmCPC - أرباح التكلفة الفعلية للنقرة في DBM ("إحصاءات 360" فقط، يجب دمجها مع DBM).
  • المقياس - ga:dbmCPM - أرباح التكلفة الفعلية لكل ألف ظهور في DBM ("إحصاءات Google 360" فقط، يجب دمجها مع DBM).
  • المقياس - ga:dbmCTR - نسبة النقر إلى الظهور في DBM (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • المقياس - ga:dbmClicks - إجمالي عدد النقرات في DBM (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • المقياس - ga:dbmConversions - إجمالي الإحالات الناجحة في DBM (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • المقياس - ga:dbmCost - تكلفة DBM (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DBM).
  • المقياس - ga:dbmImpressions - إجمالي مرات الظهور في DBM (يتطلّب "إحصاءات 360" فقط الدمج مع DBM).
  • المقياس - ga:dbmROAS - عائد الإنفاق الإعلاني لـ DBM (يتطلّب "إحصاءات 360" فقط الدمج مع DBM).
  • السمة - ga:dsAdGroup - المجموعة الإعلانية في DS (يجب استخدام "إحصاءات 360" فقط للدمج مع DS).
  • السمة - ga:dsAdGroupId - رقم تعريف المجموعة الإعلانية في DS (يجب استخدام "إحصاءات 360" فقط للدمج مع DS).
  • السمة - ga:dsAdvertiser - المعلِن في DS (يجب استخدام "إحصاءات 360" فقط للدمج مع DS).
  • السمة - ga:dsAdvertiserId - الرقم التعريفي للمعلِن في DS (يجب استخدام "إحصاءات 360" فقط لدمجها مع DS).
  • السمة - ga:dsAgency - وكالة DS (يجب استخدام "إحصاءات 360" فقط للدمج مع DS).
  • السمة - ga:dsAgencyId - رقم تعريف وكالة DS (يجب استخدام "إحصاءات 360" فقط للدمج مع DS).
  • السمة - ga:dsCampaign - حملة DS (يجب دمج "إحصاءات 360" مع DS).
  • السمة - ga:dsCampaignId - رقم تعريف حملة DS (يتطلّب دمج "إحصاءات Google 360" مع DS).
  • السمة - ga:dsEngineAccount - حساب محرك DS (يتطلّب استخدام "إحصاءات Google 360" الدمج مع DS).
  • السمة - ga:dsEngineAccountId - رقم تعريف حساب محرك البحث في DS (يجب استخدام "إحصاءات 360" فقط للدمج مع DS).
  • السمة - ga:dsKeyword - الكلمة الرئيسية في DS (يجب استخدام "إحصاءات Google 360" فقط لدمجها مع DS).
  • السمة - ga:dsKeywordId - رقم تعريف الكلمة الرئيسية في DS (يتطلّب استخدام "إحصاءات Google 360" الدمج مع DS).
  • ga:dsCPC - تكلفة النقرة في DS (يتطلب "إحصاءات Google 360" الدمج مع DS).
  • ga:dsCTR - نسبة النقر إلى الظهور في DS (يتطلّب "إحصاءات 360" فقط الدمج مع DS).
  • ga:dsClicks - نقرات DS (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DS).
  • ga:dsCost - تكلفة DS (يتطلّب استخدام "إحصاءات Google 360" فقط الدمج مع DS).
  • ga:dsImpressions - مرات ظهور DS (يتطلّب استخدام "إحصاءات Google 360" فقط الدمج مع DS)
  • ga:dsProfit - DS Profie (يتطلب "إحصاءات Google 360" فقط الدمج مع DS).
  • ga:dsReturnOnAdSpend - عائد الإنفاق الإعلاني في DS (يتطلّب استخدام "إحصاءات Google 360" الدمج مع DS).
  • ga:dsRevenuePerClick - الأرباح لكل نقرة في DS (يتطلّب استخدام "إحصاءات Google 360" الدمج مع DS).

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

الشبكة الجغرافية

  • السمة - ga:continentId - رقم تعريف القارّة للمستخدمين، المستمد من عناوين IP أو أرقام التعريف الجغرافية للمستخدمين.

الشروط

لا يمكن طلب السمات التالية في المجموعات التالية باستخدام سمات في المجموعات الأخرى:

  • الانتقال إلى مجموعة معلومات Shopping
    • ga:checkoutOptions
    • ga:shoppingStage
  • مجموعة تجارب GWO
    • ga:experimentVariant
    • ga:experimentId
  • مجموعة الاهتمامات
    • ga:interestOtherCategory
  • مجموعة الاهتمامات في السوق
    • ga:interestInMarketCategory
  • مجموعة الترويج الداخلي:
    • ga:internalPromotionCreative
    • ga:internalPromotionId
    • ga:internalPromotionName
    • ga:internalPromotionPosition
  • مجموعة الاهتمامات التجارية:
    • ga:interestAffinityCategory

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

التقرير عن الأخطاء

يبدأ هذا الإصدار في فرض حدود على طلبات إعداد التقارير التي تعذّر تنفيذها (5XX).

  • 10 طلبات فاشلة لكل مشروع في كل ملف شخصي في الساعة
  • 50 طلبًا غير ناجح لكل مشروع لكل ملف شخصي في اليوم.

الحدود المحورية

يبدأ هذا الإصدار في فرض حدود على طلبات المحتوى المحوري:

  • يمكن أن يحتوي طلب التقرير الآن على محورَين كحدّ أقصى.
  • يمكن أن يحتوي المحور المحوري على 4 سمات بحدّ أقصى.
  • السمات المحورية هي جزء من القيود المفروضة على إجمالي عدد السمات المسموح بها في الطلب.
  • تشكّل metrics المحورية جزءًا من القيود المفروضة على إجمالي عدد المقاييس المسموح بها في الطلب.

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

الشبكة الجغرافية

  • السمة - ga:metroId - رمز "منطقة السوق المحددة" (DMA) المكوّن من ثلاثة أرقام والذي وصلت منه الزيارات، ويتم استخلاصه من عناوين IP أو أرقام التعريف الجغرافية للمستخدمين.

DoubleClick for Publishers

  • المقياس - ga:dfpImpressions - يتم الإبلاغ عن مرة ظهور للإعلان في DoubleClick Search كلما تم عرض إعلان فردي على الموقع الإلكتروني. على سبيل المثال، في حال عرض صفحة تحتوي على وحدتَين إعلانيتَين مرّة واحدة، سيتم عرض مرتَي ظهور (مع تفعيل ربط BigQuery وإخفاء أرباح DoubleClick غير مُفعَّل)."
  • المقياس - ga:dfpCoverage - التغطية هي النسبة المئوية لطلبات الإعلان التي أدّت إلى عرض إعلان واحد على الأقل. بوجه عام، يمكن أن تساعد التغطية في تحديد المواقع التي يتعذّر على حساب DoubleClick توفير إعلانات مستهدفة فيها. (مرات ظهور الإعلان / إجمالي طلبات الإعلان) * 100 (تم تفعيل ربط BigQuery وإخفاء أرباح DoubleClick غير مُفعَّل)."
  • المقياس - ga:dfpMonetizedPageviews - يقيس إجمالي عدد مشاهدات الصفحة على الموقع على الويب التي تم عرضها مع إعلان من حساب DoubleClick المرتبط. تجدر الإشارة إلى أنه يمكن أن تحتوي صفحة واحدة على وحدات إعلانية متعددة (مع تفعيل ربط LDAP وإخفاء أرباح DoubleClick غير مُفعَّل)."
  • المقياس - ga:dfpImpressionsPerSession - نسبة مرات ظهور إعلانات DoubleClick إلى جلسات "إحصاءات Google" (مرات ظهور الإعلان / جلسات "إحصاءات") (تم تفعيل ربط BigQuery وإخفاء أرباح DoubleClick غير مُفعَّل).
  • المقياس - ga:dfpViewableImpressionsPercent - النسبة المئوية لمرات ظهور الإعلان القابلة للعرض. تُعتبر مرة الظهور مرة ظهور قابلة للعرض عند ظهورها ضمن متصفحات المستخدمين وتوفُّرها إمكانية ظهورها (مع تفعيل ربط LDAP وإخفاء أرباح DoubleClick غير مُفعَّل)."
  • المقياس - ga:dfpClicks - عدد المرات التي تم فيها النقر على إعلانات Currents على الموقع الإلكتروني (تم تفعيل ربط BigQuery وإخفاء أرباح DoubleClick غير مفعَّلة)."
  • المقياس - ga:dfpCTR - النسبة المئوية لمرات مشاهدة الصفحة على الويب التي أدّت إلى نقرة على إعلان DoubleClick (تم تفعيل ربط BigQuery وإخفاء أرباح DoubleClick غير مُفعَّل)."
  • المقياس - ga:dfpRevenue - أرباح DoubleClick هي تقدير لإجمالي أرباح الإعلانات استنادًا إلى مرات الظهور المعروضة (تم تفعيل ربط LDAP وإخفاء أرباح DoubleClick غير مفعّل)."
  • المقياس - ga:dfpRevenuePer1000Sessions - إجمالي الأرباح المقدَّرة من إعلانات DoubleClick لكل 1,000 جلسة في "إحصاءات Google". وتجدر الإشارة إلى أن هذا المقياس يستند إلى الجلسات إلى الموقع الإلكتروني، وليس إلى مرات ظهور الإعلانات (تم تفعيل ربط BigQuery وإخفاء أرباح DoubleClick غير مُفعَّل)."
  • المقياس - ga:dfpECPM - التكلفة الفعلية لكل ألف مشاهدة للصفحة على الويب. وتمثل هذه النسبة أرباح DoubleClick لكل 1000 مرة مشاهدة للصفحة (تم تفعيل ربط BigQuery وإخفاء أرباح DoubleClick غير مُفعَّل)."
  • المقياس - ga:backfillImpressions - مرات ظهور الإعلانات السابقة هي مجموع كل مرات ظهور إعلانات AdSense أو Ad Exchance التي تم عرضها كإعادة إعلانات من خلال DoubleClick. يتم تسجيل مرة ظهور للإعلان في كل مرة يتم فيها عرض إعلان فردي على الموقع الإلكتروني. على سبيل المثال، في حال عرض صفحة تحتوي على وحدتَين إعلانيتَين مرّة واحدة، سيتم عرض مرتَي ظهور (مع تفعيل ربط BigQuery وإخفاء أرباح DoubleClick غير مُفعَّل)."
  • المقياس - ga:backfillCoverage - تغطية إعادة التعبئة هي النسبة المئوية لطلبات الإعلان التي أدّت إلى عرض إعلان واحد على الأقل. وبوجه عام، يمكن أن تساعد التغطية في تحديد المواقع الإلكترونية التي يتعذّر على حساب الناشر توفير إعلانات مستهدفة فيها. (مرات ظهور الإعلان / إجمالي طلبات الإعلان) * 100. في حال كان كلٌّ من AdSense وAd Exchange يوفران إعلانات ملء الفراغات، يكون هذا المقياس هو المتوسط المُرجَّح لحسابَي إعادة التعبئة (ربط DoubleClick مُفعّل وإخفاء أرباح DoubleClick غير مُفعَّل)."
  • المقياس - ga:backfillMonetizedPageviews - يقيس إجمالي عدد مشاهدات الصفحة على الموقع الإلكتروني التي تم عرضها مع إعلان واحد على الأقل من حسابات إعادة التعبئة المرتبطة. تجدر الإشارة إلى أنّ مشاهدة صفحة واحدة تحقّق ربحًا
  • المقياس - ga:backfillImpressionsPerSession - نسبة مرات ظهور الإعلان السابقة للإعلانات إلى جلسات "إحصاءات Google" (مرات ظهور الإعلان / جلسات "إحصاءات Google"). في حال كان كلٌّ من AdSense وAd Exchange يوفران إعلانات ملء الفراغات، يكون هذا المقياس هو مجموع حسابَي إعادة التعبئة (تم تفعيل ربط BigQuery وإخفاء أرباح BigQuery غير مُفعَّل)."
  • المقياس - ga:backfillViewableImpressionsPercent - النسبة المئوية لمرات ظهور الإعلان التي تمت إضافة البيانات السابقة إليها التي كانت قابلة للعرض. يعتبر الظهور ظهورًا قابلاً للعرض عند ظهوره ضمن متصفحات المستخدمين وسنحت الفرصة لرؤيته. في حال كان كلٌّ من AdSense وAd Exchange يوفران إعلانات ملء البيانات، يكون هذا المقياس هو المتوسط المُرجَّح لحسابَي إعادة التعبئة (تم تفعيل ربط Feedfetcher وإخفاء أرباح DoubleClick غير مُفعَّل)."
  • المقياس - ga:backfillClicks - عدد مرات النقر على الإعلانات السابقة التي تم فيها النقر على الإعلانات على الموقع الإلكتروني. في حال كان كلٌّ من AdSense وAd Exchange يوفران إعلانات ملء الفراغات، يكون هذا المقياس عبارة عن مجموع حسابَي إعادة التعبئة (تم تفعيل ربط BigQuery وإخفاء أرباح DoubleClick غير مُفعَّل)."
  • المقياس - ga:backfillCTR - النسبة المئوية لمرات ظهور إعادة التعبئة التي أدت إلى نقرة على إعلان. في حال كان كلٌّ من AdSense وAd Exchange يوفران إعلانات ملء البيانات، يكون هذا المقياس هو المتوسط المُرجَّح لحسابَي إعادة التعبئة (تم تفعيل ربط Feedfetcher وإخفاء أرباح DoubleClick غير مُفعَّل)."
  • المقياس - ga:backfillRevenue - إجمالي الأرباح المقدَّرة من إعلانات إعادة التعبئة. في حال كان كلٌّ من AdSense وAd Exchange يوفران إعلانات ملء الفراغات، يكون هذا المقياس عبارة عن مجموع حسابَي إعادة التعبئة (تم تفعيل ربط BigQuery وإخفاء أرباح DoubleClick غير مُفعَّل)."
  • المقياس - ga:backfillRevenuePer1000Sessions - إجمالي الأرباح المقدَّرة من إعادة تعبئة الإعلانات لكل 1,000 جلسة في "إحصاءات Google". لاحظ أن هذا المقياس يستند إلى الجلسات إلى الموقع الإلكتروني وليس مرات ظهور الإعلان. في حال كان كلٌّ من AdSense وAd Exchange يوفران إعلانات ملء الفراغات، يكون هذا المقياس هو مجموع حسابَي إعادة التعبئة (تم تفعيل ربط BigQuery وإخفاء أرباح BigQuery غير مُفعَّل)."
  • المقياس - ga:backfillECPM - التكلفة الفعلية لكل ألف مشاهدة للصفحة على الويب. وهي أرباح إعادة إعلانات DoubleClick لكل 1000 مشاهدة للصفحة. في حال كان كلٌّ من AdSense وAd Exchange يوفران إعلانات ملء الفراغات، يكون هذا المقياس هو مجموع حسابَي إعادة التعبئة (تم تفعيل ربط BigQuery وإخفاء أرباح BigQuery غير مُفعَّل)."

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

الشرائح

يعالج هذا الإصدار مشكلة قد تؤدي إلى عدم احتساب مجموعة فرعية من الطلبات ضمن الشريحة كل المستخدمين (gaid::-1) ضمن الإصدار 3 من واجهة برمجة التطبيقات الأساسية لإعداد التقارير وتقسيمها إلى شريحتَين في الإصدار 4 من واجهة برمجة التطبيقات لإعداد التقارير في "إحصاءات Google".

أخذ العينات

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

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

طلبات المجموعات النموذجية

أصبح بإمكان طلبات المجموعات النموذجية الآن طلب جميع سمات المجموعة النموذجية؛ وكانت واجهة برمجة التطبيقات تعرض في السابق رسالة خطأ عند طلب سمات ga:acquisition....

القيمة الدائمة لطلب القيمة الدائمة

تجدر الإشارة إلى أن طلبات القيمة الدائمة يمكن أن تنشئ تقارير القيمة الدائمة لمشاهدات التطبيق فقط.

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

الميزات الرئيسية

تم إنشاء "إحصاءات Google" استنادًا إلى بنية أساسية قوية لإعداد تقارير البيانات. تتيح واجهة برمجة التطبيقات للمطوّرين الاستفادة من فعالية نظام "إحصاءات Google" الأساسي. تشمل بعض الميزات الرئيسية في الإصدار 4 من Analytics Reporting API ما يلي:

  • التعبيرات المقاييس - تتيح لك واجهة برمجة التطبيقات طلب المقاييس المضمنة وأيضًا تعبيرات المقاييس الرياضية. على سبيل المثال، يمكن التعبير عن الأهداف المكتملة لكل عدد من الجلسات في الطلب بالصيغة ga:goal1completions/ga:sessions.
  • نطاقات زمنية متعددة: تتيح إمكانية طلب نطاقَين زمنيَين، ما يسمح لك بمقارنة البيانات لفترتَين في طلب واحد.
  • المجموعات النموذجية والقيمة الدائمة: تحتوي واجهة برمجة التطبيقات على مفردات وافرة لطلب تقارير المجموعات النموذجية والقيمة الدائمة.
  • شرائح متعددة - يمكنك الآن طلب شرائح متعددة في طلب واحد.

البدء

راجِع مستند المطوِّر للحصول على جميع التفاصيل حول بدء استخدام واجهة برمجة التطبيقات.

سياسة الحصص

يتضمّن الإصدار 4 من "واجهة برمجة التطبيقات لإعداد التقارير في Analytics" حصصًا وحدودًا خاصة به، وبما أنّها واجهة برمجة تطبيقات جديدة، تخضع هذه الحدود والحصص للتغيير.

النقل

جنبًا إلى جنب مع دليل نقل البيانات، نتيح أيضًا مكتبة التوافق مع Python على GitHub.

المكونات والمقاييس

يضيف هذا الإصدار أيضًا مجموعة من السمات والمقاييس المخصّصة للإصدار 4 من Analytics Reporting API. اطّلِع على مستكشف السمات والمقاييس للاطّلاع على تعريفات القائمة الكاملة.

  • السمة - ga:cohort - اسم المجموعة النموذجية التي ينتمي إليها المستخدم استنادًا إلى تعريف المجموعات النموذجية. واستنادًا إلى كيفية تحديد المجموعات النموذجية، يمكن أن ينتمي المستخدم إلى مجموعات نموذجية متعددة، على غرار الطريقة التي يمكن أن ينتمي بها المستخدم إلى شرائح متعددة.

  • السمة: ga:cohortNthDay - معادلة يومية مستندة إلى القيمة 0 بالنسبة إلى تاريخ تعريف المجموعة النموذجية. على سبيل المثال، إذا تم تحديد مجموعة نموذجية بتاريخ الزيارة الأولى في 2015-09-01، ستكون قيمة ga:cohortNthDay 3 في التاريخ 2015-09-04.

  • ga:cohortNthMonth - معادلة الشهر مستندة إلى 0 بالنسبة إلى تاريخ تعريف المجموعة النموذجية.

  • السمة - ga:cohortNthWeek - معادلة الأسبوع المستندة إلى 0 بالنسبة إلى تاريخ تعريف المجموعة النموذجية.

  • السمة: ga:acquisitionTrafficChannel - قناة الزيارات التي تم اكتساب المستخدم من خلالها. ويتم استخراجه من الجلسة الأولى للمستخدم. يتم احتساب قناة الزيارات استنادًا إلى القواعد التلقائية لتصنيف القنوات إلى مجموعات (على مستوى الملف الشخصي، إن توفّر) في وقت اكتساب المستخدِمين.

  • السمة - ga:acquisitionSource - المصدر الذي تم اكتساب المستخدم من خلاله. المستمدة من الجلسة الأولى للمستخدِم.

  • السمة - ga:acquisitionMedium - الوسيط الذي تم اكتساب المستخدم من خلاله. المستمدة من الجلسة الأولى للمستخدِم.

  • السمة - ga:acquisitionSourceMedium - القيمة المجمّعة لـ ga:userالاكتسابSource وga:CPAMedium.

  • السمة - ga:acquisitionCampaign الحملة التي تم اكتساب المستخدم من خلالها. المستمدة من الجلسة الأولى للمستخدِم.

  • المقياس - ga:cohortActiveUsers - هذا المقياس مناسب في سياق سمات الإزاحة المستندة إلى 0 (ga:cohortNthDay أو ga:cohortNthWeek أو ga:cohortNthMonth). وهو يشير إلى عدد المستخدمين في المجموعة النموذجية النشطين في الفترة الزمنية المقابلة لليوم/الأسبوع/الشهر للمجموعة النموذجية. على سبيل المثال، بالنسبة إلى ga:cohortNthWeek = 1، عدد المستخدمين (في المجموعة النموذجية) النشطين في الأسبوع الثاني. إذا كان الطلب لا يتضمّن أيًا من ga:cohortNthDay أو ga:cohortNthWeek أو ga:cohortNthMonth، سيكون لهذا المقياس القيمة نفسها المُستخدَمة في ga:cohortTotalUsers.

  • المقياس - ga:cohortTotalUsers - عدد المستخدمين المنتمين إلى المجموعة النموذجية، والمعروف أيضًا باسم حجم المجموعة النموذجية.

  • المقياس - ga:cohortAppviewsPerUser - مرات مشاهدة التطبيق لكل مستخدم في مجموعة نموذجية.

  • المقياس - ga:cohortGoalCompletionsPerUser - الأهداف المكتملة لكل مستخدم في مجموعة نموذجية.

  • المقياس - ga:cohortPageviewsPerUser - عدد مرات مشاهدة الصفحة على الويب لكل مستخدم في المجموعة النموذجية.

  • المقياس - ga:cohortRetentionRate - معدل الاحتفاظ بالالمجموعات النموذجية.

  • المقياس - ga:cohortRevenuePerUser - الأرباح لكل مستخدم في المجموعة النموذجية.

  • المقياس - ga:cohortVisitDurationPerUser - مدة الجلسة لكل مستخدم في المجموعة النموذجية.

  • المقياس - ga:cohortSessionsPerUser - عدد الجلسات لكل مستخدم في المجموعة النموذجية.

  • المقياس - ga:cohortTotalUsersWithLifetimeCriteria: يكون مناسبًا في سياق الطلب الذي يحتوي على السمات ga:acquisitionTrafficChannel أو ga:acquisitionSource أو ga:acquisitionMedium أو ga:acquisitionCampaign. ويمثّل ذلك عدد المستخدِمين في المجموعات النموذجية الذين تمّ اكتسابهم من خلال القناة أو المصدر أو الوسيط أو الحملة الحالية. على سبيل المثال، بالنسبة إلى ga:acquisitionTrafficChannel=Direct، يمثّل ذلك عدد المستخدِمين في المجموعة النموذجية الذين تم اكتسابهم مباشرةً. إذا لم تتوفّر أي من السمات المذكورة، ستكون قيمتها مساوية لـ ga:cohortTotalUsers.

  • المقياس - ga:cohortAppviewsPerUserWithLifetimeCriteria - مرات مشاهدة التطبيق لكل مستخدم لسمة الاكتساب لمجموعة نموذجية.

  • المقياس - ga:cohortGoalCompletionsPerUserWithLifetimeCriteria - الأهداف المكتملة لكل مستخدم لسمة الاكتساب في مجموعة نموذجية.

  • المقياس - ga:cohortPageviewsPerUserWithLifetimeCriteria - مرات مشاهدة الصفحة على الويب لكل مستخدم لسمة الاكتساب في مجموعة نموذجية.

  • المقياس - ga:cohortRevenuePerUserWithLifetimeCriteria - الأرباح من كل مستخدم لسمة الاكتساب في مجموعة نموذجية.

  • المقياس - ga:cohortSessionsPerUserWithLifetimeCriteria - مدة الجلسة لكل مستخدم لسمة الاكتساب في مجموعة نموذجية.

تم إيقاف سمات ومقاييس "مركز بيانات الشبكات الاجتماعية" نهائيًا، ولن يتم إعداد تقارير عن البيانات السابقة إلا اعتبارًا من بعد 30 نيسان (أبريل) 2016، وبعد هذا التاريخ، لن تظهر أي بيانات جديدة. وفقًا لسياسة إيقاف البيانات نهائيًا، ستتم إزالة هذه السمات والمقاييس بعد 30 أيلول (سبتمبر) 2016.

راجِع مرجع المقاييس والسمات للحصول على القائمة الكاملة للتعريفات.

الأنشطة الاجتماعية

تم إيقاف هذه السمات والمقاييس نهائيًا وستتم إزالتها بعد 30 أيلول (سبتمبر) 2016. يُرجى الاطّلاع على سياسة إيقاف البيانات نهائيًا للحصول على تفاصيل عن إزالة البيانات:

  • السمة - ga:socialActivityEndorsingUrl - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، يكون هذا هو عنوان URL للنشاط الاجتماعي (على سبيل المثال، عنوان URL لمشاركة Google+ ، وعنوان URL لتعليق المدونة، وما إلى ذلك).
  • البُعد - ga:socialActivityDisplayName - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، هذا هو عنوان النشاط الاجتماعي الذي ينشره مستخدمو الشبكات الاجتماعية.
  • البُعد - ga:socialActivityPost - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، يكون هذا هو محتوى النشاط الاجتماعي (على سبيل المثال، محتوى رسالة تم نشرها في +Google) التي نشرها مستخدمو الشبكات الاجتماعية.
  • البُعد - ga:socialActivityTimestamp - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، هذا هو الوقت الذي حدث فيه النشاط الاجتماعي على الشبكة الاجتماعية.
  • السمة - ga:socialActivityUserHandle - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، يمثّل ذلك الاسم المعرِّف للشبكة الاجتماعية (مثل الاسم أو رقم التعريف) للمستخدمين الذين بدأوا النشاط الاجتماعي".
  • السمة - ga:socialActivityUserPhotoUrl - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، هذا هو عنوان URL للصورة المرتبطة بالملفات الشخصية للمستخدمين على الشبكات الاجتماعية".
  • السمة - ga:socialActivityUserProfileUrl - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، هذا هو عنوان URL للملفات الشخصية على الشبكات الاجتماعية للمستخدمين المرتبطين.
  • السمة - ga:socialActivityTagsSummary - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، هذه مجموعة من العلامات المفصولة بفواصل مرتبطة بالنشاط الاجتماعي.
  • السمة - ga:socialActivityAction - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، يمثل هذا نوع الإجراء الاجتماعي (على سبيل المثال، التصويت، التعليق، 1+، إلخ.) المرتبط بالنشاط.
  • البُعد - ga:socialActivityNetworkAction - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، هذا هو نوع الإجراء الاجتماعي والشبكة الاجتماعية التي نشأ منها النشاط.
  • السمة - ga:socialActivityContentUrl - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، هذا هو عنوان URL الذي يشاركه مستخدمو الشبكات الاجتماعية المرتبطون.
  • المقياس - ga:socialActivities - إجمالي عدد الأنشطة التي تمت مشاركة عنوان URL للمحتوى فيها أو تمت الإشارة إليه على شبكة شركاء مركز بيانات الشبكات الاجتماعية.

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

النظام الأساسي أو الجهاز

  • السمة ga:browserSize - حجم إطار العرض لمتصفّحات المستخدمين حجم المتصفّح هو سمة على مستوى الجلسة تسجِّل الأبعاد الأولية لإطار العرض بالبكسل، ويتمّ تنسيقه على هيئة العرض × الارتفاع. على سبيل المثال، 1920×960.

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

تضمين الصفوف الفارغة

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

المستخدِم

  • المقياس - ga:1dayUsers - إجمالي عدد المستخدمين النشطين خلال يوم واحد عن كل يوم في الفترة الزمنية المطلوبة. يجب تحديد قيمة واحدة على الأقل من ga:nthDay أو ga:date أو ga:day كبُعد من أجل طلب البحث عن هذا المقياس. وستكون القيمة المعروضة في التاريخ المحدَّد هي إجمالي عدد المستخدمين الفرديين خلال فترة يوم واحد تنتهي في التاريخ المحدّد.
  • المقياس - ga:7dayUsers - إجمالي عدد المستخدمين النشطين خلال 7 أيام عن كل يوم في الفترة الزمنية المطلوبة. يجب تحديد قيمة واحدة على الأقل من ga:nthDay أو ga:date أو ga:day كبُعد من أجل طلب البحث عن هذا المقياس. وفي التاريخ المحدّد، ستكون القيمة المعروضة هي إجمالي عدد المستخدمين الفرديين خلال فترة 7 أيام تنتهي في التاريخ المحدّد.
  • المقياس - ga:14dayUsers - إجمالي عدد المستخدمين النشطين خلال 14 يومًا عن كل يوم في الفترة الزمنية المطلوبة. يجب تحديد قيمة واحدة على الأقل من ga:nthDay أو ga:date أو ga:day كبُعد من أجل طلب البحث عن هذا المقياس. وستكون القيمة المعروضة في التاريخ المحدَّد هي إجمالي عدد المستخدمين الفرديين خلال فترة 14 يومًا تنتهي في التاريخ المحدَّد.
  • المقياس - ga:30dayUsers - إجمالي عدد المستخدمين النشطين خلال 30 يومًا عن كل يوم في الفترة الزمنية المطلوبة. يجب تحديد قيمة واحدة على الأقل من ga:nthDay أو ga:date أو ga:day كبُعد من أجل طلب البحث عن هذا المقياس. وستكون القيمة المعروضة في التاريخ المحدَّد هي إجمالي عدد المستخدمين الفريدين خلال فترة 30 يومًا تنتهي في التاريخ المحدَّد.

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

DoubleClick Ad Exchange ‏(AdX)

  • المقياس - ga:adxCTR - النسبة المئوية لمرات مشاهدة الصفحة التي أدت إلى نقرة على إعلان AdX.
  • المقياس - ga:adxClicks - عدد مرات النقر على إعلانات AdX على موقعك الإلكتروني.
  • المقياس - ga:adxCoverage - التغطية هي النسبة المئوية لطلبات الإعلان التي أدّت إلى عرض إعلان واحد على الأقل. بشكل عام، يمكن أن تساعدك التغطية في تحديد المواقع التي يتعذّر على حسابك في AdX عرض إعلانات مستهدفة فيها. (مرات ظهور الإعلان / إجمالي طلبات الإعلان) * 100
  • المقياس - ga:adxECPM - التكلفة الفعلية لكل ألف مشاهدة للصفحة على الويب. وهي أرباح AdX لكل 1000 مشاهدة صفحة على الويب.
  • المقياس - ga:adxImpressions - يتم الإبلاغ عن مرة ظهور لإعلان AdX كلما تم عرض إعلان فردي على موقعك الإلكتروني. على سبيل المثال، في حال عرض صفحة تحتوي على وحدتَين إعلانيتَين مرّة واحدة، سيتم عرض مرتَي ظهور.
  • المقياس - ga:adxImpressionsPerSession - نسبة مرات ظهور إعلان AdX إلى جلسات "إحصاءات Google" (مرات ظهور الإعلان / جلسات "إحصاءات").
  • المقياس - ga:adxMonetizedPageviews - تقيس مرات مشاهدة الصفحة التي تحقق الربح إجمالي عدد مشاهدات الصفحة على موقعك الإلكتروني التي تم عرضها مع إعلان من حسابك المرتبط في AdX. ملاحظة: يمكن أن تحتوي الصفحة الواحدة على وحدات إعلانية متعددة.
  • المقياس - ga:adxRevenue - إجمالي الأرباح المقدَّرة من إعلانات AdX.
  • المقياس - ga:adxRevenuePer1000Sessions - إجمالي الأرباح المقدَّرة من إعلانات AdX لكل 1000 جلسة في "إحصاءات Google". لاحظ أن هذا المقياس مستند إلى الجلسات في موقعك الإلكتروني وليس مرات ظهور الإعلان.
  • المقياس - ga:adxViewableImpressionsPercent - النسبة المئوية لمرات ظهور الإعلان التي كانت قابلة للعرض. يعتبر الظهور ظهورًا قابلاً للعرض عند ظهوره ضمن متصفح المستخدم وسنحت الفرصة لرؤيته.

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

السمات التي تم إيقافها نهائيًا

تم إيقاف هذه السمات نهائيًا. يُرجى الاطّلاع على سياسة إيقاف البيانات نهائيًا للحصول على تفاصيل عن إزالة البيانات:

  • السمة - ga:adSlotPosition - استخدِم ga:adSlot بدلاً منها.
  • السمة - ga:nextPagePath - استخدِم ga:pagePath بدلاً منها.
  • السمة - ga:nextContentGroupXX - استخدِم ga:contentGroupXX بدلاً منها.

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

AdWords

  • السمة - ga:adQueryWordCount - عدد الكلمات في طلب البحث.

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

النظام الأساسي أو الجهاز

  • السمة - ga:dataSource - مصدر بيانات النتيجة. يتم تسجيل النتائج المُرسلة من ga.js وanalytics.js على أنها "ويب"، بينما يتم إدراج النتائج المُرسلة من حزم تطوير البرامج (SDK) للأجهزة الجوّالة على أنها "تطبيق". ويمكن إلغاء هذه القيم.
  • السمة: ga:searchAfterDestinationPage - الصفحة التي زارها المستخدم بعد إجراء بحث داخلي على موقعك الإلكتروني.

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

ECommerce

  • المقياس - ga:transactionsPerUser - إجمالي عدد المعاملات مقسومًا على إجمالي عدد المستخدمين.
  • المقياس - ga:revenuePerUser - إجمالي أرباح المبيعات التي تم تقديمها في المعاملة باستثناء الشحن والضريبة مقسومًا على إجمالي عدد المستخدمين.

المستخدِم

  • المقياس - ga:sessionsPerUser - إجمالي عدد الجلسات مقسومًا على إجمالي عدد المستخدمين.

الشبكة الجغرافية

  • السمة - ga:cityId - أرقام تعريف المدن للمستخدمين، المستمدة من عناوين IP أو أرقام التعريف الجغرافية.
  • السمة: ga:countryIsoCode - تمثّل هذه السمة رمز ISO الخاص ببلدان المستخدمين، المستمدة من عناوين IP أو أرقام التعريف الجغرافية. يتم تقديم القيم كرمز ISO-3166-1 alpha-2.
  • السمة - ga:regionId - رقم تعريف المنطقة للمستخدِمين، المستخرَج من عناوين IP أو أرقام التعريف الجغرافية. في الولايات المتحدة، تكون المنطقة ولاية مثل نيويورك.
  • السمة: ga:regionIsoCode - رمز المنظمة الدولية للمعايير (ISO) للمنطقة، والذي تم اشتقاقه من عناوين IP أو أرقام التعريف الجغرافية. يتم تقديم القيم كرمز ISO-3166-2.
  • السمة - ga:subContinentCode - رمز المستخدمين في شبه القارة، المستمدة من عناوين IP أو أرقام التعريف الجغرافية. على سبيل المثال، بولينيزيا أو شمال أوروبا. يتم تحديد القيم على هيئة رمز UN M.49.

Campaign Manager

  • المقياس - ga:dcmROAS - عائد الإنفاق الإعلاني في DCM (عائد الإنفاق الإعلاني) (Premium فقط).

مقاييس تم إيقافها نهائيًا

تم إيقاف هذه المقاييس نهائيًا. يُرجى الاطّلاع على سياسة إيقاف البيانات لمزيد من التفاصيل حول إزالة البيانات: + المقياس - ga:dcmROI - استخدام ga:dcmROAS بدلاً من ذلك. + المقياس - ga:dcmMargen - استخدِم ga:dcmROAS بدلاً من ذلك.

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

AdWords

  • المقياس - ga:ROAS - عائد الإنفاق الإعلاني (ROAS) هو إجمالي أرباح المعاملات وقيمة الهدف مقسومًا على تكلفة الإعلان الناتجة.

السمات والمقاييس التي تم إيقافها نهائيًا

تم إيقاف هذه السمات والمقاييس نهائيًا. يُرجى الاطّلاع على سياسة إيقاف البيانات لمزيد من التفاصيل حول إزالة البيانات: + المقياس - ga:ROI - استخدام ga:ROAS بدلاً من ذلك. + المقياس - ga:margin - استخدِم ga:ROAS بدلاً من ذلك.

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

AdSense

  • المقياس - ga:adsenseCoverage - النسبة المئوية لطلبات الإعلان التي عرضت إعلانًا واحدًا على الأقل.
  • المقياس - ga:adsenseViewableImpressionPercent - النسبة المئوية لمرات الظهور التي كانت قابلة للعرض.

يتضمّن هذا الإصدار إضافة مقياس جديد للجلسة، وسمة جديدة لمصادر الزيارات، بالإضافة إلى سمات ومقاييس جديدة في DoubleClick Campaign Manager.

المكونات والمقاييس

راجِع مرجع المقاييس والسمات للحصول على القائمة الكاملة للتعريفات.

الجلسة

  • المقياس - ga:hits - إجمالي عدد النتائج المرسلة إلى "إحصاءات Google". يجمع هذا المقياس جميع أنواع النتائج (مثل مشاهدة الصفحة، والحدث، والتوقيت، وما إلى ذلك).

مصادر الزيارات

  • السمة - ga:campaignCode - عند استخدام تتبُّع الحملة اليدوي، تكون قيمة معلَمة تتبُّع الحملة utm_id.

Campaign Manager

  • السمة - ga:dcmClickAd - اسم إعلان DCM للنقرة في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • البُعد - ga:dcmClickAdId - رقم تعريف إعلان DCM للنقرة في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmClickAdType - اسم نوع الإعلان في DCM للنقر في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmClickAdTypeId - رقم تعريف نوع الإعلان في DCM لنقرة DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmClickAdvertiser - اسم معلن DCM للنقرة في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmClickAdvertiserId - الرقم التعريفي للمعلِن في DCM للنقرة في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmClickCampaign - اسم حملة DCM للنقرة في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • البُعد - ga:dcmClickCampaignId - رقم تعريف حملة DCM للنقرة في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmClickCreative - اسم تصميم الإعلان في DCM للنقرة في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • البُعد - ga:dcmClickCreativeId - رقم تعريف تصميم الإعلان في DCM للنقرة في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmClickCreativeType - اسم نوع تصميم الإعلان في DCM للنقر في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmClickCreativeTypeId - رقم تعريف نوع تصميم الإعلان في DCM للنقرة في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmClickCreativeVersion - إصدار تصميم الإعلان في DCM للنقرة في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmClickRenderingId - رقم تعريف عرض DCM للنقرة في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmClickSite - اسم الموقع الإلكتروني الذي تم فيه عرض تصميم الإعلان في DCM والنقر عليه للنقر في DCM المطابقة لجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmClickSiteId - رقم تعريف الموقع الإلكتروني في DCM حيث تم عرض تصميم الإعلان في DCM والنقر عليه للنقرة في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmClickSitePlacement - اسم موضع الإعلان على الموقع الإلكتروني في DCM للنقر في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmClickSitePlacementId - رقم تعريف موضع الإعلان على الموقع الإلكتروني في DCM للنقرة في DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmClickSpotId - رقم تعريف إعداد DCM Floodlight لنقرة DCM التي تتطابق مع جلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmFloodlightActivity - اسم نشاط Floodlight في DCM المرتبط بالإحالة الناجحة على Floodlight (النسخة المميّزة فقط).
  • السمة - ga:dcmFloodlightActivityAndGroup - اسم نشاط Floodlight في DCM واسم المجموعة المرتبط بالإحالة الناجحة على Floodlight (ميزة إضافية فقط).
  • السمة - ga:dcmFloodlightActivityGroup - اسم مجموعة أنشطة Floodlight في DCM المرتبط بالإحالة الناجحة على Floodlight (النسخة المميّزة فقط).
  • السمة - ga:dcmFloodlightActivityGroupId - رقم تعريف مجموعة أنشطة Floodlight في DCM المرتبط بالإحالة الناجحة على Floodlight (النسخة المميّزة فقط).
  • السمة - ga:dcmFloodlightActivityId - رقم تعريف نشاط Floodlight في DCM المرتبط بالإحالة الناجحة على Floodlight (النسخة المميّزة فقط).
  • السمة - ga:dcmFloodlightAdvertiserId - الرقم التعريفي للمعلِن في Floodlight في DCM المرتبط بالإحالة الناجحة على Floodlight (ميزة إضافية فقط)
  • السمة - ga:dcmFloodlightSpotId - رقم تعريف إعداد Floodlight في DCM المرتبط بالإحالة الناجحة Floodlight (للميزة الإضافية فقط).
  • السمة - ga:dcmLastEventAd - اسم إعلان DCM لآخر حدث في DCM (مرة ظهور أو نقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventAdId - رقم تعريف إعلان DCM لآخر حدث في DCM (مرة ظهور أو نقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventAdType - اسم نوع الإعلان في DCM لآخر حدث في DCM (مرة ظهور أو نقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventAdTypeId - رقم تعريف نوع الإعلان في DCM لآخر حدث في DCM (مرة ظهور أو نقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventAdvertiser - اسم معلن DCM لآخر حدث في DCM (مرة ظهور أو نقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventAdvertiserId - الرقم التعريفي للمعلِن في DCM لآخر حدث في DCM (مرة ظهور أو نقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة: ga:dcmLastEventAttributionType - هناك قيمتان محتملتان (النقر إلى الظهور ونشاط العرض). إذا كان آخر حدث DCM مرتبط بجلسة "إحصاءات Google" هو نقرة، ستكون القيمة هي النقر إلى الظهور. إذا كان حدث DCM الأخير المرتبط بجلسة "إحصاءات Google" هو مرة ظهور للإعلان، ستكون القيمة هي نشاط العرض (ميزة حصرية فقط).
  • السمة - ga:dcmLastEventCampaign - اسم حملة DCM لآخر حدث في DCM (مرات الظهور أو النقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventCampaignId - رقم تعريف حملة DCM لحدث DCM الأخير (مرة الظهور أو النقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventCreative - اسم تصميم الإعلان في DCM لآخر حدث في DCM (الظهور أو النقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventCreativeId - رقم تعريف تصميم الإعلان في DCM لآخر حدث في DCM (مرة ظهور أو نقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventCreativeType - اسم نوع تصميم الإعلان في DCM لآخر حدث في DCM (مرة ظهور أو نقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventCreativeTypeId - رقم تعريف نوع تصميم الإعلان في DCM لآخر حدث في DCM (مرة ظهور أو نقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventCreativeVersion - إصدار تصميم الإعلان في DCM لآخر حدث في DCM (مرة ظهور أو نقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventRenderingId - رقم تعريف عرض DCM لحدث DCM الأخير (مرة الظهور أو النقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventSite - اسم الموقع الإلكتروني الذي تم فيه عرض تصميم إعلان DCM والنقر عليه لآخر حدث DCM (مرة ظهور أو نقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventSiteId - رقم تعريف الموقع الإلكتروني في DCM حيث تم عرض تصميم الإعلان في DCM والنقر عليه لآخر حدث DCM (مرة ظهور أو نقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventSitePlacement - اسم موضع الإعلان على الموقع الإلكتروني في DCM لحدث DCM الأخير (مرات الظهور أو النقر ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventSitePlacementId - رقم تعريف موضع الإعلان على الموقع الإلكتروني في DCM لحدث DCM الأخير (مرة الظهور أو النقر ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • السمة - ga:dcmLastEventSpotId - رقم تعريف إعداد DCM Floodlight لحدث DCM الأخير (مرة ظهور أو نقرة ضمن فترة معاينة الإعلان في DCM) المرتبط بجلسة "إحصاءات Google" (النسخة المدفوعة فقط).
  • المقياس - ga:dcmFloodlightQuantity - عدد الإحالات الناجحة في Floodlight في DCM (النسخة المدفوعة فقط).
  • المقياس - dcmFloodlightRevenue - أرباح Floodlight في DCM (ميزة إضافية فقط)

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

المكونات والمقاييس

راجِع مرجع المقاييس والسمات للحصول على القائمة الكاملة للتعريفات.

تصنيف المحتوى إلى مجموعات

  • السمة: ga:landingContentGroupXX - مجموعة المحتوى المطابقة الأولى في جلسة المستخدم
  • السمة - ga:nextContentGroupXX - تشير إلى مجموعة المحتوى التي تمت زيارتها بعد مجموعة محتوى أخرى.
  • السمة - ga:contentGroupXX - مجموعة المحتوى على أحد المواقع. مجموعة المحتوى هي مجموعة من المحتوى الذي يوفّر بنية منطقية يمكن تحديدها من خلال رمز التتبّع أو مطابقة التعبير العادي لعنوان الصفحة أو عنوان URL أو قواعد محدّدة مسبقًا.
  • السمة ga:previousContentGroupXX: تشير إلى مجموعة المحتوى التي تمت زيارتها قبل مجموعة محتوى أخرى.
  • المقياس - ga:contentGroupUniqueViewsXX - عدد الصفحات المختلفة (الفريدة) في جلسة واحدة لمجموعة المحتوى المحدّدة. ويضع هذا في الاعتبار كلاً من pagePath وpageTitle لتحديد القيمة الفريدة.

يتضمّن هذا الإصدار شرطًا جديدًا للسمة dateOfSession من أجل الشرائح، بالإضافة إلى إضافة سمات ومقاييس التجارة الإلكترونية المحسَّنة الجديدة.

الشرائح

تتوافق الشرائح الآن مع شرط dateOfSession جديد يمكن أن يحصر شريحة بمجموعة من المستخدمين الذين بدأوا جلسة خلال نطاق زمني معيّن. راجع دليل مطوّر الشرائح لمزيد من التفاصيل.

المكونات والمقاييس

راجع مرجع المقاييس والأبعاد للحصول على القائمة الكاملة لتعريفات التجارة الإلكترونية المحسّنة.

التجارة الإلكترونية المحسَّنة

  • السمة - ga:internalPromotionCreative - المحتوى الإبداعي المصمَّم للإعلان الترويجي.
  • السمة ga:internalPromotionId - المعرّف الذي تستخدمه للعرض الترويجي.
  • السمة - ga:internalPromotionName - اسم العرض الترويجي
  • البُعد: ga:internalPromotionPosition - موضع الإعلان الترويجي على صفحة الويب أو شاشة التطبيق
  • السمة - ga:orderCouponCode - رمز القسيمة على مستوى الطلب
  • السمة: ga:productBrand - اسم العلامة التجارية التي يتم بيع المنتج بموجبها
  • السمة - ga:productCategoryHierarchy - الفئة الهرمية التي تم تصنيف المنتج فيها (التجارة الإلكترونية المحسَّنة).
  • السمة - ga:productCategoryLevelXX - المستوى (1-5) في التسلسل الهرمي لفئة المنتج، بدءًا من الأعلى.
  • السمة - ga:productCouponCode - رمز القسيمة على مستوى المنتج
  • السمة ga:productListName - اسم قائمة المنتجات التي يظهر فيها المنتج
  • السمة ga:productListPosition - موضع المنتج في قائمة المنتجات
  • السمة - ga:productVariant - الصيغة المحدّدة للمنتج، مثل XS أو S أو M أو L للحجم أو باللون الأحمر أو الأزرق أو الأخضر أو الأسود.
  • السمة - ga:checkoutOptions - خيارات المستخدم المحدَّدة أثناء عملية الدفع، مثل FedEx أو DHL أو UPS للحصول على خيارات التوصيل أو Visa أو MasterCard أو AmEx للحصول على خيارات الدفع. يجب استخدام هذا البُعد في أثناء مرحلة التسوق.
  • السمة - ga:shoppingStage - المراحل المختلفة لتجربة التسوّق التي أكملها المستخدِمون في الجلسة، مثل PRODUCT_VIEW، ADD_TO_CART، CHECKOUT، وما إلى ذلك.
  • المقياس - ga:internalPromotionCTR - معدّل نقر المستخدِمِين على الإعلان الترويجي الداخلي (عدد النقرات / عدد مرّات ظهور العرض الترويجي).
  • المقياس - ga:internalPromotionClicks - عدد النقرات على إعلان ترويجي داخلي
  • المقياس - ga:internalPromotionViews - عدد مرات مشاهدة إعلان ترويجي داخلي.
  • المقياس - ga:localProductRefundAmount - المبلغ الذي يجب رده لمنتج معيّن بالعملة المحلية
  • المقياس - ga:localRefundAmount - إجمالي المبلغ المردود للمعاملة بالعملة المحلية.
  • المقياس - ga:productAddsToCart - عدد مرات إضافة المنتج إلى سلة التسوق.
  • المقياس - ga:productCheckouts - عدد المرات التي تم فيها تضمين المنتج في عملية الدفع.
  • المقياس - ga:productDetailViews - عدد المرات التي شاهد فيها المستخدمون صفحة تفاصيل المنتج.
  • المقياس - ga:productListClicks - عدد المرات التي نقر فيها المستخدمون على المنتج عند ظهوره في قائمة المنتجات.
  • المقياس - ga:productListViews - عدد المرات التي ظهر فيها المنتج في قائمة المنتجات.
  • المقياس - ga:productListCTR - معدّل نقر المستخدمين على المنتج في قائمة المنتجات.
  • المقياس - ga:productRefunds - عدد مرات ردّ أموال المنتج.
  • المقياس - ga:productRefundAmount - إجمالي مبلغ ردّ الأموال المرتبط بالمنتج.
  • المقياس - ga:productRemovesFromCart - عدد مرات إزالة المنتج من سلات التسوق.
  • المقياس - ga:productRevenuePerPurchase - متوسط أرباح المنتج لكل عملية شراء (تُستخدم عادةً مع رمز قسيمة المنتج).
  • المقياس - ga:buyToDetailRate - عمليات الشراء الفريدة مقسومةً على مشاهدات صفحات تفاصيل المنتج.
  • المقياس - ga:cartToDetailRate - إضافات المنتج مقسومًا على مرات مشاهدة تفاصيل المنتج.
  • المقياس - ga:quantityAddedToCart - عدد وحدات المنتج التي تمت إضافتها إلى سلة التسوق.
  • المقياس - ga:quantityCheckedOut - عدد وحدات المنتج المضمّنة في عملية الدفع.
  • المقياس - ga:quantityRefunded - عدد وحدات المنتج التي تم رد أموالها.
  • المقياس - ga:quantityRemovedFromCart - عدد وحدات المنتجات التي تمت إزالتها من سلة التسوق.
  • المقياس - ga:refundAmount - المبلغ بالعملة التي تم رد أموالها لمعاملة معيّنة.
  • المقياس - ga:totalRefunds - عدد عمليات رد الأموال التي تم إصدارها.

يتضمن هذا الإصدار إصلاحًا للخطأ لأسماء رؤوس الأعمدة بالإضافة إلى إضافة أبعاد ومقاييس جديدة.

المكونات والمقاييس

راجِع مرجع المقاييس والسمات للحصول على القائمة الكاملة للتعريفات.

النظام

  • السمة: ga:sourcePropertyDisplayName - الاسم المعروض للموقع المصدر لمواقع البيانات المجمّعة. ينطبق ذلك فقط على مواقع البيانات المجمّعة.
  • السمة - ga:sourcePropertyTrackingId - رقم تعريف تتبّع الموقع المصدر لمواقع البيانات المجمّعة. هذا الخيار صالح فقط لمواقع البيانات المجمّعة.

تصنيف القنوات إلى مجموعات

  • السمة: ga:channelGrouping - التصنيف التلقائي للقنوات إلى مجموعات الذي تتم مشاركته ضمن الملف الشخصي (الملف الشخصي).
  • السمة: ga:correlationModelId - رقم تعريف نموذج الارتباط للمنتجات ذات الصلة.
  • السمة - ga:queryProductId - رقم تعريف المنتج الذي يتم الاستعلام عنه
  • السمة - ga:queryProductName - اسم المنتج الذي يتم الاستعلام عنه
  • السمة - ga:queryProductVariation - شكل المنتج الذي يتم الاستعلام عنه
  • السمة - ga:relatedProductId - رقم تعريف المنتج ذي الصلة.
  • السمة - ga:relatedProductName - اسم المنتج ذي الصلة.
  • السمة - ga:relatedProductVariation - شكل المنتج ذي الصلة.
  • المقياس - ga:correlationScore - نقاط الارتباط للمنتجات ذات الصلة.
  • المقياس - ga:queryProductQuantity - كمية المنتج الذي يتم الاستعلام عنه
  • المقياس - ga:relatedProductQuantity - كمية المنتج ذي الصلة.

تصحيح اسم عمود العنوان

  • كان هناك خطأ في الإصدار 2014/4/16؛ فإذا أجريت طلب بحث عن بُعد أو مقياس تم إيقاف العمل به، ستعرض واجهة برمجة التطبيقات عناوين الأعمدة مع البُعد أو المقياس البديل. يعرض الآن اسم السمة أو المقياس نفسه المستخدَم في الطلب بشكل صحيح.

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

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

تمّت إضافة السمات التالية إلى Core Reporting API:

AdWords

  • البُعد - ga:isTrueViewVideoAd - Yes أو No - يشير إلى ما إذا كان الإعلان إعلان فيديو TrueView من AdWords أم لا.

الوقت

  • البُعد - ga:nthHour - المؤشر لكل ساعة في النطاق الزمني المحدّد. مؤشر أول ساعة من اليوم الأول (أي تاريخ البدء) في النطاق الزمني هو 0 و1 للساعة التالية، وهكذا.

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

تمت إعادة تسمية جميع السمات والمقاييس المستندة إلى الزائر والزيارة إلى المستخدم والجلسة على التوالي بدلاً من ذلك.

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

الجمهور

  • السمة - ga:visitorAgeBracket - استخدِم ga:userAgeBracket بدلاً منها.
  • السمة - ga:visitorGender - استخدِم ga:userGender بدلاً منها.

التجارة الإلكترونية

  • المقياس - ga:transactionRevenuePerVisit - استخدِم ga:transactionRevenuePerSession بدلاً منه.
  • المقياس - ga:transactionsPerVisit - استخدِم ga:transactionsPerSession بدلاً منه.

تتبع الأحداث

  • المقياس - ga:eventsPerVisitWithEvent - استخدِم ga:eventsPerSessionWithEvent بدلاً منه.
  • المقياس - ga:visitsWithEvent - استخدِم ga:sessionsWithEvent بدلاً منه.

الإحالات الناجحة إلى الأهداف

  • المقياس - ga:goalValuePerVisit - استخدِم ga:goalValuePerSession بدلاً منه.
  • المقياس - ga:percentVisitsWithSearch - استخدِم ga:percentSessionsWithSearch بدلاً منه.
  • المقياس - ga:searchVisits - استخدِم ga:searchSessions بدلاً منه.

تتبع الصفحات

  • المقياس - ga:pageviewsPerVisit - استخدِم ga:pageviewsPerSession بدلاً منه.

الجلسة

  • السمة - ga:visitLength - استخدِم ga:sessionDurationBucket بدلاً منها.
  • المقياس - ga:avgTimeOnSite - استخدِم ga:avgSessionDuration بدلاً منه.
  • المقياس - ga:timeOnSite - استخدِم ga:sessionDuration بدلاً منه.
  • المقياس - ga:visitBounceRate - استخدِم ga:bounceRate بدلاً منه.
  • المقياس - ga:visits - استخدِم ga:sessions بدلاً منه.

التفاعلات الاجتماعية

  • السمة - ga:socialInteractionNetworkActionVisit - استخدِم ga:socialInteractionNetworkActionSession بدلاً منها.
  • المقياس - ga:socialInteractionsPerVisit - استخدِم ga:socialInteractionsPerSession بدلاً منه.

المستخدِم

  • السمة - ga:daysSinceLastVisit - استخدِم ga:daysSinceLastSession بدلاً منها.
  • السمة - ga:visitCount - استخدِم ga:sessionCount بدلاً منها.
  • السمة - ga:visitorType - استخدِم ga:userType بدلاً منها.
  • السمة - ga:visitsToTransaction - استخدِم ga:sessionsToTransaction بدلاً منها.
  • المقياس - ga:newVisits - استخدِم ga:newUsers بدلاً منه.
  • المقياس - ga:percentNewVisits - استخدِم ga:percentNewSessions بدلاً منه.
  • المقياس - ga:visitors - استخدِم ga:users بدلاً منه.

الشرائح: الإصدار 2.4 و3.0 من Core Reporting API

إتاحة شرائح جديدة في Core Reporting API

  • توفِّر المَعلمة segment الآن شرائح المستخدِمين والتسلسلات. يمكن طلب البحث عن الشرائح على مستوى المستخدم ومستوى الجلسة التي تم إنشاؤها في واجهة الويب باستخدام المعلمة segment.
  • تتوفّر بنية جديدة لشرائح الجمهور الديناميكية للاستخدام مع المَعلمة segment. لمعرفة التفاصيل، يُرجى الاطّلاع على دليل مطوّر الشرائح.
  • تم إيقاف البادئة dynamic:: نهائيًا. ننصحك migrate إلى البنية الجديدة في أقرب وقت ممكن.

يتضمّن هذا الإصدار تنسيقًا جديدًا للاستجابة لجدول البيانات، بالإضافة إلى إضافة سمات ومقاييس وإيقافها نهائيًا (يُرجى مراجعة مرجع السمات والمقاييس للاطّلاع على القائمة الكاملة للتعريفات).

إخراج جدول البيانات

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

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

تمت إضافة السمات والمقاييس التالية إلى Core Reporting API:

الوقت

  • السمة ga:minute: تعرض الدقيقة في الساعة. تتراوح القيم المحتملة بين 00 و59.
  • السمة - ga:nthMinute - المؤشر لكل دقيقة في النطاق الزمني المحدّد. مؤشر الدقيقة الأولى من اليوم الأول (أي تاريخ البدء) في النطاق الزمني هو 0 و1 للدقيقة التالية، وهكذا.

الجمهور

  • السمة - ga:visitorAgeBracket - الفئة العمرية للزائر.
  • السمة - ga:visitorGender - جنس الزائر
  • السمة - ga:interestAffinityCategory - تشير إلى زيادة احتمال اهتمام المستخدمين بالتعرّف على الفئة المحدّدة.
  • السمة - ga:interestInMarketCategory - تشير إلى أن المستخدمين يُرجح أن يكونوا مستعدين لشراء منتجات أو خدمات في الفئة المحددة.
  • السمة - ga:interestOtherCategory - تشير إلى زيادة احتمال اهتمام المستخدمين بالتعرّف على الفئة المحدّدة، ويزداد احتمال أن يكونوا مستعدين للشراء.

السمات والمقاييس المسموح بها في الشرائح

يمكن الآن استخدام هذه السمات والمقاييس في الشرائح:

  • السمة - ga:sourceMedium - القيم المجمّعة لـ ga:source وga:medium.
  • المقياس - ga:localItemRevenue - أرباح المنتج بالعملة المحلية

السمات والمقاييس التي تم إيقافها نهائيًا

تم إيقاف هذه السمات والمقاييس نهائيًا. يُرجى الاطّلاع على سياسة إيقاف البيانات نهائيًا للحصول على تفاصيل عن إزالة البيانات:

  • السمة - ga:isMobile - يمكنك استخدام ga:deviceCategory بدلاً من ذلك (على سبيل المثال، ga:deviceCategory==mobile).
  • السمة - ga:isTablet - يمكنك استخدام ga:deviceCategory بدلاً من ذلك (على سبيل المثال، ga:deviceCategory==tablet).
  • المقياس - ga:entranceBounceRate - استخدِم ga:visitBounceRate بدلاً منه.

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

AdSense

  • تمت إضافة إذن الوصول إلى بيانات AdSense:

    • تم - ga:adsenseRevenue - إجمالي الإيرادات من إعلانات AdSense.
    • تم - ga:adsenseAdUnitsViewed - عدد وحدات AdSense الإعلانية التي تمت مشاهدتها. الوحدة الإعلانية هي مجموعة من الإعلانات التي يتم عرضها كنتيجة لجزء واحد من رمز إعلان AdSense. التفاصيل: https://support.google.com/adsense/answer/32715.
    • تم - ga:adsenseAdsViewed - عدد إعلانات AdSense التي تمت مشاهدتها. يمكن عرض إعلانات متعددة ضمن الوحدة الإعلانية.
    • تم - ga:adsenseAdsClicks - عدد مرات النقر على إعلانات AdSense على موقعك.
    • تم القياس - ga:adsensePageImpressions - عدد مشاهدات الصفحة على الويب التي تم خلالها عرض إعلان AdSense. يمكن أن تحتوي مرة ظهور الصفحة على وحدات إعلانية متعددة.
    • تم - ga:adsenseCTR - النسبة المئوية لمرات ظهور الصفحة التي أدت إلى نقرة على إعلان AdSense. (ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • تم - ga:adsenseECPM - التكلفة المقدّرة لكل ألف ظهور على الصفحة. وهي ‏‫أرباح AdSense لكل 1000 ظهور للصفحة. (ga:adsenseRevenue/(ga:adsensePageimpression/1000)
    • تم - ga:adsenseExits - عدد الجلسات التي انتهت بسبب نقر أحد المستخدمين على أحد إعلانات AdSense.

الوقت

  • خافت - ga:isoYear - سنة ISO للزيارة. التفاصيل: http://en.wikipedia.org/wiki/ISO_week_date. يجب استخدام السمة ga:isoYear مع ga:isoWeek فقط، لأنّ السمة ga:week تمثّل التقويم الميلادي.
  • خافت - ga:isoYearIsoWeek - القيم الجمعية لـ ga:isoYear وga:isoWeek.

AdWords

  • يمكن العثور على هذه البيانات في تقارير AdWords:

    • خافت - ga:adKeywordMatchType - أنواع المطابقة المطبَّقة على كلماتك الرئيسية (عبارة، مطابقة تامة، تقريبية). التفاصيل: فهم تقرير عبارات البحث.

الميزات الجديدة للتحكم في حجم العينة والتواريخ النسبية

التواريخ النسبية
  • تمت إضافة إمكانية تحديد التواريخ النسبية إلى Core Reporting API. أصبحت today وyesterday وNdaysAgo الآن قيمًا صالحة لمعلَمات طلب البحث start-date وend-date.
  • سيؤدي استخدام هذه القيم إلى تحديد النطاق الزمني تلقائيًا بالاستناد إلى التاريخ الحالي في وقت إجراء طلب البحث، وإلى المنطقة الزمنية للملف الشخصي المحدّد في طلب البحث. يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات للحصول على تفاصيل إضافية.
مستوى أخذ العينات
  • تمّ تقديم مَعلمة جديدة، samplingLevel، تسمح لك بضبط مستوى أخذ العينات (أي عدد الزيارات المستخدَمة لحساب النتيجة) لأي طلب بحث لإعداد التقارير. القيم المسموح بها هي: DEFAULT وFASTER وHIGHER_PRECISION.
  • تمت إضافة حقلَين جديدَين إلى استجابة واجهة برمجة التطبيقات: sampleSize وsampleSpace. يمكنك استخدام هذه القيم لحساب النسبة المئوية للزيارات التي تم استخدامها كعينة لاستجابة.
  • يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات وأخذ العينات للحصول على تفاصيل إضافية.

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

  • يعرض ga:adwordsCustomerID الآن بشكلٍ صحيح الرقم التعريفي لعميل AdWords المؤلف من 10 أرقام والمطابق لـ AccountInfo.customerId في AdWords API. ويتيح هذا الإصلاح إمكانية دمج بيانات "إحصاءات Google" مع حسابات متعددة في AdWords.

في إطار إطلاق شرائح الجمهور الجديدة، سنطرح التغييرات التالية على واجهة برمجة التطبيقات الأساسية لإعداد التقارير.

  • تتيح المَعلمة segment الآن المعرّف الأبجدي الرقمي الجديد للشرائح المتقدمة المخصّصة، والذي يتم عرضه في مجموعة شرائح Management API.
  • سيتمّ الآن إيقاف أرقام التعريف الرقمية الحالية لشرائح الجمهور المخصّصة. وستظل أرقام التعريف القديمة هذه متاحة لمدة 6 أشهر. ننصحك بالتطبيقات التي تحفظ معرّفات شرائح المستخدمين للتبديل إلى المعرّفات الأبجدية الرقمية الجديدة. بعد انتهاء فترة الإيقاف النهائي، ستظهر رسالة خطأ في أيّ طلبات بحث تتضمّن المعرّفات الرقمية القديمة.
  • في الوقت الحالي، يمكن طلب البحث عن شرائح مستوى الزيارة التي تم إنشاؤها في واجهة الويب فقط من خلال المعلمة segment.
  • ولن تتأثر الشرائح التلقائية الحالية التي تحتوي على معرّفات رقمية سالبة. في المقابل، لا يمكن حاليًا استخدام الشرائح التلقائية الجديدة.

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

تتبع التطبيق

  • يمكن العثور على هذه البيانات في تقارير "الملف الشخصي للتطبيق":
    • تعتيم - ga:appId - رقم تعريف التطبيق.
    • تعتيم - ga:appInstallerId - رقم تعريف أداة التثبيت (على سبيل المثال، متجر Google Play) الذي تمّ تنزيل التطبيق منه. يتم تلقائيًا ضبط رقم تعريف أداة تثبيت التطبيق استنادًا إلى طريقة PackageManager#getInstallerPackageName.
    • خافت - ga:appName - اسم التطبيق.
    • تعتيم - ga:appVersion - إصدار التطبيق
    • خافت - ga:exitScreenName - اسم الشاشة عندما خرج المستخدم من التطبيق.
    • خافت - ga:landingScreenName - اسم أول شاشة تمت مشاهدتها.
    • تعتيم - ga:screenDepth - عدد مشاهدات الشاشة لكل جلسة كسلسلة. يمكن أن يكون مفيدًا للمدرجات التكرارية.
    • خافت - ga:screenName - اسم الشاشة.
    • القياس - ga:avgScreenviewDuration - متوسط الوقت الذي يقضيه المستخدمون على الشاشة بالثواني.
    • تم - ga:timeOnScreen - الوقت المستغرَق في مشاهدة الشاشة الحالية.
    • تم - ga:screenviews - إجمالي عدد مشاهدات الشاشة. استخدِم هذا بدلاً من ga:appviews.
    • تم - ga:uniqueScreenviews - عدد ga:screenviews المختلفة (الفريدة) ضمن الجلسة. استخدِم هذا بدلاً من ga:uniqueAppviews.
    • تم - ga:screenviewsPerSession - متوسط عدد ga:screenviews لكل جلسة. استخدِم هذا بدلاً من ga:appviewsPerVisit.

منهي العمل به

تم إيقاف المقاييس التالية نهائيًا. استخدِم اسم المقياس الجديد بدلاً من ذلك.

  • تم - ga:appviews - استخدام ga:screenviews كبديل.
  • تم - ga:uniqueAppviews - استخدام ga:uniqueScreenviews كبديل.
  • تم - ga:appviewsPerVisit - استخدام ga:screenviewsPerSession كبديل.

المتغيرات أو الأعمدة المخصصة

  • الوصول إلى السمات والمقاييس المخصَّصة:

    • خافت - ga:dimensionXX - اسم السمة المخصصة المطلوبة، حيث يشير XX إلى رقم/فهرس السمة المخصصة.
    • تم - ga:metricXX - اسم المقياس المخصّص المطلوب، حيث يشير XX إلى رقم/فهرس المقياس المخصّص.

التغييرات في الوثائق

تمت إعادة تسمية سمة ومقياس المتغيّر المخصّص التاليَين. ينطبق هذا التغيير على المستندات فقط، ولن يُطلب منك تعديل استعلاماتك.

  • ga:customVarName(n) ‏← ga:customVarNameXX
  • ga:customVarValue(n) ‏← ga:customVarValueXX

التجارة الإلكترونية

  • تعتيم - ga:currencyCode - رمز العملة المحلية للمعاملة استنادًا إلى معيار ISO 4217.
  • تم الدفع - ga:localItemRevenue - أرباح المنتج بالعملة المحلية
  • تم الدفع - ga:localTransactionRevenue - أرباح المعاملات بالعملة المحلية
  • تم الدفع - ga:localTransactionShipping - تكلفة شحن المعاملات بالعملة المحلية.
  • تم الدفع - ga:localTransactionTax - ضريبة المعاملات بالعملة المحلية.

الاستثناءات

  • تأتي هذه البيانات من تتبع الاستثناءات.
    • خافت - ga:exceptionDescription - وصف الاستثناء.
    • تم استيفاء - ga:exceptionsPerScreenview - عدد الاستثناءات المرفوضة مقسومًا على عدد مرات مشاهدة الصفحة في التطبيق.
    • تم الاستيفاء - ga:fatalExceptionsPerScreenview - عدد الاستثناءات الفادحة التي تم طرحها مقسومًا على عدد مرات مشاهدة الصفحة في التطبيق.

الإحالات الناجحة إلى الأهداف

  • خافت - ga:goalCompletionLocation - مسار الصفحة أو اسم الشاشة الذي طابق أي هدف مكتمل لأي نوع وجهة.
  • خافت - ga:goalPreviousStep1 - مسار الصفحة أو اسم الشاشة الذي طابق أي هدف لنوع الوجهة، قبل موقع الهدف المكتمل بخطوة واحدة.
  • خافت - ga:goalPreviousStep2 - مسار الصفحة أو اسم الشاشة الذي طابق أي هدف لنوع الوجهة، خطوتان قبل موقع الأهداف المكتملة.
  • خافت - ga:goalPreviousStep3 - مسار الصفحة أو اسم الشاشة الذي طابق أي هدف لنوع الوجهة، ثلاث خطوات قبل موقع الأهداف المكتملة.

التغييرات في الوثائق

تمت إعادة تسمية سمة "الإحالات الناجحة إلى الهدف" والمقاييس التالية. ينطبق هذا التغيير على المستندات فقط، ولن يُطلب منك تعديل استعلاماتك.

  • ga:goal(n)AbandonRate ‏← ga:goalXXAbandonRate
  • ga:goal(n)Abandons ‏← ga:goalXXAbandons
  • ga:goal(n)Completions ‏← ga:goalXXCompletions
  • ga:goal(n)ConversionRate ‏← ga:goalXXConversionRate
  • ga:goal(n)Starts ‏← ga:goalXXStarts
  • ga:goal(n)Value ‏← ga:goalXXValue
  • ga:searchGoal(n)ConversionRate ‏← ga:searchGoalXXConversionRate
  • تم - ga:percentSearchRefinements - النسبة المئوية لعدد المرات التي تحدث فيها تصفية (أي الانتقال) بين الكلمات الرئيسية للبحث الداخلي ضمن جلسة واحدة.

تتبع الصفحات

  • تم - ga:pageValue - متوسط قيمة هذه الصفحة أو مجموعة من الصفحات. قيمة الصفحة هي ((أرباح المعاملة + إجمالي قيمة الهدف) مقسومةً على مشاهدات الصفحة الفريدة للصفحة أو مجموعة الصفحات).

النظام الأساسي أو الجهاز

  • هذه البيانات مشتقة من سلسلة وكيل مستخدم HTTP.

    • خافت - ga:deviceCategory - نوع الجهاز: كمبيوتر مكتبي أو جهاز لوحي أو جهاز جوّال.
    • خافت - ga:isTablet - يشير إلى زوّار الأجهزة اللوحية. القيمتان المحتملتان هي Yes أو No.
    • خافت - ga:mobileDeviceMarketingName - الاسم التسويقي المستخدم للجهاز الجوّال.

التفاعلات الاجتماعية

  • تأتي هذه البيانات من تتبُّع التفاعل الاجتماعي في الموقع.

    • خافت - ga:socialEngagementType - نوع التفاعل. القيم المحتملة هي Socially Engaged أو Not Socially Engaged.

الوقت

  • خافت - ga:dateHour - القيم الجمعية لـ ga:date وga:hour.
  • خافت - ga:dayOfWeekName - اسم اليوم من الأسبوع (باللغة الإنجليزية).
  • خافت - ga:isoWeek - رقم أسبوع ISO، حيث يبدأ كل أسبوع بيوم الاثنين. التفاصيل: http://en.wikipedia.org/wiki/ISO_week_date.
  • خافت - ga:yearMonth - القيم الجمعية لـ ga:year وga:month.
  • خافت - ga:yearWeek - القيم الجمعية لـ ga:year وga:week.

مصادر الزيارات

  • تعتيم - ga:fullReferrer - عنوان URL للإحالة بالكامل، بما في ذلك اسم المضيف والمسار.
  • خافت - ga:sourceMedium - القيم المدمجة لـ ga:source وga:medium.
  • يضيف هذا الإصدار 5 مقاييس جديدة لسرعة الموقع الإلكتروني:
    • ga:domInteractiveTime
    • ga:avgDomInteractiveTime
    • ga:domContentLoadedTime
    • ga:avgDomContentLoadedTime
    • ga:domLatencyMetricsSample
  • يضيف هذا الإصدار شريحة تلقائية جديدة لزيارات الأجهزة اللوحية، وهي gaid::-13.

يضيف هذا الإصدار سمات ومقاييس جديدة إلى واجهة برمجة التطبيقات. اطّلِع على مرجع المقاييس والسمات للاطّلاع على التعريفات.

تتبع التطبيق

  • يمكن العثور على هذه البيانات في تقارير حزمة تطوير البرامج (SDK) لتتبُّع التطبيقات المتوافقة مع الأجهزة الجوّالة:
    • تم - ga:uniqueAppviews - عدد مرات مشاهدة التطبيق لكل جلسة.
    • تم - 'ga:appviews - إجمالي عدد مشاهدات التطبيق.
    • تم القياس - ga:appviewsPerVisit - متوسط عدد مشاهدات التطبيق لكل جلسة.

مصادر الزيارات

  • تعتيم - ga:socialNetwork - سلسلة تمثِّل اسم الشبكة الاجتماعية. يمكن أن يكون هذا مرتبطًا بالشبكة الاجتماعية المُحيلة لمصادر الزيارات، أو بالشبكة الاجتماعية لأنشطة مركز بيانات الشبكات الاجتماعية. على سبيل المثال، +Google، وBlogger، وRedit، وما إلى ذلك
  • تعتيم - ga:hasSocialSourceReferral - يشير إلى الزيارات التي وصلت إلى الموقع من مصدر اجتماعي (أي شبكة اجتماعية مثل Google+ وFacebook وTwitter وغير ذلك). القيم المحتملة هي نعم أو لا، حيث يجب أن يكون الحرف الأول كبيرًا.

الأنشطة الاجتماعية

  • تأتي هذه البيانات من النشاط خارج الموقع تم استيراده من شركاء مركز بيانات الشبكات الاجتماعية.
    • تعتيم - ga:socialActivityDisplayName - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، تمثل هذه السلسلة عنوان النشاط الاجتماعي الذي نشره مستخدم الشبكة الاجتماعية.
    • تعتيم - ga:socialActivityEndorsingUrl - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، تمثل هذه السلسلة عنوان URL للنشاط الاجتماعي (على سبيل المثال، عنوان URL لمشاركة Google+ ، وعنوان URL لتعليق المدونة، وما إلى ذلك).
    • تعتيم - ga:socialActivityPost - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، تمثل هذه السلسلة محتوى النشاط الاجتماعي الذي نشره مستخدم الشبكة الاجتماعية (على سبيل المثال، محتوى الرسالة في مشاركة في +Google)
    • خافت - ga:socialActivityTimestamp - بالنسبة لنشاط مركز بيانات الشبكات الاجتماعية، تمثل هذه السلسلة وقت حدوث النشاط الاجتماعي على الشبكة الاجتماعية.
    • تعتيم - ga:socialActivityUserPhotoUrl - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، تمثل هذه السلسلة عنوان URL للصورة المرتبطة بالملف الشخصي للمستخدم على الشبكة الاجتماعية.
    • تعتيم - ga:socialActivityUserProfileUrl - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، تمثل هذه السلسلة عنوان URL للملف الشخصي للمستخدم المرتبط على الشبكة الاجتماعية.
    • تعتيم - ga:socialActivityContentUrl - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، تمثل هذه السلسلة عنوان URL الذي شاركه مستخدم الشبكة الاجتماعية المرتبط.
    • تعتيم - ga:socialActivityTagsSummary - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، هذه مجموعة من العلامات المفصولة بفواصل مرتبطة بالنشاط الاجتماعي.
    • تعتيم - ga:socialActivityUserHandle - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، تمثل هذه السلسلة الاسم المعرِّف للشبكة الاجتماعية (أي الاسم) للمستخدم الذي بدأ النشاط الاجتماعي.
    • تعتيم - ga:socialActivityAction - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، تمثل هذه السلسلة نوع الإجراء الاجتماعي المرتبط بالنشاط (على سبيل المثال، التصويت، التعليق، 1+، وما إلى ذلك).
    • تعتيم - ga:socialActivityNetworkAction - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، تمثل هذه السلسلة نوع الإجراء الاجتماعي والشبكة الاجتماعية التي نشأ منها النشاط.
    • تم القياس - ga:socialActivities - عدد الأنشطة التي تمت فيها مشاركة عنوان URL للمحتوى أو الإشارة إليه على إحدى شبكات شركاء مركز بيانات الشبكات الاجتماعية.

التفاعلات الاجتماعية

  • تأتي هذه البيانات من تتبُّع التفاعل الاجتماعي في الموقع.
    • تعتيم - ga:socialInteractionAction - بالنسبة إلى التفاعلات الاجتماعية، سلسلة تمثل الإجراء الاجتماعي الذي يتم تتبّعه (مثل إجراء 1+، وأعجبني، وإشارة مرجعية)
    • تعتيم - ga:socialInteractionNetwork - بالنسبة إلى التفاعلات الاجتماعية، سلسلة تمثل الشبكة الاجتماعية التي يتم تتبّعها (مثل Google وFacebook وTwitter وLinkedIn)
    • تعتيم - ga:socialInteractionNetworkAction - بالنسبة إلى التفاعلات الاجتماعية، سلسلة تمثل تسلسل ga:socialInteractionNetwork وga:socialInteractionAction الذي يتم تتبّعه (مثل Google: +1، Facebook: أعجبني)
    • تعتيم - ga:socialInteractionTarget - بالنسبة إلى التفاعلات الاجتماعية، سلسلة تمثل عنوان URL (أو المورد) الذي يتلقى إجراء الشبكة الاجتماعية.
    • تم - ga:socialInteractions - إجمالي عدد التفاعلات الاجتماعية على موقعك.
    • تم - ga:uniqueSocialInteractions - إجمالي عدد التفاعلات الاجتماعية الفريدة على موقعك. استنادًا إلى زوج القيمة ga:socialInteractionNetwork وga:socialInteractionAction
    • تم - ga:socialInteractionsPerVisit - ga:socialInteractions / ga:uniqueSocialInteractions. متوسط عدد التفاعلات الاجتماعية لكل زيارة إلى موقعك الإلكتروني.

الموقع الجغرافي / الشبكة

  • خافت - ga:metro - منطقة السوق المحددة التي نشأت منها الزيارات.

تتبع الصفحات

  • خافت - ga:pagePathLevel1 - يُجري هذا البُعد عرضًا إجماليًا لكل pagePaths في المستوى الهرمي الأول في pagePath.
  • خافت - ga:pagePathLevel2 - يُجري هذا البُعد عرضًا إجماليًا لكل pagePaths في المستوى الهرمي الثاني في pagePath.
  • خافت - ga:pagePathLevel3 - يُجري هذا البُعد عرضًا إجماليًا لكل pagePaths في المستوى الهرمي الثالث في pagePath.
  • خافت - ga:pagePathLevel4 - يُجري هذا البُعد عرضًا إجماليًا لكل pagePaths في المستوى الهرمي الرابع في pagePath. ويتم أيضًا جمع كل المستويات الإضافية في التسلسل الهرمي pagePath ضمن هذه السمة.

تتبع الاستثناء

  • تأتي هذه البيانات من بيانات تتبُّع الاستثناءات.

    • تم استيفاء - ga:exceptions - عدد الاستثناءات التي تمّ إرسالها إلى "إحصاءات Google".
    • تم القبول - ga:fatalExceptions - عدد الاستثناءات التي تم فيها ضبط isFatal على "صحيح".

توقيتات المستخدم

  • وهذه البيانات مستمَدة من بيانات توقيت المستخدم.

    • تعتيم - ga:userTimingCategory - سلسلة لتصنيف جميع متغيرات توقيت المستخدم إلى مجموعات منطقية لأغراض إعداد التقارير بشكل أسهل.
    • خافت - ga:userTimingLabel - سلسلة للإشارة إلى اسم إجراء المورد الذي يتم تتبعه.
    • تعتيم - ga:userTimingVariable - سلسلة يمكن استخدامها لتوفير مرونة في عرض توقيتات المستخدم في التقارير.
    • خافت - ga:userTimingValue عدد المللي ثانية في الوقت المنقضي الذي تم إرساله إلى "إحصاءات Google".
    • تم القياس - ga:userTimingSample - عدد العيّنات التي تم إرسالها.
    • تم - ga:avgUserTimingValue - متوسط قيمة توقيت المستخدم. ga:userTimiingValue / ga:userTimiingSample

الجهاز / النظام الأساسي

  • تأتي هذه البيانات من وكيل المستخدم الخاص بالبيانات التي تم جمعها.
    • خافت - ga:mobileDeviceBranding - اسم الشركة المصنّعة للجهاز الجوّال أو اسم يحمل علامة تجارية (أمثلة: Samsung وHTC وVerizon وT-Mobile).
    • خافت - ga:mobileDeviceModel - طراز الجهاز الجوّال (مثال: Nexus S)
    • تعتيم - ga:mobileInputSelector - أداة الاختيار المستخدَمة على الجهاز الجوّال (أمثلة: الشاشة التي تعمل باللمس، وذراع التحكّم، وعجلة النقر، وقلم الشاشة)
    • Dim - ga:mobileDeviceInfo - العلامة التجارية، والطراز، والاسم التسويقي المستخدَم لتحديد الجهاز الجوّال

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

  • تتعامل واجهة برمجة التطبيقات الآن بشكل صحيح مع أحرف UTF-8 في فلتر أو شريحة ديناميكية.

يتيح هذا الإصدار لحسابات "إحصاءات Google" المدفوعة الوصول إلى ما يصل إلى 50 متغيّرًا مخصّصًا.

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

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

  • لم تعد فلاتر طلبات البحث التي تحتوي على رموز خاصة داخل التعبيرات العادية تعرض أخطاء في الخادم.

  • ولم يعد الجمع بين فلتر مقياس وشريحة متقدمة يؤدي إلى عرض خطأ.

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

مقاييس جديدة

  • تمت إضافة مقاييس سرعة الموقع الإلكتروني التالية:
    • ga:speedMetricsSample
    • ga:domainLookupTime
    • ga:pageDownloadTime
    • ga:redirectionTime
    • ga:serverConnectionTime
    • ga:serverResponseTime
    • ga:avgDomainLookupTime
    • ga:avgPageDownloadTime
    • ga:avgRedirectionTime
    • ga:avgServerConnectionTime
    • ga:avgServerResponseTime

اطّلِع على مرجع المقاييس والسمات للاطّلاع على التعريفات.

تذكير بالإيقاف النهائي للإصدار 2.3 من واجهة برمجة التطبيقات

  • تم إيقاف الإصدار 2.3 من واجهة برمجة التطبيقات لتصدير البيانات نهائيًا لمدة شهرين. خلال 4 أشهر أخرى تقريبًا، سنوقف هذه الخدمة ولن نتيح سوى واجهة برمجة التطبيقات Core Reporting API الجديدة الإصدار 3.0 والإصدار 2.4.

  • ننصحك بشدة بترحيل تطبيقاتك إلى الإصدار 3.0.

  • خلال 4 أشهر، ستتم إعادة توجيه الطلبات المقدّمة إلى الإصدار 2.3 من خلاصة بيانات XML من الإصدار القديم إلى الإصدار 2.4 وعرض ردّ XML بالإصدار 2.4. بعد هذه المرحلة، سيتم تطبيق جميع سياسات الحصص في الإصدار 2.4 على طلبات الإصدار 2.3.

  • في جميع الطلبات الخاصة بالإصدار 2.3 من JSON أو مكتبة برامج JavaScript لبيانات Google التي تستخدم ناتج الإصدار 2.3 JSON، سيتم عرض رموز الحالة 404.

  • للحصول على الحصة الكاملة، يتطلب منك كل من الإصدار 3.0 والإصدار 2.4 تسجيل تطبيقك في وحدة تحكم Google APIs واستخدام مفتاح واجهة برمجة تطبيقات (أو رمز OAuth 2.0 المميز) في كل طلب.

أصلحنا خطأً صغيرًا في "ga:visitLength". تعرِض هذه السمة الآن البيانات الصحيحة.

يؤثّر هذا الإصدار في جميع مطوّري واجهة Google Analytics API. وتُعلن عن إصدارَين جديدَين من واجهة برمجة التطبيقات، وتتطلّب تسجيل التطبيقات، وتقديم سياسة جديدة للحصة، وتغيير اسم واجهة برمجة التطبيقات إلى Core Reporting API. وأخيرًا، يتم إيقاف الإصدار 2.3 من واجهة برمجة التطبيقات الحالية لتصدير البيانات نهائيًا.

الإصدار ‎‏‎3.0

  • الإصدار 3.0 من Core Reporting API هو أحدث إصدار رئيسي من واجهة برمجة التطبيقات، ولا يتوافق مع الأنظمة القديمة. وسيتم تنفيذ جميع عمليات التطوير المستقبلية لواجهة برمجة التطبيقات على هذا الإصدار.

  • الميزات الجديدة

    • إنّ الإخراج الجديد المستند إلى JSON يقلّل من حجم الاستجابة بمقدار 10 أضعاف تقريبًا مقارنةً بمخرجات XML السابقة.
    • مكتبات عملاء Google API جديدة تتوافق مع Java وJavaScript وPython وPHP وRuby و .Net
    • دعم Google Discovery API
    • دعم OAuth 2.0 باعتباره الطريقة الجديدة المُوصى بها لتفويض المستخدمين.

  • آخر المعلومات

    • عنوان URL الجديد لإنشاء الطلبات: https://www.googleapis.com/analytics/v3/data/ga…
    • يجب إدخال رموز مميّزة للتسجيل والمطوّرين.
    • يجب تنفيذ جميع طلبات بيانات الضبط من خلال Management API.

الإصدار 2.4

  • الإصدار 2.4 من Core Reporting API هو ترقية ثانوية للإصدار متوافق في الغالب مع الإصدار 2.3 من Data Export API الحالي.

  • آخر المعلومات

    • عنوان URL جديد لتقديم الطلبات: https://www.googleapis.com/analytics/v2.4/data…
    • يجب إدخال رموز مميّزة للتسجيل والمطوّرين.
    • يكون إخراج XML متوافقًا مع الإصدار 2.3، لذا ستستمر مكتبات برامج بيانات Google الحالية الأخرى في العمل.
    • تم تغيير رمز الخطأ لأخطاء الحصة من 503 إلى 403.
    • ولا يتم دعم استجابات JSON.
    • مكتبة برامج JavaScript لبيانات Google غير متاحة.
    • ما مِن خلاصة حساب. يجب تنفيذ جميع طلبات بيانات الضبط من خلال Management API.

تسجيل

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

  • يجب أن يتضمن كل طلب لواجهة برمجة التطبيقات إما مفتاح واجهة برمجة التطبيقات أو لبروتوكول OAuth 2.0 ومعرف عميل وسر عميل.

سياسة الحصص

  • تنطبق الحصة التالية على كلّ من واجهات برمجة تطبيقات Anlaytics (واجهة برمجة تطبيقات الإدارة وواجهة برمجة التطبيقات لتصدير البيانات).

    • 50000 طلب لكل مشروع في اليوم
    • 10 طلبات في الثانية (QPS) لكل عنوان IP

  • تنطبق الحصة التالية على واجهة برمجة التطبيقات لتصدير البيانات.

    • 10,000 طلب لكل ملف شخصي في اليوم
    • 10 طلبات متزامنة لكل ملف شخصي

  • وبالنسبة إلى التطبيقات غير المسجَّلة، نقدّم حصة سماح منخفضة جدًا لاستيعاب مقدار صغير من الاختبارات.

عمليات الإيقاف

  • يعلن هذا الإصدار أيضًا عن إيقاف الإصدار 2.3 نهائيًا والإيقاف القادم لخلاصة الحساب في واجهة برمجة التطبيقات Data Export API. في 6 أشهر:

    • ستتم إعادة توجيه الطلبات إلى الإصدار 2.3 من خلاصة البيانات بتنسيق XML إلى الإصدار 2.4 وعرض استجابة من الإصدار 2.4. بعد هذه المرحلة، سيتم تطبيق جميع سياسات الحصص في الإصدار 2.4 على طلبات الإصدار 2.3.

    • ولن تكون الطلبات التي يتم إرسالها إلى الإصدار 2.3 من تنسيق JSON متوافقة مع استجابة الإصدار 2.4، وسيتم عرض رموز الحالة 404 Not Found. إذا كنت بحاجة إلى استجابة JSON، يُرجى الترقية إلى الإصدار 3.0.

    • ستؤدي الطلبات إلى خلاصة الحساب في واجهة برمجة التطبيقات لتصدير البيانات إلى عرض رموز الحالة 404 Not Found. يجب تنفيذ جميع طلبات بيانات الضبط من خلال Management API.

يضيف هذا الإصدار بيانات أحدث في AdWords والمزيد من المجموعات لسمات ومقاييس AdWords.

  • ويتم الآن تحديث بيانات AdWords في غضون ساعة. قبل تعديل البيانات يوميًا.

  • لقد قلّلنا القيود المفروضة على عدد المجموعات الصالحة الناتجة عن بيانات AdWords.

قبل بضعة أسابيع، أجرينا تغييرًا لمنع طلبات البحث من واجهة برمجة التطبيقات التي طلبت ga:adGroup أو ga:adContent مع ga:impressions، لأنّ هذه التركيبة عرضت 0. مع هذا التغيير، عادت هذه التركيبة الآن وتم إصلاحها لعرض البيانات الصحيحة.

يُصلح هذا الإصدار بعض المجموعات غير الصالحة من السمات والمقاييس.

تم إصلاح مجموعات المقاييس/السمات غير الصالحة

  • أعلنّا الشهر الماضي عن بعض التغييرات القادمة على واجهة برمجة التطبيقات لمنع بعض طلبات البحث غير الصالحة في خلاصة البيانات التي لا تعرض أي بيانات. لقد أجرينا هذه التغييرات على واجهة برمجة التطبيقات، وأصبحت المجموعات التالية غير صالحة الآن:

    • لا يمكن الجمع بين أبعاد المنتج ومقاييس المعاملات.
    • لا يمكن دمج ga:adContent أو ga:adGroup مع ga:impressions.

    بدلاً من عرض استجابة بدون عرض أي نتائج، تعرض واجهة برمجة التطبيقات الآن رمز الخطأ 400 لجميع طلبات البحث التي تطلب هذه المجموعات.

في هذا الإصدار، سيتم إيقاف قيمة فاصل الثقة في المقاييس.

إيقاف فاصل الثقة

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

    لتحديد ما إذا كان قد تم أخذ عيّنة من ردّ، يُرجى استخدام الحقل يحتوي على sampledData في الردّ.

يضيف هذا الإصدار 3 مقاييس جديدة ويعدّل القيمة المعروضة لاثنين.

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

  • أضفنا 3 مقاييس جديدة للتعامل مع أداء سرعة الموقع الإلكتروني إلى واجهة برمجة التطبيقات:
    • ga:pageLoadSample
    • ga:pageLoadTime
    • ga:avgPageLoadTime

تعديلات المقاييس

  • لتحديد قيم العملة في الفلاتر، يجب تحديد القيمة الفعلية التي تم تمريرها من رمز التتبّع، (على سبيل المثال، سيتم تحديد وحدة واحدة الآن على أنّها 1).

  • تعرض ga:CTR الآن النسبة المئوية الفعلية (على سبيل المثال، يتم عرض قيمة 2% على أنّها 2).

يساعد هذا الإصدار في تحسين أداء خلاصة البيانات وإضافة بيانات جديدة:

تحسين الأداء

  • يحسّن هذا الإصدار وقت استجابة خلاصة البيانات بنسبة تتراوح بين 30 و35%.

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

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

التغييرات القادمة

  • في الوقت الحالي، يجب تحديد قيمة لفلتر العملة كوحدات صغيرة، (على سبيل المثال، يتم تحديد وحدة واحدة من العملة على أنها 1000000). ستحتاج في المستقبل القريب إلى تحديد القيمة الفعلية التي تم تمريرها من رمز التتبّع (على سبيل المثال، سيتم تحديد وحدة واحدة الآن على أنّها 1).

  • وفي الوقت الحالي، قيمة ga:CTR هي percent وتعرض القيمة 0.02. في المستقبل القريب، سيتم تغيير هذا لعرض النسبة المئوية الفعلية (على سبيل المثال 2).

يضيف هذا الإصدار المزيد من البيانات إلى خلاصة البيانات:

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

  • تمت إضافة السمة الزمنية التالية: ga:dayOfWeek

  • تمت إضافة مقياس "البحث الداخلي" التالي: ga:percentVisitsWithSearch.

  • تمت إضافة مقاييس تتبُّع الأحداث التالية:

    • ga:visitsWithEvent
    • ga:eventsPerVisitWithEvent

التغييرات القادمة

تعرض واجهة برمجة التطبيقات حاليًا رموز الحالة 401 لمشاكل التفويض المختلفة. في غضون الأسبوعين المقبلين، سيتم استخدام حالة 401 حصريًا للرموز المميزة غير الصالحة، ما يتيح للمطورين طريقة للتعامل مع هذا الاستثناء بالتحديد.

يضيف هذا الإصدار بيانات أكثر بكثير إلى خلاصة البيانات:

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

  • تم تغيير طريقة احتساب "ga:visitors" لعرض عدد الزوّار الفريدين عبر النطاق الزمني، وأصبح بالإمكان الآن استخدام المزيد من تركيبات السمات والمقاييس.

  • تمت إضافة 10 سمات جديدة في AdWords: ga:adDistributionNetwork وga:adMatchType وga:adMatchedQuery وga:adPlacementDomain وga:adPlacementUrl وga:adFormat وga:adTargetingType وga:adTargetingOption وga:adDisplayUrl وga:adDestinationUrl.

  • تمت إضافة المقياس "ga:organicSearches" إلى مجموعة الحملات.

  • تمت إضافة المقياس ga:searchResultViews إلى مجموعة البحث الداخلي في الموقع الإلكتروني.

  • تمت إضافة 3 سمات جديدة مستندة إلى الوقت: ga:nthDay وga:nthWeek وga:nthMonth.

  • وتم تغيير مجموعات السمات والمقاييس لتعكس بشكل أفضل الميزات التي تمثلها.

مقاييس محسوبة جديدة

يتم استنتاج المقاييس المحسوبة التالية من عمليات حسابية باستخدام المقاييس الأساسية. ملاحظة: كل اسم يتضمن (n) يتوافق مع القيم من 1 إلى 20.

  • استنادًا إلى الهدف: ga:costPerConversion وga:costPerGoalConversion وga:costPerTransaction وga:goal(n)AbandonRate وga:goal(n)Abandons وga:goal(n)ConversionRate وga:goalAbandonRateAll وga:goalAbandonsAll وga:goalConversionRateAll وga:goalValueAllPerSearch وga:goalValuePerVisit.

  • استنادًا إلى المحتوى: ga:entranceBounceRate وga:visitBounceRate وga:entranceRate وga:exitRate وga:pageviewsPerVisit وga:avgTimeOnPage وga:avgTimeOnSite وga:avgEventValue.

  • استنادًا إلى البحث الداخلي في المواقع الإلكترونية: ga:avgSearchDepth وga:avgSearchDuration وga:avgSearchResultViews وga:searchGoalConversionRateAll وga:searchGoal(n)ConversionRate وga:searchExitRate.

  • استنادًا إلى التجارة الإلكترونية: ga:itemsPerPurchase وga:margin وga:percentNewVisits وga:revenuePerItem وga:revenuePerTransaction وga:ROI وga:RPC وga:totalValue وga:transactionRevenuePerVisit وga:transactionsPerVisit.

يضيف هذا الإصدار ميزة جديدة إلى خلاصة البيانات:

الميزات الجديدة

  • تمت إضافة عنصر XML جديد يتيح للمستخدمين معرفة ما إذا تم جمع عيّنات من البيانات. true. وسيعرض هذا العنصر دائمًا ما إذا كانت البيانات مستندة إلى عيّنات أم لا باستخدام السمة true أو false. تم أيضًا تعديل مكتبتَي Java وJavaScript باستخدام طرق مساعِدة للوصول إلى هذا العنصر.

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

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

  • إضافة عامل تشغيل OR في السابق إلى تعبير فلتر باستخدام سمة (أي ga:keyword==store,ga:keyword==bar) إلى قيم مختلفة عما لو تم تطبيق كل فلتر على حدة عبر طلبات بحث متعددة. تم إصلاح هذا الخطأ وأصبح استخدام عامل OR يعرض الآن قيمًا متسقة.

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

يُصلح هذا الإصدار 3 أخطاء:

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

  • تم إصلاح مشكلة متعلقة بالترميز في "مكتبة برامج JavaScript". أداة تتبُّع المشاكل في "إحصاءات Google"

  • تم إصلاح خطأ منع "خلاصة الحساب" من الظهور عند ضبط اسم الهدف أو مسار الهدف أو قيمة مقارنة الأهداف أو نوع مقارنة الأهداف بطريقة غير صحيحة.

  • وهو غير صالح لسمة "أو" ومقياس أو سمة في مَعلمة فلتر طلب البحث في خلاصة البيانات. مثلاً: ga:source==google,ga:visits>5 تم تعديل رسالة الخطأ لهذا الطلب غير الصالح لتصبح: Cannot OR dimension filter(s) with metric filter.

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

الميزات الجديدة

  • تمت إضافة السمات الخمس التالية إلى الفئة الجديدة D8. Adwords:

    • ga:adwordsAdGroupId: تتوافق مع AdGroup.id في AdWords API
    • ga:adwordsCampaignId: تتوافق مع AdWords API Campaign.id
    • ga:adwordsCreativeId: تتوافق مع Ad.id في AdWords API
    • ga:adwordsCriteriaId: تتجاوب مع Criterion.id لواجهة برمجة تطبيقات AdWords
    • ga:adwordsCustomerId: تتجاوب مع AccountInfo.customerId في AdWords API

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

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

يضيف هذا الإصدار عددًا من الميزات الجديدة وإصلاحات الأخطاء:

الميزات الجديدة

  • تم تحسين الشريحة التلقائية لـ iPhone (gaid::-11) لإعداد تقارير عنها الآن على جميع الأجهزة الجوّالة. رقم التعريف هو نفسه كما كان من قبل (-11)، ولكن اسم الشريحة أصبح الآن: Mobile Traffic.

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

  • تم تعديل سياسة الحصة لضمان حصول جميع المستخدمين على إمكانية الوصول العادل إلى الموارد. يُرجى الرجوع إلى مستندات سياسة الحصص للحصول على مزيد من التفاصيل. في ما يلي السياسة الجديدة:

    • قد يقدّم موقع إلكتروني واحد 10,000 طلب كحد أقصى كل 24 ساعة.
    • لا يمكن للتطبيق سوى تقديم 10 طلبات في أي فترة محددة تبلغ ثانية واحدة.
    • يمكن أن يضم التطبيق 4 طلبات في انتظار المراجعة فقط في أيّ وقت.

  • تم تخفيف بعض القيود على مجموعات السمات والمقاييس. تم الآن انضمام "ga:nextPagePath" و"ga:previousPagePath" إلى مجموعة "D3. Content". تم تغيير اسم مجموعة "D8. Custom Variable" إلى المجموعة "D6. Custom Variable". يُرجى الاطّلاع على الدليل المرجعي المحدّث لهذه التركيبات الجديدة.

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

  • أصلحنا خطأً في كيفية إبلاغ واجهة برمجة التطبيقات عن القيمة confidenceInterval للمقاييس. في السابق، كان يمكن أن تكون قيمة فواصل الثقة إما INF أو رقمًا من 0 إلى 1. سيكون الآن لجميع فواصل الثقة قيمة إما INF أو رقم أكبر من أو يساوي 0.

  • تم في السابق تبديل ga:itemQuantity وga:uniquePurchases وعرض قيمة بعضهما البعض. تم إصلاحها الآن لإرجاع البيانات الصحيحة.

تذكير بإيقاف السمات والمقاييس نهائيًا

  • يُرجى التوقف عن استخدام السمات والمقاييس التي تم إيقافها نهائيًا في السابق، إذا لم يسبق لك ذلك.

يضيف هذا الإصدار عددًا من الميزات الجديدة:

يعمل هذا الإصدار على زيادة رقم الإصدار الرئيسي إلى 2.

  • تتطلب بعض الميزات استخدام أحدث مكتبات العملاء. نتيح استخدام Java وJavascript رسميًا. قد لا يتم تحديث مكتبات الجهات الخارجية بعد.

    • قد تُطلب النسخة 2 من خلال إضافة العنوان GData-Version: 2 إلى كل طلب حساب أو خلاصة بيانات. يُرجى الاطّلاع على المستندات لمزيد من التفاصيل.
    • تمت إضافة مساحة اسم جديدة بتنسيق XML إلى كلٍّ من الحساب وخلاصات البيانات:
      xmlns:ga='http://schemas.google.com/ga/2009'

  • تتوافق واجهة برمجة التطبيقات الآن مع الإصدار 2 من بروتوكول Google Data.

إتاحة التقسيم إلى شرائح متقدمة

  • معلمة طلب البحث عن الشرائح الديناميكية:

    • ...&segment=dynamic::تعبير
    • يسمح بإنشاء شرائح متقدمة "أثناء التنقل".
    • يمكن أن يكون التعبير أي سمة أو مقياس، ويجب أن يتبع بنية الفلاتر نفسها.

  • معلمة طلب البحث للشرائح التلقائية والمخصّصة:

    • رقم ...&segment=gaid::
    • حيث يكون الرقم عبارة عن رقم تعريفي يشير إلى شريحة متقدمة تم تحديدها في واجهة الويب في "إحصاءات Google".
    • ويمكن العثور على رقم التعريف في خلاصة الحساب.

  • تصف خلاصة الحساب بيانات التقسيم من خلال عناصر وسمات XML التالية:

    • ga:visitorType==Returning Visitor

  • توفر خلاصة البيانات أيضًا عنصر XML يشير إلى ما إذا تم تطبيق شريحة في طلب البيانات من واجهة برمجة التطبيقات.

  • مزيد من التفاصيل حول الشرائح المتقدمة في مستنداتنا

تتوفر بيانات أهداف جديدة

  • أهداف نوع الوجهة ونوع التفاعل المتوفّرة في خلاصة الحساب:

  • تمت إضافة 48 مقياس هدف جديدًا للأهداف من 5 إلى 20 والتي تتبع جميعها اتفاقية goal(n)Completions، حيث يمثل (n) رقمًا بين 1 و20.

    • ga:goal(n)Completions
    • ga:goal(n)Starts
    • ga:goal(n)Value

  • تم تعديل GoalCompletionAll وGoalStartsAll وGoalValueAll لمراعاة بيانات الهدف الجديدة.

بيانات المتغيّرات المخصَّصة الجديدة

  • تمّت إضافة جميع المتغيرات المخصّصة التي جمعتها كل ملف شخصي كعنصر XML جديد إلى خلاصة الحساب:

  • تمت إضافة 10 سمات جديدة للمتغيرات المخصّصة. وهي تتبع اتفاقية customVar(n) حيث يمكن أن تكون (n) رقمًا بين 1 و5.

    • ga:customVarName(n)
    • ga:customVarValue(n)

ستتم إزالة السمات والمقاييس المتوقّفة.

  • يُرجى التوقف عن استخدام السمات والمقاييس التي تم إيقافها نهائيًا في السابق، إذا لم يسبق لك ذلك. ستتم إزالتها قريبًا وستظهر أخطاء من واجهة برمجة التطبيقات لدينا إذا طُلب منك ذلك.

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits

  • تمت إعادة تسمية السمات التالية:

    • ga:countOfVisits أصبحت الآن ga:visitCount.
    • ga:countOfVisitsToATransaction أصبحت الآن ga:visitsToTransaction.

يضيف هذا الإصدار ميزات جديدة ويوقِف بعض الوظائف القديمة نهائيًا:

  • تم إيقاف السمات والمقاييس التالية نهائيًا. وسنزيلها نهائيًا من واجهة برمجة التطبيقات بعد شهر واحد. يُرجى التأكّد من تعديل الرمز كي لا يتوقف عمل التطبيقات:

    • ga:countOfVisits
    • ga:countOfVisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits

  • تمت إعادة تسمية السمات التالية:

    • أصبح ga:countOfvisits الآن ga:visitCount.
    • أصبحت ga:countOfvisitsToATransaction الآن ga:visitsToTransaction

  • يتم الآن عرض جميع بيانات تتبُّع الأحداث كمجموعتَين جديدتَين:

    د7: الأحداث (السمات) * ga:eventCategory * ga:eventAction * ga:eventLabel

    م7: الأحداث (المقاييس) * ga:eventValue * ga:totalevents * ga:uniqueevents

  • يتم الآن عرض بيانات التنقل العامة في الموقع من خلال السمات التالية:

    د6: التنقل * ga:previousPagePath * ga:nextPagePath

  • يتم الآن عرض التنقّل في الصفحة المقصودة من خلال السمات التالية:

    د3. المحتوى * ga:landingPagePath * ga:secondPagePath

  • لقد تم رفع الحد الأقصى لطول التعبيرات العادية في معلمة طلب البحث لفلتر خلاصة البيانات من 32 إلى 128 حرفًا.

  • يتم الآن عرض تقرير "طول الزيارة" (الذي يمكن العثور عليه من خلال واجهة المستخدم ضمن الزائرون -> ولاء الزائر) من خلال البُعد الجديد:

    • ga:visitLength

يحدِّث هذا الإصدار واجهة برمجة التطبيقات لتصدير البيانات في "إحصاءات Google" على النحو التالي:

  • تم تخفيف بعض القيود على مجموعات السمات والمقاييس. يمكنك الآن إجراء طلبات بحث في معظم سمات المحتوى ومستوى الزائر معًا، على سبيل المثال، أصبحت ga:pagePath وga:source تركيبة صالحة الآن. يُرجى الاطلاع على الدليل المرجعي المحدّث لهذه التركيبات الجديدة: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceValidCombos.html.

  • تمت زيادة إجمالي عدد الصفوف التي يمكن طلبها في طلب واحد إلى 10,000. ولا يزال العدد التلقائي من الصفوف المعروضة هو 1,000، ولكن يمكن زيادته الآن عن طريق ضبط مَعلمة طلب البحث max-results.

  • تعرض خلاصة الحساب الآن عنصرَي بيانات جديدَين لكل رقم تعريف جدول (العملة والمنطقة الزمنية).

  • نفرض الآن أنّ طلبات البيانات يجب أن تتضمّن مقياسًا صالحًا واحدًا على الأقل.

  • تم تفعيل جميع التغييرات السابقة المتعلقة بالإيقاف النهائي.

يزيل هذا الإصدار الميزات المتوقّفة نهائيًا من الإصدار التجريبي الخاص:

  • لن يعود من الممكن استخدام اسم مستخدم في طلبات خلاصة الحساب. بدلاً من ذلك، لن يتم قبول سوى الطلبات بالتنسيق التالي:
    https://www.google.com/analytics/feeds/accounts/default

  • جارٍ إزالة المقاييس التالية ولن تعمل بعد الآن. وبدلاً من ذلك، وفّرنا تعليمات عن كيفية حساب هذه القيم هنا: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceCommonCalculations.html.

    • ga:avgPageDuration
    • ga:avgPageviews
    • ga:avgSessionTime
    • ga:bounceRate
    • ga:exitRate
    • ga:costPerConversion
    • ga:costPerGoalConversion
    • ga:costPerTransaction
    • ga:revenuePerClick
    • ga:revenuePerTransaction
    • ga:revenuePerVisit
    • ga:arangeonedFunnels1
    • ga:ahanonedFunnels2
    • ga:ahanonedFunnels3
    • ga:ahanonedFunnels4
    • ga:goalConversionRate
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit

  • تمت إعادة تسمية السمات والمقاييس التالية. ولن تعود الأسماء القديمة صالحة. يُرجى التأكد من أنك تستخدم الأسماء الرسمية الواردة في مستنداتنا هنا: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

    أبعاد * ga:subContinentRegion نقرت نقرت : subContinent *

    يمكنك استخدام التطبيق: استفِد من المعلومات التالية: يمكنك الحصول على معلومات عن التطبيق: استفِد من الطلب يمكنك تنفيذ ما يلي: *"ستُكن هذه القيمة": يمكنك الحصول على معلومات عن *new التقدّم في مساعد Google: ستُجرى عمليات الشراء