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 Fragen wie die folgenden zu beantworten:

  • Wie viele aktive Nutzer pro Tag hatte meine Android-App in der letzten Woche?
  • Wie viele Seitenaufrufe wurden jeweils für 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 Version 1 kann auch für Folgendes verwendet werden:

  • Erstellen Sie benutzerdefinierte Dashboards zur Darstellung von Google Analytics-Daten.
  • Komplexe Berichtaufgaben automatisieren und Zeit sparen
  • Google Analytics-Daten in andere Geschäftsanwendungen integrieren

Kurzanleitung

Sie können die API aufrufen, um Ihren ersten Bericht zu erstellen, und zwar mit nur wenigen Codezeilen. Informationen zum Einstieg finden Sie in der 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: Diese Methode liefert einen benutzerdefinierten Bericht Ihrer Google Analytics-Ereignisdaten. Sie ist die bevorzugte Methode für einfache Berichtsabfragen.
  • batchRunReports Dies ist eine Batch-Version der runReport-Methode, mit der mehrere Berichte über einen einzigen API-Aufruf generiert werden können.
  • runPivotReport: Diese Methode gibt einen angepassten Pivot-Bericht Ihrer Google Analytics-Ereignisdaten zurück. Pivot-Berichte haben erweiterte 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 über einen einzigen API-Aufruf mehrere Berichte generiert werden können.
  • getMetadata: Diese Methode gibt Metadaten für Dimensionen und Messwerte zurück, 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: Diese Methode gibt einen benutzerdefinierten Bericht mit Echtzeitereignisdaten für Ihre Property zurück. Ereignisse werden innerhalb von Sekunden, nachdem sie an Google Analytics gesendet wurden, in Echtzeitberichten angezeigt. Echtzeitberichte enthalten Ereignisse und Nutzungsdaten für einen bestimmten Zeitraum, der bis 30 Minuten zurückliegt (bis zu 60 Minuten bei Google Analytics 360-Properties).
  • properties.audienceExports Eine Gruppe von Methoden, mit denen Zielgruppenexporte generiert werden können, einschließlich einer Übersicht der Nutzer in einer Zielgruppe.
  • properties.recurringAudienceLists (Frühe 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ühe 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

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