Data API를 사용하여 Google 애널리틱스 보고 데이터에 프로그래매틱 방식으로 액세스할 수 있습니다. 이 API는 기존 유니버설 애널리틱스 속성과 호환되지 않습니다.
Google 애널리틱스 Data API v1을 사용하여 보고할 수 있는 몇 가지 예는 다음과 같습니다.
- 지난주 Android 앱의 일일 활성 사용자 수입니다.
- 지난 28일 동안 사이트의 상위 10개 페이지의 페이지 조회수
- 지난 30분 동안 iOS 앱의 국가별 활성 사용자 수
Google Analytics Data API v1을 사용하여 다음 작업을 할 수도 있습니다.
- 맞춤 대시보드를 만들어 Google 애널리틱스 데이터를 표시합니다.
- 복잡한 보고 작업을 자동화하여 시간을 절약하세요.
- Google 애널리틱스 데이터를 다른 비즈니스 애플리케이션과 통합합니다.
데이터 일관성 및 보고 ID
Google 애널리틱스 Data API v1은 Google 애널리틱스 인터페이스와 동일한 보고 데이터에 액세스합니다. API에서 반환된 데이터는 Google 애널리틱스 속성에 구성된 보고 ID 설정을 완전히 준수하므로 사용자 수, 중복 삭제, 데이터 모델링이 속성 설정에서 선택한 ID 공간(예: 혼합, 관측, 기기 기반)과 일치합니다.
다양한 ID 공간이 보고서에 미치는 영향을 자세히 알아보려면 보고 ID를 참고하세요.
시작하기
시작하려면 클라이언트 라이브러리 빠른 시작을 참고하세요. 구현을 간소화하기 위해 Java, Python, Node.js 및 기타 언어로 된 클라이언트 라이브러리가 있습니다.
사용 가능한 메서드
다음은 Data API 메서드 목록입니다. 자세한 내용은 참조 문서를 확인하세요.
runReport이 메서드는 Google 애널리틱스 이벤트 데이터의 맞춤 보고서를 반환하며 단순 보고서 쿼리에 기본적으로 사용되는 방법입니다.batchRunReports: 단일 API 호출을 사용하여 여러 보고서를 생성할 수 있는 runReport 메서드의 일괄 버전입니다.runPivotReport이 메서드는 Google 애널리틱스 이벤트 데이터의 맞춤 피벗 보고서를 반환합니다. 피벗 보고서는 일반 보고서보다 고급스럽고 표현력이 뛰어난 형식입니다. 각 피벗은 보고서 응답에 표시된 측정기준 열과 행을 설명합니다.batchRunPivotReportsrunPivotReport 메서드의 일괄 버전으로, 단일 API 호출을 사용하여 여러 보고서를 생성할 수 있습니다.getMetadata이 메서드는 보고 메서드에서 사용할 수 있는 측정기준 및 측정항목의 메타데이터를 반환합니다. 측정기준과 측정항목을 탐색하는 데 사용됩니다. 이 메서드의 응답에는 지정된 Google 애널리틱스 속성에 사용할 수 있는 맞춤 측정기준 및 측정항목도 포함됩니다.checkCompatibility이 메서드는 보고서 요청에 추가하여 호환성을 유지할 수 있는 측정기준과 측정항목을 나열합니다.runRealtimeReport이 메서드는 속성의 맞춤 실시간 이벤트 데이터 보고서를 반환합니다. 이벤트는 Google 애널리틱스로 전송된 후 몇 초 내에 실시간 보고서에 표시됩니다. 실시간 보고서에는 현재 시점부터 30분 전까지의 기간 (Google 애널리틱스 360 속성의 경우 최대 60분)에 대한 이벤트 및 사용 데이터가 표시됩니다.properties.audienceExports잠재고객의 사용자 스냅샷을 포함하는 잠재고객 내보내기를 생성할 수 있는 메서드 그룹입니다.properties.recurringAudienceLists(사전 체험판) 반복되는 잠재고객 내보내기를 관리할 수 있는 메서드 그룹입니다. 반복 잠재고객 내보내기는 매일 새로운 잠재고객 목록을 생성합니다.runFunnelReport(사전 체험판) 이 메서드는 Google 애널리틱스 이벤트 데이터의 맞춤 유입경로 보고서를 반환합니다. 유입경로 탐색 분석을 사용하면 사용자가 작업을 완료하기 위해 실행하는 단계를 시각화하고 단계별 작업 완료 또는 실패 여부를 신속하게 확인할 수 있습니다.
지원되는 측정기준 및 측정항목
Data API에서 지원하는 모든 측정기준과 측정항목의 목록은 API 스키마 문서를 참고하세요.