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

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

‫15‏ تشرين الأول (أكتوبر) 2024 تمت إضافة ميزة مستوى جمع العينات إلى طريقة reportTasks

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • المصدر والوسيط الخاصَان بالجلسة في "مدير الحملة 360" (sessionCm360SourceMedium)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • 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" للمستخدِم الجديد

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

08-11-2023 تمت إضافة ميزة تصدير قائمة المستخدمين إلى ميزة "جداول بيانات Google" إلى الإصدار الأول من Data API.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

في 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" الذي أدّى إلى تسجيل هذه الجلسة. على سبيل المثال، "إعلان متجاوب على شبكة البحث" أو "إعلان نصي موسّع".

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • dauPerWau المستخدمون النشطون يوميًا / المستخدمون النشطون أسبوعيًا يشير ذلك إلى النسبة المئوية المتزايدة للمستخدمين النشطين خلال 7 أيام والذين هم أيضًا مستخدمون نشطون لمدة يوم واحد.

  • wauPerMau المستخدمون النشطون أسبوعيًا (WAU)/المستخدمون النشطون شهريًا (MAU) النسبة المئوية المتجدّدة للمستخدمين النشطين خلال 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 سمة معرّف 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 مصدر الزيارات الذي اكتسبت المستخدم لأوّل مرة. يُرجى عدم الاعتماد على عرض هذا الحقل للقيمة "يدوي" للزيارات التي تستخدِم علامات Universal Analytics‏ (UTM). سيتم تعديل هذا الحقل من عرض القيمة "يدوي" إلى عرض القيمة "(not set)" لإطلاق ميزة قادمة.

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

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

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

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

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

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

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

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

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

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

تم إجراء تغييرات على مخطّط واجهة برمجة التطبيقات في 2021-06-10.

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

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

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

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

2021-04-09 تم إطلاق الإصدار التجريبي من 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

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

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

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

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

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

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

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

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

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

2021-02-08 تمت إضافة سمات جديدة للحملة.

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

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

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

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

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

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

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

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

‫28‏ كانون الثاني (يناير) 2021: خفّضت Data API الرموز المميّزة للحصة التي يتم تحصيل رسومها مقابل كل طلب بحث.

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

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

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

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

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

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

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

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

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

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

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

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