結構定義相容性異動公告。

下列重大異動將於 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 第 1 版建立自訂報表，請更新程式碼，反映結構定義相容性變更。

以商品為範圍的維度

以項目為範圍的維度包括：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。