Google 애널리틱스 Data API v1을 사용하면 Google 애널리틱스 4 (GA4) 보고서 데이터에 프로그래매틱 방식으로 액세스할 수 있습니다. Google 애널리틱스 4는 사용자가 웹, iOS 또는 Android 앱을 사용하는 방법을 이해하는 데 도움이 됩니다. Google 애널리틱스 4 속성 자세히 알아보기
Google Analytics Data API v1에서는 보고서를 작성하여 다음과 같은 질문에 답할 수 있습니다.
- 지난주에 내 Android 앱의 일일 활성 사용자 수는?
- 지난 28일간 내 사이트의 상위 10개 페이지 URL 각각에 페이지 조회수가 얼마나 발생했나요?
- 지난 30분 동안 국가별로 iOS 앱을 사용 중인 사용자는 몇 명인가요?
Google Analytics Data API v1을 사용하여 다음을 수행할 수도 있습니다.
- Google 애널리틱스 데이터를 표시하는 커스텀 대시보드를 빌드합니다.
- 복잡한 보고 작업을 자동화하여 시간을 절약하세요.
- Google 애널리틱스 데이터를 다른 비즈니스 애플리케이션과 통합합니다.
빠른 시작 가이드
단 몇 줄의 코드만으로 API를 호출하여 첫 번째 보고서를 만들 수 있습니다. 클라이언트 라이브러리를 사용한 빠른 시작을 참조하여 시작하세요. 구현을 간소화하는 자바, Python, Node.js, 기타 언어로 된 클라이언트 라이브러리가 있습니다.
사용 가능한 메서드
- runReport: Google 애널리틱스 이벤트 데이터의 맞춤 보고서를 반환하는 방법으로, 간단한 보고서 쿼리를 위해 선호되는 방법입니다.
- batchRunReports: 단일 API 호출을 사용하여 여러 보고서를 생성할 수 있는 runReport 메서드의 일괄 버전입니다.
- runPivotReport: Google 애널리틱스 이벤트 데이터의 맞춤 피봇 보고서를 반환합니다. 피봇 보고서는 일반 보고서보다 더 풍부하고 다양한 형식을 제공합니다. 각 피봇은 보고서 응답에 표시되는 측정기준 열과 행을 설명합니다.
- batchRunPivotReports: 단일 API 호출을 사용하여 여러 보고서를 생성할 수 있는 runPivotReport 메서드의 일괄 버전입니다.
- getMetadata: 이 메서드는 보고 메서드에서 사용할 수 있는 측정기준 및 측정항목에 대한 메타데이터를 반환합니다. 측정기준과 측정항목을 탐색하는 데 사용됩니다. 이 메서드의 응답에는 지정된 GA4 속성에 사용할 수 있는 맞춤 측정기준 및 측정항목도 포함됩니다.
- runRealtimeReport: 이 메서드는 속성의 실시간 이벤트 데이터에 관한 맞춤 보고서를 반환합니다. 이벤트가 Google 애널리틱스로 전송된 후 몇 초 후에 실시간 보고서에 표시됩니다. 실시간 보고서에는 현재 시점부터 30분 전까지의 기간 (Google 애널리틱스 360 속성의 경우 최대 60분) 동안 이벤트 및 사용 데이터가 표시됩니다.
- runFunnelReport (초기 미리보기) 이 메서드는 Google 애널리틱스 이벤트 데이터의 맞춤 유입경로 보고서를 반환합니다. 유입경로 탐색 분석을 사용하면 사용자가 작업을 완료하기 위해 실행하는 단계를 시각화하고 단계별 작업 완료 또는 실패 여부를 신속하게 확인할 수 있습니다.
지원되는 측정기준 및 측정항목
API 스키마 문서에는 현재 Analytics Data API에서 지원하는 측정기준과 측정항목이 나와 있습니다.