변경 기록

Google Analytics API에 관한 공식 공지사항을 받아보려면 Google Analytics API Notify 그룹을 구독하세요.

2024년 6월 28일 '속성별 프로젝트당 클라이언트 오류' 할당량이 추가됨

이제 15분 동안 프로젝트, 속성별로 API 서버 오류가 10,000개로 제한됩니다. 여기에는 500 또는 200 이외의 코드로 응답을 반환하는 모든 요청이 포함됩니다. 이 할당량에 해당하는 오류의 예로는 호환되지 않는 측정기준 및 측정항목 조합을 사용하는 경우, 모든 인증 오류가 있습니다.

이 제한을 초과하면 15분 기간이 끝날 때까지 해당 속성에 대한 추가 API 호출이 연결된 Google Cloud 프로젝트에 대해 일시적으로 차단됩니다.

2024년 5월 14일 비교 기능 추가됨

비교를 사용하면 데이터의 하위 집합을 나란히 평가할 수 있습니다.

Data API v1beta의 핵심 보고 메서드는 comparisons 필드를 지원하도록 업데이트되었습니다. 이 필드가 포함된 경우 요청된 비교 구성을 지정합니다.

요청에서 dimensionFilter 표현식을 요청에 제공하여 기본 비교를 지정하거나 comparison 필드에 비교의 리소스 이름을 제공하여 저장된 비교를 사용할 수 있습니���.

comparisons 응답 필드 아래에 속성에 사용할 수 있는 저장된 모든 비교를 나열하도록 getMetadata 메서드가 업데이트되었습니다.

요청에 비교가 하나 이상 지정되면 응답에 각 비교를 식별하는 comparison 열이 포함됩니다.

현재 저장된 비교 항목은 Google 애널리틱스 UI를 사용해서만 만들 수 있습니다.

2024년 5월 8일 Data API v1alpha에 비동기 보고 기능인 보고서 작업이 추가되었습니다.

보고서 작업을 사용하면 장기 실행 비동기 요청을 시작하여 Google 애널리틱스 이벤트 데이터의 맞춤 보고서를 작성할 수 있습니다.

다음과 같은 보고서 작업 조작 메서드가 Data API v1alpha에 추가되었습니다.

2024년 5월 6일 주요 이벤트의 새로운 측정기준

이제 주요 이벤트의 측정기준과 측정항목을 사용할 수 있습니다.

대신 isKeyEvent 측정기준을 사용하도록 isConversionEvent 측정기준을 사용하는 보고서 요청을 수정하세요.

대신 주요 이벤트 측정항목을 사용하도록 다음 표에서 지원 중단된 측정항목을 사용하는 보고서 요청을 수정하세요.

지원 중단된 측정항목 주요 이벤트 측정항목
advertiserAdCostPerConversion advertiserAdCostPerKeyEvent
conversions keyEvents
firstTimePurchaserConversionRate firstTimePurchaserRate
purchaserConversionRate purchaserRate
sessionConversionRate sessionKeyEventRate
userConversionRate userKeyEventRate

보고서 요청에서 주요 이벤트 한 개에 대한 주요 이벤트 측정항목의 사용 방식을 유사하게 수정합니다.

properties/getMetadata 메서드의 응답은 다음과 같이 DimensionMetadata 및 MetricMetadata 객체의 주요 이벤트 측정기준 및 측정항목이 도입되었음을 반영합니다.

  • apiName, uiName, description에는 주요 이벤트 API 이름, UI 이름, 설명이 포함되어 있습니다.
  • deprecatedApiNames 반복 필드에 지원 중단된 전환 API 이름이 포함된 항목이 있습니다.

2024년 3월 25일 기본 채널 그룹, 수동 트래픽 소스 및 통합 관련 측정기준이 추가되었습니다.

기본 채널 그룹, 수동 트래픽 소스, CM360, DV360, SA360 통합별 측정기준이 Data API 스키마에 추가되었습니다.

잠재고객 측정기준:

  • audienceId 잠재고객 ID입니다. 잠재고객의 숫자 식별자입니다.

기본 채널 그룹 측정기준:

  • firstUserPrimaryChannelGroup 신규 사용자 기본 채널 그룹

  • 기본 채널 그룹 primaryChannelGroup개

  • 세션 기본 채널 그룹 sessionPrimaryChannelGroup개

수동 트래픽 소스 측정기준:

  • manualCampaignId 수동 캠페인 ID

  • manualCampaignName 수동 캠페인 이름

  • manualCreativeFormat 수동 광고 소재 형식

  • manualMarketingTactic 수동 마케팅 전략

  • manualMedium 수동 매체

  • manualSource 수동 소스

  • manualSourceMedium 수동 소스 / 매체

  • manualSourcePlatform 수동 소스 플랫폼

  • firstUserManualCampaignId 신규 사용자 수동 캠페인 ID

  • firstUserManualCampaignName 신규 사용자 수동 캠페인 이름

  • firstUserManualCreativeFormat 신규 사용자 수동 광고 소재 형식

  • firstUserManualMarketingTactic 신규 사용자 수동 마케팅 전략

  • firstUserManualMedium 신규 사용자 수동 매체

  • firstUserManualSource 신규 사용자 수동 소스

  • firstUserManualSourceMedium 신규 사용자 수동 소스 / 매체

  • firstUserManualSourcePlatform 신규 사용자 수동 소스 플랫폼

  • 세션 수동 캠페인 ID sessionManualCampaignId개

  • sessionManualCampaignName 세션 수동 캠페인 이름

  • sessionManualCreativeFormat 세션 수동 광고 소재 형식

  • sessionManualMarketingTactic 세션 수동 마케팅 전략

  • 세션 수동 매체 sessionManualMedium개

  • 세션 수동 소스 sessionManualSource개

  • 세션 수동 소스 / 매체 sessionManualSourceMedium개

  • 세션 수동 소스 플랫폼 sessionManualSourcePlatform개

