سجلّ التغييرات

للاطّلاع على الإشعارات الرسمية بشأن Google Analytics API، يُرجى الاشتراك في مجموعة الإشعارات بشأن Google Analytics API.

‫2024-10-20 تمت إضافة نوع فلتر السمة EmptyFilter

باستخدام فلتر السمة EmptyFilter، يمكنك إنشاء شروط فلترة مقارنةً بقيمة فارغة.

‫15-10-2024 تمت إضافة ميزة مستوى جمع العينات إلى طريقة reportTasks

باستخدام حقل samplingLevel في الطريقة properties.runReportTask ، يمكنك التحكّم في مستوى أخذ العينات للتقرير.

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

‎18-09-2024 تمت إضافة ميزة "لقطة QUOTAS للموقع"

باستخدام الطريقة properties.getPropertyQuotasSnapshot، يمكنك الحصول على لقطة حديثة لجميع حصص المواقع المرتّبة حسب فئة الحصة لموقع معيّن.

‎2024-06-28 تمت إضافة حصة "أخطاء العميل لكل مشروع لكل موقع"

يُسمح الآن بحد أقصى 10,000 خطأ في خادم واجهة برمجة التطبيقات لكل مشروع، ولكل موقع، خلال فترة 15 دقيقة. ويشمل ذلك جميع الطلبات التي تؤدي إلىتلقّي ردّ يتضمّن أي رمز غير 500 أو 200. تشمل أمثلة الأخطاء التي تندرج تحت هذه الحصة استخدام مجموعات سمات ومقاييس غير متوافقة، وجميع أخطاء مصادقة البيانات.

وفي حال تجاوز هذا الحدّ، سيتم بشكل مؤقت حظر أي طلبات أخرى من واجهة برمجة التطبيقات إلى هذا الموقع الإلكتروني في مشروع Google Cloud المرتبط به إلى أن تنتهي مهلة الـ 15 دقيقة.

‎2024-05-14 تمت إضافة ميزة "المقارنات"

باستخدام المقارنات، يمكنك تقييم مجموعات فرعية من بياناتك معًا.

تم تعديل طرق إعداد التقارير الأساسية في الإصدار التجريبي من Data API‏ 1 ليتيح استخدام الحقل comparisons الذي يحدّد، عند تضمينه، إعدادات المقارنات المطلوبة.

في الطلب، يمكنك تحديد مقارنة أساسية، عن طريق تقديم تعبير dimensionFilter مع طلب، أو استخدام مقارنة محفوظة عن طريق تقديم اسم موارد المقارنة في الحقل comparison.

تم تعديل الطريقة getMetadata لعرض كل المقارنات المحفوظة المتاحة لموقع معيّن ضمن حقل الاستجابة comparisons.

عند تحديد مقارنة واحدة على الأقل في طلب، سيتضمّن الردّ عمود comparison الذي يحدِّد كل مقارنة.

في الوقت الحالي، لا يمكن إنشاء المقارنات المحفوظة إلا باستخدام واجهة مستخدم "إحصاءات Google".

‎08-05-2024 تمت إضافة مهام إعداد التقارير، وهي ميزة إعداد تقارير غير متزامنة، إلى الإصدار 1alpha من Data API.

باستخدام مهام التقارير، يمكنك بدء طلب غير متزامن يستغرق وقتًا طويلاً ل إنشاء تقرير مخصّص لبيانات الأحداث في "إحصاءات Google".

تمت إضافة طرق التحكّم في مهام إعداد التقارير التالية إلى Data API v1alpha:

‎06-05-2024 سمات جديدة للأحداث الرئيسية

تتوفّر الآن السمات والمقاييس للأحداث المهمة.

عدِّل طلبات التقارير التي تستخدِم سمة isConversionEvent ل استخدام سمة isKeyEvent بدلاً من ذلك.

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

مقياس تم إيقافه مقياس الحدث الرئيسي
advertiserAdCostPerConversion advertiserAdCostPerKeyEvent
conversions keyEvents
firstTimePurchaserConversionRate firstTimePurchaserRate
purchaserConversionRate purchaserRate
sessionConversionRate sessionKeyEventRate
userConversionRate userKeyEventRate

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

يوضّح ردّ طريقة properties/getMetadata إدخال سمات الأحداث الرئيسية ومقاييسها في عنصرَي DimensionMetadata و MetricMetadata على النحو التالي:

  • تحتوي السمات apiName وuiName وdescription على اسم واجهة برمجة التطبيقات للحدث الرئيسي، واسم واجهة المستخدم، ووصفها.
  • يحتوي الحقل المتكرّر deprecatedApiNames على إدخال يحمل اسم واجهة برمجة التطبيقات للإحالات الناجحة المتوقّفة نهائيًا.

‫25‏ آذار (مارس) 2024: تمت إضافة مجموعة القنوات الأساسية ومصدر الزيارات اليدوي والسمات المتعلّقة بالدمج.

سمات خاصة بدمج مجموعة القنوات الأساسية ومصدر الزيارات اليدوي و"مدير الحملة 360" و"مساحة العرض والفيديو 360" و"إعلانات شبكة البحث 360" تمت إضافتها إلى مخطّط Data API

سمات الجمهور:

  • audienceId رقم تعريف الجمهور المعرّف الرقمي لشريحة جمهور

سمات مجموعة القنوات الأساسية:

  • firstUserPrimaryChannelGroup مجموعة القنوات الأساسية للمستخدِم الجديد

  • primaryChannelGroup مجموعة القنوات الأساسية

  • sessionPrimaryChannelGroup مجموعة القنوات الأساسية للجلسة

سمات مصدر الزيارات اليدوية:

  • manualCampaignId رقم تعريف الحملة اليدوية

  • manualCampaignName اسم الحملة اليدوية

  • manualCreativeFormat تنسيق التصميم اليدوي

  • manualMarketingTactic منهج التسويق اليدوي

  • manualMedium الوسيط اليدوي

  • manualSource المصدر اليدوي

  • manualSourceMedium المصدر / الوسيط اليدوي

  • manualSourcePlatform منصّة المصدر اليدوي

  • firstUserManualCampaignId رقم تعريف الحملة اليدوية للمستخدِم الجديد

  • firstUserManualCampaignName اسم الحملة اليدوية للمستخدِم الجديد

  • firstUserManualCreativeFormat تنسيق تصميم الإعلان اليدوي للمستخدِم الجديد

  • firstUserManualMarketingTactic منهج التسويق اليدوي للمستخدِم الجديد

  • firstUserManualMedium الوسيط اليدوي للمستخدِم الجديد

  • firstUserManualSource المصدر اليدوي للمستخدِم الجديد

  • firstUserManualSourceMedium الوسيط / المصدر اليدوي للمستخدِم الجديد

  • firstUserManualSourcePlatform المنصّة المصدر اليدوية للمستخدِم الجديد

  • sessionManualCampaignId رقم تعريف الحملة اليدوية للجلسة

  • sessionManualCampaignName اسم الحملة اليدوية للجلسة

  • sessionManualCreativeFormat تنسيق التصميم اليدوي للجلسة

  • sessionManualMarketingTactic منهج التسويق اليدوي للجلسة

  • sessionManualMedium الوسيط اليدوي للجلسة

  • sessionManualSource المصدر اليدوي للجلسة

  • sessionManualSourceMedium المصدر / الوسيط اليدوي للجلسة

  • sessionManualSourcePlatform المنصّة المصدر اليدوية للجلسة

