Core Reporting API란? - 개요

이 문서에서는 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의 기반이 되는 세 가지 기본 개념은 다음과 같습니다.

  1. 보고서와 사용자 및 보기 (프로필)의 관계
  2. 보고서의 구조 및 쿼리를 작성하는 방법
  3. 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와 함께 사용할 수 있는 모든 클라이언트 라이브러리 목록은 라이브러리 및 샘플 페이지를 확인하세요.

맨 위로