Campaign Manager 360 (CM360) 통합 측정기준:

  • cm360AccountId CM360 계정 ID

  • cm360AccountName CM360 계정 이름

  • cm360AdvertiserId CM360 광고주 ID

  • cm360AdvertiserName CM360 광고주 이름

  • cm360CampaignId CM360 캠페인 ID

  • cm360CampaignName CM360 캠페인 이름

  • cm360CreativeFormat CM360 광고 소재 형식

  • CM360 광고 소재 ID cm360CreativeId개

  • cm360CreativeName CM360 광고 소재 이름

  • CM360 광고 소재 유형 cm360CreativeType개

  • cm360CreativeTypeId CM360 광고 소재 유형 ID

  • CM360 광고 소재 버전 cm360CreativeVersion개

  • cm360Medium CM360 매체

  • cm360PlacementCostStructure CM360 게재위치 비용 구조

  • cm360PlacementId CM360 게재위치 ID

  • cm360PlacementName CM360 게재위치 이름

  • cm360RenderingId CM360 렌더링 ID

  • cm360SiteId CM360 사이트 ID

  • cm360SiteName CM360 사이트 이름

  • CM360 소스 cm360Source개

  • cm360SourceMedium CM360 소스 / 매체

  • firstUserCm360AccountId 신규 사용자 CM360 계정 ID

  • firstUserCm360AccountName 신규 사용자 CM360 계정 이름

  • firstUserCm360AdvertiserId 신규 사용자 CM360 광고주 ID

  • firstUserCm360AdvertiserName 신규 사용자 CM360 광고주 이름

  • firstUserCm360CampaignId 신규 사용자 CM360 캠페인 ID

  • firstUserCm360CampaignName 신규 사용자 CM360 캠페인 이름

  • firstUserCm360CreativeFormat 신규 사용자 CM360 광고 소재 형식

  • firstUserCm360CreativeId 신규 사용자 CM360 광고 소재 ID

  • firstUserCm360CreativeName 신규 사용자 CM360 광고 소재 이름

  • firstUserCm360CreativeType 신규 사용자 CM360 광고 소재 유형

  • firstUserCm360CreativeTypeId 신규 사용자 CM360 광고 소재 유형 ID

  • firstUserCm360CreativeVersion 신규 사용자 CM360 광고 소재 버전

  • firstUserCm360Medium 신규 사용자 CM360 매체

  • firstUserCm360PlacementCostStructure 신규 사용자 CM360 게재위치 비용 구조

  • firstUserCm360PlacementId 신규 사용자 CM360 게재위치 ID

  • firstUserCm360PlacementName 신규 사용자 CM360 게재위치 이름

  • firstUserCm360RenderingId 신규 사용자 CM360 렌더링 ID

  • firstUserCm360SiteId 신규 사용자 CM360 사이트 ID

  • firstUserCm360SiteName 신규 사용자 CM360 사이트 이름

  • firstUserCm360Source 신규 사용자 CM360 소스

  • firstUserCm360SourceMedium 신규 사용자 CM360 소스 / 매체

  • sessionCm360AccountId 세션 CM360 계정 ID

  • sessionCm360AccountName 세션 CM360 계정 이름

  • sessionCm360AdvertiserId 세션 CM360 광고주 ID

  • sessionCm360AdvertiserName 세션 CM360 광고주 이름

  • sessionCm360CampaignId 세션 CM360 캠페인 ID

  • sessionCm360CampaignName 세션 CM360 캠페인 이름

  • sessionCm360CreativeFormat 세션 CM360 광고 소재 형식

  • sessionCm360CreativeId 세션 CM360 광고 소재 ID

  • sessionCm360CreativeName 세션 CM360 광고 소재 이름

  • sessionCm360CreativeType 세션 CM360 광고 소재 유형

  • sessionCm360CreativeTypeId 세션 CM360 광고 소재 유형 ID

  • sessionCm360CreativeVersion 세션 CM360 광고 소재 버전

  • sessionCm360Medium 세션 CM360 매체

  • sessionCm360PlacementCostStructure 세션 CM360 게재위치 비용 구조

  • sessionCm360PlacementId 세션 CM360 게재위치 ID

  • sessionCm360PlacementName 세션 CM360 게재위치 이름

  • sessionCm360RenderingId 세션 CM360 렌더링 ID

  • sessionCm360SiteId 세션 CM360 사이트 ID

  • sessionCm360SiteName 세션 CM360 사이트 이름

  • 세션 CM360 소스 sessionCm360Source개

  • sessionCm360SourceMedium 세션 CM360 소스 / 매체

Google Display & Video 360 (DV360) 통합 측정기준:

  • dv360AdvertiserId DV360 광고주 ID

  • dv360AdvertiserName DV360 광고주 이름

  • DV360 캠페인 ID dv360CampaignId개

  • dv360CampaignName DV360 캠페인 이름

  • DV360 광고 소재 형식 dv360CreativeFormat개

  • dv360CreativeId DV360 광고 소재 ID

  • dv360CreativeName DV360 광고 소재 이름

  • dv360ExchangeId DV360 거래소 ID

  • dv360ExchangeName DV360 거래소 이름

  • dv360InsertionOrderId DV360 게재 신청서 ID

  • dv360InsertionOrderName DV360 게재 신청서 이름

  • DV360 광고 항목 ID dv360LineItemId개

  • dv360LineItemName DV360 광고 항목 이름

  • DV360 매체 dv360Medium개

  • DV360 파트너 ID dv360PartnerId개

  • dv360PartnerName DV360 파트너 이름

  • DV360 소스 dv360Source개

  • DV360 소스 / 매체 dv360SourceMedium개

  • firstUserDv360AdvertiserId 신규 사용자의 DV360 광고주 ID

  • firstUserDv360AdvertiserName 신규 사용자의 DV360 광고주 이름

  • firstUserDv360CampaignId 신규 사용자 DV360 캠페인 ID

  • firstUserDv360CampaignName 신규 사용자 DV360 캠페인 이름

  • firstUserDv360CreativeFormat 신규 사용자 DV360 광고 소재 형식

  • firstUserDv360CreativeId 신규 사용자의 DV360 광고 소재 ID

  • firstUserDv360CreativeName 신규 사용자의 DV360 광고 소재 이름

  • firstUserDv360ExchangeId 신규 사용자의 DV360 거래소 ID

  • firstUserDv360ExchangeName 신규 사용자의 DV360 거래소 이름

  • firstUserDv360InsertionOrderId 신규 사용자의 DV360 게재 신청서 ID

  • firstUserDv360InsertionOrderName 신규 사용자의 DV360 게재 신청서 이름

  • firstUserDv360LineItemId 신규 사용자의 DV360 광고 항목 ID

  • firstUserDv360LinteItemName 신규 사용자의 DV360 광고 항목 이름

  • firstUserDv360Medium 신규 사용자 DV360 매체

  • firstUserDv360PartnerId 신규 사용자의 DV360 파트너 ID

  • firstUserDv360PartnerName 신규 사용자의 DV360 파트너 이름

  • firstUserDv360Source 신규 사용자의 DV360 소스

  • firstUserDv360SourceMedium 신규 사용자 DV360 소스 / 매체

  • sessionDv360AdvertiserId 세션 DV360 광고주 ID

  • sessionDv360AdvertiserName 세션 DV360 광고주 이름

  • sessionDv360CampaignId 세션 DV360 캠페인 ID

  • sessionDv360CampaignName 세션 DV360 캠페인 이름

  • sessionDv360CreativeFormat 세션 DV360 광고 소재 형식

  • sessionDv360CreativeId 세션 DV360 광고 소재 ID

  • sessionDv360CreativeName 세션 DV360 광고 소재 이름

  • sessionDv360ExchangeId 세션 DV360 거래소 ID

  • sessionDv360ExchangeName 세션 DV360 거래소 이름

  • sessionDv360InsertionOrderId 세션 DV360 게재 신청서 ID

  • sessionDv360InsertionOrderName 세션 DV360 게재 신청서 이름

  • 세션 DV360 광고 항목 ID sessionDv360LineItemId개

  • sessionDv360LineItemName 세션 DV360 광고 항목 이름

  • sessionDv360Medium 세션 DV360 매체

  • sessionDv360PartnerId 세션 DV360 파트너 ID

  • sessionDv360PartnerName 세션 DV360 파트너 이름

  • 세션 DV360 소스 sessionDv360Source개

  • sessionDv360SourceMedium 세션 DV360 소스 / 매체

