Pete Frisella, przedstawiciel ds. kontaktu z deweloperami Google Analytics, lipiec 2013 r.
Ten dokument dotyczy superserwera proxy Google Analytics i wyjaśnia, jak zacząć z niego korzystać, oraz zawiera opis ważnych kwestii.
Wstęp
Superserwer proxy Google Analytics umożliwia publiczne udostępnianie danych raportowania Google Analytics. Możesz jej używać do tworzenia własnych niestandardowych paneli i widżetów, przekształcania odpowiedzi na różne formaty, testowania i nie tylko.
Superserwer proxy Google Analytics współpracuje z interfejsami Core Reporting API, Real Time Reporting API i Raportowania ścieżek wielokanałowych.
Najważniejsze funkcje:
- Publicznie udostępniaj swoje dane Google Analytics.
- Używaj serwera proxy do obsługi własnych niestandardowych paneli.
- Konwertuj do plików CSV, Data Table, TSV.
- Obsługiwane są daty względne (np. ostatnie 7 dni).
- Automatycznie odświeża dane w raporcie.
- Buforowanie – szybkie odpowiedzi i efektywne wykorzystanie limitu.
Jak to działa
Utwórz zapytanie o dane Google Analytics, a konkretne dane raportowania będą publicznie dostępne pod nowym adresem URL, który możesz udostępniać. Każdy, kto odwiedzi ten adres URL, będzie miał dostęp do danych raportowania bez konieczności uzyskania upoważnienia.
Możesz np. utworzyć zapytanie, które pobierze 10 najpopularniejszych przeglądarek na podstawie odsłon z minionego tygodnia, jedno zapytanie dotyczące liczby sesji z poprzedniego tygodnia itd. Ty decydujesz, które zapytania chcesz udostępniać publicznie i jak często dane mają być aktualizowane, a superserwer proxy Google Analytics zajmie się resztą.
Wskazówka: do generowania raportów możesz użyć eksploratora zapytań, a potem skopiować Query URI, aby używać go z superserwerem proxy Google Analytics.
Konfigurowanie i tworzenie zapytania
Superserwer proxy Google Analytics to aplikacja internetowa działająca w środowisku Google App Engine. Możesz pobrać i wdrożyć tę aplikację, wykonując proste instrukcje.
Zarządzanie użytkownikami
Superserwer proxy Google Analytics ma prosty interfejs do zarządzania użytkownikami, za pomocą którego możesz dodawać użytkowników. Każdy użytkownik będzie mógł tylko wyświetlać listy zapytań do interfejsu API i zarządzać nimi.
Użytkownikami mogą zarządzać tylko administratorzy. Aby dodać nowego użytkownika:
- W interfejsie administratora superserwera proxy Google Analytics (np.
https://your-application-id.appspot.com/admin) kliknij przycisk Zarządzaj użytkownikami. - Na stronie Zarządzanie użytkownikami wpisz adres e-mail użytkownika, którego chcesz dodać, i kliknij przycisk Dodaj użytkownika. Użytkownik zostanie dodany, ale nie będzie miał dostępu, dopóki nie aktywuje konta.
- Poproś użytkownika o aktywowanie konta na stronie
/admin/activate. Na przykład:https://your-application-id.appspot.com/admin/activate. Aby aktywacja powiodła się, osoby te muszą być zalogowane na konto Google z dodanego przez Ciebie adresu e-mail. - Po aktywowaniu konta użytkownik będzie mógł wejść na stronę
/admin, autoryzować dostęp do swojego konta Google Analytics i zacząć tworzyć własne zapytania do interfejsu API.
Administratorzy
Administratorzy superserwera proxy Google Analytics są dodawani przy użyciu konsoli administracyjnej App Engine. Administratorem stanie się każdy użytkownik dodany za pomocą tej konsoli o dowolnej roli.
Administratorzy mogą wyświetlać listy zapytań do interfejsu API wszystkich użytkowników i zarządzać nimi.
Ograniczenia domeny
W niektórych przypadkach możesz chcieć korzystać z funkcji oferowanych przez superserwera proxy Google Analytics, ale nie chcesz upubliczniać żadnych danych spoza określonego zbioru użytkowników lub domeny. Domyślnie w przypadku każdej bezpłatnej aplikacji hostowanej w App Engine każdy użytkownik zalogowany na konto Google może uzyskać dostęp do Twoich publicznych punktów końcowych.
Jeśli chcesz jeszcze bardziej ograniczyć dostęp do swojej aplikacji, musisz wdrożyć własną warstwę uwierzytelniania przed systemem proxy Google Analytics lub skorzystać z G Suite, co pozwala ograniczyć dostęp do aplikacji tylko do użytkowników zarządzanych przez Twoją domenę. Więcej informacji znajdziesz w artykule o konfigurowaniu uwierzytelniania w aplikacji.
Uwagi na temat limitu
Superserwer proxy Google Analytics pomaga oszczędzać limit, udostępniając dane raportowania z pamięci podręcznej/magazynu danych. Jednak ustawienie krótkich odstępów odświeżania nadal może spowodować szybkie wykorzystanie limitu. Aby tego uniknąć, odświeżaj zapytania w rozsądnych odstępach czasu w zależności od typu żądanych danych.
Z App Engine
Domyślne limity bezpłatnych limitów dla aplikacji App Engine są obszerne i prawdopodobnie będą wystarczające w większości przypadków użycia. Możesz jednak włączyć płatności, aby zwiększyć lub usunąć domyślne limity. Więcej informacji znajdziesz w artykule Limity App Engine.
Śledzenie społeczności i problemów
Forum Google Analytics SuperProxy to grupa dyskusyjna, na której możesz zadawać pytania, dzielić się pomysłami i uzyskiwać opinie na temat swoich wspaniałych projektów.
Narzędzie do śledzenia błędów pozwala zgłaszać i śledzić problemy oraz prośby o dodanie funkcji dotyczące superserwera proxy Google Analytics.