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

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 애널리틱스 UI (GA4)에서 기본 보고서만 사용하는 경우 별도의 조치를 취하지 않아도 됩니다. 이러한 보고서는 자동으로 이전됩니다.

  • Google 애널리틱스 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, publisherAdClicks, addToCarts, addToCarts, addToCarts, addToCarts, addToCarts, addToCarts, addToCartspublisherAdImpressionspurchaseRevenuescreenPageViewsscreenPageViewsPerSessionshippingAmounttaxAmounttransactionstransactionsPerPurchaseruserEngagementDuration

기여 분석 측정기준과 호환되지 않는 이벤트 범위 측정항목

기여 분석 측정기준과 호환되지 않는 이벤트 범위 측정항목은 다음과 같습니다. eventCount, adUnitExposure, addToCarts, averagePurchaseRevenue, checkouts, ecommercePurchases, eventCountPerUser, eventsPerSession, firstTimePurchasersPerNewUser, itemListClicks, itemListViews, itemPromotionClicks, itemPromotionViews, itemViews, newUsers, publisherAdClicks, publisherAdImpressions, screenPageViews, addToCarts, addToCarts, addToCarts, addToCarts, addToCarts, addToCartsscreenPageViewsPerSessionshippingAmounttaxAmounttransactionstransactionsPerPurchaseruserEngagementDuration

상품 범위 측정항목

항목 범위 측정항목에는 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입니다.