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

لتلقّي إشعارات رسمية حول واجهة برمجة تطبيقات "إحصاءات Google"، يُرجى الاشتراك في مجموعة إشعارات واجهة برمجة تطبيقات "إحصاءات Google".

25-03-2024 تمت إضافة سمات مرتبطة بمجموعة القنوات الأساسية ومصدر الزيارات اليدوية والدمج.

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

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

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

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

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

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

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

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

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

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

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

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

  • manualMedium وسيط يدوي

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

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

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

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

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

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

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

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

  • مصدر يدوي واحد (firstUserManualSource) للمستخدم الجديد

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

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

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

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

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

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

  • الوسيط اليدوي لجلسة واحدة (sessionManualMedium)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • مصدر واحد (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"

  • اسم حساب "مدير الحملة 360" للجلسة واحد (sessionCm360AccountName)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • مصدر واحد (sessionCm360Source) للجلسة في "مدير الحملة 360"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • رقم تعريف تبادل واحد (sessionDv360ExchangeId) للجلسة في "مساحة العرض والفيديو 360"

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

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

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

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

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

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

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

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

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

  • مصدر أو وسيط واحد (sessionDv360SourceMedium) للجلسة في "مساحة العرض والفيديو 360"

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2023-12-05 تتوفّر قوائم المستخدِمين في الإصدار التجريبي 1 من Data API ضمن عمليات "تصدير البيانات إلى الجمهور".

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

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

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

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

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

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

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

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

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

13-10-2023: تمّت إضافة الدعم لشرائح الجمهور بمدة عضوية تبلغ يوم واحد.

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

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

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

قبل إجراء هذا التغيير، ربما تكون قد تلقيت التقرير التالي:

deviceId isAdsPersonalizationAllowed
ABC صحيح
DAC false
ABC false
AAA صحيح

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

deviceId isAdsPersonalizationAllowed
AAA صحيح
ABC false
ABC صحيح
DAC false

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

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

    لمزيد من المعلومات، راجع سمات قائمة المستخدمين.

2023-08-15 تمت إضافة سمة "currencyCode"، ومقياس "itemDiscountAmount"

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

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

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

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

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

    لمزيد من المعلومات، راجع سمات قائمة المستخدمين.

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

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

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

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

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

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

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

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

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

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

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

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

اسم الحصة الحد القديم الحد الجديد
الرموز المميّزة الأساسية لكل موقع في اليوم 250000 2,000,000
الرموز المميّزة الأساسية لكل موقع في الساعة 50,000 400,000
الرموز المميّزة الأساسية لكل مشروع لكل موقع في الساعة 17500 140,000
الرموز المميّزة في الوقت الفعلي لكل موقع في اليوم 250000 2,000,000
الرموز المميّزة في الوقت الفعلي لكل موقع في الساعة 50,000 400,000
الرموز المميّزة في الوقت الفعلي لكل مشروع لكل موقع في الساعة 17500 140,000
الرموز المميّزة لمسار الإحالة الناجحة لكلّ موقع في اليوم 250000 2,000,000
الرموز المميّزة لمسار الإحالة الناجحة لكلّ موقع في الساعة 50,000 400,000
الرموز المميّزة لمسار الإحالة الناجحة لكلّ مشروع لكلّ موقع في الساعة 17500 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-2023 تمت إضافة سمات التجارة الإلكترونية.

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

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

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

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

  • 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 الخاص بجهاز المستخدم.

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

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

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

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

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

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

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

2022-09-01: تغييرات في الحصة

  • تتم إزالة نسبتَي الحصص Requests per day وRequests Per Minute وRequests Per Minute Per User من Data API.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • sessionCampaignId، sessionCampaignName تتوافق الآن السمات مع الحملات على "إعلانات شبكة البحث 360".

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

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

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

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

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

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

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

05-05-2022 تمت إضافة وظيفة إعداد تقارير مسارات الإحالات الناجحة إلى قناة الإصدار الأولي.

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 المستخدمون النشطون يوميًا (DAU)/المستخدمون النشطون شهريًا (MAU) النسبة المئوية المتحرّكة للمستخدمين النشطين خلال 30 يومًا والذين هم أيضًا مستخدمون نشطون خلال يوم واحد.

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

  • wauPerMau المستخدمون النشطون أسبوعيًا (WAU)/المستخدمون النشطون شهريًا (MAU) النسبة المئوية المتحرّكة للمستخدمين النشطين خلال 30 يومًا والذين هم أيضًا مستخدمون نشطون خلال 7 أيام.

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

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

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

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

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

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

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

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

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

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

2021-09-07 تمت إضافة سمات جديدة مليئة بمَعلمات الأحداث.

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

  • character شخصية اللاعب في لعبة ضمن حدث.

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

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

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

  • linkClasses سمة فئة HTML لرابط خارجي.

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

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

  • linkText تمثّل هذه السمة نص الرابط الخاص بتنزيل الملف.

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

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

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

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

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

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

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

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

  • videoTitle: تحدّد هذه السمة عنوان الفيديو.

  • videoUrl: تشير هذه السمة إلى عنوان URL للفيديو.

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

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

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

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

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

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

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

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

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

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

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

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 تم إطلاق الإصدار التجريبي 1 من Data API على "إحصاءات Google".

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

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

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

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

2021-02-08 dayOfWeek، تغييرات في البُعد week.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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