جرِّب خادم MCP لخدمة "إحصاءات Google". يمكنك تثبيت التطبيق من
GitHub والاطّلاع على
الإعلان لمعرفة المزيد من التفاصيل.
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إعلان عن تغييرات التوافق مع المخطط
في 1 كانون الأول (ديسمبر) 2022، سيتم إجراء التغييرات الأساسية التالية:
سمات تحديد المصدر مثل source
أصبحت غير متوافقة مع بعض
المقاييس على مستوى الحدث
مثل eventCount. ستظلّ سمات تحديد المصدر
متوافقة مع المقاييس التي يمكن تحديد مصدرها مثل
conversions والمقاييس المستندة إلى المستخدِم
مثل activeUsers والمقاييس المستندة إلى الجلسة مثل
sessions.
إنّ السمات التي تتضمّن سلسلة طلب البحث مثل pagePathPlusQueryString لن تكون متوافقة إلا مع مجموعة محدودة من السمات
والمقاييس.
كان من المقرر تطبيق التغييرات التالية في 1 كانون الأول (ديسمبر) 2022.
ومع ذلك، سيتم إجراء التغييرات على السمات على مستوى السلع في وقت لاحق في أوائل عام 2023.
- السمات على مستوى المنتج أو الخدمة
مثل
itemName أصبحت غير متوافقة مع
المقاييس على مستوى الحدث
مثل eventCount. ستظلّ السمات على مستوى المنتج أو الخدمة
متوافقة مع المقاييس على مستوى المنتج أو الخدمة مثل
itemRevenue والمقاييس المستندة إلى المستخدِم مثل
activeUsers والمقاييس المستندة إلى الجلسة مثل
sessions.
بالإضافة إلى ذلك، ستعيد "إحصاءات Google" تسمية المقاييس التالية:
| اسم واجهة برمجة التطبيقات الحالي |
اسم واجهة برمجة التطبيقات المستقبلية |
| itemListClicks |
itemListClickEvents |
| itemListViews |
itemListViewEvents |
| itemPromotionClicks |
promotionClicks |
| itemPromotionViews |
promotionViews |
| itemViews |
itemViewEvents |
| itemPurchaseQuantity |
itemsPurchased |
الإجراءات المطلوبة
إذا كنت تعتمد فقط على التقارير التلقائية في واجهة مستخدِم "إحصاءات Google 4"،
ليس عليك اتّخاذ أيّ إجراء. وسيتم نقل بيانات هذه التقارير تلقائيًا.
إذا كنت تستخدِم الاستكشافات أو التقارير المخصّصة في واجهة مستخدِم "إحصاءات Google"
(إحصاءات Google 4)، عدِّل الاستكشافات والتقارير المحفوظة لاستخدام الحقول
المتوافقة فقط.
إذا كنت تنشئ تقارير مخصّصة باستخدام الإصدار 1 من Google Analytics Data API،
عدِّل الرمز البرمجي لتعكس التغييرات في توافق المخطّط.
السمات على مستوى المنتج أو الخدمة
تشمل السمات على مستوى المنتج أو الخدمة ما يلي: itemAffiliation وitemBrand وitemCategory
itemCategory2 وitemCategory3 وitemCategory4 وitemCategory5 وitemId
itemListId وitemListName وitemName وitemPromotionCreativeName
itemPromotionId وitemPromotionName وitemVariant.
المقاييس على مستوى الحدث غير متوافقة مع السمات على مستوى المنتج أو الخدمة
في ما يلي المقاييس على مستوى الحدث التي أصبحت غير متوافقة مع السمات على مستوى المنتج أو الخدمة: eventCount وadUnitExposure وaddToCarts
وaveragePurchaseRevenue وcheckouts وconversions وecommercePurchases
وeventCountPerUser وeventValue وeventsPerSession
وfirstTimePurchasersPerNewUser وitemListClicks وitemListViews
وitemPromotionClicks وitemPromotionViews وitemViews وnewUsers
وpublisherAdClicks وpublisherAdImpressions وpurchaseRevenue
وscreenPageViews وscreenPageViewsPerSession وshippingAmount وtaxAmount
وtransactions وtransactionsPerPurchaser وuserEngagementDuration.
المقاييس على مستوى الحدث غير متوافقة مع سمات تحديد المصدر
في ما يلي المقاييس على مستوى الحدث التي أصبحت غير متوافقة مع سمات تحديد المصدر: eventCount وadUnitExposure وaddToCarts
وaveragePurchaseRevenue وcheckouts وecommercePurchases
وeventCountPerUser وeventsPerSession وfirstTimePurchasersPerNewUser
وitemListClicks وitemListViews وitemPromotionClicks وitemPromotionViews
وitemViews وnewUsers وpublisherAdClicks وpublisherAdImpressions
وscreenPageViews وscreenPageViewsPerSession وshippingAmount وtaxAmount
وtransactions وtransactionsPerPurchaser وuserEngagementDuration.
المقاييس على مستوى المنتج أو الخدمة
تشمل المقاييس على مستوى المنتج أو الخدمة: itemRevenue وitemPurchaseQuantity.
المقاييس المستندة إلى المستخدِم
تشمل المقاييس المستندة إلى المستخدِم ما يلي: activeUsers وactive1DayUsers
active28DayUsers وactive7DayUsers وtotalUsers وcartToViewRate
cohortActiveUsers وcohortTotalUsers وdauPerMau وdauPerWau
firstTimePurchaserConversionRate وfirstTimePurchasers
itemListClickThroughRate وitemPromotionClickThroughRate
purchaseToViewRate وpurchaserConversionRate وuserConversionRate
sessionsPerUser وwauPerMau.
المقاييس المستنِدة إلى الجلسات
تشمل المقاييس المستندة إلى الجلسات ما يلي: sessions وengagedSessions
sessionConversionRate وbounceRate.
سمات تحديد المصدر
تشمل سمات تحديد المصدر ما يلي: source وcampaignId وcampaignName
defaultChannelGrouping وmedium وsourcePlatform وgoogleAdsAccountName
googleAdsAdGroupId وgoogleAdsAdGroupName وgoogleAdsAdNetworkType
googleAdsCampaignId وgoogleAdsCampaignName وgoogleAdsCampaignType
googleAdsCreativeId وgoogleAdsCustomerId وgoogleAdsKeyword
googleAdsQuery.
المقاييس التي يمكن تحديد مصدرها
تشمل المقاييس التي يمكن تحديد مصدرها: conversions وeventValue وpurchaseRevenue
totalRevenue وtotalAdRevenue.
السمات المتوافقة مع سمات سلسلة طلب البحث
تشمل السمات التي ستكون متوافقة مع سمات سطر الطلب ما يلي:
pagePathPlusQueryString وunifiedPageScreen وpageLocation وfullPageUrl
hostName وpageTitle وeventName وplatform وcountryId وdate و
country.
المقاييس المتوافقة مع سمات سلسلة الطلب
تشمل المقاييس التي ستكون متوافقة مع سمات سلسلة طلب البحث ما يلي:
screenPageViews وuserEngagementDuration وeventCount وactiveUsers
conversions وtotalUsers وtotalSessions وengagedSessions.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eOn December 1st, 2022, Google Analytics 4 will introduce breaking changes to schema compatibility, affecting how certain dimensions and metrics can be combined in reports and analyses.\u003c/p\u003e\n"],["\u003cp\u003eAttribution dimensions (like source, medium, campaign) will become incompatible with some event-scoped metrics (like eventCount, addToCarts), while remaining compatible with attributable, user-based, and session-based metrics.\u003c/p\u003e\n"],["\u003cp\u003eDimensions containing query strings (like pagePathPlusQueryString) will have limited compatibility with other dimensions and metrics.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Analytics 4 is also renaming several item-related metrics for better clarity and consistency.\u003c/p\u003e\n"],["\u003cp\u003eIf you are using explorations, custom reports, or the Data API, review and update your configurations to align with these schema compatibility changes to avoid reporting issues.\u003c/p\u003e\n"]]],["Schema compatibility changes are coming to Google Analytics. Starting December 1st, 2022, attribution dimensions like `source` will be incompatible with event-scoped metrics like `eventCount`. Dimensions including query strings will only work with a limited set of dimensions and metrics. Item-scoped dimension changes will happen in early 2023, not December 1st. Several metrics will also be renamed. Users need to update custom reports and API code to ensure compatibility with the changes.\n"],null,["Schema compatibility changes announcement.\n------------------------------------------\n\nOn *December 1st 2022*, the following breaking changes will occur:\n\n1. [Attribution dimensions](#attribution_dimensions) like `source` are\n becoming incompatible with some\n [event-scoped metrics](#event-scoped_metrics_incompatible_with_attribution_dimensions)\n like `eventCount`. Attribution dimensions will still be\n compatible with [attributable metrics](#attributable_metrics) like\n `conversions`, [user-based metrics](#user-based_metrics)\n like `activeUsers`, and [session-based metrics](#session-based_metrics) like\n `sessions`.\n\n2. Dimensions that include the query string like `pagePathPlusQueryString` will\n only be compatible with a limited set of [dimensions](#dimensions_compatible_with_query_string_dimensions)\n \\& [metrics](#metrics_compatible_with_query_string_dimensions).\n\nThe following changes were originally scheduled for *December 1st 2022* .\nHowever, the changes to [Item-scoped dimensions](#item-scoped_dimensions) will\nhappen at a later date in early 2023.\n\n1. [Item-scoped dimensions](#item-scoped_dimensions) like `itemName` are becoming incompatible with [event-scoped metrics](#event-scoped_metrics_incompatible_with_item-scoped_dimensions) like `eventCount`. Item-scoped dimensions will still be compatible with [item-scoped metrics](#item_scope_metrics) like `itemRevenue`, [user-based metrics](#user-based_metrics) like `activeUsers`, and [session-based metrics](#session-based_metrics) like `sessions`.\n\nIn addition, the Google Analytics is renaming the following metrics:\n\n| Current API name | Future API name |\n|----------------------|---------------------|\n| itemListClicks | itemListClickEvents |\n| itemListViews | itemListViewEvents |\n| itemPromotionClicks | promotionClicks |\n| itemPromotionViews | promotionViews |\n| itemViews | itemViewEvents |\n| itemPurchaseQuantity | itemsPurchased |\n\n### Actions needed\n\n- If you are only relying on default reports in the Google Analytics UI (GA4),\n no action needed. These reports will be migrated automatically.\n\n- If you are using explorations or custom reports in the Google Analytics UI\n (GA4) , update the saved explorations and reports to only use the compatible\n fields.\n\n- If you are creating custom reports using the Google Analytics Data API v1,\n update your code to reflect the schema compatibility changes.\n\n### Item-scoped dimensions\n\nItem-scoped dimensions include: `itemAffiliation`, `itemBrand`, `itemCategory`,\n`itemCategory2`, `itemCategory3`, `itemCategory4`, `itemCategory5`, `itemId`,\n`itemListId`, `itemListName`, `itemName`, `itemPromotionCreativeName`,\n`itemPromotionId`, `itemPromotionName`, \\& `itemVariant`.\n\n### Event-scoped metrics incompatible with item-scoped dimensions\n\nThe event-scoped metrics that are becoming incompatible with item-scoped\ndimensions include: `eventCount`, `adUnitExposure`, `addToCarts`,\n`averagePurchaseRevenue`, `checkouts`, `conversions`, `ecommercePurchases`,\n`eventCountPerUser`, `eventValue`, `eventsPerSession`,\n`firstTimePurchasersPerNewUser`, `itemListClicks`, `itemListViews`,\n`itemPromotionClicks`, `itemPromotionViews`, `itemViews`, `newUsers`,\n`publisherAdClicks`, `publisherAdImpressions`, `purchaseRevenue`,\n`screenPageViews`, `screenPageViewsPerSession`, `shippingAmount`, `taxAmount`,\n`transactions`, `transactionsPerPurchaser` \\& `userEngagementDuration`.\n\n### Event-scoped metrics incompatible with attribution dimensions\n\nThe event-scoped metrics that are becoming incompatible with attribution\ndimensions include: `eventCount`, `adUnitExposure`, `addToCarts`,\n`averagePurchaseRevenue`, `checkouts`, `ecommercePurchases`,\n`eventCountPerUser`, `eventsPerSession`, `firstTimePurchasersPerNewUser`,\n`itemListClicks`, `itemListViews`, `itemPromotionClicks`, `itemPromotionViews`,\n`itemViews`, `newUsers`, `publisherAdClicks`, `publisherAdImpressions`,\n`screenPageViews`, `screenPageViewsPerSession`, `shippingAmount`, `taxAmount`,\n`transactions`, `transactionsPerPurchaser`, \\& `userEngagementDuration`.\n\n### Item scope metrics\n\nItem-scoped metrics include: `itemRevenue` \\& `itemPurchaseQuantity`.\n\n### User-based metrics\n\nUser-based metrics include: `activeUsers`, `active1DayUsers`,\n`active28DayUsers`, `active7DayUsers`, `totalUsers`, `cartToViewRate`,\n`cohortActiveUsers`, `cohortTotalUsers`, `dauPerMau`, `dauPerWau`,\n`firstTimePurchaserConversionRate`, `firstTimePurchasers`,\n`itemListClickThroughRate`, `itemPromotionClickThroughRate`,\n`purchaseToViewRate`, `purchaserConversionRate`, `userConversionRate`,\n`sessionsPerUser`, \\& `wauPerMau`.\n\n### Session-based metrics\n\nSession-based metrics include: `sessions`, `engagedSessions`,\n`sessionConversionRate` \\& `bounceRate`.\n\n### Attribution dimensions\n\nAttribution dimensions include: `source`, `campaignId`, `campaignName`,\n`defaultChannelGrouping`, `medium`, `sourcePlatform`, `googleAdsAccountName`,\n`googleAdsAdGroupId`, `googleAdsAdGroupName`, `googleAdsAdNetworkType`,\n`googleAdsCampaignId`, `googleAdsCampaignName`, `googleAdsCampaignType`,\n`googleAdsCreativeId`, `googleAdsCustomerId`, `googleAdsKeyword`,\n`googleAdsQuery`.\n\n### Attributable metrics\n\nAttributable metrics include: `conversions`, `eventValue`, `purchaseRevenue`,\n`totalRevenue`, \\& `totalAdRevenue`.\n\n### Dimensions compatible with query string dimensions\n\nDimensions that will be compatible with query string dimensions include:\n`pagePathPlusQueryString`, `unifiedPageScreen`, `pageLocation`, `fullPageUrl`,\n`hostName`, `pageTitle`, `eventName`, `platform`, `countryId`, `date`, and\n`country`.\n\n### Metrics compatible with query string dimensions\n\nMetrics that will be compatible with query string dimensions include:\n`screenPageViews`, `userEngagementDuration`, `eventCount`, `activeUsers`,\n`conversions`, `totalUsers`, `totalSessions`, \\& `engagedSessions`."]]
