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

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

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

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

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

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

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

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

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

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

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

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

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

  • 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.

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

رسائل الخطأ

عندما كانت واجهة برمجة التطبيقات تعرض في السابق رسالة خطأ خاطئة، 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/1/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" (يتطلّب ذلك الدمج مع "إحصاءات 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" (يتطلّب ذلك الدمج مع "إحصاءات 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 ("إحصاءات 360" فقط، تتطلب الدمج مع DBM).
  • المقياس - ga:dbmCPC - أرباح التكلفة الفعلية للنقرة في DBM ("إحصاءات 360" فقط، تتطلب الدمج مع DBM).
  • المقياس - ga:dbmCPM - أرباح التكلفة الفعلية لكل ألف ظهور في DBM ("إحصاءات 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 ("إحصاءات Google 360" فقط، يجب الدمج مع DS)
  • السمة - ga:dsCampaign - حملة DS (يجب استخدام "إحصاءات 360" فقط، ويجب دمجها مع DS).
  • السمة - ga:dsCampaignId - رقم تعريف حملة DS (يجب استخدام "إحصاءات 360" فقط، ويجب الدمج مع DS).
  • السمة - ga:dsEngineAccount - حساب محرك البحث في DS (يجب استخدام "إحصاءات 360" فقط، ويجب الدمج مع DS).
  • السمة - ga:dsEngineAccountId - رقم تعريف حساب محرك البحث في DS ("إحصاءات 360" فقط، يجب الدمج مع DS).
  • السمة - ga:dsKeyword - الكلمة الرئيسية في DS (يجب استخدام "إحصاءات Google 360" فقط، ويجب دمجها مع DS).
  • السمة - ga:dsKeywordId - رقم تعريف الكلمة الرئيسية في DS ("إحصاءات 360" فقط، يجب الدمج مع DS).
  • ga:dsCPC - تكلفة النقرة للمعلن في DS (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DS).
  • ga:dsCTR - نسبة النقر إلى الظهور في DS ("إحصاءات 360" فقط، يجب دمجها مع DS)
  • ga:dsClicks - نقرات DS (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DS).
  • ga:dsCost - تكلفة DS (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DS).
  • ga:dsImpressions - مرات ظهور DS ("إحصاءات 360" فقط، تتطلب الدمج مع DS).
  • ga:dsProfit - إعداد DS (يجب استخدام "إحصاءات 360" فقط، ويجب الدمج مع DS).
  • ga:dsReturnOnAdSpend - عائد الإنفاق الإعلاني في DS (يتطلّب برنامج "إحصاءات 360" فقط الدمج مع DS).
  • ga:dsRevenuePerClick - الأرباح لكل نقرة في DS ("إحصاءات 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 : في كل مرة يتم فيها عرض إعلان فردي على الموقع الإلكتروني. على سبيل المثال، في حال عرض صفحة تحتوي على وحدتَين إعلانيتَين مرة واحدة، سيتم عرض مرتَي ظهور (مع تفعيل ربط BigQuery وإخفاء أرباح AdSense غير مُفعَّل).
  • المقياس - ga:dfpCoverage - التغطية هي النسبة المئوية لطلبات الإعلان التي أدّت إلى عرض إعلان واحد على الأقل. وبوجهٍ عام، يمكن أن تساعد التغطية في تحديد المواقع الإلكترونية التي يتعذّر على حساب DoubleClick توفير إعلانات مستهدفة فيها. (مرات ظهور الإعلان / إجمالي طلبات الإعلان) * 100 (تم تفعيل ربط DoubleClick for وإخفاء أرباح AdMob غير مُفعَّل)."
  • المقياس - ga:dfpMonetizedPageviews - يقيس إجمالي عدد مشاهدات الصفحة على الموقع الإلكتروني التي تم عرضها مع إعلان من حساب DoubleClick المرتبط. تجدر الإشارة إلى أنه يمكن أن تحتوي صفحة واحدة على وحدات إعلانية متعددة (مع تفعيل ربط BigQuery وإخفاء أرباح AdSense غير مُفعَّل).
  • المقياس - ga:dfpImpressionsPerSession - نسبة مرات ظهور إعلانات DoubleClick إلى جلسات "إحصاءات Google" (مرات ظهور الإعلان / جلسات "إحصاءات") (تم تفعيل ربط LDAP وإخفاء أرباح DoubleClick القديمة)."
  • المقياس - ga:dfpViewableImpressionsPercent - النسبة المئوية لمرات ظهور الإعلان القابلة للعرض. تُعتبر مرة الظهور ظهورًا قابلاً للعرض عندما تظهر ضمن متصفحات المستخدمين وتكون متاحة لرؤيتها (مع تفعيل ربط BigQuery وإخفاء أرباح BigQuery غير مُفعَّل).
  • المقياس - ga:dfpClicks - عدد المرات التي تم فيها النقر على إعلانات DoubleClick على الموقع (تم تفعيل ربط LDAP وإخفاء أرباح DoubleClick القديمة)."
  • المقياس - ga:dfpCTR - النسبة المئوية لمرات مشاهدة الصفحة التي أدت إلى نقرة على إعلان LDAP (تم تفعيل ربط BigQuery وإخفاء أرباح AdMob غير مُفعَّل)."
  • المقياس - ga:dfpRevenue - أرباح DBM هي تقدير لإجمالي أرباح الإعلانات استنادًا إلى مرات الظهور المعروضة (تم تفعيل ربط LDAP وإخفاء أرباح AdMob غير مُفعَّل)."
  • المقياس - ga:dfpRevenuePer1000Sessions - إجمالي الأرباح المقدَّرة من إعلانات DoubleClick لكل 1,000 جلسة في "إحصاءات Google". تجدر الإشارة إلى أن هذا المقياس يستند إلى الجلسات إلى الموقع، وليس إلى مرات ظهور الإعلان (تم تفعيل ربط LDAP وإخفاء أرباح DoubleClick القديمة)."
  • المقياس - ga:dfpECPM - التكلفة الفعلية لكل ألف مشاهدة على الصفحة. وهي أرباح DoubleClick لكل 1,000 مشاهدة للصفحة (تم تفعيل ربط BigQuery وإخفاء أرباح DoubleClick غير مُفعَّل)."
  • المقياس - ga:backfillImpressions - مرات ظهور إعادة الإعلانات هي مجموع كل مرات ظهور إعلانات AdSense أو Ad Exchance التي يتم عرضها كإعادة إعلانات من خلال DoubleClick. يتم تسجيل مرة ظهور للإعلان في كل مرة يتم فيها عرض إعلان فردي على الموقع الإلكتروني. على سبيل المثال، في حال عرض صفحة تحتوي على وحدتَين إعلانيتَين مرة واحدة، سيتم عرض مرتَي ظهور (مع تفعيل ربط BigQuery وإخفاء أرباح AdSense غير مُفعَّل).
  • المقياس - ga:backfillCoverage - "تغطية إعادة التعبئة" هي النسبة المئوية لطلبات إعلانات إعادة التعبئة التي أدت إلى عرض إعلان واحد على الأقل. بوجه عام، يمكن أن تساعد التغطية على تحديد المواقع الإلكترونية التي يتعذّر على حساب الناشر توفير إعلانات مستهدفة فيها. (مرات ظهور الإعلان / إجمالي طلبات الإعلان) * 100. في حال كان كلٌّ من AdSense وAd Exchange يقدّمان إعلانات ملء الفراغات، يكون هذا المقياس هو المتوسط التقديري لحسابَي إعادة التعبئة (تم تفعيل ربط BigQuery وإخفاء أرباح AdSense غير مُفعَّل).
  • المقياس - ga:backfillMonetizedPageviews - يقيس إجمالي عدد مشاهدات الصفحة على الموقع الإلكتروني التي تم عرضها مع إعلان واحد على الأقل من حسابات إعادة التعبئة المرتبطة. تجدر الإشارة إلى أن مشاهدة الصفحة الواحدة التي تحقق ربحًا يمكن أن تشمل مرات ظهور متعددة للإعلان (تم تفعيل ربط DoubleClick وعدم تفعيل إخفاء أرباح DoubleClick)."
  • المقياس - ga:backfillImpressionsPerSession - نسبة مرات ظهور الإعلان السابقة إلى جلسات "إحصاءات Google" (مرات ظهور الإعلان / جلسات "إحصاءات Google"). في حال كان كلٌّ من AdSense وAd Exchange يقدمان إعلانات إعادة التعبئة، يكون هذا المقياس عبارة عن مجموع حسابَي إعادة التعبئة (تم تفعيل ربط BigQuery وإخفاء أرباح AdMob غير مُفعَّل).
  • المقياس - ga:backfillViewableImpressionsPercent - النسبة المئوية لمرات ظهور إعلان إعادة التعبئة التي كانت قابلة للعرض. يُعتبر الظهور قابلاً للعرض عند ظهوره ضمن متصفّحات المستخدمين وسنحت الفرصة لرؤيته. إذا كان كلٌّ من AdSense وAd Exchange يقدمان إعلانات ملء الفراغات، يكون هذا المقياس هو المتوسط المُرجَّح لحسابَي إعادة التعبئة (مع تفعيل ربط BigQuery وإخفاء أرباح AdSense غير مُفعَّل).
  • المقياس - ga:backfillClicks - عدد مرات النقر على إعلانات ملء الفراغات على الموقع الإلكتروني. في حال كان كلّ من AdSense وAd Exchange يقدّمان إعلانات ملء الفراغات، يكون هذا المقياس عبارة عن مجموع حسابَي إعادة التعبئة (تم تفعيل ربط BigQuery وإخفاء أرباح AdSense غير مُفعَّل).
  • المقياس - ga:backfillCTR - النسبة المئوية لمرات ظهور الإعلانات السابقة التي أدت إلى نقرة على أحد الإعلانات. إذا كان كلٌّ من AdSense وAd Exchange يقدمان إعلانات ملء الفراغات، يكون هذا المقياس هو المتوسط المُرجَّح لحسابَي إعادة التعبئة (مع تفعيل ربط BigQuery وإخفاء أرباح AdSense غير مُفعَّل).
  • المقياس - ga:backfillRevenue - إجمالي الأرباح المقدَّرة من إعلانات إعادة التعبئة. في حال كان كلّ من AdSense وAd Exchange يقدّمان إعلانات ملء الفراغات، يكون هذا المقياس عبارة عن مجموع حسابَي إعادة التعبئة (تم تفعيل ربط BigQuery وإخفاء أرباح AdSense غير مُفعَّل).
  • المقياس - ga:backfillRevenuePer1000Sessions - إجمالي الأرباح المقدَّرة من إعلانات إعادة التعبئة لكل 1,000 جلسة في "إحصاءات Google". تجدر الإشارة إلى أن هذا المقياس يستند إلى الجلسات في الموقع الإلكتروني وليس مرات ظهور الإعلان. في حال كان كلٌّ من AdSense وAd Exchange يقدمان إعلانات إعادة التعبئة، يكون هذا المقياس عبارة عن مجموع حسابَي إعادة التعبئة (تم تفعيل ربط BigQuery وإخفاء أرباح AdMob غير مُفعَّل).
  • المقياس - ga:backfillECPM - التكلفة الفعلية لكل ألف مشاهدة على الصفحة. وهي أرباح إعادة إعلانات DoubleClick لكل 1000 مشاهدة للصفحة. في حال كان كلٌّ من AdSense وAd Exchange يقدمان إعلانات إعادة التعبئة، يكون هذا المقياس عبارة عن مجموع حسابَي إعادة التعبئة (تم تفعيل ربط BigQuery وإخفاء أرباح AdMob غير مُفعَّل).

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

الشرائح

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

أخذ العينات

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

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

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

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

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

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

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

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

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

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

البدء

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

سياسة الحصص

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

النقل

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

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

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

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

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

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

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

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

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

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

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

  • السمة - 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 - حجم إطار العرض لمتصفّحات المستخدمين حجم المتصفّح هو سمة على مستوى الجلسة تسجِّل الأبعاد الأولية لإطار العرض بالبكسل، ويتم تنسيقه على أنّه العرض X. على سبيل المثال، 1920x960.

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

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

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

المستخدِم

  • المقياس - 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 كسمة من أجل طلب البحث عن هذا المقياس. بالنسبة إلى التاريخ المحدد، ستمثل القيمة المعروضة إجمالي عدد المستخدمين الفريدين لفترة الأربعة عشر يومًا المنتهية في التاريخ المحدد.
  • المقياس - 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.

مدير حملة DoubleClick

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

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

تم إيقاف هذه المقاييس نهائيًا. يُرجى مراجعة سياسة إيقاف البيانات للحصول على تفاصيل عن إزالة البيانات: + المقياس - 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.

مدير حملة DoubleClick

  • السمة - 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 - اسم مجموعة أنشطة DCM Floodlight المرتبط بالإحالة الناجحة على Floodlight (النسخة المدفوعة فقط).
  • السمة - ga:dcmFloodlightActivityGroupId - رقم تعريف مجموعة أنشطة DCM Floodlight المرتبط بالإحالة الناجحة على Floodlight (النسخة المدفوعة فقط).
  • السمة - ga:dcmFloodlightActivityId - رقم تعريف نشاط DCM Floodlight المرتبط بالإحالة الناجحة على Floodlight (النسخة المدفوعة فقط).
  • السمة - ga:dcmFloodlightAdvertiserId - الرقم التعريفي للمعلِن في Floodlight في DCM المرتبط بالإحالة الناجحة على Floodlight (النسخة المدفوعة فقط).
  • السمة - ga:dcmFloodlightSpotId - رقم تعريف إعداد DCM Floodlight المرتبط بالإحالة الناجحة على 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 - أرباح DCM Floodlight (الإصدار المميّز فقط).

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

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

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

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

  • السمة: 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-04-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"، يمكن أن تعرض واجهة برمجة التطبيقات اختياريًا عنصر "جدول بيانات" في الاستجابة.

  • تمت إضافة مَعلمة طلب بحث output اختيارية إلى واجهة برمجة التطبيقات. ويمكن استخدامها لاختيار تنسيق الناتج لبيانات "إحصاءات Google" في الاستجابة، وهو JSON تلقائيًا. في حال ضبط هذه السياسة على datatable، يتم تضمين سمة dataTable تحتوي على عنصر جدول البيانات في الاستجابة. ويمكن استخدام هذا الكائن مباشرةً مع مخططات 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.
    • Met - ga:adsenseAdsViewed - عدد إعلانات AdSense التي تمت مشاهدتها. يمكن عرض إعلانات متعددة ضمن وحدة إعلانية واحدة.
    • Met - ga:adsenseAdsClicks - عدد المرات التي تم فيها النقر على إعلانات AdSense على موقعك الإلكتروني.
    • متوسط - ga:adsensePageImpressions - عدد مرات مشاهدة الصفحة على الويب التي تم خلالها عرض إعلان AdSense. يمكن أن تحتوي مرة ظهور الصفحة على وحدات إعلانية متعددة.
    • متوسط - ga:adsenseCTR - النسبة المئوية لمرات ظهور الصفحة التي أدت إلى نقرة على إعلان AdSense. (ga:adsenseAdsClicks/ga:adsensePageImpressions)
    • متدنٍ - ga:adsenseECPM - التكلفة المقدّرة لكل ألف ظهور للصفحة. وهي ‏‫أرباح AdSense لكل 1000 ظهور للصفحة. (ga:adsenseRevenue/(ga:adsensePage احتجت/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.

كجزء من إطلاق الشرائح الجديدة، سنطرح التغييرات التالية على Core Reporting API.

  • تدعم المعلمة 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 - الأرباح الناتجة عن المعاملات بالعملة المحلية
  • Met - 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 وreddit وما إلى ذلك.
  • خافت - 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 - منطقة السوق المحددة (DMA) التي نشأت منها الزيارات.

تتبع الصفحات

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

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

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

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

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

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

    • خافت - 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 من واجهة برمجة التطبيقات Data Export API نهائيًا لمدة شهرين. خلال 4 أشهر أخرى تقريبًا، سيتم إيقاف هذه الخدمة وإتاحة الإصدار الجديد من Core Reporting API الإصدار 3.0 والإصدار 2.4 فقط.

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

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

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

  • للحصول على الحصة الكاملة، يطلب منك الإصداران 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
    • دعم 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 (واجهة برمجة التطبيقات لإدارة البيانات وواجهة برمجة تطبيقات تصدير البيانات).

    • 50,000 طلب لكل مشروع في اليوم
    • 10 طلبات في الثانية (QPS) لكل عنوان IP
  • تنطبق الحصة التالية على Data Export API.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

يؤدي هذا الإصدار إلى إيقاف قيمة فاصل الثقة في المقاييس نهائيًا.

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

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

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

يضيف هذا الإصدار 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 Campaign.id
    • ga:adwordsCreativeId: يتوافق مع Ad.id من AdWords API
    • ga:adwordsCriteriaId: تتوافق مع Criterion.id في AdWords API
    • 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'.
  • تتوافق واجهة برمجة التطبيقات الآن مع بروتوكول Google Data الإصدار 2.

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

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

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

    • ...&segment=gaid::رقم
    • حيث يكون الرقم عبارة عن معرّف يشير إلى شريحة متقدمة محدّدة في واجهة الويب لبرنامج Google Analytics.
    • ويمكن العثور على رقم التعريف في خلاصة الحساب.
  • تصف خلاصة الحساب بيانات التقسيم من خلال عناصر وسمات 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
    • الآن
  • يتم الآن عرض جميع بيانات تتبع الأحداث كمجموعتين جديدتين:

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

    M7. الأحداث (المقاييس) * ga:eventValue * ga:totalEvents * ga:uniqueEvents

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

    D6. التنقل * ga:previousPagePath * ga:nextPagePath

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

    D3. المحتوى * 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:abandonedFunnels1
    • ga:abandonedFunnels2
    • ga:abandonedFunnels3
    • ga:abandonedFunnels4
    • ga:goalConversionRate
    • ga:goalConversionRate1
    • ga:goalConversionRate2
    • ga:goalConversionRate3
    • ga:goalConversionRate4
    • ga:goalValuePerVisit
  • تمت إعادة تسمية السمات والمقاييس التالية. ولن تعود الأسماء القديمة صالحة. يُرجى التأكد من أنك تستخدم الأسماء الرسمية في مستنداتنا هنا: http://code.google.com/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html

    الأبعاد * ga:subContinentRegion نقرت نظرًا لـ:subContinentRegion نقرت نظرًا لـ:subContinent Region