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

2022 年 12 月 1 日に、以下の互換性のない変更が行われます。

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

  2. pagePathPlusQueryString などのクエリ文字列を含むディメンションは、一部のディメンションと指標との組み合わせでのみ使用できます。

以下の変更は当初 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 アナリティクスの管理画面（GA4）のデフォルト レポートのみを使用している場合は、対応は必要ありません。これらのレポートは自動的に移行されます。

  • 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、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 があります。