سمات دمج "مدير الحملة 360":

  • cm360AccountId رقم تعريف حساب "مدير الحملة 360"

  • cm360AccountName اسم حساب "مدير الحملة 360"

  • cm360AdvertiserId الرقم التعريفي للمعلِن في "مدير الحملة 360"

  • cm360AdvertiserName اسم المعلِن في "مدير الحملة 360"

  • cm360CampaignId رقم تعريف الحملة في "مدير الحملة 360"

  • cm360CampaignName اسم الحملة في "مدير الحملة 360"

  • cm360CreativeFormat تنسيق تصميم الإعلان في "مدير الحملة 360"

  • cm360CreativeId رقم تعريف تصميم الإعلان في "مدير الحملة 360"

  • cm360CreativeName اسم تصميم الإعلان في "مدير الحملة 360"

  • cm360CreativeType نوع تصميم الإعلان في "مدير الحملة 360"

  • cm360CreativeTypeId رقم تعريف نوع تصميم الإعلان في "مدير الحملة 360"

  • cm360CreativeVersion نسخة تصميم الإعلان في "مدير الحملة 360"

  • cm360Medium الوسيط في "مدير الحملة 360"

  • cm360PlacementCostStructure بنية تكلفة موضع الإعلان في "مدير الحملة 360"

  • cm360PlacementId رقم تعريف موضع الإعلان في "مدير الحملة 360"

  • cm360PlacementName اسم موضع الإعلان في "مدير الحملة 360"

  • cm360RenderingId رقم تعريف عرض الإعلانات في "مدير الحملة 360"

  • cm360SiteId رقم تعريف الموقع الإلكتروني في "مدير الحملة 360"

  • cm360SiteName اسم الموقع الإلكتروني في "مدير الحملة 360"

  • cm360Source المصدر في "مدير الحملة 360"

  • cm360SourceMedium المصدر / الوسيط في "مدير الحملة 360"

  • firstUserCm360AccountId رقم تعريف حساب "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360AccountName اسم حساب "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360AdvertiserId الرقم التعريفي للمعلِن في "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360AdvertiserName اسم المعلِن في "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360CampaignId رقم تعريف الحملة في "مدير الحملة 360" للمستخدِم الجديد

  • firstUserCm360CampaignName اسم الحملة في "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360CreativeFormat تنسيق تصميم الإعلان في "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360CreativeId رقم تعريف تصميم الإعلان في "مدير الحملة 360" للمستخدِم الجديد

  • firstUserCm360CreativeName اسم تصميم الإعلان في "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360CreativeType نوع تصميم الإعلان في "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360CreativeTypeId رقم تعريف نوع تصميم الإعلان في "مدير الحملة 360" للمستخدِم الجديد

  • firstUserCm360CreativeVersion إصدار تصميم الإعلان في "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360Medium الوسيط في "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360PlacementCostStructure هيكل تكلفة موضع الإعلان في "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360PlacementId رقم تعريف موضع الإعلان في "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360PlacementName اسم موضع الإعلان في "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360RenderingId رقم تعريف عرض الإعلانات في "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360SiteId رقم تعريف الموقع الإلكتروني في "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360SiteName اسم الموقع الإلكتروني في "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360Source المصدر في "مدير الحملة 360" للمستخدم الجديد

  • firstUserCm360SourceMedium المصدر / الوسيط في "مدير الحملة 360" للمستخدم الجديد

  • sessionCm360AccountId رقم تعريف الحساب الخاص بالجلسة في "مدير الحملة 360"

  • sessionCm360AccountName اسم الحساب الخاص بالجلسة في "مدير الحملة 360"

  • sessionCm360AdvertiserId الرقم التعريفي للمعلِن في "مدير الحملة 360" للجلسة

  • sessionCm360AdvertiserName اسم المعلِن الخاص بالجلسة في "مدير الحملة 360"

  • sessionCm360CampaignId رقم تعريف الحملة الخاص بالجلسة في "مدير الحملة 360"

  • sessionCm360CampaignName اسم الحملة الخاص بالجلسة في "مدير الحملة 360"

  • sessionCm360CreativeFormat تنسيق تصميم الإعلان الخاص بالجلسة في "مدير الحملة 360"

  • sessionCm360CreativeId رقم تعريف تصميم الإعلان في "مدير الحملة 360" للجلسة

  • sessionCm360CreativeName اسم تصميم الإعلان في "مدير الحملة 360" للجلسة

  • sessionCm360CreativeType نوع تصميم الإعلان في "مدير الحملة 360" للجلسة

  • sessionCm360CreativeTypeId رقم تعريف نوع تصميم الإعلان في "مدير الحملة 360" للجلسة

  • sessionCm360CreativeVersion إصدار تصميم الإعلان في "مدير الحملة 360" للجلسة

  • sessionCm360Medium الوسيط الخاص بالجلسة في "مدير الحملة 360"

  • sessionCm360PlacementCostStructure هيكل تكلفة موضع الإعلان في "مدير الحملة 360" للجلسة

  • sessionCm360PlacementId رقم تعريف موضع الإعلان الخاص بالجلسة في "مدير الحملة 360"

  • sessionCm360PlacementName اسم موضع الإعلان الخاص بالجلسة في "مدير الحملة 360"

  • sessionCm360RenderingId رقم تعريف عرض الإعلانات الخاص بالجلسة في "مدير الحملة 360"

  • sessionCm360SiteId رقم تعريف الموقع الإلكتروني الخاص بالجلسة في "مدير الحملة 360"

  • sessionCm360SiteName اسم الموقع الإلكتروني الخاص بالجلسة في "مدير الحملة 360"

  • sessionCm360Source المصدر الخاص بالجلسة في "مدير الحملة 360"

  • sessionCm360SourceMedium المصدر / الوسيط في "مدير الحملة 360" للجلسة