Google Search Ads 360 (SA360) 통합 측정기준:

  • firstUserSa360AdGroupId 신규 사용자 SA360 광고그룹 ID

  • firstUserSa360AdGroupName 신규 사용자 SA360 광고그룹 이름

  • firstUserSa360CampaignId 신규 사용자 SA360 캠페인 ID

  • firstUserSa360CampaignName 신규 사용자 SA360 캠페인

  • firstUserSa360CreativeFormat 신규 사용자 SA360 광고 소재 형식

  • firstUserSa360EngineAccountId 신규 사용자 SA360 엔진 계정 ID

  • firstUserSa360EngineAccountName 신규 사용자 SA360 엔진 계정 이름

  • firstUserSa360EngineAccountType 신규 사용자 SA360 엔진 계정 유형

  • firstUserSa360KeywordText 신규 사용자 SA360 키워드 텍스트

  • firstUserSa360ManagerAccountId 신규 사용자 SA360 관리자 계정 ID

  • firstUserSa360ManagerAccountName 신규 사용자 SA360 관리자 계정 이름

  • firstUserSa360Medium 신규 사용자 SA360 매체

  • firstUserSa360Query 신규 사용자 SA360 검색어

  • firstUserSa360Source 신규 사용자 SA360 소스

  • firstUserSa360SourceMedium 신규 사용자 SA360 소스 / 매체

  • SA360 광고 그룹 ID sa360AdGroupId개

  • SA360 캠페인 ID sa360CampaignId개

  • SA360 광고 그룹 이름 sa360AdGroupName개

  • SA360 캠페인 sa360CampaignName개

  • SA360 광고 소재 형식 sa360CreativeFormat개

  • sa360EngineAccountId SA360 엔진 계정 ID

  • sa360EngineAccountName SA360 엔진 계정 이름

  • SA360 엔진 계정 유형 sa360EngineAccountType개

  • sa360KeywordText SA360 키워드 텍스트

  • SA360 관리자 계정 ID sa360ManagerAccountId개

  • sa360ManagerAccountName SA360 관리자 계정 이름

  • SA360 매체 sa360Medium개

  • SA360 검색어 sa360Query개

  • SA360 소스 sa360Source개

  • SA360 소스 / 매체 sa360SourceMedium개

  • sessionSa360AdGroupId 세션 SA360 광고 그룹 ID

  • sessionSa360CampaignId 세션 SA360 캠페인 ID

  • sessionSa360ManagerAccountId 세션 SA360 관리자 계정 ID

  • sessionSa360ManagerAccountName 세션 SA360 관리자 계정 이름

  • sessionSa360SourceMedium 세션 SA360 소스 / 매체

2024년 3월 6일 잠재고객 내보내기에서 비활성 사용자 잠재고객이 지원됩니다.

잠재고객 내보내기 기능은 비활성 사용자 잠재고객 내보내기를 더 잘 지원합니다. 사용자는 조건을 충족하는 이벤트 없이 이러한 잠재고객을 입력합니다. 예를 들어 7일 동안 웹사이트를 방문하지 않으면 잠재고객에 들어갈 수 있습니다. 비활성 사용자 잠재고객의 예로는 '7일간 비활성 구매자', '7일간 비활성 사용자', '7일간 알림을 받지 않은 사용자'가 있습니다. 이러한 추천 잠재고객에 관한 자세한 내용은 추천 잠재고객을 참고하세요.

2024-02-28 잠재고객 내보내기는 태그 지정에 지정된 사용자 ID를 반환합니다.

이제 속성에 사용자 제공 데이터가 사용 설정되어 있어도 잠재고객 내보내기가 태그 지정에 지정된 사용자 ID를 반환합니다. 사용자 제공 데이터 수집이 사용 설정된 경우 측정을 개선하기 위해 User-ID와 함께 사용자 제공 데이터를 태그 지정을 통해 Google 애널리틱스로 전송할 수 있습니다. 자세한 내용은 사용자 제공 데이터 수집을 참고하세요.

2024년 1월 30일 Data API v1 알파에서 잠재고객 목록, 반복 잠재고객 목록에 대해 웹훅 알림이 지원됩니다.

AudienceList.webhookNotification 및 RecurringAudienceList.webhookNotification 필드는 잠재고객 목록 (properties.audienceLists.create 사용) 또는 반복 잠재고객 목록 (properties.recurringAudienceLists.create 사용)을 만들 때 지정할 수 있습니다.

