Google Analytics Data API(GA4) 연동하기 - 3. gcloud CLI

Google Analytics Data API(GA4) 연동하기 - 3. gcloud CLI

Overview

GA4 리포팅은 기존 Google Analytics와 같이 SDK, API, CLI 등의 인터페이스를 모두 제공하고 있다. gcloud cli가 익숙하다면 "CLI를 활용한 GA4 리포트 생성 및 조회" 기능을 통해 데이터를 바로 조회할 수 있다. 해당 CLI 기능 테스트를 진행할 경우 설정 및 인증 단계를 함께 이해하는 것이 필요하므로, command line 활용이 익숙하지 않은 경우 Google에서 제공하는 Try this API 기능을 활용하여 데이터 조회시 필요한 GA4 Property 확인 및 Dimension을 조회조건에 추가하는 방법을 익힐 것을 권장한다.

 

Quckstart Using the Command Line

Step1. Enable the API

아래 파란버튼('Enable the Google Analytics Data API v1')을 누르면 설명과 같이 아래 3가지 내용이 함께 활성화된다.

• 새 프로젝트('Quick Start') 생성
• GA Data API v1 사용하기 활성화
• OAuth2 credentials 생성

프로젝트 생성 및 기능 활성화

 

참고로 별도의 프로젝트를 생성한 경우, 2번(GA Data API v1 활성화), 3번(OAuth2 credentials 생성)은 프로젝트 설정에서 진행하면 된다.

프로젝트 API 활성화

credentials.json 파일 다운로드

 

Step2. Install and initialize the Cloud SDK

gcloud 미설치 시 아래 링크에 방문하여 해당 OS에 따라 CLI를 설치한다.

gcloud CLI 설치  |  Google Cloud

 

Step3. Make an API call

Select a Reporting Entity

우선 Property ID를 확인한다. Property ID는 GA4 Admin > Property > Property Settings에서 확인할 수 있다.

Property ID 확인

GA4 속성 ID 확인(GA4 Property ID)

cli 변수로 등록하여 조회할 경우 헬프센터 가이드와 같이 export에 해당 Property 값을 추가하면 된다.

즉, GA4 Property ID가 123456790이면 아래와 같이 설정하면 된다.

$ export GA4_PROPERTY_ID=1234567890

 

Create the Request JSON

request body에 사용할 JSON 파일을 생성해 둡니다.(기술문서에 따르면 plain text로 저장 후 테스트)

{
  "dateRanges": [{ "startDate": "2023-05-14", "endDate": "2023-05-21" }],
  "dimensions": [{ "name": "country" }],
  "metrics": [{ "name": "activeUsers" }]
}

 

Authenticate(인증)

credentials.json은 Step1에서 다운로드한 파일을 활용하고, 경로는 다운로드한 위치를 지정하면 된다.

credentials.json 위치확인

 

Auth 명령어 실행

gcloud auth application-default login \
    --scopes=https://www.googleapis.com/auth/analytics.readonly \
    --client-id-file=[PATH/TO/credentials.json]

OAuth2 인증화면

인증완료 리디렉트 결과페이지

 

리포트 실행요청(Send the request)

curl -X POST \
  -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
  -H "Content-Type: application/json; charset=utf-8" \
  https://analyticsdata.googleapis.com/v1beta/properties/$GA4_PROPERTY_ID:runReport -d @request.json

 

리포트 조회결과

기타

Try this API 사용해보기

라이브러리 > Try THIS API

 

Try this API 선택 시 아래 화면으로 이동한다. 조회하고자 하는 GA4의 Property ID를 동일하게 필수 파라미터로 입력하면 된다.

Request Body는 Dimension, Metric을 등록하면 되는데 조회가능한 지표는 아래 API Dimensions & Metrics에서 확인하면 된다.

Try this method - Default 화면

Try this method - 확장 보기화면

참고자료

gcloud CLI 사용

API 빠른 시작: 명령줄 사용  |  Google Analytics Data API  |  Google for Developers

API 측정기준 및 측정항목

API 측정기준 및 측정항목  |  Google Analytics Data API  |  Google for Developers