سمات دمج "مساحة العرض والفيديو 360" من Google:

  • dv360AdvertiserId الرقم التعريفي للمعلِن في "مساحة العرض والفيديو 360"

  • dv360AdvertiserName اسم المعلِن في "مساحة العرض والفيديو 360"

  • dv360CampaignId رقم تعريف الحملة في "مساحة العرض والفيديو 360"

  • dv360CampaignName اسم الحملة في "مساحة العرض والفيديو 360"

  • dv360CreativeFormat تنسيق تصميم الإعلان في "مساحة العرض والفيديو 360"

  • dv360CreativeId رقم تعريف تصميم الإعلان في "مساحة العرض والفيديو 360"

  • dv360CreativeName اسم تصميم الإعلان في "مساحة العرض والفيديو 360"

  • dv360ExchangeId رقم تعريف تبادل الإعلانات في "مساحة العرض والفيديو 360"

  • dv360ExchangeName اسم تبادل الإعلانات في "مساحة العرض والفيديو 360"

  • dv360InsertionOrderId معرّف طلب الإدراج في "مساحة العرض والفيديو 360"

  • dv360InsertionOrderName اسم طلب الإدراج في "مساحة العرض والفيديو 360"

  • dv360LineItemId معرّف العنصر في "مساحة العرض والفيديو 360"

  • dv360LineItemName اسم العنصر في "مساحة العرض والفيديو 360"

  • dv360Medium الوسيط في "مساحة العرض والفيديو 360"

  • dv360PartnerId رقم تعريف الشريك في "مساحة العرض والفيديو 360"

  • dv360PartnerName اسم شريك "مساحة العرض والفيديو 360"

  • dv360Source مصدر "مساحة العرض والفيديو 360"

  • dv360SourceMedium المصدر / الوسيط في "مساحة العرض والفيديو 360"

  • firstUserDv360AdvertiserId الرقم التعريفي للمعلِن في "مساحة العرض والفيديو 360" للمستخدم الجديد

  • firstUserDv360AdvertiserName اسم المعلِن في "مساحة العرض والفيديو 360" للمستخدم الجديد

  • firstUserDv360CampaignId رقم تعريف الحملة في "مساحة العرض والفيديو 360" للمستخدم الجديد

  • firstUserDv360CampaignName اسم الحملة في "مساحة العرض والفيديو 360" للمستخدم الجديد

  • firstUserDv360CreativeFormat تنسيق تصميم الإعلان في "مساحة العرض والفيديو 360" للمستخدِم الجديد

  • firstUserDv360CreativeId رقم تعريف تصميم الإعلان في "مساحة العرض والفيديو 360" للمستخدِم الجديد

  • firstUserDv360CreativeName اسم تصميم الإعلان في "مساحة العرض والفيديو 360" للمستخدِم الجديد

  • firstUserDv360ExchangeId رقم تعريف تبادل الإعلانات في "مساحة العرض والفيديو 360" للمستخدِم الجديد

  • firstUserDv360ExchangeName اسم تبادل الإعلانات للمستخدم الجديد في "مساحة العرض والفيديو 360"

  • firstUserDv360InsertionOrderId معرّف طلب الإدراج في "مساحة العرض والفيديو 360" للمستخدِم الجديد

  • firstUserDv360InsertionOrderName اسم طلب الإدراج في "مساحة العرض والفيديو 360" للمستخدِم الجديد

  • firstUserDv360LineItemId معرّف العنصر في "مساحة العرض والفيديو 360" للمستخدِم الجديد

  • firstUserDv360LinteItemName اسم العنصر في "مساحة العرض والفيديو 360" للمستخدِم الجديد

  • firstUserDv360Medium الوسيط للمستخدم الجديد في "مساحة العرض والفيديو 360"

  • firstUserDv360PartnerId رقم تعريف شريك المستخدِم الجديد في "مساحة العرض والفيديو 360"

  • firstUserDv360PartnerName اسم شريك المستخدِم الجديد في "مساحة العرض والفيديو 360"

  • firstUserDv360Source المصدر في "مساحة العرض والفيديو 360" للمستخدِم الجديد

  • firstUserDv360SourceMedium المصدر / الوسيط في "مساحة العرض والفيديو 360" للمستخدِم الجديد

  • sessionDv360AdvertiserId الرقم التعريفي للمعلِن الخاص بالجلسة في "مساحة العرض والفيديو 360"

  • sessionDv360AdvertiserName اسم المعلِن الخاص بالجلسة في "مساحة العرض والفيديو 360"

  • sessionDv360CampaignId رقم تعريف الحملة الخاص بالجلسة في "مساحة العرض والفيديو 360"

  • sessionDv360CampaignName اسم الحملة الخاص بالجلسة في "مساحة العرض والفيديو 360"

  • sessionDv360CreativeFormat تنسيق تصميم الإعلان الخاص بالجلسة في "مساحة العرض والفيديو 360"

  • sessionDv360CreativeId رقم تعريف تصميم الإعلان الخاص بالجلسة في "مساحة العرض والفيديو 360"

  • sessionDv360CreativeName اسم تصميم الإعلان الخاص بالجلسة في "مساحة العرض والفيديو 360"

  • sessionDv360ExchangeId رقم تعريف تبادل الإعلانات الخاص بالجلسة في "مساحة العرض والفيديو 360"

  • sessionDv360ExchangeName اسم تبادل الإعلانات الخاص بالجلسة في "مساحة العرض والفيديو 360"

  • sessionDv360InsertionOrderId معرّف طلب الإدراج الخاص بالجلسة في "مساحة العرض والفيديو 360"

  • sessionDv360InsertionOrderName اسم طلب الإدراج الخاص بالجلسة في "مساحة العرض والفيديو 360"

  • sessionDv360LineItemId معرّف العنصر في "مساحة العرض والفيديو 360" للجلسة

  • sessionDv360LineItemName اسم العنصر في "مساحة العرض والفيديو 360" للجلسة

  • sessionDv360Medium الوسيط الخاص بالجلسة في "مساحة العرض والفيديو 360"

  • sessionDv360PartnerId رقم تعريف الشريك للجلسة في "مساحة العرض والفيديو 360"

  • sessionDv360PartnerName اسم الشريك للجلسة في "مساحة العرض والفيديو 360"

  • sessionDv360Source المصدر الخاص بالجلسة في "مساحة العرض والفيديو 360"

  • sessionDv360SourceMedium المصدر / الوسيط الخاصَان بالجلسة في "مساحة العرض والفيديو 360"

سمات دمج "إعلانات شبكة البحث 360" من Google:

  • firstUserSa360AdGroupId رقم تعريف المجموعة الإعلانية في "إعلانات شبكة البحث 360" للمستخدِم الجديد

  • firstUserSa360AdGroupName اسم المجموعة الإعلانية على "إعلانات شبكة البحث 360" للمستخدِم الجديد

  • firstUserSa360CampaignId رقم تعريف الحملة الأولى للمستخدم في "إعلانات شبكة البحث 360"

  • firstUserSa360CampaignName الحملة على "إعلانات شبكة البحث 360" للمستخدِم الجديد

  • firstUserSa360CreativeFormat شكل المواد الإبداعية في "إعلانات شبكة البحث 360" للمستخدم الجديد

  • firstUserSa360EngineAccountId رقم تعريف حساب محرّك البحث على "إعلانات شبكة البحث 360" للمستخدِم الجديد

  • firstUserSa360EngineAccountName اسم حساب محرّك البحث على "إعلانات شبكة البحث 360" للمستخدِم الجديد

  • firstUserSa360EngineAccountType نوع حساب محرّك البحث على "إعلانات شبكة البحث 360" للمستخدِم الجديد

  • firstUserSa360KeywordText نصّ الكلمة الرئيسية في "إعلانات شبكة البحث 360" للمستخدِم الجديد

  • firstUserSa360ManagerAccountId رقم تعريف الحساب الإداري في "إعلانات شبكة البحث 360" للمستخدِم الجديد

  • firstUserSa360ManagerAccountName اسم الحساب الإداري على "إعلانات شبكة البحث 360" للمستخدِم الجديد

  • firstUserSa360Medium الوسيط في "إعلانات شبكة البحث 360" للمستخدِم الجديد

  • firstUserSa360Query طلب البحث على "إعلانات شبكة البحث 360" للمستخدِم الجديد

  • firstUserSa360Source مصدر "إعلانات شبكة البحث 360" للمستخدِم الجديد

  • firstUserSa360SourceMedium المصدر / الوسيط في "إعلانات شبكة البحث 360" للمستخدِم الجديد

  • sa360AdGroupId رقم تعريف المجموعة الإعلانية في "إعلانات شبكة البحث 360"

  • sa360CampaignId رقم تعريف الحملة في "إعلانات شبكة البحث 360"

  • sa360AdGroupName اسم المجموعة الإعلانية في "إعلانات شبكة البحث 360"

  • sa360CampaignName الحملة على "إعلانات شبكة البحث 360"

  • sa360CreativeFormat تنسيق تصميم الإعلان في "إعلانات شبكة البحث 360"

  • sa360EngineAccountId رقم تعريف حساب محرّك البحث في "إعلانات شبكة البحث 360"

  • sa360EngineAccountName اسم حساب محرّك البحث في "إعلانات شبكة البحث 360"

  • sa360EngineAccountType نوع حساب محرّك البحث في "إعلانات شبكة البحث 360"

  • sa360KeywordText نصّ الكلمة الرئيسية في "إعلانات شبكة البحث 360"

  • sa360ManagerAccountId رقم تعريف الحساب الإداري على "إعلانات شبكة البحث 360"

  • sa360ManagerAccountName اسم الحساب الإداري على "إعلانات شبكة البحث 360"

  • sa360Medium الوسيط في "إعلانات شبكة البحث 360"

  • sa360Query طلب البحث في "إعلانات شبكة البحث 360"

  • sa360Source مصدر "إعلانات شبكة البحث 360"

  • sa360SourceMedium المصدر / الوسيط في "إعلانات شبكة البحث 360"

  • sessionSa360AdGroupId رقم تعريف المجموعة الإعلانية في "إعلانات شبكة البحث 360" الخاص بالجلسة

  • sessionSa360CampaignId رقم تعريف الحملة الخاص بالجلسة في "إعلانات شبكة البحث 360"

  • sessionSa360ManagerAccountId رقم تعريف الحساب الإداري الخاص بالجلسة في "إعلانات شبكة البحث 360"

  • sessionSa360ManagerAccountName اسم الحساب الإداري الخاص بالجلسة في "إعلانات شبكة البحث 360"

  • sessionSa360SourceMedium المصدر / الوسيط الخاصَان بالجلسة في "إعلانات شبكة البحث 360"

