이 문서에서는 Google 애널리틱스 Core Reporting API 버전 3.0을 개략적으로 설명합니다. API에 관한 자세한 내용은 참조 가이드를 확인하세요.
소개
Google 애널리틱스 Core Reporting API를 사용하면 Google 애널리틱스의 대부분의 보고서 데이터에 액세스할 수 있습니다. Core Reporting API를 사용하면 다음을 수행할 수 있습니다.
- 맞춤 대시보드를 빌드하여 Google 애널리틱스 데이터를 표시합니다.
- 복잡한 보고 작업을 자동화하여 시간을 절약합니다.
- Google 애널리틱스 데이터를 다른 비즈니스 애플리케이션과 통합합니다.
버전 선택
최근 새로운 버전의 Core Reporting API가 출시되었습니다.
- 새 애플리케이션을 빌드하시나요? – 최신 버전 3.0을 사용하는 것이 좋습니다.
- 기존 버전 2.3을 사용 중인가요? – 새 버전을 사용하도록 앱을 업데이트하는 방법에 관한 자세한 내용은 이전 가이드를 참고하세요.
시작하기
지금 당장 시작하고 싶으신가요? Hello Analytics API 튜토리얼 읽기
API를 사용하는 각 애플리케이션은 등록, 사용자 승인, API 작업을 위해 몇 가지 단계를 거쳐야 합니다. 이 튜토리얼에서는 각 단계를 살펴보고 마지막에는 맞춤설정할 수 있는 작동하는 애플리케이션을 만들게 됩니다.
개념 개요
Core Reporting API는 Google 애널리틱스 추적 코드에서 수집한 데이터에서 파생된 통계로 구성된 보고서 데이터를 반환합니다. 각 보고서는 측정기준 및 측정항목으로 구성됩니다. 맞춤설정된 보고서를 빌드하기 위해 Core Reporting API를 사용하여 측정기준 및 측정항목을 쿼리합니다.
Core Reporting API에는 세 가지 기본 개념이 있습니다.
- 보고서와 사용자 및 보기 (프로필)의 관계
- 보고서 구조 및 쿼리 작성 방법
- API 응답 다루기
보고서, 사용자 및 보기 (프로필)
사용자의 보고서 데이터를 요청하려면 애플리케이션에서 사용자를 식별하고 데이터를 가져올 뷰 (프로필)를 지정해야 합니다. 사용자는 승인 사용자 인증 정보를 획득하고 각 API 요청에 전달하여 식별됩니다. 보기 (프로필)는 Google 애널리틱스 구성 계층 구조의 일부이며 보기 (프로필) ID로 식별됩니다.
보기 (프로필) ID를 찾는 방법에는 여러 가지가 있습니다.
- 애플리케이션에서 Management API를 사용하여 관리 구성 계층 구조를 순회하여 뷰 (프로필) ID를 가져올 수 있습니다.
- Google 애널리틱스 각 보고서의 URL
스크린샷
- Google 애널리틱스의 메뉴 바에서 관리를 클릭합니다. 보기가 속한 계정과 속성을
선택합니다. 뷰 열에서 뷰 설정을 클릭하여 뷰 ID를 가져옵니다.
스크린샷
측정기준 및 측정항목 쿼리하기
측정기준과 측정항목으로 구성된 Google 애널리틱스 보고서 데이터의 API를 쿼리합니다. 측정항목은 속성에서 사용자 활동(예: 세션 및 페이지 조회)의 개별 측정값입니다. 측정기준은 국가, 브라우저 등 일반적인 기준별로 측정항목을 분류합니다. 검색어를 만들 때 보고서 데이터에 포함할 측정기준과 측정항목을 지정합니다.
대화형 측정기준 및 측정항목 참조 가이드를 통해 API를 통해 노출된 모든 측정기준과 측정항목을 살펴보세요. Core Reporting API 참조 가이드에서 API 쿼리에서 측정기준 및 측정항목을 지정하는 방법도 알아보세요.
보고서 사용하기
API에서 반환되는 데이터는 헤더와 행 목록이 있는 테이블로 생각할 수 있습니다. 각 API 응답은 각 열의 이름과 데이터 유형을 설명하는 헤더로 구성됩니다. 응답에는 행 목록도 포함됩니다. 여기서 각 행은 헤더와 동일한 순서로 데이터가 있는 셀 목록입니다. 헤더의 정보를 사용하여 각 셀의 데이터 유형을 확인합니다.
API 응답에 대한 자세한 내용은 Core Reporting API 참조 가이드를 참고하세요.
할당량 및 지원 중단 정책
Google 애널리틱스 API는 수백만 개의 작업을 처리합니다. 시스템에서 처리할 수 있는 것보다 많은 작업을 수신하는 것을 방지하고 시스템 리소스의 균등한 배포를 보장하려면 할당량 시스템을 사용해야 합니다. 구체적인 한도는 한도 및 할당량 가이드를 참조하세요.
Core Reporting API 열의 변경사항 (예: 측정기준 및 측정항목)이 처리되는 방식에 대한 자세한 내용은 데이터 지원 중단 정책을 참조하세요. Metadata API를 사용하여 지원 중단된 열을 확인하는 방법을 알아보려면 Metadata API 개발자 가이드를 참고하세요.
다음 단계
이제 API의 작동 방식을 이해했으므로 시작하는 데 도움이 되는 다양한 리소스를 제공합니다.
- API 관련 작업 방법은 개발자 가이드를 참고하세요.
- 대화형 쿼리 탐색기 도구를 사용하여 API를 통해 쿼리를 시각적으로 빌드하고 응답을 확인합니다.
- Core Reporting API에 대한 가장 일반적인 몇 가지 쿼리가 나와 있는 일반 쿼리 도움말을 읽습니다.
- API를 통해 사용 가능한 모든 데이터의 목록은 측정기준 및 측정항목 참조를 확인하세요.
- 이 API와 함께 사용할 수 있는 모든 클라이언트 라이브러리 목록을 라이브러리 및 샘플 페이지에서 확인하세요.