이 기능을 사용하면 잠재고객 목록을 사용할 수 있게 될 때 웹훅 알림을 비동기식으로 수신할 수 있습니다.

2024년 1월 18일 쿼리 문자열 또는 분 구성요소가 포함된 측정기준의 호환성이 개선되었습니다.

이제 쿼리 문자열을 포함하는 측정기준이 대부분의 필드와 호환됩니다. pagePathPlusQueryString, unifiedPageScreen, pageLocation, fullPageUrl와 같은 측정기준이 이제 sessionSource, browser, city, landingPage를 비롯한 많은 추가 필드와 호환됩니다.

이제 분 구성요소를 포함하는 측정기준이 대부분의 필드와 호환됩니다. minute, nthMinute, dateHourMinute 등의 측정기준이 이제 유사한 추가 필드 집합과 호환됩니다.

포괄적인 호환성 정보는 GA4 측정기준 및 측정항목 탐색기를 참고하세요.

2023년 12월 13일 맞춤 상품 범위 매개변수

이제 다음 구문을 사용하여 상품 범위 맞춤 측정기준을 Analytics Data API 쿼리에 포함할 수 있습니다.

일반 API 이름 설명
customItem:parameter_name parameter_name의 상품 범위 맞춤 측정기준

자세한 내용은 API 측정기준 및 측정항목을 참고하세요.

2023년 12월 5일 Data API v1 베타에서 잠재고객 내보내기로 잠재고객 목록 사용 가능

잠재고객 목록 기능이 잠재고객 내보내기로 이름이 변경되고 Data API v1 베타에 추가되었습니다.

Data API v1 베타에 다음 메서드가 추가되었습니다.

2023년 11월 28일 보고 응답에 samplingMetadatas 추가됨

ResponseMetaData에 samplingMetadatas를 추가했습니다. 이 컬렉��에는 결과가 샘플링된 요청의 각 기간에 대한 SampleMetadata이 포함됩니다. Google 애널리틱스는 카디널리티 한도로 인해 데이터 품질이 저하될 것으로 예상되는 경우에만 샘플링을 적용합니다.

2023년 11월 28일 Data API v1 알파에 반복되는 잠재고객 목록 내보내기 기능이 추가됨

Data API v1 알파에 properties.recurringAudienceLists.create, properties.recurringAudienceLists.create, properties.recurringAudienceLists.list 메서드를 추가했습니다.

이 기능을 사용하면 잠재고객 멤버십 변경에 따라 잠재고객 목록을 매일 생성할 수 있습니다. 반복 잠재고객 목록을 사용하면 최신 잠재고객 멤버십 결과를 사용할 수 있습니다.

2023년 11월 8일 Data API v1 알파에서 Sheets로 잠재고객 목록 내보내기 기능을 추가함

Data API v1 알파 버전에 잠재고객 목록을 Google Sheets로 내보낼 수 있는 properties.audienceLists.exportSheet 메서드가 추가되었습니다.

2023년 10월 13일 포함 기간이 1일인 잠재고객에 대한 지원 추가

포함 기간이 1일인 잠재고객은 이제 잠재고객 목록 내보내기 기능에서 지원됩니다.

2023년 9월 12일 AudienceList 기본 순서 규칙

기본적으로 잠재고객 목록 내보내기 기능을 사용하여 만든 보고서는 Data API의 다른 보고 방법과 동일한 정렬 규칙을 따릅니다. 즉, 첫 번째 열로 내림차순, 두 번째 열 기준으로 내림차순으로 정렬됩니다.

변경 전에는 다음과 같은 보고서가 발송되었을 수 있습니다.

deviceId isAdsPersonalizationAllowed
ABC true
DAC false
ABC false
AAA true

변경사항이 적용되면 다음과 같은 보고서를 받게 됩니다.

deviceId isAdsPersonalizationAllowed
AAA true
ABC false
ABC true
DAC false

2023년 8월 15일 잠재고객 목록 내보내기 스키마에 isLimitedAdTracking 측정기준이 추가됨

  • isLimitedAdTracking: 기기의 광고 추적 제한 설정 가능한 값은 true, false, (not set)입니다.

    자세한 내용은 잠재고객 목록 측정기준을 참고하세요.

2023년 8월 15일 currencyCode 측정기준, itemDiscountAmount 측정항목이 추가됨

  • currencyCode 전자상거래 이벤트의 현지 통화 코드입니다 (ISO 4217 표준 기반). 예: 'USD' 또는 'GBP'

  • itemDiscountAmount 전자상거래 이벤트에서 발생한 상품 할인의 금전적 가치입니다. 이 측정항목은 '할인' 상품 매개변수에 의해 태그 지정 시 채워집니다.

자세한 내용은 Data API 보고 스키마를 참고하세요.

2023년 8월 10일 잠재고객 목록 내보내기 스키마에 isAdsPersonalizationAllowed 측정기준이 추가됨

  • isAdsPersonalizationAllowed 광고 개인 최적화 허용 여부 사용자가 광고 개인 최적화 요건을 충족하면 isAdsPersonalizationAllowed가 true를 반환합니다. 사용자가 광고 개인 최적화 대상이 아닌 경우 isAdsPersonalizationAllowed는 false를 반환합니다.

    자세한 내용은 잠재고객 목록 측정기준을 참고하세요.

2023년 7월 10일 잠재고객 목록

Data API v1 알파에 잠재고객 목록 지원이 추가되었습니다. 잠재고객 목록에는 잠재고객 목록 생성 시 잠재고객에 속한 사용자의 스냅샷이 포함됩니다.

Data API v1 알파에 다음 메서드가 추가되었습니다.

2023년 5월 19일 맞춤 채널 그룹

Data API에 맞춤 채널 그룹 지원이 추가되었습니다.

2023년 5월 11일 토큰 할당량 변경

더 정확한 청구를 위해 Data API의 할당량 시스템이 업데이트되었습니다.

각 요청에 대해 청구되는 토큰 수는 할당량 변경에 따라 업데이트되고 더 많은 간단한 보고 쿼리를 허용하는 방식으로 재조정되며 대규모 날짜 보고서의 경우 훨씬 더 많은 할당량 토큰이 청구됩니다.

이 변경 후에는 일부 요청에 대한 요금은 그대로 유지되지만 더 복잡한 쿼리의 요금은 현저하게 증가합니다. 예를 들어 6개월을 초과하는 데이터를 요청하면 1,000개 이상의 할당량 토큰이 청구될 수 있습니다.

