Pete Frisella, Google Analytics Developer Advocate, Juli 2013
In diesem Dokument geht es um den Google Analytics-SuperProxy. Es werden die ersten Schritte und die Verwendung bestimmter Funktionen erläutert. Außerdem werden wichtige Überlegungen erörtert.
Einleitung
Mit dem Google Analytics-SuperProxy können Sie Ihre Google Analytics-Berichtsdaten öffentlich freigeben. Sie können damit Ihre eigenen benutzerdefinierten Dashboards und Widgets optimieren, Antworten in verschiedene Formate umwandeln, Tests durchführen und vieles mehr.
Der Google Analytics-SuperProxy funktioniert mit der Core Reporting API, der Real Time Reporting API und der Multi-Channel Trichter Reporting API.
Funktionshighlights:
- Geben Sie Ihre Google Analytics-Daten öffentlich frei.
- Nutzen Sie den Proxy, um Ihre eigenen benutzerdefinierten Dashboards zu unterstützen.
- Konvertieren in CSV, Datentabelle, TSV.
- Relative Zeiträume werden unterstützt (z.B. letzte 7 Tage).
- Die Berichtsdaten werden automatisch aktualisiert.
- Caching – schnelle Antworten und effiziente Kontingentnutzung
Funktionsweise
Erstellen Sie eine Abfrage für Ihre Google Analytics-Daten. Die spezifischen Berichtsdaten sind dann unter einer neuen URL öffentlich verfügbar und können freigegeben werden. Alle Nutzer, die die URL aufrufen, können ohne Autorisierung auf die Berichtsdaten zugreifen.
Sie könnten beispielsweise eine Abfrage erstellen, um die Top-10-Browser basierend auf den Seitenaufrufen der vergangenen Woche abzurufen, und eine Abfrage für die Anzahl der gestrigen Sitzungen usw. Sie entscheiden, welche Abfragen veröffentlicht werden sollen und wie oft die Daten aktualisiert werden sollen. Der Google Analytics-SuperProxy erledigt den Rest.
Tipp:Sie können mit dem Abfrage-Explorer Berichte generieren und dann Query URI
zur Verwendung mit dem Google Analytics-SuperProxy kopieren
Abfrage einrichten und erstellen
Der Google Analytics-SuperProxy ist eine Webanwendung, die in der Google App Engine-Umgebung ausgeführt wird. Sie können die Anwendung ganz einfach herunterladen und bereitstellen.
Nutzer verwalten
Der Google Analytics-SuperProxy umfasst eine einfache Oberfläche zur Nutzerverwaltung, über die Sie Nutzer hinzufügen können. Jeder Nutzer kann nur die von ihm erstellten API-Abfragen auflisten und verwalten.
Nur Administratoren können Nutzer verwalten. So fügen Sie einen neuen Nutzer hinzu:
- Klicken Sie in der Admin-Oberfläche des Super-Proxy von Google Analytics (z.B.
https://your-application-id.appspot.com/admin
) auf die Schaltfläche Nutzer verwalten. - Geben Sie auf der Seite Nutzer verwalten die E-Mail-Adresse des Nutzers ein, den Sie hinzufügen möchten, und klicken Sie auf die Schaltfläche Nutzer hinzufügen. Der Nutzer wird zwar hinzugefügt, hat aber erst dann Zugriff, wenn er das Konto aktiviert hat.
- Bitten Sie den Nutzer, sein Konto auf der Seite
/admin/activate
zu aktivieren. Beispiel:https://your-application-id.appspot.com/admin/activate
. Damit die Aktivierung funktioniert, muss er im Google-Konto für die von Ihnen hinzugefügte E-Mail-Adresse angemeldet sein. - Sobald der Nutzer sein Konto aktiviert hat, kann er die Seite
/admin
aufrufen, den Zugriff auf sein Google Analytics-Konto autorisieren und eigene API-Abfragen erstellen.
Admin-Nutzer
Google Analytics-Super-Proxy-Administratoren werden über die App Engine-Verwaltungskonsole hinzugefügt. Jeder Nutzer, der über diese Konsole hinzugefügt wird, gilt unabhängig von der Rolle als Administrator.
Administratoren können die API-Abfragen jedes Nutzers auflisten und verwalten.
Domain-Einschränkungen
In einigen Fällen möchten Sie vielleicht die Funktionen des Google Analytics-Super-Proxys nutzen, aber keine Daten außerhalb einer bestimmten Nutzer- oder Domaingruppe veröffentlichen. Standardmäßig kann jeder, der mit einem Google-Konto angemeldet ist, bei kostenlosen Anwendungen, die in App Engine gehostet werden, auf Ihre öffentlichen Endpunkte zugreifen.
Wenn Sie den Zugriff auf Ihre Anwendung weiter einschränken möchten, müssen Sie Ihre eigene Authentifizierungsebene vor Google Analytics-SuperProxy implementieren oder die G Suite verwenden. So können Sie eine Anwendung auf Nutzer beschränken, die von Ihrer Domain verwaltet werden. Weitere Informationen findest du unter Authentifizierung deiner Anwendung konfigurieren.
Überlegungen zu Kontingenten
Mit dem Google Analytics-SuperProxy können Sie Kontingente einsparen, da Berichtsdaten aus dem Cache bzw. Datenspeicher bereitgestellt werden. Allerdings kann das Festlegen kurzer Aktualisierungsintervalle dazu führen, dass das Kontingent schnell aufgebraucht wird. Aktualisieren Sie die Abfragen in einem für den angeforderten Datentyp geeigneten Intervall, um dies zu vermeiden.
App Engine
Die kostenlosen Standardkontingente für App Engine-Anwendungen sind großzügig bemessen und reichen wahrscheinlich für die meisten Anwendungsfälle aus. Sie können jedoch die Abrechnung aktivieren, um die Standardlimits zu erhöhen oder zu entfernen. Weitere Informationen finden Sie unter App Engine-Kontingente.
Community- und Problemverfolgung
Das Google Analytics-SuperProxy-Forum ist eine Diskussionsgruppe, in der Sie Fragen stellen, Ideen austauschen und Feedback zu Ihren tollen Projekten erhalten können.
Im Issue Tracker können Sie Probleme mit dem Google Analytics-SuperProxy melden und Funktionsanfragen stellen.