Changelog

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • firstUserSa360Source مصدر "إعلانات شبكة البحث 360" للمستخدم الأوّل

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

‫30-01-2024 إتاحة إشعارات Webhook لقوائم المستخدِمين وقوائم المستخدِمين المتكرّرة في الإصدار الأوّلي من Data API v1.

يمكن تحديد الحقلَين 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 v1.

تمت إضافة الطرق التالية إلى الإصدار التجريبي الأول من 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 رمز مميّز للحصة أو أكثر.

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

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

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

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

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

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

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

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

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

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

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

‫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 عائد الإنفاق الإعلاني: عائد الإنفاق الإعلاني هو إجمالي الأرباح مقسومًا على تكلفة إعلانات المعلِن.

‫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 تعرض القيمة "true" إذا كان المحتوى مرئيًا.

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

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

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

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

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

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

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

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

‫07-09-2021 تمت إضافة طريقة 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 تم إصدار الإصدار التجريبي من 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 سمات ومقاييس جديدة للتجارة الإلكترونية

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

السمات: 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

‫2021-02-08 تغييرات في سمتَي 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. تمت إزالة الحد الأقصى لنطاق التاريخ البالغ عامًا واحدًا لكل طلب من واجهة برمجة التطبيقات.

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

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

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

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

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

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

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

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

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