‎06-03-2024 إتاحة شرائح جمهور المستخدِمين غير النشطين في عمليات تصدير شرائح الجمهور

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

‎2024-02-28 تعرض عمليات تصدير شرائح الجمهور رقم تعريف المستخدم المحدّد في وضع العلامات.

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

‫30‏ كانون الثاني (يناير) 2024: إتاحة إشعارات Webhook لقوائم المستخدمين وقوائم المستخدمين المتكرّرة في الإصدار التجريبي من Data API‏ v1

يمكن تحديد الحقلَين AudienceList.webhookNotification وRecurringAudienceList.webhookNotification عند إنشاء قائمة مستخدِمين (باستخدام properties.audienceLists.create) أو قائمة مستخدِمين متكرّرة (باستخدام properties.recurringAudienceLists.create).

تتيح لك هذه الوظيفة تلقّي إشعارات Webhook بشكل غير متزامن عندما تصبح قائمة شرائح الجمهور متاحة.

‎2024-01-18 تم تحسين التوافق مع السمات التي تتضمّن سلسلة طلب البحث أو مكوّن الدقائق.

أصبحت السمات التي تتضمّن سلسلة طلب البحث متوافقة الآن مع معظم الحقول. أصبحت السمات مثل pagePathPlusQueryString وunifiedPageScreen وpageLocation وfullPageUrl متوافقة الآن مع العديد من الحقول الإضافية، بما في ذلك sessionSource وbrowser وcity وlandingPage.

أصبحت السمات التي تتضمّن مكوّن الدقائق متوافقة الآن مع معظم الحقول. أصبحت السمات، مثل minute وnthMinute وdateHourMinute، متوافقة الآن مع مجموعة مشابهة من الحقول الإضافية.

اطّلِع على أداة استكشاف المقاييس والسمات في "إحصاءات Google‏ 4" للحصول على معلومات شاملة عن التوافق.

‎13-12-2023 المَعلمات المخصّصة على مستوى المنتج أو الخدمة

يمكن الآن تضمين السمات المخصّصة على مستوى السلعة في طلبات البحث في Analytics Data API باستخدام البنية التالية:

اسم واجهة برمجة التطبيقات العام الوصف
customItem:parameter_name سمة مخصّصة على مستوى المنتج أو الخدمة للسمة parameter_name

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

‫05‏/12‏/2023: تتوفّر قوائم المستخدِمين في الإصدار التجريبي من Data API v1 كعمليات تصدير للمستخدِمين

تمت إعادة تسمية ميزة "قوائم الجمهور" إلى عمليات تصدير شرائح الجمهور وإضافتها إلى الإصدار التمهيدي من Data API v1.

تمت إضافة الطرق التالية إلى الإصدار التجريبي من Data API v1:

‎2023-11-28 تمت إضافة samplingMetadatas للإبلاغ عن الردّ

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

‫28-11-2023 تمت إضافة وظيفة تصدير قائمة الجمهور المتكرّرة إلى الإصدار التجريبي من Data API ‏1.

تمت إضافة الطرق properties.recurringAudienceLists.create، properties.recurringAudienceLists.create، properties.recurringAudienceLists.list إلى الإصدار التجريبي من Data API v1.

تتيح لك هذه الوظيفة إنشاء قوائم جمهور يوميًا مع تغيُّر عضويات الجمهور. تضمن لك قوائم المستخدمين المتكرّرة استخدام أحدث نتائج ميزة "الاشتراك في قناة".

‎08-11-2023 تمت إضافة وظيفة تصدير "قائمة الجمهور" إلى "جداول بيانات Google" إلى الإصدار التجريبي من Data API v1.

تمت إضافة الطريقة properties.audienceLists.exportSheet إلى الإصدار التجريبي من Data API ‏1 الذي يتيح لك تصدير قائمة جمهور إلى جداول بيانات Google.

‫13‏ تشرين الأول (أكتوبر) 2023 تمت إضافة ميزة "شرائح الجمهور" التي تتضمن مدة عضوية تبلغ يومًا واحدًا.

أصبحت شرائح الجمهور التي تبلغ مدة اشتراكها يومًا واحدًا متاحة الآن من خلال وظيفة تصدير قوائم الجمهور.

‎2023-09-12 قواعد الترتيب التلقائية في AudienceList

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

قبل هذا التغيير، ربما تلقّيت التقرير التالي:

deviceId isAdsPersonalizationAllowed
ABC صحيح
DAC خطأ
ABC خطأ
AAA صحيح

بعد هذا التغيير، سيصلك التقرير التالي:

deviceId isAdsPersonalizationAllowed
AAA صحيح
ABC خطأ
ABC صحيح
DAC خطأ

‎15-08-2023 تمت إضافة السمة isLimitedAdTracking إلى مخطّط تصدير "قائمة المستخدمين".

  • isLimitedAdTracking الإعداد "تقييد تتبُّع الإعلانات" على الجهاز. تشمل القيم المحتملة: true وfalse و(not set).

    لمعرفة مزيد من المعلومات، يمكنك الاطّلاع على سمات قائمة المستخدمين.

‎15-08-2023 تمت إضافة السمة currencyCode والمقياس itemDiscountAmount.

  • currencyCode رمز العملة المحلية (استنادًا إلى معيار ISO 4217) ل حدث التجارة الإلكترونية. على سبيل المثال، "USD" أو "GBP".

  • itemDiscountAmount القيمة المالية لخصومات السلع في أحداث التجارة الإلكترونية. تتم تعبئة هذا المقياس في وضع العلامات حسب مَعلمة السلعة "discount".

لمزيد من المعلومات، يُرجى الاطّلاع على مخطّط إعداد التقارير في Data API.

‎10-08-2023 تمت إضافة السمة isAdsPersonalizationAllowed إلى مخطّط تصدير "قائمة الجمهور".

  • isAdsPersonalizationAllowed يُسمح بتخصيص الإعلانات. إذا كان المستخدِم مؤهَّلاً لتخصيص الإعلانات، يعرِضisAdsPersonalizationAllowed القيمةtrue. إذا لم يكن المستخدِم مؤهَّلاً لتخصيص الإعلانات، يعرِض الحقل isAdsPersonalizationAllowed القيمة false.

    لمعرفة مزيد من المعلومات، يمكنك الاطّلاع على سمات قائمة المستخدمين.

‎2023-07-10 قوائم المستخدِمين

تمت إضافة إمكانية استخدام قوائم الجمهور إلى الإصدار 1 الأوّلي من Data API. تتضمّن قوائم المستخدمين نبذة عن المستخدِمين في شريحة الجمهور في وقت إنشاء قائمة المستخدِمين.

