Google 애널리틱스 API 공식 발표를 확인하려면 Google 애널리틱스 API 알림 그룹을 구독하세요.
2024년 10월 20일 EmptyFilter
측정기준 필터 유형 추가
EmptyFilter 측정기준 필터를 사용하면 빈 값과 비교할 필터링 조건을 만들 수 있습니다.
2024년 10월 15일 reportTasks
메서드에 샘플링 수준 기능 추가
properties.runReportTask 메서드의 samplingLevel 필드를 사용하여 보고서의 샘플링 수준을 제어할 수 있습니다.
이 기능을 사용하면 Google 애널리틱스 360 속성에서 10억 개의 이벤트라는 더 높은 샘플링 한도에 액세스할 수 있습니다. 또한 샘플링되지 않은 결과의 이벤트 수가 많은 경우 샘플링 한도를 UNSAMPLED
로 설정할 수 있습니다.
2024년 9월 18일 속성 할당량 스냅샷 기능 추가
properties.getPropertyQuotasSnapshot 메서드를 사용하면 지정된 속성에 대해 할당량 카테고리별로 정리된 모든 속성 할당량의 현재 스냅샷을 가져올 수 있습니다.
2024년 6월 28일 '프로젝트별 속성별 클라이언트 오류' 할당량 추가
이제 15분 동안 프로젝트별, 속성별로 허용되는 API 서버 오류가 10,000개로 제한됩니다. 여기에는 500
또는 200
이외의 코드가 포함된 응답이 발생하는 모든 요청이 포함됩니다. 이 할당량에 해당하는 오류의 예: 호환되지 않는 측정기준 및 측정항목 조합 사용, 모든 인증 오류
이 한도를 초과하면 15분 기간이 끝날 때까지 연결된 Google Cloud 프로젝트에 대한 해당 속성의 추가 API 호출이 일시적으로 차단됩니다.
2024년 5월 14일 비교 기능 추가
비교를 사용하면 데이터의 하위 집합을 나란히 평가할 수 있습니다.
Data API v1beta의 핵심 보고 메서드가 업데이트되어 comparisons
필드를 지원합니다. 이 필드는 포함된 경우 요청된 비교의 구성을 지정합니다.
요청에서 요청과 함께 dimensionFilter
표현식을 제공하여 기본 비교를 지정하거나 comparison
필드에 비교의 리소스 이름을 제공하여 저장된 비교를 사용할 수 있습니다.
getMetadata 메서드가 comparisons
응답 필드 아래에 속성에 사용할 수 있는 모든 저장된 비교를 나열하도록 업데이트되었습니다.
요청에 하나 이상의 비교가 지정되면 응답에는 각 비교를 식별하는 comparison
열이 포함됩니다.
현재 저장된 비교는 Google 애널리틱스 UI를 사용해서만 만들 수 있습니다.
2024년 5월 8일 비동기 보고 기능인 보고서 작업을 Data API v1alpha에 추가했습니다.
보고서 작업을 사용하면 Google 애널리틱스 이벤트 데이터의 맞춤 보고서를 생성하기 위해 장기 실행 비동기 요청을 시작할 수 있습니다.
다음 보고서 작업 조작 메서드가 Data API v1alpha에 추가되었습니다.
- properties.reportTasks.create
- properties.reportTasks.get
- properties.reportTasks.list
- properties.reportTasks.query
2024년 5월 6일 주요 이벤트의 새 측정기준
이제 주요 이벤트의 측정기준과 측정항목을 사용할 수 있습니다.
isConversionEvent
측정기준을 사용하는 보고서 요청을 isKeyEvent
측정기준을 사용하도록 수정합니다.
다음 표에서 지원 중단된 측정항목을 사용하는 보고서 요청을 주요 이벤트 측정항목을 사용하도록 수정합니다.
지원 중단된 측정항목 | 주요 이벤트 측정항목 |
---|---|
advertiserAdCostPerConversion |
advertiserAdCostPerKeyEvent |
conversions |
keyEvents |
firstTimePurchaserConversionRate |
firstTimePurchaserRate |
purchaserConversionRate |
purchaserRate |
sessionConversionRate |
sessionKeyEventRate |
userConversionRate |
userKeyEventRate |
보고서 요청에서 주요 이벤트 1개의 주요 이벤트 측정항목을 사용하는 경우에도 유사한 수정사항을 적용합니다.
properties/getMetadata
메서드의 응답은 DimensionMetadata
및 MetricMetadata
객체에 주요 이벤트 측정기준과 측정항목이 도입된 것을 다음과 같이 반영합니다.
apiName
,uiName
,description
에는 키 이벤트 API 이름, UI 이름, 설명이 포함됩니다.deprecatedApiNames
반복 필드에 지원 중단된 전환 API 이름이 포함된 항목이 있습니다.
2024년 3월 25일 기본 채널 그룹, 수동 트래픽 소스, 통합별 측정기준이 추가되었습니다.
기본 채널 그룹, 수동 트래픽 소스, CM360, DV360, SA360 통합 관련 측정기준이 데이터 API 스키마에 추가되었습니다.
잠재고객 측정기준:
audienceId
잠재고객 ID입니다. 잠재고객의 숫자 식별자입니다.
기본 채널 그룹 측정기준:
firstUserPrimaryChannelGroup
신규 사용자 기본 채널 그룹primaryChannelGroup
기본 채널 그룹sessionPrimaryChannelGroup
세션 기본 채널 그룹
수동 트래픽 소스 측정기준:
manualCampaignId
수동 캠페인 IDmanualCampaignName
수동 캠페인 이름manualCreativeFormat
수동 광고 소재 형식manualMarketingTactic
수동 마케팅 전략manualMedium
수동 매체manualSource
수동 소스manualSourceMedium
수동 소스 / 매체manualSourcePlatform
수동 소스 플랫폼firstUserManualCampaignId
신규 사용자 수동 캠페인 IDfirstUserManualCampaignName
신규 사용자 수동 캠페인 이름firstUserManualCreativeFormat
신규 사용자 수동 광고 소재 형식firstUserManualMarketingTactic
신규 사용자 수동 마케팅 전략firstUserManualMedium
신규 사용자 수동 매체firstUserManualSource
신규 사용자 수동 소스firstUserManualSourceMedium
신규 사용자 수동 소스 / 매체firstUserManualSourcePlatform
신규 사용자 수동 소스 플랫폼sessionManualCampaignId
세션 수동 캠페인 IDsessionManualCampaignName
세션 수동 캠페인 이름sessionManualCreativeFormat
세션 수동 광고 소재 형식sessionManualMarketingTactic
세션 수동 마케팅 전략sessionManualMedium
세션 수동 매체sessionManualSource
세션 수동 소스sessionManualSourceMedium
세션 수동 소스 / 매체sessionManualSourcePlatform
세션 수동 소스 플랫폼
Campaign Manager 360 (CM360) 통합 측정기준:
cm360AccountId
CM360 계정 IDcm360AccountName
CM360 계정 이름cm360AdvertiserId
CM360 광고주 IDcm360AdvertiserName
CM360 광고주 이름cm360CampaignId
CM360 캠페인 IDcm360CampaignName
CM360 캠페인 이름cm360CreativeFormat
CM360 광고 소재 형식cm360CreativeId
CM360 광고 소재 IDcm360CreativeName
CM360 광고 소재 이름cm360CreativeType
CM360 광고 소재 유형cm360CreativeTypeId
CM360 광고 소재 유형 IDcm360CreativeVersion
CM360 광고 소재 버전cm360Medium
CM360 매체cm360PlacementCostStructure
CM360 게재위치 비용 구조cm360PlacementId
CM360 게재위치 IDcm360PlacementName
CM360 게재위치 이름cm360RenderingId
CM360 렌더링 IDcm360SiteId
CM360 사이트 IDcm360SiteName
CM360 사이트 이름cm360Source
CM360 소스cm360SourceMedium
CM360 소스 / 매체firstUserCm360AccountId
신규 사용자 CM360 계정 IDfirstUserCm360AccountName
신규 사용자 CM360 계정 이름firstUserCm360AdvertiserId
신규 사용자 CM360 광고주 IDfirstUserCm360AdvertiserName
신규 사용자 CM360 광고주 이름firstUserCm360CampaignId
신규 사용자 CM360 캠페인 IDfirstUserCm360CampaignName
신규 사용자 CM360 캠페인 이름firstUserCm360CreativeFormat
신규 사용자 CM360 광고 소재 형식firstUserCm360CreativeId
신규 사용자 CM360 광고 소재 IDfirstUserCm360CreativeName
신규 사용자 CM360 광고 소재 이름firstUserCm360CreativeType
신규 사용자 CM360 광고 소재 유형firstUserCm360CreativeTypeId
신규 사용자 CM360 광고 소재 유형 IDfirstUserCm360CreativeVersion
신규 사용자 CM360 광고 소재 버전firstUserCm360Medium
신규 사용자 CM360 매체firstUserCm360PlacementCostStructure
신규 사용자 CM360 게재위치 비용 구조firstUserCm360PlacementId
신규 사용자 CM360 게재위치 IDfirstUserCm360PlacementName
신규 사용자 CM360 게재위치 이름firstUserCm360RenderingId
신규 사용자 CM360 렌더링 IDfirstUserCm360SiteId
신규 사용자 CM360 사이트 IDfirstUserCm360SiteName
신규 사용자 CM360 사이트 이름firstUserCm360Source
신규 사용자 CM360 소스firstUserCm360SourceMedium
신규 사용자 CM360 소스 / 매체sessionCm360AccountId
세션 CM360 계정 IDsessionCm360AccountName
세션 CM360 계정 이름sessionCm360AdvertiserId
세션 CM360 광고주 IDsessionCm360AdvertiserName
세션 CM360 광고주 이름sessionCm360CampaignId
세션 CM360 캠페인 IDsessionCm360CampaignName
세션 CM360 캠페인 이름sessionCm360CreativeFormat
세션 CM360 광고 소재 형식sessionCm360CreativeId
세션 CM360 광고 소재 IDsessionCm360CreativeName
세션 CM360 광고 소재 이름sessionCm360CreativeType
세션 CM360 광고 소재 유형sessionCm360CreativeTypeId
세션 CM360 광고 소재 유형 IDsessionCm360CreativeVersion
세션 CM360 광고 소재 버전sessionCm360Medium
세션 CM360 매체sessionCm360PlacementCostStructure
세션 CM360 게재위치 비용 구조sessionCm360PlacementId
세션 CM360 게재위치 IDsessionCm360PlacementName
세션 CM360 게재위치 이름sessionCm360RenderingId
세션 CM360 렌더링 IDsessionCm360SiteId
세션 CM360 사이트 IDsessionCm360SiteName
세션 CM360 사이트 이름sessionCm360Source
세션 CM360 소스sessionCm360SourceMedium
세션 CM360 소스 / 매체
Google Display & Video 360 (DV360) 통합 측정기준:
dv360AdvertiserId
DV360 광고주 IDdv360AdvertiserName
DV360 광고주 이름dv360CampaignId
DV360 캠페인 IDdv360CampaignName
DV360 캠페인 이름dv360CreativeFormat
DV360 광고 소재 형식dv360CreativeId
DV360 광고 소재 IDdv360CreativeName
DV360 광고 소재 이름dv360ExchangeId
DV360 광고 거래 IDdv360ExchangeName
DV360 거래소 이름dv360InsertionOrderId
DV360 게재 신청서 IDdv360InsertionOrderName
DV360 게재 신청서 이름dv360LineItemId
DV360 광고 항목 IDdv360LineItemName
DV360 광고 항목 이름dv360Medium
DV360 매체dv360PartnerId
DV360 파트너 IDdv360PartnerName
DV360 파트너 이름dv360Source
DV360 소스dv360SourceMedium
DV360 소스 / 매체firstUserDv360AdvertiserId
신규 사용자 DV360 광고주 IDfirstUserDv360AdvertiserName
신규 사용자 DV360 광고주 이름firstUserDv360CampaignId
신규 사용자 DV360 캠페인 IDfirstUserDv360CampaignName
신규 사용자 DV360 캠페인 이름firstUserDv360CreativeFormat
신규 사용자 DV360 광고 소재 형식firstUserDv360CreativeId
신규 사용자 DV360 광고 소재 IDfirstUserDv360CreativeName
신규 사용자 DV360 광고 소재 이름firstUserDv360ExchangeId
신규 사용자 DV360 거래소 IDfirstUserDv360ExchangeName
신규 사용자 DV360 거래소 이름firstUserDv360InsertionOrderId
신규 사용자 DV360 게재 신청서 IDfirstUserDv360InsertionOrderName
신규 사용자 DV360 게재 신청서 이름firstUserDv360LineItemId
신규 사용자 DV360 광고 항목 IDfirstUserDv360LinteItemName
신규 사용자 DV360 광고 항목 이름firstUserDv360Medium
신규 사용자 DV360 매체firstUserDv360PartnerId
신규 사용자 DV360 파트너 IDfirstUserDv360PartnerName
신규 사용자 DV360 파트너 이름firstUserDv360Source
신규 사용자 DV360 소스firstUserDv360SourceMedium
신규 사용자 DV360 소스 / 매체sessionDv360AdvertiserId
세션 DV360 광고주 IDsessionDv360AdvertiserName
세션 DV360 광고주 이름sessionDv360CampaignId
세션 DV360 캠페인 IDsessionDv360CampaignName
세션 DV360 캠페인 이름sessionDv360CreativeFormat
세션 DV360 광고 소재 형식sessionDv360CreativeId
세션 DV360 광고 소재 IDsessionDv360CreativeName
세션 DV360 광고 소재 이름sessionDv360ExchangeId
세션 DV360 거래소 IDsessionDv360ExchangeName
세션 DV360 거래소 이름sessionDv360InsertionOrderId
세션 DV360 게재 신청서 IDsessionDv360InsertionOrderName
세션 DV360 게재 신청서 이름sessionDv360LineItemId
세션 DV360 광고 항목 IDsessionDv360LineItemName
세션 DV360 광고 항목 이름sessionDv360Medium
세션 DV360 매체sessionDv360PartnerId
세션 DV360 파트너 IDsessionDv360PartnerName
세션 DV360 파트너 이름sessionDv360Source
세션 DV360 소스sessionDv360SourceMedium
세션 DV360 소스 / 매체
Google Search Ads 360 (SA360) 통합 측정기준:
firstUserSa360AdGroupId
신규 사용자 SA360 광고 그룹 IDfirstUserSa360AdGroupName
신규 사용자 SA360 광고 그룹 이름firstUserSa360CampaignId
신규 사용자 SA360 캠페인 IDfirstUserSa360CampaignName
신규 사용자 SA360 캠페인firstUserSa360CreativeFormat
신규 사용자 SA360 광고 소재 형식firstUserSa360EngineAccountId
신규 사용자 SA360 엔진 계정 IDfirstUserSa360EngineAccountName
신규 사용자 SA360 엔진 계정 이름firstUserSa360EngineAccountType
신규 사용자 SA360 엔진 계정 유형firstUserSa360KeywordText
첫 사용자 SA360 키워드 텍스트firstUserSa360ManagerAccountId
신규 사용자 SA360 관리자 계정 IDfirstUserSa360ManagerAccountName
신규 사용자 SA360 관리자 계정 이름firstUserSa360Medium
신규 사용자 SA360 매체firstUserSa360Query
신규 사용자 SA360 검색어firstUserSa360Source
신규 사용자 SA360 소스firstUserSa360SourceMedium
신규 사용자 SA360 소스 / 매체sa360AdGroupId
SA360 광고 그룹 IDsa360CampaignId
SA360 캠페인 IDsa360AdGroupName
SA360 광고 그룹 이름sa360CampaignName
SA360 캠페인sa360CreativeFormat
SA360 광고 소재 형식sa360EngineAccountId
SA360 엔진 계정 IDsa360EngineAccountName
SA360 엔진 계정 이름sa360EngineAccountType
SA360 엔진 계정 유형sa360KeywordText
SA360 키워드 텍스트sa360ManagerAccountId
SA360 관리자 계정 IDsa360ManagerAccountName
SA360 관리자 계정 이름sa360Medium
SA360 매체sa360Query
SA360 검색어sa360Source
SA360 소스sa360SourceMedium
SA360 소스 / 매체sessionSa360AdGroupId
세션 SA360 광고 그룹 IDsessionSa360CampaignId
세션 SA360 캠페인 IDsessionSa360ManagerAccountId
세션 SA360 관리자 계정 IDsessionSa360ManagerAccountName
세션 SA360 관리자 계정 이름sessionSa360SourceMedium
세션 SA360 소스 / 매체
2024년 3월 6일 잠재고객 내보내기에서 비활성 사용자 잠재고객 지원
잠재고객 내보내기 기능은 비활성 사용자 잠재고객 내보내기를 더 잘 지원합니다. 사용자는 자격 요건을 충족하는 이벤트 없이 이러한 잠재고객에 포함됩니다. 예를 들어 사용자가 7일 동안 웹사이트를 방문하지 않으면 잠재고객에 포함될 수 있습니다. 비활성 사용자 잠재고객의 예로는 '7일간 활동이 없는 구매자', '7일간 활동이 없는 사용자', '7일간 알림을 받지 않은 사용자'가 있습니다. 추천 잠재고객에 대해 자세히 알아보려면 추천 잠재고객을 참고하세요.
2024년 2월 28일 잠재고객 내보내기에서 태그에 지정된 사용자 ID가 반환됩니다.
이제 속성에 사용자 제공 데이터가 사용 설정되어 있어도 잠재고객 내보내기에서 태그에 지정된 사용자 ID가 반환됩니다. 사용자 제공 데이터 수집이 사용 설정된 경우 측정 개선을 위해 태그 지정 시 사용자 제공 데이터와 User-ID를 Google 애널리틱스로 전송할 수 있습니다. 자세한 내용은 사용자 제공 데이터 수집을 참고하세요.
2024-01-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일 맞춤 상품 범위 매개변수
이제 다음 구문을 사용하여 애널리틱스 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년 10월 13일 멤버십 기간이 1일인 잠재고객 지원 추가
이제 잠재고객 목록 내보내기 기능에서 멤버십 기간이 1일인 잠재고객을 지원합니다.
2023년 9월 12일 AudienceList 기본 순서 지정 규칙
기본적으로 잠재고객 목록 내보내기 기능을 사용하여 생성된 보고서는 Data API의 다른 보고 방법과 동일한 순서 지정 규칙을 따릅니다. 즉, 첫 번째 열을 기준으로 내림차순으로 정렬한 다음 두 번째 열을 기준으로 내림차순으로 정렬하는 방식입니다.
이 변경사항이 적용되기 전에는 다음과 같은 보고서를 받았을 수 있습니다.
deviceId | isAdsPersonalizationAllowed |
---|---|
ABC | true |
DAC | 거짓 |
ABC | 거짓 |
AAA | true |
이 변경사항이 적용되면 다음 보고서가 제공됩니다.
deviceId | isAdsPersonalizationAllowed |
---|---|
AAA | true |
ABC | 거짓 |
ABC | true |
DAC | 거짓 |
2023년 8월 15일 잠재고객 목록 내보내기 스키마에 isLimitedAdTracking
측정기준 추가
isLimitedAdTracking
기기의 광고 추적 제한 설정입니다. 가능한 값은true
,false
,(not set)
입니다.자세한 내용은 잠재고객 목록 측정기준을 참고하세요.
2023년 8월 15일 currencyCode
측정기준, itemDiscountAmount
측정항목 추가
currencyCode
전자상거래 이벤트의 현지 통화 코드 (ISO 4217 표준 기반)입니다. 예: 'USD' 또는 'GBP'itemDiscountAmount
전자상거래 이벤트의 상품 할인 금액입니다. 이 측정항목은 태그에서 'discount' 상품 매개변수에 의해 채워집니다.
자세한 내용은 데이터 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명 | 2,000,000 |
시간당 속성별 핵심 토큰 | 50,000 | 400,000 |
시간당 속성별 프로젝트당 핵심 토큰 | 17,500 | 140,000 |
일일 속성별 실시간 토큰 수 | 250,000명 | 2,000,000 |
시간당 속성별 실시간 토큰 | 50,000 | 400,000 |
시간당 속성별 프로젝트당 실시간 토큰 수 | 17,500 | 140,000 |
일일 속성별 유입경로 토큰 수 | 250,000명 | 2,000,000 |
시간당 속성별 유입경로 토큰 수 | 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 Place 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일에 다음과 같은 호환성이 깨지는 변경사항이 적용됩니다.
itemName
와 같은 상품 범위 측정기준이eventCount
와 같은 이벤트 범위 측정항목과 호환되지 않습니다. 상품 범위 측정기준은itemRevenue
와 같은 상품 범위 측정항목,activeUsers
와 같은 사용자 기반 측정항목,sessions
와 같은 세션 기반 측정항목과 계속 호환됩니다.source
와 같은 기여 분석 측정기준이eventCount
와 같은 일부 이벤트 범위 측정항목과 호환되지 않습니다. 기여도 측정기준은conversions
와 같은 기여도 측정항목,activeUsers
와 같은 사용자 기반 측정항목,sessions
와 같은 세션 기반 측정항목과 계속 호환됩니다.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의 광고 그룹 이름입니다.sessionSa360CampaignName
세션 SA360 캠페인입니다. 이 세션으로 이어진 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
전환 이벤트를 트리거한 사용자의 비율입니다.
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
신규 사용자당 평균 첫 구매자 수입니다.dauPerMau
DAU / MAU. 30일 활성 사용자 중 1일 활성 사용자의 롤링 비율입니다.dauPerWau
DAU / WAU. 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 class 속성입니다.linkDomain
외부 연결의 대상 도메인입니다.linkId
외부 연결 링크 또는 파일 다운로드의 HTML ID 속성입니다.linkText
파일 다운로드의 링크 텍스트입니다.linkUrl
외부 연결 링크 또는 파일 다운로드의 전체 URL입니다.method
이벤트가 트리거된 메서드입니다.outbound
링크가 속성 도메인의 일부가 아닌 사이트로 연결되는 경우 'true'를 반환합니다.pageLocation
방문한 웹페이지의 프로토콜, 호스트 이름, 페이지 경로, 쿼리 문자열pageReferrer
호스트 이름과 경로가 포함된 전체 참조 URLpercentScrolled
사용자가 페이지에서 아래로 스크롤한 비율입니다(예: '90').searchTerm
사용자가 검색한 용어입니다.videoProvider
동영상의 소스 (예: 'youtube')입니다.videoTitle
동영상의 제목입니다.videoUrl
동영상의 URL입니다.visible
콘텐츠가 표시되면 'true'를 반환합니다.unifiedPagePathScreen
이벤트가 기록된 페이지 경로 (웹) 또는 화면 클래스 (앱)입니다.
2021년 9월 7일 API 스키마 변경사항
기존 측정기준의 변경사항:
unifiedPageScreen
웹에서 생성된 이벤트의 경우 이 측정기준은 이제 이벤트가 로깅된 페이지 경로 및 쿼리 문자열을 반환합니다.
예정 변경사항 공지:
firstUserTrafficOrigin
사용자를 최초로 획득한 트래픽 출처입니다. UTM을 사용하는 트래픽에 대해 이 필드가 'Manual'을 반환한다고 가정하지 마세요. 향후 기능 출시를 위해 이 필드가 'Manual'을 반환하는 것에서 '(not set)'을 반환하는 것으로 업데이트될 예정입니다.sessionTrafficOrigin
세션 캠페인의 트래픽 출처입니다. UTM을 사용하는 트래픽에 대해 이 필드가 'Manual'을 반환한다고 가정하지 마세요. 향후 기능 출시를 위해 이 필드가 'Manual'을 반환하는 것에서 '(not set)'을 반환하는 것으로 업데이트될 예정입니다.trafficOrigin
전환 이벤트 캠페인의 트래픽 출처입니다. UTM을 사용하는 트래픽에 대해 이 필드가 'Manual'을 반환한다고 가정하지 마세요. 향후 기능 출시를 위해 이 필드가 'Manual'을 반환하는 것에서 '(not set)'을 반환하는 것으로 업데이트될 예정입니다.
2021년 9월 7일 API에 checkCompatibility
메서드가 추가되었습니다.
checkCompatibility
메서드는 보고서 요청에 추가할 수 있고 호환성을 유지하는 측정기준과 측정항목을 나열합니다.
2021년 7월 21일 실시간 보고 변경사항
이제 runRealtimeReport
메서드의 minuteRanges
매개변수를 사용하여 읽을 이벤트 데이터의 분 범위를 지정할 수 있습니다.
2021년 7월 21일 새로운 채널 그룹 측정기준
Data API 보고 스키마에 새로운 채널 그룹 측정기준이 추가되었습니다.
firstUserDefaultChannelGrouping
신규 사용자 기본 채널 그룹입니다.defaultChannelGrouping
기본 채널 그룹
2021년 6월 10일 API 스키마가 변경되었습니다.
minutesAgo
측정기준이 Data API 실시간 스키마에 추가되었으며runRealtimeReport
메서드에 대한 쿼리에서 사용할 수 있습니다. 이 측정기준에는 이벤트가 수집된 시점으로부터 경과된 시간이 분 단위로 포함됩니다. 00은 현재 분을 나타내고 01은 이전 분을 나타냅니다.데이터 API 스키마에
googleAdsCreativeId
측정기준이 추가되었습니다. 이 측정기준에는 전환 이벤트에 기여한 Google Ads 광고 소재의 ID가 포함됩니다.데이터 API 스키마에
sessionGoogleAdsCreativeId
측정기준이 추가되었습니다. 이 측정기준에는 웹사이트 또는 앱에서 세션으로 연결된 Google Ads 광고 소재의 ID가 포함됩니다.데이터 API 스키마에서
firstUserCreativeId
측정기준이firstUserGoogleAdsCreativeId
으로 이름이 변경되었습니다. 이 측정기준에는 사용자를 처음 획득한 Google Ads 광고 소재의 ID가 포함됩니다.
2021년 4월 9일 Google 애널리틱스 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일은 항상 1주 차에 있습니다.
2021년 1월 28일 맞춤 측정항목의 집계 변형을 추가했습니다.
속성이 등록하는 각 맞춤 측정항목은 합계, 평균, 개수의 세 가지 API 측정항목 변형을 만듭니다.
2021년 1월 28일 새로운 날짜/시간 측정기준이 추가되었습니다.
API 스키마에 다음 새 측정기준이 추가되었습니다.
hour
, nthHour
, nthYear
, dateHour
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일 API에 getMetadata
메서드가 추가되었습니다.
getMetadata 메서드는 지정된 GA4 속성 ID에 사용할 수 있는 맞춤 측정기준 및 측정항목과 유니버설 메타데이터를 반환합니다.
2020년 10월 8일 보고서에서 맞춤 측정기준 및 측정항목을 사용할 수 있습니다.
맞춤 측정기준 및 측정항목에 관한 문서는 API 스키마 문서를 참고하세요. 이번 업데이트에는 이벤트 범위 맞춤 측정기준 및 측정항목과 사용자 범위 맞춤 측정기준이 포함됩니다.