개요

이 문서에서는 Google 애널리틱스 Real Time Reporting API를 설명합니다. API에 대한 자세한 참조는 API 참조를 확인하세요.

소개

Real Time Reporting API를 사용하면 인증된 사용자의 실시간 데이터(예: 속성에서 실시간 활동)를 요청할 수 있습니다.

Real Time Reporting API를 사용하여 다음을 수행할 수 있습니다.

  • 페이지의 활성 사용자를 표시하여 유한한 인벤토리가 있는 항목을 보고 있는 사용자에게 긴박한 느낌을 줍니다.
  • 상위 10개 활성 페이지와 같이 가장 인기 있는 콘텐츠를 표시합니다.
  • 실시간 대시보드를 만들고 표시합니다.

Google 애널리틱스 수퍼프록시

Google 애널리틱스 superProxy를 사용하면 Google 애널리틱스 API를 사용하여 시각화 및 차트 라이브러리에 직접 사용되는 형식으로 API 응답을 인증, 캐싱, 변환하는 다양한 구현 세부정보를 처리할 수 있습니다.

개념 개요

Real Time Reporting API의 기본 개념은 다음과 같습니다.

  • 보고서와 사용자 및 보기 (프로필)의 관계
  • 보고서의 구조 및 쿼리를 작성하는 방법
  • API 응답 작업

보고서, 사용자, 보기 (프로필)

사용자가 애플리케이션을 사용하여 보기 (프로필)에서 보고서 데이터를 요청할 수 있으려면 먼저 다음 작업을 완료해야 합니다.

  1. Google 애널리틱스 API를 사용 설정합니다.
  2. 애플리케이션이 API에 액세스할 수 있도록 사용자 인증 정보를 만듭니다.
  3. 애플리케이션에 사용자 인증 정보를 삽입합니다.

애플리케이션을 사용하여 보고서 데이터를 요청할 때 사용자는 자신을 대신하여 데이터에 액세스할 수 있도록 승인해야 합니다.

보기 (프로필)는 보기 (프로필) ID로 식별됩니다. 보기 (프로필)는 다른 항목과 함께 Google 애널리틱스 계정, 사용자, 속성 및 보기의 계층 구조의 일부입니다. 애플리케이션은 Management API를 사용하여 이 계층 구조를 순회하고 뷰 (프로필)를 가져올 수 있습니다.

측정기준 및 측정항목 쿼리

측정기준과 측정항목으로 구성된 Google 애널리틱스 보고서 데이터에 대해 API를 쿼리합니다. 측정항목은 현재 속성에 존재하는 활성 사용자 수와 같은 사용자 활동의 개별 측정값입니다. 측정기준은 트래픽 소스, 지리적 위치, 페이지 정보 등 일반적인 몇 가지 기준으로 측정항목을 분류합니다.

측정기준 및 측정항목 참조 가이드를 사용하여 API에서 사용할 수 있는 모든 측정기준과 측정항목을 [노출로] 살펴볼 수 있습니다. 또한 API 쿼리에서 측정기준 및 측정항목을 지정하는 방법을 알아보려면 Real Time Reporting API 참조 가이드를 확인하세요.

보고서 사용

API에서 반환되는 데이터는 헤더와 행 목록이 있는 테이블로 생각할 수 있습니다. 각 API 응답은 각 열의 이름과 데이터 유형을 설명하는 헤더로 구성됩니다. 응답에는 행 목록도 포함되며, 각 행은 데이터가 헤더와 동일한 순서의 셀 목록입니다. API 응답에 대한 자세한 내용은 Real Time Reporting API 참조 가이드를 확인하세요.

할당량 정책

Real Time Reporting API는 수백만 개의 데이터 쿼리 작업을 처리합니다. 할당량 시스템을 도입하여 시스템이 처리할 수 있는 수준보다 더 많은 작업을 수신하지 않도록 보호하고 시스템 리소스의 균등한 분배를 보장합니다. 자세한 내용은 한도 및 할당량 가이드를 참조하세요.

다음 단계

이제 API의 작동 방식을 이해했으니 시작하는 방법은 다음과 같습니다.