الطرق التالية التي تمت إضافتها إلى الإصدار التجريبي من Data API‏ 1:

‎2023-05-19 مجموعات القنوات المخصّصة

تمت إضافة مجموعات القنوات المخصَّصة إلى Data API.

‫11‏ أيار (مايو) 2023: تغييرات في حصة الرموز المميّزة

تم تعديل نظام الحصص في Data API للسماح برسوم أكثر دقة.

تم تعديل عدد الرموز المميّزة التي يتم تحصيلها مقابل كل طلب بالتزامن مع تغيير الحصة وتم إعادة التوازن بطريقة تسمح بإجراء عدد أكبر من طلبات البحث البسيطة لإعداد التقارير، مع تحصيل عددٍ أكبر بكثير من رموز الحصة لتقارير البيانات الكبيرة.

بعد إجراء هذا التغيير، ستظلّ الرسوم المفروضة على بعض الطلبات كما هي، ولكن ستتم زيادة ملحوظة في الرسوم المفروضة على طلبات البحث الأكثر تعقيدًا. على سبيل المثال، يمكن أن تؤدي طلبات الحصول على بيانات لأكثر من 6 أشهر إلى تحصيل رسوم 1,000 رمز مميّز أو أكثر للحصة.

الخصائص العادية

اسم الحصة الحدّ القديم الحدّ الجديد
الرموز الأساسية لكل موقع في اليوم 25000 200,000
الرموز الأساسية لكل موقع في الساعة 5000 40,000
الرموز الأساسية لكل مشروع لكل موقع في الساعة 1,750 14,000
الرموز المميّزة في الوقت الفعلي لكلّ موقع في اليوم 25000 200,000
الرموز المميّزة في الوقت الفعلي لكلّ موقع في الساعة 5000 40,000
الرموز المميّزة في الوقت الفعلي لكل مشروع لكل موقع في الساعة 1,750 14,000
الرموز المميّزة للمسارات الإجرائية لكلّ موقع في اليوم 25000 200,000
رموز مسارات الإحالات الناجحة لكلّ موقع في الساعة 5000 40,000
رموز مسارات الإحالة الناجحة لكل مشروع لكل موقع في الساعة 1,750 14,000

مواقع "إحصاءات Google‏ 360"

اسم الحصة الحدّ القديم الحدّ الجديد
الرموز الأساسية لكل موقع في اليوم 250000 2,000,000
الرموز الأساسية لكل موقع في الساعة 50,000 400,000
الرموز الأساسية لكل مشروع لكل موقع في الساعة 17,500 140,000
الرموز المميّزة في الوقت الفعلي لكلّ موقع في اليوم 250000 2,000,000
الرموز المميّزة في الوقت الفعلي لكلّ موقع في الساعة 50,000 400,000
الرموز المميّزة في الوقت الفعلي لكل مشروع لكل موقع في الساعة 17,500 140,000
الرموز المميّزة للمسارات الإجرائية لكلّ موقع في اليوم 250000 2,000,000
رموز مسارات الإحالات الناجحة لكلّ موقع في الساعة 50,000 400,000
رموز مسارات الإحالة الناجحة لكل مشروع لكل موقع في الساعة 17,500 140,000

‫02‏/03‏/2023 تمت إضافة سمات التاريخ.

  • dayOfWeekName اسم اليوم من الأسبوع يوم الأسبوع باللغة الإنجليزية تحتوي هذه السمة على قيم Sunday وMonday وما إلى ذلك.

  • isoWeek أسبوع ISO من السنة رقم الأسبوع وفقًا لمعيار ISO، حيث يبدأ كل أسبوع يوم الاثنين للاطّلاع على التفاصيل، يُرجى الانتقال إلى https://en.wikipedia.org/wiki/ISO_week_date. تشمل أمثلة القيم 01 و02 و53.

  • isoYear عام ISO السنة وفقًا لمعيار ISO للحدث. للاطّلاع على التفاصيل، يُرجى الانتقال إلى https://en.wikipedia.org/wiki/ISO_week_date. تشمل أمثلة القيم 2022 و2023.

  • isoYearIsoWeek أسبوع ISO من عام ISO القيم المجمّعة لـ isoWeek وisoYear تشمل أمثلة القيم 201652 و201701.

  • yearMonth السنة والشهر القيم المجمّعة لـ year وmonth تشمل أمثلة القيم 202212 أو 202301.

  • yearWeek السنة والأسبوع القيم المجمّعة لـ year وweek تشمل أمثلة القيم 202253 أو 202301.

‫2023-02-27 تمت إضافة سمات التجارة الإلكترونية.

  • itemListPosition موضع السلعة في قائمة السلع موضع سلعة معيّنة (مثلاً، منتج تبيعه) في قائمة السلع. تتم تعبئة هذه السمة في وضع العلامات باستخدام المَعلمة index في مصفوفة السلع.

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

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

‎2023-02-21 تمت إضافة سمة "الصفحة المقصودة + سلسلة طلب البحث".

  • landingPagePlusQueryString الصفحة المقصودة + سلسلة طلب البحث مسار الصفحة + سلسلة طلب البحث المرتبطَان بأول مشاهدة صفحة على الويب في إحدى الجلسات.

يحلّ هذا الحقل محلّ سمة landingPage التي تم إيقافها نهائيًا وسيتم تعديلها لمنع عرض سلسلة طلب بحث في 14 أيار (مايو) 2023.

‎2023-01-28 تمت إضافة مقياسَي "مرّات المشاهدة لكلّ مستخدِم" و"المستخدِمون الذين تصفّحوا الصفحة".

  • screenPageViewsPerUser مرّات المشاهدة لكل مستخدم عدد شاشات التطبيق أو صفحات الويب التي شاهدها المستخدِمون لكلّ مستخدِم نشط ويتم احتساب مرات المشاهدة المكرّرة لصفحة أو شاشة واحدة. (screen_view + page_view events) / active users

  • scrolledUsers المستخدمون الذين تصفّحوا المحتوى عدد المستخدِمين الفريدين الذين انتقلوا إلى أسفل 90% من الصفحة على الأقل

‎2023-01-23 تمت إضافة السمتَين "القارة" و"رقم تعريف القارة".

  • continent القارة القارة التي نشأ منها نشاط المستخدِم. على سبيل المثال، Americas أو Asia.

  • continentId رقم تعريف القارة رقم التعريف الجغرافي للقارة التي نشأ منها نشاط المستخدِم، والذي يتم استخراجه من عنوان IP الخاص به.

‎2023-01-23 تمت إضافة سمة "رقم تعريف فلتر بيانات الاختبار".

  • testDataFilterId رقم تعريف فلتر بيانات الاختبار المعرّف الرقمي لأحد فلاتر البيانات في حالة الاختبار يمكنك استخدام فلاتر البيانات لتضمين بيانات الأحداث أو استثنائها من تقاريرك التي تستند إلى قيم معلّمات الأحداث. لمزيد من المعلومات، يُرجى الاطّلاع على https://support.google.com/analytics/answer/10108813.

