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

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

‫14-09-2026 تمت إضافة ميزة طلبات البحث الحوارية في الإصدار 1 الأولي

تمت إضافة الطريقة properties.chat للتفاعل مع بيانات "إحصاءات Google" باستخدام طلبات بلغة طبيعية.

  • يقبل نص الطلب طلب بحث ومعرّف جلسة اختياري لمواصلة محادثة سابقة ومَعلمة returnPropertyQuota اختيارية.
  • تعرض الاستجابة بيانات استجابة المحادثة المنظَّمة في كائنات ResponseBlock ومعرّف الجلسة وتفاصيل حصة الرموز المميزة للسمات باستخدام PropertyChatQuota إذا تم طلبها.
  • يوفّر نطاق OAuth‏ https://www.googleapis.com/auth/analytics.chatbot.read إذن الوصول للقراءة إلى الطريقة properties.chat.

‫14-09-2026 تمت إضافة أسباب اقتطاع البيانات إلى ردود التقارير

تمت إضافة الحقل dataTruncationReasons إلى ResponseMetaData في الإصدار التجريبي 1 والإصدار الأولي 1. عند اقتطاع بيانات تقرير، سيتضمّن هذا الحقل قائمة بعناصر DataTruncationReason التي تشمل نوع الاقتطاع ورسالة وصفية والتواريخ المتأثرة.

‫23-04-2026 تمت إضافة ميزة إعداد تقارير الإحالات الناجحة في الإصدار الأوّلي 1

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

  • تمت إضافة الحقل ConversionSpec إلى RunReportRequest، ما يسمح بفلترة الإحالات الناجحة باستخدام conversionActions (أرقام تعريف إجراءات الإحالات الناجحة) واختيار AttributionModel (DATA_DRIVEN أو LAST_CLICK).
  • تمت إضافة الحقل Section إلى ResponseMetaData لتحديد ما إذا كانت البيانات في التقرير مأخوذة من التقارير العادية (SECTION_REPORT) أو تقارير الإحالات الناجحة (SECTION_ADVERTISING).

تم تعديل طريقة getMetadata في الإصدار الأوّلي من Data API v1 لتوفير معلومات عن تقارير الإحالات الناجحة:

  • تمت إضافة الحقل conversions إلى الاستجابة، الذي يعرض قائمة بكائنات ConversionMetadata التي تربط أرقام تعريف إجراءات الإحالات الناجحة بالأسماء المعروضة.
  • تمت إضافة الحقل sections إلى DimensionMetadata وMetricMetadata لتحديد ما إذا كان حقل معيّن متوافقًا مع إعداد التقارير العادية أو إعداد تقارير الإحالات الناجحة أو كليهما.

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

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

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

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

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

‫18-09-2024 تمت إضافة ميزة "لمحة عن حصص الموقع"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫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-03-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"

  • اسم الحملة في "مدير الحملة 360" المرتبط بـ cm360CampaignName

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • 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‏ (DV360):

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫28-02-2024: تُعرِض عمليات تصدير بيانات الجمهور رقم تعريف المستخدم المحدّد في وضع العلامات.

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

‫30-01-2024: إتاحة إشعارات الويب هوك لقوائم المستخدمين وقوائم المستخدمين المتكرّرة في الإصدار الأولي 1 من واجهة برمجة التطبيقات Data API

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

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

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

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

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

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

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

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

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

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

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

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

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

‫28-11-2023 تمت إضافة samplingMetadatas إلى ردّ التقرير

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

‫28-11-2023 تمت إضافة وظيفة تصدير قائمة المستخدمين المتكرّرة إلى الإصدار الأولي من Data API v1

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

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

‫13-10-2023 تمت إضافة إمكانية استخدام شرائح الجمهور التي تبلغ مدة عضويتها يومًا واحدًا

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

‫12-09-2023 قواعد الترتيب التلقائية في 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.

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

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

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

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

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

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

‫11-05-2023 تغييرات في حصة الرموز المميّزة

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

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

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

المواقع العادية

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

مواقع "إحصاءات 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫13-09-2022: الإعلان عن تغييرات في توافق المخطّطات

في 1 ديسمبر 2022، سيتم إجراء التغييرات التالية التي قد تؤدي إلى عطل:

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

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

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

‫1-9-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.

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

‫2022-08-03 تمت إضافة سمات "إعلانات شبكة البحث 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 تمت إضافة وظيفة إعداد تقارير مسارات الإحالة الناجحة إلى قناة الإصدار الأوّلي.

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

العبارات والمحتوى اليدوي

  • 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 عدد الدقائق التي مرّت منذ بداية النطاق الزمني.

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

  • ‫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 مسار الصفحة (الويب) أو فئة الشاشة (التطبيق) التي تم تسجيل الحدث فيها

تغييرات في مخطط واجهة برمجة التطبيقات (API) بتاريخ ‎2021-09-07

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

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

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

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

  • sessionTrafficOrigin مصدر الزيارات لحملة الجلسة يُرجى عدم الاعتماد على عرض هذا الحقل للقيمة "يدوي" للزيارات التي تستخدم وحدات تتبُّع نظام مراقبة الزيارات من Urchin (UTM)، حيث سيتم تعديل هذا الحقل من عرض القيمة "يدوي" إلى عرض القيمة "(not set)" لإطلاق ميزة قادمة.

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

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

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

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

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

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

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

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

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

تغييرات في مخطط واجهة برمجة التطبيقات (API) بتاريخ ‎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 v1.

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

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

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

  • تم تعديل مكتبات عملاء واجهة برمجة التطبيقات لاستخدام نقطة النهاية الجديدة لواجهة برمجة التطبيقات.

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

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

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

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

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

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

السمات: 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-02-2021 تمت إضافة سمات جديدة للحملات.

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

‫08-02-2021: تم إجراء تغييرات على السمتَين dayOfWeek وweek.

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

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

‫28-01-2021 تمت إضافة أنواع تجميع للمقاييس المخصّصة.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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