Analytics Data API – Übersicht

Mit der Google Analytics Data API Version 1 erhalten Sie programmatischen Zugriff auf Google Analytics 4-Berichtsdaten (GA4). Mit Google Analytics 4 können Sie nachvollziehen, wie Nutzer Ihre Web-, iOS- oder Android-App verwenden. Weitere Informationen zu Google Analytics 4-Properties

Mit dem Google Analytics Data API Version 1 können Sie Berichte erstellen, um beispielsweise folgende Fragen zu beantworten:

  • Wie viele aktive Nutzer hat meine Android-App in der letzten Woche pro Tag?
  • Wie viele Seitenaufrufe wurden jeweils über die Top-10-Seiten-URLs meiner Website in den letzten 28 Tagen erzielt?
  • Wie viele aktive Nutzer hatte meine iOS-App in den letzten 30 Minuten pro Land?

Das Google Analytics Data API Version 1 kann auch für Folgendes verwendet werden:

  • Erstellen Sie benutzerdefinierte Dashboards, um Google Analytics-Daten anzuzeigen.
  • Komplexe Berichtaufgaben automatisieren, um Zeit zu sparen
  • Integrieren Sie Ihre Google Analytics-Daten in andere Geschäftsanwendungen.

Kurzanleitung

Mit nur wenigen Codezeilen können Sie die API aufrufen, um Ihren ersten Bericht zu erstellen. Informationen zum Einstieg finden Sie unter Kurzanleitung zur Verwendung von Clientbibliotheken. Es gibt Clientbibliotheken in Java, Python, Node.js und anderen Sprachen, um die Implementierung zu vereinfachen.

Verfügbare Methoden

  • runReport: Bei dieser Methode wird ein benutzerdefinierter Bericht mit Ihren Google Analytics-Ereignisdaten zurückgegeben. Sie ist die bevorzugte Methode für einfache Berichtsabfragen.
  • batchRunReports Dies ist eine Batchversion der runReport-Methode, mit der mit einem einzigen API-Aufruf mehrere Berichte generiert werden können.
  • runPivotReport: Mit dieser Methode wird ein benutzerdefinierter Pivot-Bericht Ihrer Google Analytics-Ereignisdaten zurückgegeben. Pivot-Berichte sind komplexere und ausdrucksstärkere Formate als reguläre Berichte. Jeder Drehpunkt beschreibt die sichtbaren Dimensionsspalten und Zeilen in der Berichtsantwort.
  • batchRunPivotReports Dies ist eine Batch-Version der runPivotReport-Methode, mit der mit einem einzigen API-Aufruf mehrere Berichte generiert werden können.
  • getMetadata: Bei dieser Methode werden Metadaten für Dimensionen und Messwerte zurückgegeben, die in Berichtsmethoden verfügbar sind. Sie dient zur Untersuchung der Dimensionen und Messwerte. Die Antwort auf diese Methode enthält auch die benutzerdefinierten Dimensionen und Messwerte, die für die angegebene GA4-Property verfügbar sind.
  • checkCompatibility Mit dieser Methode werden Dimensionen und Messwerte aufgelistet, die einer Berichtsanfrage hinzugefügt werden können. So wird die Kompatibilität gewahrt.
  • runRealtimeReport: Mit dieser Methode wird ein benutzerdefinierter Bericht mit Echtzeitereignisdaten für Ihre Property zurückgegeben. Ereignisse werden innerhalb von Sekunden in Echtzeitberichten angezeigt, nachdem sie an Google Analytics gesendet wurden. Echtzeitberichte enthalten Ereignisse und Nutzungsdaten vom aktuellen Zeitpunkt bis zu 30 Minuten (bis zu 60 Minuten bei Google Analytics 360-Properties).
  • runFunnelReport (Early Preview) Diese Methode gibt einen benutzerdefinierten Trichterbericht Ihrer Google Analytics-Ereignisdaten zurück. Mit der explorativen Trichteranalyse können Sie die Schritte visualisieren, die Nutzer zum Abschließen einer Aufgabe durchlaufen. So sehen Sie auf einen Blick, wie erfolgreich die einzelnen Schritte abgeschlossen werden.
  • properties.audienceLists (Early Preview) Eine Gruppe von Methoden, mit denen Zielgruppenlisten generiert werden können, die einen Snapshot der Nutzer in einer Zielgruppe enthalten.

Unterstützte Dimensionen und Messwerte

In der Dokumentation zum API-Schema sind die Dimensionen und Messwerte aufgeführt, die derzeit von der Analytics Data API unterstützt werden.