Google Analytics-Super-Proxy

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:

  1. 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.
  2. 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.
  3. 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.
  4. 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.