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

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

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

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

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

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

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

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

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

سجلّ تغيير واجهة برمجة التطبيقات الأساسية لإعداد التقارير
–
الاشتراك rss

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

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

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

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

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

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

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

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

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

الوقت

  • البُعد الجديد ga:dateHourMinute، الذي يجمع بين ga:date وga:hour وga:minute.

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

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

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

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

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

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

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

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

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

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

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

أبعاد المستخدم

رسائل الخطأ

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

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

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

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

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

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

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

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

تتبع الأحداث

سيتغيّر تعريف 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) المرتبط بجلسة "إحصاءات Google" ("إحصاءات 360" فقط، يتطلب الدمج مع DBM).
  • المكوّن - ga:dbmLastEventCreativeId - رقم تعريف تصميم إعلان DBM لآخر حدث DBM (مرة الظهور أو النقرة خلال فترة معاينة الإعلان في DBM) المرتبطة بجلسة "إحصاءات Google" ("إحصاءات 360" فقط، يتطلب الدمج مع DBM).
  • المكوّن - ga:dbmLastEventExchange - اسم تبادل Exchange لآخر حدث في DBM (مرة الظهور أو النقرة خلال فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" ("إحصاءات 360" فقط، يتطلب الدمج مع DBM).
  • المكوّن - ga:dbmLastEventExchangeId - رقم تعريف تبادل DBM لآخر حدث DBM (مرة الظهور أو النقرة خلال فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" ("إحصاءات 360" فقط، يتطلب الدمج مع DBM).
  • المكوّن - ga:dbmLastEventInsertionOrder - اسم طلب الإدراج في DBM لآخر حدث في DBM (مرة الظهور أو النقرة خلال فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" (يتطلب "إحصاءات 360" فقط الدمج مع DBM).
  • المكوّن - ga:dbmLastEventInsertionOrderId - معرّف طلب الإدراج في DBM آخر حدث DBM (مرة الظهور أو النقرة خلال فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" (يتطلب "إحصاءات 360" فقط الدمج مع DBM).
  • المكوّن - ga:dbmLastEventLineItem - اسم عنصر DBM لآخر حدث في DBM (مرة الظهور أو النقرة خلال فترة معاينة الإعلان في DBM) المرتبطة بجلسة "إحصاءات Google" ("إحصاءات 360" فقط، يتطلب الدمج مع DBM).
  • المكوّن - ga:dbmLastEventLineItemId - رقم تعريف عنصر DBM لآخر حدث DBM (مرة الظهور أو النقرة خلال فترة معاينة الإعلان في DBM) المرتبط بجلسة "إحصاءات Google" ("إحصاءات 360" فقط، يتطلب الدمج مع DBM).
  • المكوّن - ga:dbmLastEventSite - اسم الموقع الإلكتروني في DBM الذي تم فيه عرض تصميم الإعلان في DBM والنقر عليه لحدث DBM السابق (مرة الظهور أو النقرة ضمن فترة معاينة الإعلان في DBM) المرتبطة بجلسة "إحصاءات Google" ("إحصاءات 360" فقط، يتطلب الدمج مع DBM).
  • المكوّن - ga:dbmLastEventSiteId - رقم تعريف الموقع الإلكتروني في DBM حيث تم عرض تصميم إعلان DBM والنقر عليه لحدث DBM السابق (مرة الظهور أو النقرة ضمن فترة معاينة الإعلان في DBM) المرتبطة بجلسة "إحصاءات Google" (يتطلب "إحصاءات 360" فقط الدمج مع DBM).
  • المقياس - ga:dbmCPA - التكلفة الفعلية للإجراء للأرباح في DBM ("إحصاءات 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 ("إحصاءات 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 ("إحصاءات 360" فقط، تتطلّب الدمج مع DS).
  • المكوّن - ga:dsKeywordId - رقم تعريف الكلمة الرئيسية في DS ("إحصاءات 360" فقط، يتطلب الدمج مع DS).
  • ga:dsCPC - تكلفة النقرة المُعلنة لكل نقرة ("إحصاءات 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 Profie (يتطلب "إحصاءات 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 أبعاد بحدٍ أقصى.
  • الأبعاد المحورية هي جزء من القيد على إجمالي عدد الأبعاد المسموح بها في الطلب.
  • المقاييس المحورية هي جزء من القيود على إجمالي عدد المقاييس المسموح بها في الطلب.

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

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

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

DoubleClick for Publishers

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

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

الشرائح

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

أخذ العينات

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

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

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

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

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

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

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

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

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

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

البدء

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

سياسة الحصة

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

النقل

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

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

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

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

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

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

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

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

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

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

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

  • السمة - 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. على سبيل المثال، 1920 × 960.

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

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

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

مستخدم

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

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

DoubleClick Ad Exchange ‏(AdX)

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

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

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

  • المقياس - 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 أو أرقام التعريف الجغرافية. على سبيل المثال، بولينيزيا أو أوروبا الشمالية. ويتم تقديم القيم كرمز M.49.

DoubleClick Campaign Manager

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

المقاييس التي تم إيقافها

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

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

AdWords

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

المقاييس والمكوّنات التي تم إيقافها

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

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

AdSense

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

يتضمن هذا الإصدار إضافة مقياس جلسة جديد وبُعد جديد لمصادر الزيارات وأبعاد ومقاييس جديدة لحملة DoubleClick Campaign Manager.

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

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

الجلسة

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

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

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

DoubleClick Campaign Manager

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

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

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

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

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

  • المكوّن - ga:landingContentGroupXX - أول مجموعة محتوى مطابقة في جلسة أحد المستخدمين.
  • المكوّن - ga:nextContentGroupXX: يشير إلى مجموعة المحتوى التي تمت زيارتها بعد مجموعة محتوى أخرى.
  • السمة - ga:contentGroupXX - مجموعة محتوى على موقع معيّن مجموعة المحتوى هي مجموعة من المحتوى توفر بنية منطقية يمكن تحديدها عن طريق رمز التتبّع أو تطابق التعبير العادي لعنوان الصفحة/عنوان URL أو قواعد محدّدة مسبقًا.
  • البُعد - ga:previousContentGroupXX - يشير إلى مجموعة المحتوى التي تمت زيارتها قبل مجموعة محتوى أخرى.
  • المقياس - ga:contentGroupUniqueViewsXX - عدد الصفحات المختلفة (الفريدة) في جلسة واحدة لمجموعة المحتوى المحدّدة. ويضع ذلك في الاعتبار كل من pathPath و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 والدفع وغير ذلك
  • المقياس - 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. إذا أرسلت طلب بحث عن بُعد أو مقياس تم إيقافه، ستعرض واجهة برمجة التطبيقات رؤوس الأعمدة مع البُعد أو المقياس البديل. وهي تعرض الآن بشكل صحيح اسم المكوّن أو المقياس نفسه المستخدَم في الطلب.

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

مقاييس وأبعاد جديدة

تمت إضافة السمات التالية إلى واجهة برمجة التطبيقات الأساسية لإعداد التقارير:

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 من AMP

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

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

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

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

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

مقاييس وأبعاد جديدة

تمت إضافة المكوّنات والمقاييس التالية إلى واجهة برمجة التطبيقات الأساسية لإعداد التقارير:

الوقت

  • البُعد - 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:

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

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

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

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

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

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

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

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

تتبع التطبيق

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

منهي العمل به

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

  • Meet - ga:appviews - استخدِم ga:screenviews بدلاً من ذلك.
  • Meet - ga:uniqueAppviews - استخدِم ga:uniqueScreenviews بدلاً من ذلك.
  • Meet - ga:appviewsPerVisit - استخدِم ga:screenviewsPerSession بدلاً من ذلك.

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

  • الوصول إلى المكوّن والمقاييس المخصّصة:

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

التغييرات في المستندات

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

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

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

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

الاستثناءات

  • وتأتي هذه البيانات من تتبُّع الاستثناء.
    • تعتيم - ga:exceptionDescription - وصف الاستثناء
    • العدد - ga:exceptionsPerScreenview - عدد الاستثناءات التي تم طرحها مقسومًا على عدد مرات مشاهدة الصفحة في التطبيق.
    • Met - 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
  • Meet - ga:percentSearchRefinements - النسبة المئوية لعدد مرات التصفية (أي الانتقال) بين الكلمات الرئيسية للبحث الداخلي ضمن جلسة ما.

تتبع الصفحات

  • Met - 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 - عدد مرات مشاهدة التطبيق لكل جلسة.
    • Met - '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 - بالنسبة إلى نشاط مركز بيانات الشبكات الاجتماعية، تمثل هذه السلسلة نوع الإجراء الاجتماعي والشبكة الاجتماعية التي نشأ منها النشاط.
    • Meet - ga:socialActivities - عدد الأنشطة التي تمت فيها مشاركة عنوان URL للمحتوى أو الإشارة إليه على شبكة شركاء مركز بيانات الشبكات الاجتماعية.

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

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

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

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

تتبع الصفحات

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

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

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

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

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

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

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

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

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

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

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

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

يعمل هذا الإصدار على إصلاح خطأين:

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

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

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

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

مقاييس جديدة

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

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

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

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

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

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

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

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

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

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

الإصدار ‎‏‎3.0

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

  • ميزات جديدة

  • تسلسل التحديثات

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

الإصدار 2.4

  • الإصدار 2.4 من Reporting API:

  • تسلسل التحديثات

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

تسجيل

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

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

سياسة الحصة

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

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

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

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

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

الإيقاف

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

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

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

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

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

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

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

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

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

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

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

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

    وبدلاً من عرض استجابة مع ظهور 0، تعرض واجهة برمجة التطبيقات الآن رمز خطأ 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.id لواجهة برمجة تطبيقات AdWords
    • ga:adwordsCreativeId: يتوافق مع Ad.id API في AdWords
    • ga:adwordsCriteriaId: يتوافق مع Criteria.id في AdWords API
    • ga:adwordsCustomerId: يتوافق مع AccountInfo.customerId من AdWords API

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

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

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

ميزات جديدة

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

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

  • وقد تم تعديل سياسة الحصة في محاولة لضمان حصول جميع المستخدمين على وصول متساوٍ إلى الموارد. يُرجى الاطّلاع على مستندات سياسة عروض الأسعار التقديرية لمزيد من التفاصيل. والسياسة الجديدة هي:

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

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

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

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

  • سبق أن تم تبادل ga:itemQuantity وga:uniquePurchases وعرضت قيمة بعضهما البعض. وقد تم حلّ هذه المشاكل الآن بهدف عرض البيانات الصحيحة.

تذكير بشأن إيقاف العمل بالمقاييس والسمات

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

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

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

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

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

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

دعم التصنيف المتقدم

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

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

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

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

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

    • ga:visitorType==Returning Visitor

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

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

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

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

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

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

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

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

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

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

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

تم إيقاف العمل بالمكوّنات والمقاييس التي سيتم إزالتها.

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

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

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

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

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

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

    • ga:countOfvisits
    • ga:countOfvisitsToATransaction
    • ga:sourceMedium
    • ga:percentNewVisits

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

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

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

    D7. الأحداث (الأبعاد) * ga:eventCategory * ga:eventAction * ga:eventLabel

    M7. الأحداث (المقاييس) * ga:eventValue * ga:totalevents * ga:فريدevents

  • يتم الآن الكشف بشكلٍ عام عن بيانات التنقّل في الموقع الإلكتروني من خلال السمات التالية:

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

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

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

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

  • يتم الآن عرض تقرير "مدة الزيارة" (المتوفر من خلال واجهة المستخدم ضمن "زائرون" -&gt؛ "ولاء الزائر") من خلال البُعد الجديد:

    • 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/gdataReferenceCommon العمليات الحسابية.html

    • ga:avgPageLength
    • ga:avg مرات مشاهدة الصفحة
    • 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/gdataReferenceMetrics.html

    البيانات على الإنترنت التالية:

    (بما يلي: :1)