스키마 호환성 변경사항 공지

2022년 12월 1일에 다음과 같은 중대한 변경사항이 적용됩니다.

  1. source와 같은 기여 분석 측정기준eventCount와 같은 일부 이벤트 범위 측정항목과 호환되지 않게 됩니다. 기여 분석 측정기준은 conversions와 같은 기여 분석 측정항목, activeUsers와 같은 사용자 기반 측정항목, sessions와 같은 세션 기반 측정항목과 계속 호환됩니다.

  2. pagePathPlusQueryString와 같은 쿼리 문자열이 포함된 측정기준은 제한된 측정기준측정항목과만 호환됩니다.

다음 변경사항은 원래 2022년 12월 1일에 적용될 예정이었습니다. 하지만 상품 범위 측정기준은 2023년 초에 변경될 예정입니다.

  1. itemName와 같은 상품 범위 측정기준eventCount와 같은 이벤트 범위 측정항목과 호환되지 않게 됩니다. 상품 범위 측정기준은 itemRevenue와 같은 상품 범위 측정항목, activeUsers와 같은 사용자 기반 측정항목, sessions와 같은 세션 기반 측정항목과 계속 호환됩니다.

또한 Google 애널리틱스에서는 다음 측정항목의 이름을 변경합니다.

현재 API 이름 Future API 이름
itemListClicks itemListClickEvents
itemListViews itemListViewEvents
itemPromotionClicks promotionClicks
itemPromotionViews promotionViews
itemViews itemViewEvents
itemPurchaseQuantity itemsPurchased

조치 필요

  • Google 애널리틱스 UI (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입니다.

상품 범위 측정항목

상품 범위 측정항목에는 itemRevenueitemPurchaseQuantity가 포함됩니다.

사용자 기반 측정항목

사용자 기반 측정항목에는 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입니다.