이 문서에서는 Google 애널리틱스 Real Time Reporting API를 설명합니다. API에 대한 자세한 내용은 API 참조를 읽어보세요.
소개
Real Time Reporting API를 사용하면 인증된 사용자의 실시간 데이터(예: 속성의 실시간 활동)를 요청할 수 있습니다.
Real Time Reporting API를 사용하여 다음을 수행할 수 있습니다.
- 페이지의 활성 뷰어를 표시하고 유한한 인벤토리가 있는 항목을 보는 사용자가 긴급하다고 느끼게 합니다.
- 상위 10개 활성 페이지와 같은 가장 인기 있는 콘텐츠를 표시합니다.
- 실시간 대시보드를 만들고 표시합니다.
Google 애널리틱스 superProxy
Google 애널리틱스 superProxy를 사용하여 인증, 캐싱, 시각화 및 차트 라이브러리에서 직접 사용되는 형식으로 API 응답을 변환하는 Google 애널리틱스 API 작업의 여러 구현 세부정보를 처리할 수 있습니다.
개념 개요
Real Time Reporting API의 기본 개념은 다음과 같습니다.
- 보고서와 사용자 및 보기 (프로필)의 관계
- 보고서 구조 및 쿼리 작성 방법
- API 응답 다루기
보고서, 사용자 및 보기 (프로필)
사용자가 애플리케이션을 사용하여 보기 (프로필)에서 보고서 데이터를 요청하려면 먼저 다음을 수행해야 합니다.
- Google 애널리틱스 API를 사용 설정합니다.
- 애플리케이션이 API에 액세스할 수 있도록 사용자 인증 정보를 만듭니다.
- 애플리케이션에 사용자 인증 정보를 넣습니다.
애플리케이션을 사용하여 보고서 데이터를 요청할 때 사용자는 사용자를 대신하여 데이터에 액세스하도록 승인해야 합니다.
보기 (프로필)는 보기 (프로필) ID로 식별됩니다. 보기 (프로필)는 Google 애널리틱스 계정, 사용자, 속성, 보기의 계층 구조에 속합니다. 애플리케이션은 Management API를 사용하여 이 계층 구조를 순회하고 뷰 (프로필)를 얻을 수 있습니다.
측정기준 및 측정항목 쿼리하기
측정기준 및 측정항목으로 구성된 Google 애널리틱스 보고서 데이터의 API를 쿼리합니다. 측정항목은 현재 속성의 활성 사용자 수와 같은 사용자 활동의 개별 측정값입니다. 측정기준은 트래픽 소스, 지리적 위치, 페이지 정보 등 일반적인 기준에 따라 측정항목을 분류합니다.
측정기준 및 측정항목 참조 가이드에서 API에 제공되는 모든 측정기준과 측정항목을 살펴보세요. Real Time Reporting API 참조 가이드에서 API 쿼리에서 측정기준과 측정항목을 지정하는 방법도 알아보세요.
보고서 사용하기
API에서 반환되는 데이터는 헤더와 행 목록이 있는 테이블이라고 볼 수 있습니다. 각 API 응답은 각 열의 이름과 데이터 유형을 설명하는 헤더로 구성됩니다. 응답에는 행 목록도 포함됩니다. 여기서 각 행은 헤더와 동일한 순서로 데이터가 있는 셀 목록입니다. API 응답에 대한 자세한 내용은 Real Time Reporting API 참조 가이드를 읽어보세요.
할당량 정책
Real Time Reporting API는 수백만 개의 데이터 쿼리 작업을 처리합니다. Google에서는 할당량 시스템을 사용하여 시스템에서 처리할 수 있는 것보다 많은 작업을 수신하는 것을 방지하고 시스템 리소스의 균등한 배포를 보장합니다. 자세한 내용은 한도 및 할당량 가이드를 참조하세요.
다음 단계
이제 API 작동 방식을 이해했으므로 다음과 같이 시작합니다.
- API 관련 작업 방법은 개발자 가이드를 참고하세요.
- API를 통해 사용할 수 있는 모든 데이터의 목록은 측정기준 및 측정항목 참조 가이드를 확인하세요.
- 라이브러리 및 샘플 페이지에서 API와 함께 사용할 수 있는 모든 클라이언트 라이브러리 목록을 확인합니다.