표준 속성

할당량 이름 이전 한도 새 한도
일일 속성별 핵심 토큰 25,000 200,000
시간별 속성별 핵심 토큰 5,000 40,000명
시간당 속성별 프로젝트당 핵심 토큰 1,750명 14,000개
일일 속성별 실시간 토큰 수 25,000 200,000
시간당 속성별 실시간 토큰 5,000 40,000명
시간당 속성별 프로젝트별 실시간 토큰 1,750명 14,000개
속성별 일일 유입경로 토큰 25,000 200,000
시간당 속성별 유입경로 토큰 5,000 40,000명
시간당 속성별 프로젝트당 유입경로 토큰 1,750명 14,000개

애널리틱스 360 속성

할당량 이름 이전 한도 새 한도
일일 속성별 핵심 토큰 250,000명 200만
시간별 속성별 핵심 토큰 50,000 400,000
시간당 속성별 프로젝트당 핵심 토큰 17,500명 140,000명
일일 속성별 실시간 토큰 수 250,000명 200만
시간당 속성별 실시간 토큰 50,000 400,000
시간당 속성별 프로젝트별 실시간 토큰 17,500명 140,000명
속성별 일일 유입경로 토큰 250,000명 200만
시간당 속성별 유입경로 토큰 50,000 400,000
시간당 속성별 프로젝트당 유입경로 토큰 17,500명 140,000명

2023년 3월 2일 추가된 날짜 측정기준

  • dayOfWeekName 요일 이름입니다. 영어로 된 요일입니다. 이 측정기준의 값은 Sunday, Monday 등입니다.

  • isoWeek ISO 주(1년 기준)입니다. 매주 월요일에 시작하는 ISO 주 번호입니다. 자세한 내용은 https://en.wikipedia.org/wiki/ISO_week_date를 참고하세요. 값의 예로는 01, 02, 53가 있습니다.

  • isoYear ISO 연도입니다. 이벤트의 ISO 연도입니다. 자세한 내용은 https://en.wikipedia.org/wiki/ISO_week_date를 참고하세요. 값의 예로는 2022 및 2023이 있습니다.

  • isoYearIsoWeek ISO 주(ISO 연도 기준)입니다. isoWeek와 isoYear의 결합된 값입니다. 값의 예로는 201652 및 201701이 있습니다.

  • yearMonth년 월 year와 month의 결합된 값입니다. 값의 예로는 202212 또는 202301이 있습니다.

  • yearWeek년 주 year와 week의 결합된 값입니다. 값의 예로는 202253 또는 202301이 있습니다.

2023년 2월 27일 전자상거래 측정기준이 추가되었습니다.

  • itemListPosition 상품 목록 위치입니다. 상품의(예: 판매하는 제품) 목록 내 위치입니다. 이 측정기준은 상품 배열의 'index' 매개변수에 의해 태그 지정 시 채워집니다.

  • itemLocationID 상품 위치 ID입니다. 상품과 연결된 실제 위치입니다 (예: 오프라인 상점 위치). 연결�� 항목에 해당하는 Google 장소 ID를 사용하는 것이 좋습니다. 맞춤 위치 ID도 사용할 수 있습니다. 이 필드는 항목 배열의 'location_id' 매개변수에 의해 태그를 지정할 때 채워집니다.

  • itemPromotionCreativeSlot 상품 프로모션 광고 소재 슬롯 상품과 연결된 프로모션 광고 소재 슬롯의 이름입니다. 이 측정기준은 이벤트 또는 상품 수준에서 creative_slot 매개변수를 통해 태그 지정에 지정할 수 있습니다. 매개변수가 이벤트 및 상품 수준 모두에 지정된 경우 상품 수준 매개변수가 사용됩니다.

2023년 2월 21일 '방문 페이지 + 쿼리 문자열' 측정기준이 추가되었습니다.

  • landingPagePlusQueryString 방문 페이지 + 쿼리 문자열 세션의 첫 번째 페이지 조회와 연결된 페이지 경로 + 쿼리 문자열입니다.

이 필드는 지원 중단된 landingPage 측정기준을 대체하며 2023년 5월 14일에 쿼리 문자열을 반환하지 않도록 업데이트될 예정입니다.

2023년 1월 28일 '사용자당 조회수', '스크롤한 사용자' 측정항목이 추가되었습니다.

  • 사용자당 조회수 screenPageViewsPerUser회 활성 사용자당 조회한 앱 화면 또는 웹페이지의 수입니다. 한 페이지 또는 한 화면을 반복해서 조회한 횟수도 집계에 포함됩니다. (screen_view + page_view events) / active users.

  • scrolledUsers 스크롤된 사용자 페이지의 90% 이상 아래로 스크롤한 순 사용자 수입니다.

2023년 1월 23일 '대륙', '대륙 ID' 측정기준이 추가되었습니다.

  • 대륙 continent. 사용자 활동이 발생한 대륙입니다. 예를 들어 Americas 또는 Asia입니다.

  • continentId 대륙 ID입니다. 사용자 활동이 발생한 대륙의 지역 ID로, IP 주소에서 가져온 값입니다.

2023년 1월 23일 '테스트 데이터 필터 ID' 측정기준이 추가되었습니다.

  • testDataFilterId 테스트 데이터 필터 ID입니다. 테스트 상태에 있는 데이터 필터의 숫자 식별자입니다. 이벤트 매개변수 값에 따라 데이터 필터를 사용하여 이벤트 데이터를 보고서에 포함하거나 제외할 수 있습니다. 자세한 내용은 https://support.google.com/analytics/answer/10108813을 참고하세요.

2022년 10월 18일 광고 측정항목이 추가되었습니다.

  • 광고 클릭수 advertiserAdClicks회 사용자가 속성에 도달하기 위해 광고를 클릭한 총횟수입니다.
  • 광고 비용: advertiserAdCost 광고에 지불한 총 금액입니다.
  • advertiserAdCostPerClick 광고 클릭당비용 광고 클릭당비용은 광고 비용을 광고 클릭수로 나눈 값이며 종종 CPC로 축약됩니다.
  • advertiserAdCostPerConversion 전환당비용 전환당비용은 광고 비용을 전환수로 나눈 값입니다.
  • 광고 노출수 advertiserAdImpressions회 총 노출수입니다.
  • returnOnAdSpend 광고 투자수익 광고 투자수익 (ROAS)은 총 수익을 광고주 광고 비용으로 나눈 값입니다.