‫18-10-2022 تمت إضافة مقاييس "إعلانات Google".

  • advertiserAdClicks النقرات على الإعلانات: إجمالي عدد المرّات التي نقر فيها المستخدِمون على إعلان للوصول إلى الموقع.
  • advertiserAdCost تكلفة الإعلانات: المبلغ الإجمالي المدفوع مقابل إعلاناتك
  • advertiserAdCostPerClick تكلفة النقرة على الإعلانات تكلفة النقرة للإعلانات هي تكلفة الإعلان مقسومة على عدد النقرات على الإعلان، وغالبًا ما يتم اختصارها إلى تكلفة النقرة (CPC).
  • advertiserAdCostPerConversion تكلفة الإحالة الناجحة: التكلفة لكلّ إحالة ناجحة هي تكلفة الإعلان مقسومة على الإحالات الناجحة.
  • advertiserAdImpressions مرّات ظهور الإعلانات: إجمالي عدد مرات الظهور
  • returnOnAdSpend عائد الإنفاق الإعلاني: عائد الإنفاق الإعلاني (ROAS) هو إجمالي الأرباح مقسومًا على تكلفة إعلان المعلِن.

‫17-10-2022 تمت إضافة مقاييس على مستوى المنتج أو الخدمة.

  • itemsAddedToCart السلع التي تمّت إضافتها إلى سلّة التسوّق عدد الوحدات التي تمّت إضافتها إلى سلّة التسوّق لسِلعة واحدة.
  • itemsCheckedOut السلع التي تمّ دفع قيمتها عدد الوحدات التي تمّ شراؤها لسِلعة واحدة.
  • itemsClickedInList السلع التي تمّ النقر عليها في القائمة عدد الوحدات التي تم النقر عليها في قائمة لسِلعة واحدة.
  • itemsClickedInPromotion السلع التي تم النقر عليها في العرض الترويجي عدد الوحدات التي تم النقر عليها في عرض ترويجي لسلعة واحدة.
  • itemsViewed السلع التي تم الاطّلاع عليها عدد الوحدات التي تمّ الاطّلاع عليها لسِلعة واحدة.
  • itemsViewedInList السلع المعروضة في القائمة عدد الوحدات التي تمّ الاطّلاع عليها في قائمة لسِلعة واحدة.
  • itemsViewedInPromotion السلع التي تمّ الاطّلاع عليها في العرض الترويجي عدد الوحدات التي تمّ الاطّلاع عليها في عرض ترويجي لسلعة واحدة.

‫13‏ أيلول (سبتمبر) 2022: إعلان عن تغييرات التوافق مع Schema

في 1 كانون الأول (ديسمبر) 2022، سيتم إجراء التغييرات الأساسية التالية:

  1. أصبحت السمات على مستوى المنتج أو الخدمة، مثل itemName، غير متوافقة مع المقاييس على مستوى الحدث، مثل eventCount. ستظلّ السمات على مستوى المنتج أو الخدمة متوافقة مع المقاييس على مستوى المنتج أو الخدمة، مثل itemRevenue، والمقاييس المستندة إلى المستخدِم، مثلactiveUsers، والمقاييس المستندة إلى الجلسة، مثلsessions.

  2. أصبحت سمات تحديد المصدر، مثل source، غير متوافقة مع بعض المقاييس على مستوى الحدث، مثل eventCount. ستظلّ سمات تحديد المصدر متوافقة مع المقاييس التي يمكن تحديد مصدرها، مثل conversions، والمقاييس المستندة إلى المستخدِم، مثلactiveUsers، والمقاييس المستندة إلى الجلسة، مثلsessions.

  3. إنّ السمات التي تتضمّن سلسلة طلب البحث، مثل pagePathPlusQueryString ، لن تكون متوافقة إلا مع مجموعة محدودة من السمات والمقاييس.

لمزيد من المعلومات، اطّلِع على الشرح التفصيلي لتغييرات التوافق.

‫01‏/09‏/2022: تغييرات في الحصة

  • Requests per day , Requests Per Minute, Requests Per Minute Per User تمّت إزالة الحصص من Data API.

  • تمت إضافة حصة Tokens Per Project Per Property Per Hour إلى واجهة برمجة التطبيقات.

  • يستهلك كل طلب الحصة لكل من Tokens Per Property Per Hour و Tokens Per Project Per Property Per Hour.

    راجِع مستندات الحصص للحصول على معلومات تفصيلية عن الحصص الجديدة.

‎03-08-2022 تمت إضافة سمات "إعلانات شبكة البحث 360" على مستوى الجلسة.

  • sessionSa360AdGroupName اسم المجموعة الإعلانية في "إعلانات شبكة البحث 360" للجلسة اسم المجموعة الإعلانية من "إعلانات شبكة البحث 360" التي أدّت إلى تسجيل هذه الجلسة.

  • sessionSa360CampaignName حملة "إعلانات شبكة البحث 360" للجلسة اسم الحملة من "إعلانات شبكة البحث 360" التي أدّت إلى هذه الجلسة.

  • sessionSa360CreativeFormat تنسيق تصميم الإعلان الخاص بالجلسة في "إعلانات شبكة البحث 360" نوع تصميم الإعلان في "إعلانات شبكة البحث 360" الذي أدّى إلى هذه الجلسة. على سبيل المثال، "إعلان متجاوب على شبكة البحث" أو "إعلان نصي موسّع".

  • sessionSa360EngineAccountId رقم تعريف حساب محرّك البحث الخاص بالجلسة في "إعلانات شبكة البحث 360" رقم تعريف حساب المحرّك في "إعلانات شبكة البحث 360" الذي أدّى إلى هذه الجلسة.

  • sessionSa360EngineAccountName اسم حساب محرّك البحث في "إعلانات شبكة البحث 360" للجلسة اسم حساب محرّك البحث في "إعلانات شبكة البحث 360" الذي أدّى إلى هذه الجلسة.

  • sessionSa360EngineAccountType نوع حساب محرّك البحث في "إعلانات شبكة البحث 360" للجلسة نوع حساب محرّك البحث في "إعلانات شبكة البحث 360" الذي أدّى إلى هذه الجلسة. على سبيل المثال، "إعلانات Google" أو "bing" أو "baidu".

  • sessionSa360Keyword نصّ الكلمة الرئيسية في "إعلانات شبكة البحث 360" للجلسة الكلمة الرئيسية لمحرّك البحث من "إعلانات شبكة البحث 360" التي أدّت إلى هذه الجلسة.

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

  • sessionSa360Query طلب البحث الخاص بالجلسة في "إعلانات شبكة البحث 360" طلب البحث من "إعلانات شبكة البحث 360" الذي أدّى إلى تسجيل هذه الجلسة.

  • sessionSa360Source مصدر الجلسة في "إعلانات شبكة البحث 360" مصدر الزيارات الواردة من "إعلانات شبكة البحث 360" التي أدّت إلى تسجيل هذه الجلسة. على سبيل المثال، "example.com" أو "google".

  • تتيح السمتَان sessionCampaignId وsessionCampaignName الآن استخدام حملات "إعلانات شبكة البحث 360".

‫11-07-2022 تمت إضافة مقاييس معدل الإحالات الناجحة.

معدل الإحالات الناجحة

  • sessionConversionRate النسبة المئوية للجلسات التي بدأ فيها أيّ حدث إحالة ناجحة.

  • userConversionRate النسبة المئوية للمستخدمين الذين بدأوا أيّ حدث إحالة ناجحة.

مقاييس معدّل الإحالات الناجحة لإحالة ناجحة واحدة

  • sessionConversionRate:event_name النسبة المئوية للجلسات التي بدأ فيها حدث إحالة ناجحة محدّد.

  • userConversionRate:event_name النسبة المئوية للمستخدمين الذين بدأوا حدث إحالة ناجحة محدّدًا.

‫05‏/05‏/2022 تمت إضافة وظيفة إعداد تقارير المسارات إلى قناة الإصدار الأولي.

‫2022-02-16 تمت إضافة سمات جديدة.

