Google 애널리틱스 데이터 API 개요

Data API를 사용하여 Google 애널리틱스 보고 데이터에 프로그래매틱 방식으로 액세스할 수 있습니다. 이 API는 기존 유니버설 애널리틱스 속성과 호환되지 않습니다.

Google 애널리틱스 속성에 대해 자세히 알아보기

Google 애널리틱스 Data API v1을 사용하여 보고할 수 있는 몇 가지 예는 다음과 같습니다.

  • 지난주 Android 앱의 일일 활성 사용자 수입니다.
  • 지난 28일 동안 사이트의 상위 10개 페이지의 페이지 조회수
  • 지난 30분 동안 iOS 앱의 국가별 활성 사용자 수

Google Analytics Data API v1을 사용하여 다음 작업을 할 수도 있습니다.

  • 맞춤 대시보드를 만들어 Google 애널리틱스 데이터를 표시합니다.
  • 복잡한 보고 작업을 자동화하여 시간을 절약하세요.
  • Google 애널리틱스 데이터를 다른 비즈니스 애플리케이션과 통합합니다.

시작하기

시작하려면 클라이언트 라이브러리 빠른 시작을 참고하세요. 구현을 간소화하기 위해 Java, Python, Node.js 및 기타 언어로 된 클라이언트 라이브러리가 있습니다.

사용 가능한 메서드

다음은 Data API 메서드 목록입니다. 자세한 내용은 참조 문서를 확인하세요.

  • runReport 이 메서드는 Google 애널리틱스 이벤트 데이터의 맞춤 보고서를 반환하며 간단한 보고서 쿼리에 권장되는 메서드입니다.
  • batchRunReports: 단일 API 호출을 사용하여 여러 보고서를 생성할 수 있는 runReport 메서드의 일괄 버전입니다.
  • runPivotReport 이 메서드는 Google 애널리틱스 이벤트 데이터의 맞춤 피벗 보고서를 반환합니다. 피벗 보고서는 일반 보고서보다 고급스럽고 표현력이 뛰어난 형식입니다. 각 피벗은 보고서 응답에 표시된 측정기준 열과 행을 설명합니다.
  • batchRunPivotReports runPivotReport 메서드의 일괄 버전으로, 단일 API 호출을 사용하여 여러 보고서를 생성할 수 있습니다.
  • getMetadata 이 메서드는 보고 메서드에서 사용할 수 있는 측정기준 및 측정항목의 메타데이터를 반환합니다. 측정기준과 측정항목을 탐색하는 데 사용됩니다. 이 메서드의 응답에는 지정된 Google 애널리틱스 속성에 사용할 수 있는 맞춤 측정기준 및 측정항목도 포함됩니다.
  • checkCompatibility 이 메서드는 보고서 요청에 추가하여 호환성을 유지할 수 있는 측정기준과 측정항목을 나열합니다.
  • runRealtimeReport 이 메서드는 속성의 맞춤 실시간 이벤트 데이터 보고서를 반환합니다. 이벤트는 Google 애널리틱스로 전송된 후 몇 초 내에 실시간 보고서에 표시됩니다. 실시간 보고서에는 현재 시점부터 30분 전까지의 기간 (Google 애널리틱스 360 속성의 경우 최대 60분)에 대한 이벤트 및 사용 데이터가 표시됩니다.
  • properties.audienceExports 잠재고객의 사용자 스냅샷을 포함하는 잠재고객 내보내기를 생성할 수 있는 메서드 그룹입니다.
  • properties.recurringAudienceLists (사전 체험판) 반복되는 잠재고객 내보내기를 관리할 수 있는 메서드 그룹입니다. 반복 잠재고객 내보내기는 매일 새로운 잠재고객 목록을 생성합니다.
  • runFunnelReport (사전 체험판) 이 메서드는 Google 애널리틱스 이벤트 데이터의 맞춤 유입경로 보고서를 반환합니다. 유입경로 탐색 분석을 사용하면 사용자가 작업을 완료하기 위해 실행하는 단계를 시각화하고 단계별 작업 완료 또는 실패 여부를 신속하게 확인할 수 있습니다.

지원되는 측정기준 및 측정항목

Data API에서 지원하는 모든 측정기준과 측정항목의 목록은 API 스키마 문서를 참고하세요.