2022년 10월 17일 상품 범위 측정항목이 추가되었습니다.

  • 상품 itemsAddedToCart개가 장바구니에 추가되었습니다. 단일 상품의 장바구니에 추가된 단위의 수입니다.
  • 항목 itemsCheckedOut개가 결제되었습니다. 단일 상품에 대해 체크아웃된 단위 수입니다.
  • 목록에서 항목 itemsClickedInList개를 클릭했습니다. 단일 상품에 대해 목록에서 클릭된 단위의 수입니다.
  • 프로모션에서 클릭된 상품 itemsClickedInPromotion개 단일 상품의 프로모션에서 클릭된 단위 수입니다.
  • 항목 itemsViewed개가 조회되었습니다. 단일 상품에 대해 조회된 단위의 수입니다.
  • 목록에서 상품 itemsViewedInList개가 조회되었습니다. 단일 상품에 대해 목록에서 조회된 단위의 수입니다.
  • 프로모션에서 조회된 상품 itemsViewedInPromotion개 단일 상품에 대한 프로모션에서 조회된 단위 수입니다.

2022년 9월 13일 스키마 호환성 변경사항 공지

2022년 12월 1일에 다음과 같은 브레이킹 체인지가 적용됩니다.

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

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

  3. pagePathPlusQueryString와 같은 쿼리 문자열을 포함하는 측정기준은 제한된 측정기준 및 측정항목 집합과만 호환됩니다.

자세한 내용은 호환성 변경사항에 관한 자세한 설명을 참고하세요.

2022년 9월 1일 할당량 변경

  • Requests per day , Requests Per Minute, Requests Per Minute Per User 할당량이 Data API에서 삭제되었습니다.

  • Tokens Per Project Per Property Per Hour 할당량이 API에 추가되었습니다.

  • 각 요청은 Tokens Per Property Per Hour 및 Tokens Per Project Per Property Per Hour의 할당량을 모두 사용합니다.

    새 할당량에 대한 자세한 내용은 할당량 문서를 참조하세요.

2022년 8월 3일 세션 범위 SA360 측정기준이 추가되었습니다.

  • sessionSa360AdGroupName 세션 SA360 광고 그룹 이름입니다. 이 세션으로 이어진 Search Ads 360의 광고그룹 이름입니다.

  • 세션 SA360 캠페인 sessionSa360CampaignName개 이 세션으로 이어진 Search Ads 360의 캠페인 이름입니다.

  • sessionSa360CreativeFormat 세션 SA360 광고 소재 형식입니다. 이 세션으로 이어진 Search Ads 360의 광고 소재 유형입니다. 예: '반응형 검색 광고' 또는 '확장 텍스트 광고'

  • sessionSa360EngineAccountId 세션 SA360 엔진 계정 ID입니다. 이 세션으로 이어진 SA360 엔진 계정의 ID입니다.

  • sessionSa360EngineAccountName 세션 SA360 엔진 계정 이름입니다. 이 세션으로 이어진 SA360의 엔진 계정 이름입니다.

  • sessionSa360EngineAccountType 세션 SA360 엔진 계정 유형입니다. 이 세션으로 이어진 Search Ads 360의 엔진 계정 유형입니다. 예: 'google ads', 'bing', 'baidu'

  • sessionSa360Keyword 세션 SA360 키워드 텍스트입니다. 이 세션으로 이어진 Search Ads 360의 검색엔진 키워드입니다.

  • sessionSa360Medium 세션 SA360 매체입니다. 이 세션으로 이어진 Search Ads 360의 검색엔진 키워드입니다. 예: 'cpc'.

  • sessionSa360Query 세션 SA360 검색어. 이 세션으로 이어진 Search Ads 360의 검색어입니다.

  • sessionSa360Source 세션 SA360 소스입니다. Search Ads 360에서 이 세션으로 이어진 트래픽의 소스입니다. 예: 'example.com' 또는 'google'

  • sessionCampaignId, sessionCampaignName 측정기준이 이제 Search Ads 360 캠페인을 지원합니다.

2022년 7월 11일 전환율 측정항목이 추가되었습니다.

전환율

  • sessionConversionRate 전환 이벤트가 트리거된 세션의 비율입니다.

  • userConversionRate 전환 이벤트를 트리거한 사용자의 비율입니다.

전환 1회에 대한 전환율 측정항목

  • sessionConversionRate:event_name 특정 전환 이벤트가 트리거된 세션의 비율입니다.

  • userConversionRate:event_name 특정 전환 이벤트를 트리거한 사용자의 비율입니다.

2022년 5월 5일 알파 채널에 유입경로 보고서 기능이 추가되었습니다.

  • runFunnelReport 메서드가 API의 v1alpha 버전에 추가되어 Google 애널리틱스 이벤트 데이터의 맞춤설정된 유입경로 보고서가 반환됩니다.

  • 이 메서드는 베타 버전에 들어가기 전에 구문 및 기능에 관한 의견을 수집하기 위해 알파 안정성에서 도입됩니다. Google 애널리틱스 Data API 유입경로 보고 의견을 작성��여 이 API에 대한 의견을 보내주세요.

2022년 2월 16일 새로운 측정기준이 추가되었습니다.

수동 용어 및 콘텐츠

  • firstUserManualAdContent 신규 사용자 수동 광고 콘텐츠입니다. 사용자를 처음 획득한 광고 콘텐츠입니다. utm_content 매개변수로 채워집니다.

  • firstUserManualTerm 신규 사용자 수동 검색어 사용자를 처음 획득한 검색어입니다. utm_term 매개변수로 채워집니다.

  • manualAdContent 수동 광고 콘텐츠 전환 이벤트에 기여한 광고 콘텐츠입니다. utm_content 매개변수로 채워집니다.

  • manualTerm 수동 검색어입니다. 전환 이벤트에 기여한 검색어입니다. utm_term 매개변수로 채워집니다.

  • sessionManualAdContent 세션 수동 광고 콘텐츠. 세션으로 이어진 광고 콘텐츠입니다. utm_content 매개변수로 채워집니다.

  • sessionManualTerm 세션 수동 검색어. 세션으로 이어진 검색어입니다. utm_term 매개변수로 채워집니다.