المصطلح والمحتوى اليدويان

  • firstUserManualAdContent محتوى الإعلان اليدوي للمستخدِم الجديد. محتوى الإعلان الذي اكتسب المستخدِم لأول مرّة. تتم تعبئة هذا الحقل بالمَعلمة utm_content.

  • firstUserManualTerm العبارة المُضافة يدويًا للمستخدِم الجديد. العبارة التي تمّت الاستعانة بها في اكتساب المستخدِم لأول مرّة. تتم تعبئة هذا الحقل بالمَعلمة utm_term.

  • manualAdContent محتوى الإعلان المُضاف يدويًا محتوى الإعلان المنسوب إلى حدث الإحالة الناجحة. تتم تعبئة هذا الحقل بالمَعلمة utm_content.

  • manualTerm عبارة مُضافة يدويًا. العبارة المنسوبة إلى حدث الإحالة الناجحة. تتم تعبئة هذا الحقل بالمَعلمة utm_term.

  • sessionManualAdContent محتوى الإعلان المزوَّد بعلامات مُضافة يدويًا على مستوى الجلسة محتوى الإعلان الذي أدّى إلى تسجيل جلسة تتم تعبئة هذا الحقل بالمَعلمة utm_content.

  • sessionManualTerm العبارة المُضافة يدويًا للجلسة العبارة التي أدّت إلى تسجيل جلسة تتم تعبئة هذا الحقل بالمَعلمة utm_term.

تحليل الأعطال

  • crashAffectedUsers المستخدمون المتأثرون بالأعطال عدد المستخدمين الذين سجّلوا تعطُّلاً في هذا الصف من التقرير

  • crashFreeUsersRate معدّل المستخدمين الذين لم يواجههم أي تعطُّل

التطبيقات/الويب

  • averageSessionDuration متوسّط مدّة جلسات المستخدِمين (بالثواني).

  • newVsReturning المستخدِمون الجدد / المكرّرو الزيارة

  • screenPageViewsPerSession مرّات المشاهدة لكلّ جلسة

  • landingPage الصفحة المقصودة: مسار الصفحة + سلسلة طلب البحث المرتبطَان بأول مشاهدة صفحة على الويب في إحدى الجلسات

  • platformDeviceCategory النظام الأساسي ونوع الجهاز الذي تم تشغيل موقعك الإلكتروني أو تطبيقك المتوافق مع الأجهزة الجوّالة عليه

التطبيق المتوافق مع الأجهزة الجوّالة

  • averagePurchaseRevenuePerUser متوسّط الإيرادات من عمليات الشراء لكلّ مستخدِم

  • firstTimePurchaserConversionRate النسبة المئوية للمستخدمين النشطين الذين أجروا أوّل عملية شراء لهم.

  • firstTimePurchasersPerNewUser متوسّط عدد المشترين للمرّة الأولى لكلّ مستخدم جديد.

  • dauPerMau المستخدمون النشطون يوميًا / المستخدمون النشطون شهريًا النسبة المئوية المتجدّدة للمستخدمين النشطين خلال 30 يومًا والذين هم أيضًا مستخدمون نشطون لمدة يوم واحد.

  • dauPerWau المستخدمون النشطون يوميًا / المستخدمون النشطون أسبوعيًا النسبة المئوية المتجدّدة للمستخدمين النشطين خلال 7 أيام والذين هم أيضًا مستخدمون نشطون لمدة يوم واحد.

  • wauPerMau المستخدِمون النشطون أسبوعيًا / المستخدِمون النشطون شهريًا النسبة المئوية المتجدّدة للمستخدمين النشطين خلال 30 يومًا والذين هم أيضًا مستخدمون نشطون خلال 7 أيام.

  • purchaserConversionRate النسبة المئوية للمستخدمين النشطين الذين أجروا معاملة شراء واحدة أو أكثر

  • transactionsPerPurchaser المعاملات لكل مشترٍ:

حملة على "إعلانات Google"

  • firstUserGoogleAdsCampaignType نوع حملة "إعلانات Google" التي اكتسبت المستخدِم لأول مرة.

  • googleAdsCampaignType نوع حملة "إعلانات Google" المنسوبة إلى حدث الإحالة الناجحة.

  • sessionGoogleAdsCampaignType نوع حملة "إعلانات Google" التي أدّت إلى تسجيل هذه الجلسة.

‫07‏/09‏/2021: تمت إضافة سمات جديدة للتاريخ/الوقت.

  • dateHourMinute القيم المجمّعة للتاريخ والساعة والدقيقة منسَّقة بالتنسيق YYYYMMDDHHMM.

  • minute الدقيقة المؤلّفة من رقمَين للساعة التي تم تسجيل الحدث فيها.

  • nthMinute عدد الدقائق التي مرّت منذ بداية النطاق الزمني

‫07‏/09‏/2021 تمت إضافة سمات جديدة يتم تعبئتها بواسطة مَعلمات الأحداث.

  • achievementId رقم تعريف الإنجاز في لعبة أثناء وقوع الحدث.

  • character شخصية اللاعب في اللعبة أثناء وقوع الحدث.

  • fileExtension امتداد الملف الذي تم تنزيله

  • fileName مسار الصفحة للملف الذي تم تنزيله.

  • groupId رقم تعريف مجموعة اللاعبين في لعبة أثناء وقوع الحدث.

  • linkClasses سمة class في رمز HTML لرابط خارجي

  • linkDomain نطاق وجهة الرابط الخارجي

  • linkId السمة id في رمز HTML لرابط خارجي أو لعملية تنزيل ملف.

  • linkText نص الرابط لعملية تنزيل الملف.

  • linkUrl عنوان URL الكامل لرابط خارجي أو لعملية تنزيل ملف.

  • method الطريقة التي تم بها تشغيل الحدث.

  • outbound تعرِض هذه الدالة القيمة "صحيح" إذا كان الرابط يؤدي إلى موقع إلكتروني ليس جزءًا من نطاق الموقع.

  • pageLocation البروتوكول واسم المضيف ومسار الصفحة وسلسلة طلب البحث للصفحات الويب التي تمت زيارتها

  • pageReferrer عنوان URL الكامل المُحيل، بما في ذلك اسم المضيف والمسار

  • percentScrolled النسبة المئوية التي تُظهِر مدى انتقال المستخدِم إلى أسفل الصفحة (على سبيل المثال، "90").

  • searchTerm العبارة التي بحث عنها المستخدم.

  • videoProvider مصدر الفيديو (مثل "youtube").

  • videoTitle عنوان الفيديو

  • videoUrl عنوان URL الخاص بالفيديو

  • visible تعرِض هذه السمة القيمة "صحيح" إذا كان المحتوى مرئيًا.

  • unifiedPagePathScreen مسار الصفحة (على الويب) أو فئة الشاشة (في التطبيق) التي تم تسجيل الحدث عليها.

‫07‏/09‏/2021: تغييرات على مخطّط واجهة برمجة التطبيقات

التغييرات في السمات الحالية:

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

إشعار بالتغييرات القادمة:

  • firstUserTrafficOrigin نقطة انطلاق عدد الزيارات التي اكتسبت المستخدم لأول مرة. يُرجى عدم الاعتماد على عرض هذا الحقل للقيمة "يدوي" للزيارات التي تستخدِم علامات Universal Analytics، لأنّه سيتم تعديل هذا الحقل من عرض القيمة "يدوي" إلى عرض القيمة "(not set)" لإطلاق ميزة قادمة.

  • sessionTrafficOrigin نقطة انطلاق عدد الزيارات لحملة الجلسة. يُرجى عدم الاعتماد على عرض هذا الحقل للقيمة "يدوي" للزيارات التي تستخدِم علامات Universal Analytics، لأنّه سيتم تعديل هذا الحقل من عرض القيمة "يدوي" إلى عرض القيمة "(not set)" لإطلاق ميزة قادمة.

  • trafficOrigin مصدر الزيارات لحملة حدث الإحالة الناجحة. يُرجى عدم الاعتماد على عرض هذا الحقل للقيمة "يدوي" للزيارات التي تستخدِم علامات Universal Analytics، لأنّه سيتم تعديل هذا الحقل من عرض القيمة "يدوي" إلى عرض القيمة "(not set)" لإطلاق ميزة قادمة.

