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

自 2022 年 12 月 1 日起，我們將實施下列破壞性變更：

  1. source 等歸因維度與部分事件範圍指標 (例如 eventCount) 不相容。歸因維度仍與可歸因的指標 (例如 conversions)、以使用者為基礎的指標 (例如 activeUsers) 和以工作階段為基礎的指標 (例如 sessions) 相容。

  2. 包含查詢字串 (例如 pagePathPlusQueryString) 的維度僅與一組有限的維度和metrics相容。

下列變更原本已排定於 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 (分析) UI (GA4) 中的預設報表，則無須採取任何行動。這些報表會自動遷移。

  • 如果您使用 Google Analytics (分析) UI (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、publisherAdImpressions、publisherAdImpressions{18/、publisherAdClickspurchaseRevenuescreenPageViewsscreenPageViewsPerSessionshippingAmounttaxAmounttransactionstransactionsPerPurchaseruserEngagementDuration

以事件為範圍的指標與歸因維度不相容

與歸因維度不相容的以事件為範圍指標包括：eventCount、adUnitExposure、addToCarts、averagePurchaseRevenue、checkouts、ecommercePurchases、eventCountPerUser、eventsPerSession、firstTimePurchasersPerNewUser、itemListClicks、itemListViews、itemPromotionClicks、itemPromotionViews、itemViews、newUsers、publisherAdClicks、publisherAdImpressions、screenPageViewsPerSession、screenPageViewsPerSession、screenPageViewsPerSession、screenPageViewsPerSession、checkouts、ecommercePurchases、screenPageViewsshippingAmounttaxAmounttransactionstransactionsPerPurchaseruserEngagementDuration

商品範圍指標

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