비정상 종료 분석

  • 비정상 종료의 영향을 받은 사용자 crashAffectedUsers명 보고서의 이 행에 비정상 종료를 로깅한 사용자 수입니다.

  • crashFreeUsersRate 비정상 종료가 발생하지 않은 사용자 비율

앱/웹

  • averageSessionDuration 사용자 세션의 평균 시간 (초)입니다.

  • newVsReturning 신규 / 재사용자

  • 세션당 조회수 screenPageViewsPerSession회

  • landingPage 방문 페이지 세션의 첫 번째 페이지 조회와 연결된 페이지 경로 + 쿼리 문자열입니다.

  • platformDeviceCategory: 웹사이트 또는 모바일 앱이 실행된 플랫폼 및 기기 유형입니다.

모바일 앱

  • averagePurchaseRevenuePerUser 사용자당 평균 구매 수익입니다.

  • firstTimePurchaserConversionRate: 처음으로 구매한 활성 사용자의 비율입니다.

  • firstTimePurchasersPerNewUser 신규 사용자당 평균 최초 구매자 수입니다.

  • DAU / MAU dauPerMau. 30일 활성 사용자 중 1일 활성 사용자의 롤링 비율입니다.

  • DAU / WAU dauPerWau명. 7일 활성 사용자 중 1일 활성 사용자의 롤링 비율입니다.

  • wauPerMau WAU / MAU. 30일 활성 사용자 중 7일 활성 사용자의 롤링 비율입니다.

  • purchaserConversionRate: 1회 이상 구매 거래를 한 활성 사용자의 비율입니다.

  • 구매자당 거래 transactionsPerPurchaser건

Google Ads 캠페인

  • firstUserGoogleAdsCampaignType 사용자를 처음 획득한 Google Ads 캠페인의 캠페인 유형입니다.

  • googleAdsCampaignType: 전환 이벤트가 기여한 Google Ads 캠페인의 캠페인 유형입니다.

  • sessionGoogleAdsCampaignType 이 세션으로 이어진 Google Ads 캠페인의 캠페인 유형입니다.

2021년 9월 7일 새로운 날짜/시간 측정기준이 추가되었습니다.

  • dateHourMinute YYYYMMDDHHMM 형식의 날짜, 시간, 분을 결합한 값입니다.

  • minute 이벤트가 기록된 시간의 두 자리 분입니다.

  • nthMinute 기간이 시작된 이후 지난 분입니다.

2021년 9월 7일 이벤트 매개변수로 채워진 새로운 측정기준이 추가되었습니다.

  • achievementId 이벤트 관련 게임의 업적 ID입니다.

  • character 이벤트 게임의 플레이어 캐릭터입니다.

  • fileExtension 다운로드한 파일의 확장자입니다.

  • fileName 다운로드한 파일의 페이지 경로입니다.

  • groupId: 이벤트 관련 게임의 플레이어 그룹 ID입니다.

  • linkClasses: 외부 연결 링크의 HTML 클래스 속성입니다.

  • linkDomain 외부 연결 링크의 대상 도메인입니다.

  • linkId 외부 링크 또는 파일 다운로드의 HTML ID 속성입니다.

  • linkText 파일 다운로드의 링크 텍스트입니다.

  • linkUrl 외부 연결 링크 또는 파일 다운로드의 전체 URL입니다.

  • method 이벤트가 트리거된 메서드입니다.

  • outbound 사이트로 연결되는 링크가 속성 도메인의 일부가 아닌 경우 'true'를 반환합니다.

  • pageLocation 방문한 웹페이지의 프로토콜, 호스트 이름, 페이지 경로, 쿼리 문자열입니다.

  • pageReferrer: 호스트 이름과 경로가 포함된 전체 참조 URL입니다.

  • percentScrolled 사용자가 페이지에서 아래로 스크롤한 비율입니다(예: '90').

  • searchTerm 사용자가 검색한 검색어입니다.

  • videoProvider 동영상의 소스입니다 (예: 'youtube').

  • videoTitle: 동영상의 제목입니다.

  • videoUrl: 동영상의 URL입니다.

  • visible 콘텐츠가 표시되면 'true'를 반환합니다.

  • unifiedPagePathScreen: 이벤트가 로깅된 페이지 경로 (웹) 또는 화면 클래스 (앱)입니다.

2021년 9월 7일 API 스키마 변경사항

기존 측정기준의 변경사항:

  • unifiedPageScreen 웹에서 생성된 이벤트의 경우 이 측정기준은 이제 이벤트가 로깅된 페이지 경로 및 쿼리 문자열을 반환합니다.

예정된 변경사항 공지사항:

  • firstUserTrafficOrigin 사용자를 처음 획득한 트래픽 출처입니다. UTM을 사용하는 트래픽에 대해 '수동'을 반환하는 이 필드에 의존하지 마세요. 곧 출시될 기능 출시를 위해 이 필드가 '수동'에서 '(설정되지 않음)'을 반환하는 것으로 업데이트됩니다.

  • sessionTrafficOrigin 세션 캠페인의 트래픽 출처입니다. UTM을 사용하는 트래픽에 대해 '수동'을 반환하는 이 필드에 의존하지 마세요. 곧 출시될 기능 출시를 위해 이 필드가 '수동'에서 '(설정되지 않음)'을 반환하는 것으로 업데이트됩니다.

  • trafficOrigin 전환 이벤트 캠페인의 트래픽 출처입니다. UTM을 사용하는 트래픽에 대해 '수동'을 반환하는 이 필드에 의존하지 마세요. 곧 출시될 기능 출시를 위해 이 필드가 '수동'에서 '(설정되지 않음)'을 반환하는 것으로 업데이트됩니다.

2021년 9월 7일 checkCompatibility 메서드가 API에 추가되었습니다.

checkCompatibility 메서드는 보고서 요청에 추가하고 호환성을 유지할 수 있는 측정기준과 측정항목을 나열합니다.

2021년 7월 21일 실시간 보고 변경사항.

이제 runRealtimeReport 메서드의 minuteRanges 매개변수를 사용하여 읽을 이벤트 데이터의 분 범위를 지정할 수 있습니다.

2021년 7월 21일 새로운 채널 그룹 측정기준입니다.