‫07‏-09‏-2021: تمت إضافة طريقة checkCompatibility إلى واجهة برمجة التطبيقات.

تعرض السمات والمقاييس التي يمكن إضافتها إلى طلب تقرير مع الحفاظ على التوافق في checkCompatibility method.

‫21-07-2021 تغييرات في تقارير "الوقت الفعلي"

أصبح من الممكن الآن تحديد النطاقات الزمنية بالدقائق لبيانات الأحداث المطلوب قراءتها باستخدام المَعلمة minuteRanges لطريقة runRealtimeReport.

‫2021-07-21 سمات جديدة لتصنيف القنوات إلى مجموعات

سمات جديدة لتصنيف القنوات إلى مجموعات تمت إضافتها إلى مخطّط إعداد تقارير Data API:

  • firstUserDefaultChannelGrouping التصنيف التلقائي للقنوات إلى مجموعات للمستخدِم الجديد

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

التغييرات في مخطّط واجهة برمجة التطبيقات بتاريخ 10‏-06‏-2021

  • تمّت إضافة سمة minutesAgo إلى مخطّط الوقت الفعلي لواجهة برمجة التطبيقات Data API ويمكن استخدامها في طلبات البحث التي تُرسَل إلى طريقة runRealtimeReport. تحتوي هذه السمة على عدد الدقائق التي مضت منذ جمع حدث. يشير الرقم 00 إلى الدقيقة الحالية، ويشير الرقم 01 إلى الدقيقة السابقة.

  • تمّت إضافة سمة googleAdsCreativeId إلى مخطّط Data API. تحتوي هذه السمة على رقم تعريف تصميم الإعلان في "إعلانات Google" المنسوب إلى حدث الإحالة الناجحة.

  • تمّت إضافة سمة sessionGoogleAdsCreativeId إلى مخطّط Data API. تحتوي هذه السمة على رقم تعريف تصميم الإعلان في "إعلانات Google" الذي يؤدّي إلى تسجيل جلسة على موقعك الإلكتروني أو تطبيقك.

  • تمت إعادة تسمية سمة firstUserCreativeId إلى firstUserGoogleAdsCreativeId في مخطّط Data API. تحتوي هذه السمة على رقم تعريف ملفّ العمل الفني على "إعلانات Google" الذي اكتسب المستخدِم للمرّة الأولى.

‫09‏-04‏-2021: تم إصدار الإصدار التجريبي من Google Analytics Data API‏ 1.

  • تم تعديل نقطة نهاية واجهة برمجة التطبيقات إلى https://analyticsdata.googleapis.com/v1beta.

  • تقبل طُرق runReport وrunPivotReport وbatchRunReports وbatchRunPivotReports الآن رقم تعريف موقع على "إحصاءات Google‏ 4" في المَعلمة property لمسار عنوان URL بدلاً من الحقل entity في محتوى الطلب:

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports
    
  • تم تعديل مكتبات عملاء واجهة برمجة التطبيقات لاستخدام نقطة نهاية واجهة برمجة التطبيقات الجديدة.

‫2021-02-19 تغييرات في تقسيم الصفحات

  • تمّ زيادة حجم الاستجابة التلقائية للتقارير من 10 إلى 10,000 صف من بيانات الأحداث.

  • لم تعُد قيمة "limit" : -1 التي تم استخدامها للإشارة إلى محاولة استرداد كل الصفوف متاحة في RunReportRequest.

  • تم ضبط الحد الأقصى لقيمة حقل limit على 100000. استخدِم الفهرسة لاسترداد التقارير التي تحتوي على أكثر من 100,000 صف.

‎02-08-2021 سمات ومقاييس جديدة للتجارة الإلكترونية

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

السمات: adFormat وadSourceName وadUnitName وitemBrand itemCategory وitemCategory2 وitemCategory3 وitemCategory4 itemCategory5 itemId وitemListId وitemListName وitemName itemPromotionCreativeName وitemPromotionId وitemPromotionName orderCoupon وtransactionId

المقاييس: adUnitExposure وaddToCarts وcartToViewRate وcheckouts ecommercePurchases وfirstTimePurchasers وitemListClickThroughRate itemListClicks وitemListViews وitemPromotionClickThroughRate itemPromotionClicks وitemPromotionViews وitemPurchaseQuantity itemRevenue وitemViews وpublisherAdClicks publisherAdImpressions وtotalPurchasers

‫08‏ شباط (فبراير) 2021: تمت إضافة سمات حملة جديدة.

تمت إضافة سمات حملة جديدة إلى مخطّط واجهة برمجة التطبيقات: campaignId وcampaignName وgoogleAdsAccountName googleAdsAdGroupId وgoogleAdsAdGroupName وgoogleAdsAdNetworkType source وtrafficOrigin

‎02-08-2021 تغييرات في السمتَين dayOfWeek وweek

  • تبدأ قيمة سمة dayOfWeek الآن بالرقم 0 بدلاً من الرقم 1.

  • تبدأ قيمة سمة week الآن بالرقم 01 وتُعرِض عددًا مكوّنًا من رقمَين من 01 إلى 53. يبدأ كل أسبوع يوم الأحد. يكون 1 كانون الثاني (يناير) دائمًا في الأسبوع 01.

‎2021-01-28 تمت إضافة صيغ تجميع للمقاييس المخصّصة.

ينشئ كل مقياس مخصّص يسجّله موقع ثلاثة صيغ لمقياس واجهة برمجة التطبيقات: مجموع ومتوسط وعدد.

‎2021-01-28 تمت إضافة سمات جديدة للتاريخ/الوقت.

تمت إضافة السمات الجديدة التالية إلى مخطّط واجهة برمجة التطبيقات: hour وnthHour وnthYear وdateHour.

‫2021-01-28 خفضت واجهة Data API عدد الرموز المميّزة للحصة التي يتم تحصيل رسومها مقابل كل طلب بحث.

خفضت واجهة برمجة التطبيقات Data API عدد الرموز المميّزة للحصة التي يتم تحصيل رسومها مقابل كل طلب بحث. لم يتم تغيير حدود الحصة لرموزها الحصة على مستوى الموقع الإلكتروني في الساعة وفي اليوم.

‎09-11-2020 تم حذف الطريقة getUniversalMetadata.

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

‫02‏-11‏-2020 تمت إضافة طريقة إعداد تقارير في الوقت الفعلي.

اطّلِع على إنشاء تقرير في الوقت الفعلي للحصول على أمثلة وrunRealtimeReport للحصول على مستندات مرجعية لـ REST.

‫19-10-2020 تم تعديل عناصر مكتبة العميل.

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

‫13-10-2020 تمت إعادة تسمية مواقع "التطبيقات + المواقع الإلكترونية" إلى "إحصاءات Google‏ 4".

‫08-10-2020 تمت إضافة طريقة getMetadata إلى واجهة برمجة التطبيقات.

تُرجِع طريقة getMetadata السمات والمقاييس المخصّصة المتوفّرة لرقم تعريف موقع "إحصاءات Google‏ 4" المحدّد، بالإضافة إلى البيانات الوصفية الشاملة.

‫08-10-2020 تتوفّر السمات والمقاييس المخصّصة في التقارير.

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