Google 애널리틱스 Real Time Reporting API 변경 로그

Google은 새로운 기능을 제공하고 이전 버전에서 발견된 결함을 복구하기 위해 Google 애널리틱스 Real Time Reporting API를 정기적으로 업데이트합니다. 대부분의 경우 이러한 변경사항은 API 개발자에게 투명하게 전달됩니다. 하지만 개발자가 기존 애플리케이션을 수정해야 하는 변경이 필요한 경우도 있습니다.

이 페이지에서는 애플리케이션에 영향을 줄 수 있는 Google 애널리틱스 Real Time Reporting API의 변경사항을 설명합니다. API 개발자는 이 목록을 주기적으로 참고하여 새로운 공지사항을 확인하는 것이 좋습니다. 아래 구독 섹션에 나열된 피드를 통해 변경사항을 확인할 수도 있습니다.

관련 변경 로그 구독

모든 수집, 구성, Reporting API가 포함됩니다.

Core Reporting API, 다중 채널 유입경로 Reporting API, Real Time Reporting API가 포함되어 있습니다.

애널리틱스 Real Time API 할당량 및 한도가 변경되었습니다.

애널리틱스 Real Time Reporting API 호출은 다른 애널리틱스 API 호출과 마찬가지로 보기(프로필)당 하루 10,000회 호출에 기여합니다. 이제 애널리틱스 Real Time Reporting API 호출이 별도로 계산되므로 애널리틱스 Real Time Reporting API를 사용하여 보기(프로필)당 하루 10,000회의 호출을 할 수 있고 다른 애널리틱스 API를 사용하여 보기(프로필)당 하루 10,000회의 호출을 더 할 수 있습니다. 자세한 내용은 한도 및 할당량 페이지를 참고하세요.

이 변경으로 인해 더 세밀하고 안전하게 할당량을 관리할 수 있으므로, 애널리틱스 Real Time Reporting API를 사용하여 자주 호출해도 하루 중 남은 시간 동안 개별 프로필에 대한 다른 모든 애널리틱스 API 호출이 실수로 차단되지 않습니다.

버그 수정 출시입니다.

  • 이 출시 버전에서는 Real Time Reporting API 쿼리에서 필터링 제약 조건을 강제로 적용하는 문제가 해결되었습니다. rt:activeUsers 및 이벤트 수준 측정기준에 대한 필터가 포함된 요청은 badRequest 이유 및 OR operator not supported for a hit level filter 메시지와 함께 오류가 발생합니다. 쿼리 제약조건에 대한 자세한 내용은 Real Time Reporting API 개발자 가이드를 참고하세요.

이 출시 버전에는 새로운 측정기준이 포함됩니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

시간

  • 측정기준 - rt:minutesAgo - 조회가 발생한 시간(분)

이 출시 버전에서는 측정기준 및 측정항목의 이름이 변경되었습니다. 전체 정의 목록은 측정기준 및 측정항목 참조를 참고하세요.

측정기준 및 측정항목 이름이 변경됨

다음 측정기준 및 측정항목의 이름이 변경되었습니다. 데이터 이름 변경에 대한 자세한 내용은 데이터 지원 중단 정책을 참고하세요.

사용자

  • 측정기준 - rt:visitorType - rt:userType을 대신 사용하세요.
  • 측정항목 - rt:activeVisitors - rt:activeUsers를 대신 사용하세요.

ga: 접두어가 지원 중단됨

ga: 접두어가 모든 실시간 측정기준과 측정항목에서 지원 중단되고 새로운 rt: 접두어로 대체되었습니다. ga: 접두어를 사용하는 API 요청은 6개월 동안 계속 작동하지만 그 후에는 오류가 반환됩니다.

새로운 측정기준 및 측정항목

이 업데이트에서는 Real Time Reporting API에 새로운 측정기준 및 측정항목이 추가되었습니다. 전체 목록은 측정기준 및 측정항목 참조를 참고하세요.

이벤트 추적

  • 측정기준 - rt:eventAction - 이벤트의 작업
  • 측정기준 - rt:eventCategory - 이벤트의 카테고리
  • 측정기준 - rt:eventLabel - 이벤트의 라벨
  • 측정기준 - rt:totalEvents - 프로필에서 발생한 모든 카테고리의 총 이벤트 수

목표 추적

  • 측정기준 - rt:goalId - 목표 ID에 해당하는 문자열
  • 측정항목 - rt:goalXXValue: 요청된 목표 번호의 총 숫자 값. 여기서 XX는 1과 20 사이의 숫자입니다.
  • 측정항목 - rt:goalValueAll - 프로필에 정의된 모든 목표의 총 숫자 값
  • 측정항목 - rt:goalXXCompletions: 요청된 목표 번호의 총 달성 횟수. 여기서 XX는 1과 20 사이의 숫자입니다.
  • 측정항목 - rt:goalCompletionsAll - 프로필에 정의된 모든 목표의 총 달성 횟수

페이지 추적

  • 측정항목 - rt:pageViews - 총 페이지 조회수

앱 추적

  • 측정항목 - rt:screenViews - 총 화면 조회수

제한된 베타 버전으로 제공되는 Real Time Reporting API의 최초 출시 버전입니다.

  • Real Time Reporting API를 사용하면 속성에서 발생하는 활동을 실시간으로 보고할 수 있습니다. Real Time Reporting API를 사용하여 고객 대상 웹 위젯 및 대시보드를 만들기 위한 측정기준과 측정항목을 쿼리할 수 있습니다. 자세한 내용은 Real Time Reporting API 개요를 참고하세요.