Google Analytics 4 Data API – Übersicht

Mit der Data API können Sie programmatisch auf Google Analytics 4-Berichtsdaten (GA4) zugreifen. Diese API ist nicht mit bisherigen Universal Analytics-Properties kompatibel.

Weitere Informationen zu Google Analytics 4-Properties

Im Folgenden finden Sie einige Beispiele für Berichte zur Google Analytics Data API Version 1:

  • Die Anzahl der aktiven Nutzer pro Tag, die deine Android-App in der letzten Woche hatte.
  • Die Anzahl der Seitenaufrufe, die die Top-10-Seiten Ihrer Website in den letzten 28 Tagen hatten.
  • Die Anzahl der aktiven Nutzer pro Land, die Ihre iOS-App in den letzten 30 Minuten hatte.

Sie können das Google Analytics Data API v1 auch für Folgendes verwenden:

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

Erste Schritte

Informationen zum Einstieg finden Sie in der Kurzanleitung zur Clientbibliothek. Es gibt Clientbibliotheken in Java, Python, Node.js und anderen Sprachen, um die Implementierung zu vereinfachen.

Verfügbare Methoden

Im Folgenden finden Sie eine Liste der Data API-Methoden. Weitere Informationen finden Sie in der Referenzdokumentation.

  • runReport Mit 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 Methode runReport, mit der Sie mehrere Berichte mit einem einzigen API-Aufruf generieren können.
  • runPivotReport Mit dieser Methode wird ein benutzerdefinierter Pivot-Bericht Ihrer Google Analytics-Ereignisdaten zurückgegeben. Pivot-Berichte sind komplexere und aussagekräftigere Formate als normale Berichte. Jeder Pivot beschreibt die sichtbaren Dimensionsspalten und -zeilen in der Berichtsantwort.
  • batchRunPivotReports Dies ist eine Batchversion der Methode runPivotReport, mit der Sie mehrere Berichte mit einem einzigen API-Aufruf generieren können.
  • getMetadata Bei dieser Methode werden Metadaten zu Dimensionen und Messwerten zurückgegeben, die in Berichtsmethoden verfügbar sind. Damit lassen sich Dimensionen und Messwerte untersuchen. Die Antwort auf diese Methode umfasst 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 und die Kompatibilität aufrechterhalten.
  • runRealtimeReport Mit dieser Methode wird ein benutzerdefinierter Bericht mit Echtzeitereignisdaten für Ihre Property zurückgegeben. Ereignisse erscheinen Sekunden, nachdem sie an Google Analytics gesendet wurden, in Echtzeitberichten. Echtzeitberichte enthalten Ereignisse und Nutzungsdaten für die Zeitspanne vom aktuellen Zeitpunkt bis zu den letzten 30 Minuten (bis zu 60 Minuten bei Google Analytics 360-Properties).
  • properties.audienceExports Eine Gruppe von Methoden, mit denen Sie Zielgruppenexporte erstellen können, die eine Übersicht der Nutzer in einer Zielgruppe enthalten.
  • properties.recurringAudienceLists (Frühere Vorschau): Gruppe von Methoden, mit denen sich wiederkehrende Zielgruppenexporte verwalten lassen Bei einem wiederkehrenden Zielgruppenexport werden täglich neue Zielgruppenlisten erstellt.
  • runFunnelReport (Frühere Vorschau): 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.

Unterstützte Dimensionen und Messwerte

Eine Liste aller von der Data API unterstützten Dimensionen und Messwerte finden Sie in der Dokumentation zum API-Schema.