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

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

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

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

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

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

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

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

تمّت إضافة إمكانية استرداد البيانات من تقرير أداء الإحالات الناجحة باستخدام الطريقة runReport في الإصدار الأوّلي من Data API الإصدار 1. يتيح لك ذلك الوصول إلى بيانات الإحالات الناجحة نفسها المتوفّرة في واجهة مستخدم "إحصاءات 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 الإصدار 1 التجريبي لإتاحة الحقل comparisons الذي يحدّد، عند تضمينه، إعدادات المقارنات المطلوبة.

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

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

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

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

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

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

تمت إضافة طرق تعديل مهام التقارير التالية إلى الإصدار الأوّلي من 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" (CM360):

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

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

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

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

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

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

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

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

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

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

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

  • 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، ستعرض عمليات تصدير شرائح الجمهور رقم تعريف المستخدم المحدّد في وضع العلامات.

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

‫30-01-2024 إتاحة إشعارات Webhook لقوائم المستخدمين وقوائم المستخدمين المتكرّرة في الإصدار الأوّلي 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

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

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

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

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

‫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 قواعد الترتيب التلقائي لقوائم المستخدمين

تتّبع التقارير التي يتم إنشاؤها باستخدام وظيفة تصدير قوائم المستخدِمين تلقائيًا قواعد الترتيب نفسها المتّبعة في طرق إعداد التقارير الأخرى في 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 الإصدار 1. تتضمّن قوائم المستخدِمين لقطة للمستخدِمين في شريحة الجمهور في وقت إنشاء قائمة المستخدِمين.

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

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

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

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

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

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

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

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

اسم الحصة الحدّ القديم حدّ جديد
الرموز المميزة الأساسية لكل موقع في اليوم 25,000 200,000
رموز Core Tokens لكل موقع في الساعة 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
رموز Core Tokens لكل موقع في الساعة 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 تكلفة النقرة على الإعلانات: تكلفة النقرة للإعلانات هي تكلفة الإعلان مقسومة على عدد النقرات على الإعلان، ويتم اختصارها غالبًا إلى "تكلفة النقرة".
  • advertiserAdCostPerConversion تكلفة الإحالة الناجحة: تكلفة الإحالة الناجحة هي تكلفة الإعلان مقسومة على عدد الإحالات الناجحة.
  • advertiserAdImpressions مرّات ظهور الإعلانات إجمالي عدد مرّات الظهور
  • returnOnAdSpend عائد الإنفاق الإعلاني: عائد الإنفاق الإعلاني (ROAS) هو إجمالي الإيرادات مقسومًا على تكلفة إعلانات المعلِن.

‫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، ستكون متوافقة فقط مع مجموعة محدودة من السمات والمقاييس.

‫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" التي أدّت إلى هذه الجلسة. على سبيل المثال، 'cpc'.

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

‫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 مصدر الزيارات الذي اكتسب المستخدِم للمرّة الأولى. يُرجى عدم الاعتماد على عرض الحقل للقيمة "يدوي" في ما يتعلّق بنسبة الزيارات التي تستخدم معلَمات نظام مراقبة الزيارات من Urchin (UTM)، إذ سيتم تعديل هذا الحقل من عرض القيمة "يدوي" إلى عرض القيمة "(not set)" عند إطلاق ميزة قادمة.

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

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

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

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

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

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

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

تمّت إضافة سمات جديدة لتصنيف القنوات إلى مجموعات إلى مخطّط إعداد التقارير في 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 تم إصدار الإصدار التجريبي من الإصدار 1 من Google Analytics Data API.

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

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

السمات: 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 تمت إضافة سمات جديدة للتاريخ/الوقت.

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

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

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

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

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

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

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

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

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

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

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

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

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

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