スキーマの互換性の変更に関するお知らせ。

2022 年 12 月 1 日より、以下の重要な変更が行われます。

  1. source などのアトリビューション ディメンションは、eventCount などの一部のイベント スコープの指標と互換性がありません。アトリビューション ディメンションは、conversions などのアトリビューション可能な指標、activeUsers などのユーザーベースの指標、sessions などのセッション ベースの指標と引き続き互換性があります。

  2. pagePathPlusQueryString のようなクエリ文字列を含むディメンションは、一部のディメンションとmetricsにのみ対応しています。

当初は 2022 年 12 月 1 日に以下の変更を行う予定でしたが、ただし、アイテム スコープのディメンションに対する変更は、2023 年初頭の後日に適用されます。

  1. itemName などのアイテム スコープのディメンションは、eventCount などのイベント スコープの指標と互換性がなくなります。アイテム スコープのディメンションは、itemRevenue などのアイテム スコープの指標、activeUsers などのユーザーベースの指標、sessions などのセッション ベースの指標と引き続き互換性があります。

また、Google アナリティクスでは次の指標の名前も変更されます。

現在の API 名 今後の API 名
itemListClicks itemListClickEvents
itemListViews itemListViewEvents
itemPromotionClicks promotionClicks
itemPromotionViews promotionViews
itemViews itemViewEvents
itemPurchaseQuantity itemsPurchased

必要な対応

  • Google アナリティクス管理画面のデフォルトのレポートのみを使用している場合は、特にご対応いただく必要はありません。これらのレポートは自動的に移行されます。

  • Google アナリティクス UI（GA4）でデータ探索やカスタム レポートを使用している場合は、互換性のあるフィールドのみが使用されるように、保存済みのデータ探索とレポートを更新します。

  • Google アナリティクス 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、{1,2}、purchaseRevenue、purchaseRevenue、purchaseRevenuepublisherAdImpressionsscreenPageViewsscreenPageViewsPerSessionshippingAmounttaxAmounttransactionstransactionsPerPurchaseruserEngagementDuration

イベント スコープの指標はアトリビューション ディメンションに対応していません

アトリビューション ディメンションと互換性がなくなるイベント スコープの指標: eventCount、adUnitExposure、addToCarts、averagePurchaseRevenue、checkouts、ecommercePurchases、eventCountPerUser、eventsPerSession、firstTimePurchasersPerNewUser、itemListClicks、itemListViews、itemPromotionClicks、itemPromotionViews、itemViews、newUsers、publisherAdClicks、publisherAdImpressions、screenPageViews、addToCarts、addToCarts、addToCarts、screenPageViewsPerSession、screenPageViewsPerSessionshippingAmounttaxAmounttransactionstransactionsPerPurchaseruserEngagementDuration

アイテム スコープの指標

アイテム スコープの指標には、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 があります。