구글 애널리틱스(이하 GA)가 제공하는 GA 화면, 조금더 나아가서는 커스터마이즈 리포트가 GA에서 할수 있는 정도다라고 생각했던 때가 있었습니다. (그것 밖에 안봤으니까)
사실 이것만에 대해서는 많은 시간을 들이지 않고 기능을 익힐 수 있습니다. 하지만 깊게 파고들면 GA 분석 화면은 빙산의 일각일뿐 구글 애널리틱스만의 거대한 생태계가 들어나게 됩니다. 구글 마케팅 플랫폼 + 구글 클라우드 까지 가게되면 말입니다. 최근 저는 GA에 대해 정말이지 많은 것들을 접하고 시도해보고 있습니다. 그중에서 구글 애널리틱스에서 사용할 수 있는 API 기능을 소개해봅니다.
구글 애널리틱스에서는 다양한 다양한 API 기능을 제공하는데, API를 사용하기 위한 세팅 방법을 알아봅니다. API란(application programming interface)로 외부 기능과 연결하여 기본 기능외 확장 기능을 사용할 수 있게 해주는 것을 말합니다. 이번 예시에서는 파이썬을 통해 GA에 접근해 세션 정보를 가져와서 출력해보겠습니다. 참고로 구글에서 제공하는 API 기능들은 사용하려면 다소 복잡합니다. 잘 모르겠다면 일단 이런 확장기능이 있다는 정도로만 알아둡시다.
A. 구글 애널리틱스 셋팅
1. 구글 API 프로젝트 생성
구글 API 콘솔에 접속해서 API 프로젝트를 만듭니다.
2. Service Account 만들기
Analytics API를 사용하려면, Google cloud에 Service Account를 갖고 있어야 합니다. 자신의 Service Account에 들어가면 Key를 생성할 수 있고 json 파일로 내려 받을 수 있습니다. Service Account 를 만듭니다.
Oauth 클라이언트 ID, 서비스 계정 키를 선택하여 발급 받을 수 있습니다. 우리는 2번을 필요로 합니다.
1. Oauth Client ID : 키를 받으면 Oauth 인증을 통해 앱 사용자가 엑세스 할 수 있게 됩니다. (높은수준)
2. Service Account : 서버 간의 앱 수준 인증시 사용합니다.
적당한 이름을 넣으면 ~@~iam.gserviceaccount.com 이라는 계정이 만들어집니다. 이 계정이 앞으로 API 서비스를 이용할대 사용할 계정입니다.
Service Account를 만들었으면 json파일을 다운 받습니다. 아 파일은 API를 사용할때 쓰는 키라고 생각하면 됩니다.
3. 구글 애널리틱스에 서비스 계정 등록 (Analytics API 설정)
Service Account의 email에 Read 권한을 주지 않으면 데이터를 읽을 수 없기 때문에 Service Account의 email 주소를 나의 Google Analytics에 등록해야 합니다. 아래와 같이 + 버튼을 눌러 만들어진 서비스 계정을 추가해줍니다. ( ~@~iam.gserviceaccount.com )
B. 파이썬 셋팅
이제 파이썬을 셋팅할 차례입니다. 저는 파이썬으로 하지만 여러분이 사용하고자 하는 랭귀지에 따라 다르게 진행될 수 있습니다.
1. 구글 API와 파이썬을 연동하기 위한 'google-api-python-client' 패키지를 파이썬에 설치합니다. 저는 파이참을 이용해 설치했습니다.
2. 첨부파일에 동봉된 파이썬 스크립트를 띄웁니다.
3. key 파일의 path는 자신에 경로에 맞게 변경을 해야 합니다. key파일은 앞서서 다운 받은 json 파일입니다. 파일 경로를 잘 설정합니다.
key_file_location = '여기에 키경로 입력'
4. 파이썬 스크립트를 실행해 봅니다. GA에 접근해서 성공적으로 데이터를 가져온다면 아래와 같이 출력됩니다.
905개의 세션이 집계되었다고 출력이 되었습니다. 이런식으로 GA 분석화면에서 처리하지 못했던 다양한 데이터들도 자동화하고 처리할 수 있습니다.
구글 애널리틱스(이하 GA)가 제공하는 GA 화면, 조금더 나아가서는 커스터마이즈 리포트가 GA에서 할수 있는 정도다라고 생각했던 때가 있었습니다. (그것 밖에 안봤으니까)
사실 이것만에 대해서는 많은 시간을 들이지 않고 기능을 익힐 수 있습니다. 하지만 깊게 파고들면 GA 분석 화면은 빙산의 일각일뿐 구글 애널리틱스만의 거대한 생태계가 들어나게 됩니다. 구글 마케팅 플랫폼 + 구글 클라우드 까지 가게되면 말입니다. 최근 저는 GA에 대해 정말이지 많은 것들을 접하고 시도해보고 있습니다. 그중에서 구글 애널리틱스에서 사용할 수 있는 API 기능을 소개해봅니다.
구글 애널리틱스에서는 다양한 다양한 API 기능을 제공하는데, API를 사용하기 위한 세팅 방법을 알아봅니다. API란(application programming interface)로 외부 기능과 연결하여 기본 기능외 확장 기능을 사용할 수 있게 해주는 것을 말합니다. 이번 예시에서는 파이썬을 통해 GA에 접근해 세션 정보를 가져와서 출력해보겠습니다. 참고로 구글에서 제공하는 API 기능들은 사용하려면 다소 복잡합니다. 잘 모르겠다면 일단 이런 확장기능이 있다는 정도로만 알아둡시다.
A. 구글 애널리틱스 셋팅
1. 구글 API 프로젝트 생성
구글 API 콘솔에 접속해서 API 프로젝트를 만듭니다.
2. Service Account 만들기
Analytics API를 사용하려면, Google cloud에 Service Account를 갖고 있어야 합니다. 자신의 Service Account에 들어가면 Key를 생성할 수 있고 json 파일로 내려 받을 수 있습니다. Service Account 를 만듭니다.
Oauth 클라이언트 ID, 서비스 계정 키를 선택하여 발급 받을 수 있습니다. 우리는 2번을 필요로 합니다.
1. Oauth Client ID : 키를 받으면 Oauth 인증을 통해 앱 사용자가 엑세스 할 수 있게 됩니다. (높은수준)
2. Service Account : 서버 간의 앱 수준 인증시 사용합니다.
적당한 이름을 넣으면 ~@~iam.gserviceaccount.com 이라는 계정이 만들어집니다. 이 계정이 앞으로 API 서비스를 이용할대 사용할 계정입니다.
Service Account를 만들었으면 json파일을 다운 받습니다. 아 파일은 API를 사용할때 쓰는 키라고 생각하면 됩니다.
3. 구글 애널리틱스에 서비스 계정 등록 (Analytics API 설정)
Service Account의 email에 Read 권한을 주지 않으면 데이터를 읽을 수 없기 때문에 Service Account의 email 주소를 나의 Google Analytics에 등록해야 합니다. 아래와 같이 + 버튼을 눌러 만들어진 서비스 계정을 추가해줍니다. ( ~@~iam.gserviceaccount.com )
B. 파이썬 셋팅
이제 파이썬을 셋팅할 차례입니다. 저는 파이썬으로 하지만 여러분이 사용하고자 하는 랭귀지에 따라 다르게 진행될 수 있습니다.
1. 구글 API와 파이썬을 연동하기 위한 'google-api-python-client' 패키지를 파이썬에 설치합니다. 저는 파이참을 이용해 설치했습니다.
2. 첨부파일에 동봉된 파이썬 스크립트를 띄웁니다.
3. key 파일의 path는 자신에 경로에 맞게 변경을 해야 합니다. key파일은 앞서서 다운 받은 json 파일입니다. 파일 경로를 잘 설정합니다.
key_file_location = '여기에 키경로 입력'
4. 파이썬 스크립트를 실행해 봅니다. GA에 접근해서 성공적으로 데이터를 가져온다면 아래와 같이 출력됩니다.
905개의 세션이 집계되었다고 출력이 되었습니다. 이런식으로 GA 분석화면에서 처리하지 못했던 다양한 데이터들도 자동화하고 처리할 수 있습니다.