Google 애널리틱스 superProxy

피트 프리셀라, Google 애널리틱스 Developer Advocate – 2013년 7월

이 문서에서는 Google 애널리틱스 superProxy에 대해 설명하며, 시작하는 방법, 특정 기능을 사용하는 방법, 중요한 고려사항을 설명합니다.

소개

Google 애널리틱스 superProxy를 사용하면 Google 애널리틱스 보고 데이터를 공개적으로 공유할 수 있습니다. 이를 통해 자체 커스텀 대시보드 및 위젯을 강화하고, 다양한 형식에 대한 응답을 변환하고, 테스트하는 등의 작업을 수행할 수 있습니다.

Google 애널리틱스 수퍼프록시는 Core Reporting API, Real Time Reporting API , 다채널 유입경로 Reporting API와 함께 작동합니다.

주요 기능:

  • Google 애널리틱스 데이터를 공개적으로 공유합니다.
  • 프록시를 사용하여 나만의 맞춤 대시보드를 강화하세요.
  • CSV, 데이터 테이블, TSV로 변환
  • 상대적 날짜 (예: 지난 7일)가 지원됩니다.
  • 보고서 데이터를 자동으로 새로고침합니다.
  • 캐싱 - 빠른 응답 및 효율적인 할당량 사용

작동 방식

Google 애널리틱스 데이터에 대한 쿼리를 만들면 특정 보고 데이터가 공유할 수 있는 새 URL에서 공개적으로 제공됩니다. URL을 방문하는 모든 사용자는 승인 없이 보고 데이터에 액세스할 수 있습니다.

예를 들어 지난주의 페이지 조회수를 기준으로 상위 10개의 브라우저를 검색하는 쿼리와 어제의 세션수에 대한 쿼리 등을 만들 수 있습니다. 공개할 쿼리와 데이터 업데이트 빈도를 결정하면 Google 애널리틱스 수퍼프록시가 나머지 작업을 처리합니다.

팁: 쿼리 탐색기를 사용하여 보고서를 생성한 다음 Query URI를 복사하여 Google 애널리틱스 superProxy와 함께 사용할 수 있습니다.

쿼리 설정 및 만들기

Google 애널리틱스 수퍼프록시는 Google App Engine 환경에서 실행되는 웹 애플리케이션입니다. 간단한 안내에 따라 이 애플리케이션을 다운로드하고 배포할 수 있습니다.

사용자 관리

Google 애널리틱스 수퍼프록시에는 사용자를 추가하는 데 사용할 수 있는 간단한 사용자 관리 인터페이스가 포함되어 있습니다. 각 사용자는 자신이 생성한 API 쿼리를 나열하고 관리하기만 할 수 있습니다.

관리자만 사용자를 관리할 수 있습니다. 신규 사용자 추가 방법:

  1. Google 애널리틱스 superProxy 관리 인터페이스 (예: https://your-application-id.appspot.com/admin)에서 사용자 관리 버튼을 클릭합니다.
  2. 사용자 관리 페이지에서 추가하려는 사용자의 이메일 주소를 입력하고 사용자 추가 버튼을 클릭합니다. 사용자는 추가되지만 계정을 활성화할 때까지 액세스할 수 없습니다.
  3. 사용자에게 /admin/activate 페이지를 방문하여 계정을 활성화하도록 안내합니다. 예: https://your-application-id.appspot.com/admin/activate 활성화가 작동하려면 추가된 이메일의 Google 계정으로 로그인해야 합니다.
  4. 사용자가 계정을 활성화하면 /admin 페이지를 방문하여 Google 애널리틱스 계정에 대한 액세스를 승인하고 자체 API 쿼리를 만들 수 있습니다.

관리자

Google 애널리틱스 수퍼프록시 관리자는 App Engine 관리 콘솔을 사용하여 추가됩니다. 이 콘솔을 통해 추가된 모든 사용자가 역할에 관계없이 관리자가 됩니다.

관리자는 사용자의 API 쿼리를 나열하고 관리할 수 있습니다.

도메인 제한

경우에 따라 Google 애널리틱스 슈퍼프록시가 제공하는 기능을 활용하고 싶지만 특정 사용자 또는 도메인 외에는 데이터를 공개하고 싶지 않을 수 있습니다. 기본적으로 App Engine에서 호스팅되는 모든 무료 애플리케이션의 경우 Google 계정으로 로그인한 모든 사용자가 공개 엔드포인트에 액세스할 수 있습니다.

애플리케이션 액세스를 추가로 제한하려면 Google 애널리틱스 수퍼프록시 앞에 자체 인증 레이어를 구현하거나 G Suite를 사용하여 도메인에서 관리하는 사용자로 애플리케이션을 제한해야 합니다. 자세한 내용은 앱 인증 구성을 참조하세요.

할당량 고려사항

Google 애널리틱스 superProxy를 사용하면 캐시/데이터 저장소에서 보고 데이터를 제공하여 할당량을 절약할 수 있습니다. 하지만 새로고침 간격을 짧게 설정하면 할당량을 빠르게 소진할 수 있습니다. 이를 방지하려면 요청되는 데이터 유형에 적합한 간격으로 쿼리를 새로고침해야 합니다.

App Engine

App Engine 애플리케이션의 무료 기본 할당량 한도는 넉넉하여 대부분의 사용 사례에 충분합니다. 하지만 결제를 사용 설정하여 기본 한도를 늘리거나 삭제할 수 있습니다. 자세한 내용은 App Engine 할당량을 참조하세요.

커뮤니티 및 Issue Tracker

Google 애널리틱스 superProxy 포럼은 훌륭한 프로젝트에 관해 질문하고, 아이디어를 공유하고, 의견을 얻을 수 있는 토론 그룹입니다.

Issue Tracker에서는 Google 애널리틱스 슈퍼프록시의 문제 및 기능 요청을 신고하고 추적할 수 있습니다.