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 v1 können Sie Berichte erstellen, um folgende Fragen zu beantworten:

  • Wie viele aktive Nutzer pro Tag hatte meine Android-App in der letzten Woche?
  • 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 pro Land in den letzten 30 Minuten?

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

  • 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.

Kurzanleitung

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

Verfügbare Methoden

  • runReport: Diese Methode gibt einen benutzerdefinierten Bericht Ihrer Google Analytics-Ereignisdaten zurück und ist die bevorzugte Methode für einfache Berichtsabfragen.
  • batchRunReports Dies ist eine Batchversion der runReport-Methode, mit der mehrere Berichte mit einem einzigen API-Aufruf generiert werden können.
  • runPivotReport: Diese Methode gibt einen benutzerdefinierten Pivot-Bericht Ihrer Google Analytics-Ereignisdaten zurück. Pivot-Berichte sind komplexere und ausdrucksstärkere Formate als reguläre Berichte. Jeder Pivot beschreibt die sichtbaren Dimensionsspalten und -zeilen in der Berichtsantwort.
  • batchRunPivotReports Dies ist eine Batchversion der Methode runPivotReport, mit der mehrere Berichte mit einem einzigen API-Aufruf generiert werden können.
  • getMetadata: Mit dieser Methode werden Metadaten für Dimensionen und Messwerte zurückgegeben, die in Berichtsmethoden verfügbar sind. Damit lassen sich Dimensionen und Messwerte untersuchen. 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, um die Kompatibilität zu wahren.
  • 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. In Echtzeitberichten werden Ereignisse und Nutzungsdaten für die Zeitspanne vom aktuellen Zeitpunkt bis zu den letzten 30 Minuten angezeigt (bis zu 60 Minuten bei Google Analytics 360-Properties).
  • properties.audienceExports Eine Gruppe von Methoden zum Generieren von Zielgruppenexporten, einschließlich einer Übersicht der Nutzer in einer Zielgruppe.
  • properties.recurringAudienceLists (Vorschau) Eine Gruppe von Methoden, mit denen wiederkehrende Zielgruppenexporte verwaltet werden können. Bei einem wiederkehrenden Zielgruppenexport werden jeden Tag 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 beim Abschließen einer Aufgabe durchlaufen. So sehen Sie auf einen Blick, wie erfolgreich die einzelnen Schritte abgeschlossen werden.

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.