架构兼容性变更公告。

2022 年 12 月 1 日，将发生以下重大变更：

  1. source 等归因维度与 eventCount 等事件级范围的指标变得不兼容。归因维度仍可与 conversions 等可归因指标、activeUsers 等基于用户的指标以及 sessions 等基于会话的指标搭配使用。

  2. 包含查询字符串（例如 pagePathPlusQueryString）的维度仅与一小部分维度和指标兼容。

以下变更原定于 2022 年 12 月 1 日生效。不过，商品级范围的维度的更改将于 2023 年初晚些时候进行。

  1. 商品级范围的维度（例如 itemName）将与事件级范围的指标（例如 eventCount）不兼容。商品级范围的维度仍可与 itemRevenue 等商品级范围的指标、activeUsers 等基于用户的指标以及 sessions 等基于会话的指标搭配使用。

此外，Google Analytics 还将重命名以下指标：

当前 API 名称 未来的 API 名称
itemListClicks itemListClickEvents
itemListViews itemListViewEvents
itemPromotionClicks promotionClicks
itemPromotionViews promotionViews
itemViews itemViewEvents
itemPurchaseQuantity itemsPurchased

需要采取的措施

  • 如果您仅依赖 Google Analytics 界面 (GA4) 中的默认报告，则无需执行任何操作。这些报告将自动迁移。

  • 如果您在 Google Analytics 界面 (GA4) 中使用探索或自定义报告，请更新已保存的探索和报告，以便仅使用兼容的字段。

  • 如果您使用 Google Analytics Data API v1 创建自定义报告，请更新代码以反映架构兼容性变更。

商品级范围的维度

商品级范围的维度包括：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。