سرور MCP را برای Google Analytics امتحان کنید. از
GitHub نصب کنید و برای جزئیات بیشتر به
اطلاعیه مراجعه کنید.
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
اعلام تغییرات سازگاری طرحواره.
در 1 دسامبر 2022 ، تغییرات شکسته زیر رخ خواهد داد:
ابعاد انتساب مانند source با برخی از معیارهای محدوده رویداد مانند eventCount ناسازگار می شود. ابعاد اسناد همچنان با معیارهای قابل انتساب مانند conversions ، معیارهای مبتنی بر کاربر مانند activeUsers و معیارهای مبتنی بر جلسه مانند sessions سازگار خواهد بود.
ابعادی که شامل رشته جستجو مانند pagePathPlusQueryString هستند فقط با مجموعه محدودی از ابعاد و معیارها سازگار خواهند بود.
تغییرات زیر در ابتدا برای 1 دسامبر 2022 برنامه ریزی شده بود. با این حال، تغییرات در ابعاد آیتم در تاریخ بعدی در اوایل سال 2023 رخ خواهد داد.
- ابعاد با محدوده مورد مانند
itemName با معیارهای محدوده رویداد مانند eventCount ناسازگار می‌شوند. ابعاد محدوده مورد همچنان با معیارهای محدوده مورد مانند itemRevenue ، معیارهای مبتنی بر کاربر مانند activeUsers و معیارهای مبتنی بر جلسه مانند sessions سازگار خواهد بود.
علاوه بر این، Google Analytics در حال تغییر نام معیارهای زیر است:
| نام API فعلی | نام API آینده |
|---|
| itemListClicks | itemListClickEvents |
| itemListViews | itemListViewEvents |
| itemPromotionClicks | تبلیغات کلیک |
| itemPromotionViews | promotionViews |
| itemViews | itemViewEvents |
| مورد خرید مقدار | اقلام خریداری شده |
اقدامات مورد نیاز
اگر فقط به گزارش‌های پیش‌فرض در رابط کاربری Google Analytics (GA4) تکیه می‌کنید، هیچ اقدامی لازم نیست. این گزارش ها به صورت خودکار منتقل می شوند.
اگر از کاوش‌ها یا گزارش‌های سفارشی در رابط کاربری Google Analytics (GA4) استفاده می‌کنید، کاوش‌ها و گزارش‌های ذخیره‌شده را به‌روزرسانی کنید تا فقط از فیلدهای سازگار استفاده کنید.
اگر با استفاده از Google Analytics Data API v1 گزارش‌های سفارشی ایجاد می‌کنید، کد خود را به‌روزرسانی کنید تا تغییرات سازگاری طرحواره را منعکس کند.
ابعاد محدوده مورد
ابعاد محدوده مورد itemPromotionId از: itemAffiliation , itemBrand , itemCategory , itemCategory2 , itemCategory3 , itemCategory4 , itemCategory5 , itemId , itemListId itemName itemListName , itemPromotionCreativeName , itemPromotionName و itemVariant .
معیارهای محدوده رویداد با ابعاد محدوده مورد ناسازگار است
سنجه‌های محدوده رویداد که با ابعاد مورد نظر ناسازگار می‌شوند عبارتند از: eventCount ، adUnitExposure ، addToCarts ، averagePurchaseRevenue خرید، checkouts ، conversions ، ecommercePurchases ، eventCountPerUser ، eventValue ، eventsPerSession ، firstTimePurchasersPerNewUser itemListClicks , itemListViews , itemPromotionClicks , itemPromotionViews , itemViews , newUsers , publisherAdClicks , publisherAdImpressions taxAmount purchaseRevenue , screenPageViews , screenPageViewsPerSession shippingAmount transactions transactionsPerPurchaser و userEngagementDuration .
معیارهای محدوده رویداد با ابعاد اسناد ناسازگار است
سنجه‌های محدوده رویداد که با ابعاد انتساب ناسازگار می‌شوند عبارتند از: eventCount ، adUnitExposure ، addToCarts ، averagePurchaseRevenue خرید، checkouts ، itemListClicks ecommercePurchases ، eventCountPerUser ، eventsPerSession ، firstTimePurchasersPerNewUser itemListViews , itemPromotionClicks , itemPromotionViews , itemViews transactionsPerPurchaser newUsers userEngagementDuration publisherAdClicks , publisherAdImpressions , screenPageViews , screenPageViewsPerSession , shippingAmount transactions taxAmount .
معیارهای محدوده آیتم
معیارهای محدوده مورد عبارتند از: 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 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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`."]]