새로운 채널 그룹 측정기준이 Data API 보고 스키마에 추가되었습니다.

  • firstUserDefaultChannelGrouping 신규 사용자 기본 채널 그룹입니다.

  • defaultChannelGrouping 기본 채널 그룹

2021년 6월 10일 API 스키마 변경사항

  • minutesAgo 측정기준은 Data API 실시간 스키마에 추가되며 runRealtimeReport 메서드에 대한 쿼리에서 사용할 수 있습니다. 이 측정기준에는 이벤트가 수집된 시간(분)이 포함됩니다. 00은 현재 분이고 01은 이전 분을 의미합니다.

  • googleAdsCreativeId 측정기준이 Data API 스키마에 추가되었습니다. 이 측정기준에는 전환 이벤트에 기여한 Google Ads 광고 소재의 ID가 포함됩니다.

  • sessionGoogleAdsCreativeId 측정기준이 Data API 스키마에 추가되었습니다. 이 측정기준에는 웹사이트 또는 앱에서 세션으로 연결되는 Google Ads 광고 소재의 ID가 포함됩니다.

  • Data API 스키마에서 firstUserCreativeId 측정기준 이름이 firstUserGoogleAdsCreativeId로 변경되었습니다. 이 측정기준에는 사용자를 처음 획득한 Google Ads 광고 소재의 ID가 포함됩니다.

2021년 4월 9일 Google Analytics Data API v1 베타가 출시되었습니다.

  • API 엔드포인트가 https://analyticsdata.googleapis.com/v1beta로 업데이트되었습니다.

  • 이제 runReport, runPivotReport, batchRunReports, batchRunPivotReports 메서드가 요청 본문의 entity 필드 대신 URL 경로의 property 매개변수에 Google 애널리틱스 4 속성의 ID를 허용합니다.

    POST https://analyticsdata.googleapis.com/v1beta/GA4_PROPERTY_ID:batchRunReports

  • API 클라이언트 라이브러리가 새 API 엔드포인트를 사용하도록 업데이트되었습니다.

2021년 2월 19일 페이지로 나누기 변경사항

  • 기본 보고서 응답 크기가 이벤트 데이터의 행이 10개에서 10,000개로 늘어났습니다.

  • 모든 행을 검색하려는 시도를 나타내는 데 사용된 "limit" : -1 값이 더 이상 RunReportRequest에서 지원되지 않습니다.

  • limit 필드의 최댓값은 100000로 설정됩니다. 페이지로 나누기를 사용하여 100,000개 이상의 행이 포함된 보고서를 검색하세요.

2021년 2월 8일 새로운 전자상거래 측정기준 및 측정항목입니다.

새로운 전자상거래 측정기준 및 측정항목이 API 스키마에 추가되었습니다.

측정기준: adFormat, adSourceName, adUnitName, itemBrand, itemCategory, itemCategory2, itemCategory3, itemCategory4, itemCategory5 itemId, itemListId, itemListName, itemName, itemPromotionCreativeName, itemPromotionId, itemPromotionName, orderCoupon, transactionId.

측정항목: adUnitExposure, addToCarts, cartToViewRate, checkouts, ecommercePurchases, firstTimePurchasers, itemListClickThroughRate, itemListClicks, itemListViews, itemPromotionClickThroughRate, itemPromotionClicks, itemPromotionViews, itemPurchaseQuantity, itemRevenue, itemViews, publisherAdClicks, publisherAdImpressions, totalPurchasers.

2021년 2월 8일 새 캠페인 측정기준이 추가되었습니다.

새 캠페인 측정기준이 API 스키마에 추가되었습니다. campaignId, campaignName, googleAdsAccountName, googleAdsAdGroupId, googleAdsAdGroupName, googleAdsAdNetworkType, source, trafficOrigin

2021년 2월 8일 dayOfWeek, 측정기준이 week개 변경됨

  • 이제 dayOfWeek 측정기준의 값이 1이 아닌 0으로 시작합니다.

  • week 차원의 값이 이제 01로 시작하고 01에서 53까지 두 자리 숫자를 반환합니다. 매주 일요일에 시작됩니다. 1월 1일은 항상 01번째 주에 속합니다.

2021년 1월 28일 맞춤 측정항목의 집계 변형이 추가되었습니다.

속성이 등록하는 각 커스텀 측정항목은 합계, 평균, 개수의 세 가지 API 측정항목 변형을 만듭니다.

2021년 1월 28일 새로운 날짜/시간 측정기준이 추가되었습니다.

hour, nthHour, nthYear, dateHour와 같은 새로운 측정기준이 API 스키마에 추가되었습니다.

2021년 1월 28일 Data API가 쿼리당 청구되는 할당량 토큰을 줄였습니다.

Data API가 쿼리당 청구되는 할당량 토큰을 줄였습니다. 시간당 및 일일 속성 할당량 토큰의 할당량 한도는 변경되지 않았습니다.

2020년 11월 9일 getUniversalMetadata 메서드가 삭제되었습니다.

getUniversalMetadata 메서드가 삭제되었습니다. getMetadata를 사용하세요. API 요청당 최대 기간인 1년이 삭제되었습니다.

2020년 11월 2일에 실시간 보고 방법이 추가되었습니다.

예시는 실시간 보고서 만들기를, REST 참조 문서는 runRealtimeReport를 참조하세요.

2020년 10월 19일 클라이언트 라이브러리 아티팩트가 업데이트되었습니다.

사용 안내 및 코드 샘플과 함께 업데이트된 클라이언트 라이브러리 아티팩트입니다.

2020년 10월 13일 앱 + 웹 속성의 이름이 Google 애널리틱스 4 (GA4)로 변경되었습니다.

2020년 10월 8일 getMetadata 메서드가 API에 추가되었습니다.

getMetadata 메서드는 지정된 GA4 속성 ID에 사용할 수 있는 맞춤 측정기준 및 측정항목과 범용 메타데이터를 반환합니다.

2020년 10월 8일 맞춤 측정기준 및 측정항목은 보고서에서 사용할 수 있습니다.

맞춤 측정기준 및 측정항목에 대한 문서는 API 스키마 문서를 참조하세요. 이번 업데이트에는 이벤트 범위 맞춤 측정기준 및 측정항목과 사용자 범위 맞춤 측정기준이 포함됩니다.