피테 프리셀라, Google 애널리틱스 Developer Advocate – 2013년 7월
이 문서에서는 Google 애널리틱스 superProxy에 대한 가이드로 시작하기, 특정 기능 사용, 중요한 고려사항에 대해 설명합니다.
소개
Google 애널리틱스 superProxy를 사용하면 Google 애널리틱스 보고 데이터를 공개적으로 공유할 수 있습니다. 이를 사용하여 자체 커스텀 대시보드 및 위젯을 구동하고, 다양한 형식으로 응답을 변환하고, 테스트하는 등의 작업을 할 수 있습니다.
Google 애널리틱스 superProxy는 Core Reporting API, Real Time Reporting API, 다채널 유입경로 Reporting API와 함께 작동합니다.
주요 기능:
- Google 애널리틱스 데이터를 공개적으로 공유합니다.
- 프록시를 사용하여 나만의 맞춤 대시보드를 만드세요.
- CSV, 데이터 표, TSV로 변환합니다.
- 상대적 날짜 (예: 지난 7일)는 지원됩니다.
- 보고서 데이터를 자동으로 새로고침합니다.
- 캐싱 - 빠른 응답 및 효율적인 할당량 사용
작동 방식
Google 애널리틱스 데이터에 대한 쿼리를 만들면 해당 보고 데이터가 공유할 수 있는 새 URL에 공개적으로 제공됩니다. 이 URL을 방문하는 사용자는 승인 없이 보고 데이터에 액세스할 수 있습니다.
예를 들어 지난주의 페이지 조회를 기준으로 상위 10개 브라우저를 검색하고 어제 세션 수 등을 쿼리하는 쿼리를 만들 수 있습니다. 공개로 설정할 쿼리와 데이터 업데이트 빈도를 결정하고 나머지는 Google 애널리틱스 superProxy에서 처리합니다.
팁: 쿼리 탐색기를 사용하여 보고서를 생성한 다음 Query URI를 복사하여 Google 애널리틱스 superProxy와 함께 사용할 수 있습니다.
쿼리 설정 및 만들기
Google 애널리틱스 superProxy는 Google App Engine 환경에서 실행되는 웹 애플리케이션입니다. 간단한 안내를 따라 이 애플리케이션을 다운로드하고 배포할 수 있습니다.
사용자 관리
Google 애널리틱스 superProxy에는 사용자를 추가하는 데 사용할 수 있는 간단한 사용자 관리 인터페이스가 포함되어 있습니다. 각 사용자는 자신이 만든 API 쿼리만 나열하고 관리할 수 있습니다.
관리자만 사용자를 관리할 수 있습니다. 신규 사용자 추가 방법:
- Google 애널리틱스 superProxy 관리 인터페이스 (예:
https://your-application-id.appspot.com/admin)에서 사용자 관리 버튼을 클릭합니다. - 사용자 관리 페이지에서 추가하려는 사용자의 이메일 주소를 입력하고 사용자 추가 버튼을 클릭합니다. 사용자가 추가되지만 계정을 활성화하기 전에는 액세스할 수 없습니다.
- 사용자에게
/admin/activate페이지를 방문하여 계정을 활성화하라고 안내합니다. 예:https://your-application-id.appspot.com/admin/activate. 추가한 이메일 계정으로 Google 계정에 로그인해야 활성화가 작동합니다. - 사용자가 계정을 활성화한 후에는
/admin페이지를 방문하여 Google 애널리틱스 계정에 대한 액세스를 승인하고 자체 API 쿼리를 만들 수 있습니다.
관리자
Google 애널리틱스 superProxy 관리자는 App Engine 관리 콘솔을 사용하여 추가됩니다. 이 콘솔을 통해 역할에 상관없이 추가된 모든 사용자가 관리자가 됩니다.
관리자는 사용자의 API 쿼리를 나열하고 관리할 수 있습니다.
도메인 제한
Google 애널리틱스 superProxy에서 제공하는 기능을 활용하고 싶지만 특정 사용자 또는 도메인 외에는 데이터를 공개하지 않으려는 경우도 있습니다. 기본적으로 App Engine에서 호스팅되는 무료 애플리케이션의 경우 Google 계정으로 로그인한 모든 사용자가 공개 엔드포인트에 액세스할 수 있습니다.
애플리케이션 액세스를 추가로 제한하려면 Google 애널리틱스 superProxy 앞에 자체 인증 레이어를 구현하거나 G Suite를 사용하여 도메인에서 관리하는 사용자로 애플리케이션을 제한해야 합니다. 자세한 내용은 앱 인증 구성을 참조하세요.
할당량 고려사항
Google 애널리틱스 superProxy를 사용하면 캐시/Datastore의 보고 데이터를 제공하여 할당량을 절약할 수 있습니다. 그러나 새로고침 간격을 짧게 설정하면 여전히 할당량을 빠르게 사용할 수 있습니다. 이를 방지하려면 요청 중인 데이터 유형에 대해 적절한 간격으로 쿼리를 새로고침해야 합니다.
App Engine
App Engine 애플리케이션의 무료 기본 할당량 한도는 넉넉하며 대부분의 사용 사례에서 충분합니다. 하지만 결제를 사용 설정하여 기본 한도를 늘리거나 삭제할 수 있습니다. 자세한 내용은 App Engine 할당량을 참조하세요.
커뮤니티 문제 Issue Tracker
Google 애널리틱스 superProxy 포럼은 질문하고, 아이디어를 공유하고, 멋진 프로젝트에 관한 의견을 얻을 수 있는 토론 그룹입니다.
Issue Tracker에서 Google 애널리틱스 superProxy의 문제 및 기능 요청을 보고하고 추적할 수 있습니다.