Übersicht über die Google Analytics Data API

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

Weitere Informationen zu Google Analytics Properties.

Hier einige Beispiele für Berichte, die Sie mit der Google Analytics Data API v1 erstellen können:

  • Wie viele aktive Nutzer pro Tag hat Ihre Android-App in der letzten Woche verwendet?
  • Wie viele Seitenaufrufe haben die 10 beliebtesten Seiten auf Ihrer Website in den letzten 28 Tagen erhalten?
  • Wie viele aktive Nutzer pro Land hat Ihre iOS-App in den letzten 30 Minuten verwendet?

Mit der Google Analytics Data API v1 können Sie auch Folgendes tun:

  • Benutzerdefinierte Dashboards erstellen, um Google Analytics-Daten darzustellen
  • Komplexe Berichtsaufgaben automatisieren, um Zeit zu sparen
  • Google Analytics-Daten in andere Geschäftsanwendungen einbinden

Datenkonsistenz und Identität für die Berichterstellung

Die Google Analytics Data API v1 greift auf dieselben Berichtsdaten zu wie die Google Analytics-Benutzeroberfläche. Die von der API zurückgegebenen Daten berücksichtigen die Einstellungen für die Identität für die Berichterstellung, die für Ihre Google Analytics-Property konfiguriert wurden. Die Nutzerzahlen, die Deduplizierung und die Datenmodellierung stimmen mit dem ausgewählten Identitätsbereich überein, z. B. „Gemischt“, „Beobachtet“ oder „Gerätebasiert“ in Ihren Property-Einstellungen.

Weitere Informationen dazu, wie sich verschiedene Identitätsbereiche auf Ihre Berichte auswirken können, finden Sie unter Identität für die Berichterstellung.

Jetzt starten

Eine Einführung finden Sie im Schnellstart zur Clientbibliothek. Es gibt Clientbibliotheken in Java, Python, Node.js und anderen Sprachen, um die Implementierung zu vereinfachen.

Verfügbare Methoden

Hier finden Sie eine Liste der Data API-Methoden. Weitere Informationen finden Sie in der Referenz dokumentation.

  • 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 Methode „runReport“, mit der Sie mehrere Berichte mit einem einzigen API-Aufruf erstellen können.
  • runPivotReport Diese Methode gibt einen benutzerdefinierten Pivot-Bericht Ihrer Google Analytics-Ereignis daten zurück. Pivot-Berichte sind komplexere und aussagekräftigere Formate als reguläre Berichte. Jeder Pivot beschreibt die sichtbaren Dimensionsspalten und ‑zeilen in der Berichtantwort.
  • batchRunPivotReports Dies ist eine Batchversion der Methode „runPivotReport“, mit der Sie mehrere Berichte mit einem einzigen API-Aufruf erstellen können.
  • getMetadata Diese Methode gibt Metadaten für Dimensionen und Messwerte zurück, die in Berichtsmethoden verfügbar sind. Sie wird verwendet, um die Dimensionen und Messwerte zu untersuchen. Die Antwort dieser Methode enthält auch die benutzerdefinierten Dimensionen und Messwerte, die für die angegebene Google Analytics-Property verfügbar sind.
  • checkCompatibility Diese Methode listet Dimensionen und Messwerte auf, die einer Berichtsanfrage hinzugefügt werden können, ohne die Kompatibilität zu beeinträchtigen.
  • runRealtimeReport Diese Methode gibt einen benutzerdefinierten Bericht mit Echtzeit-Ereignisdaten für Ihre Property zurück. Ereignisse werden in Echtzeitberichten angezeigt, sobald sie an Google Analytics gesendet wurden. In Echtzeitberichten werden Ereignis- und Nutzungsdaten für die Zeiträume vom aktuellen Zeitpunkt bis vor 30 Minuten angezeigt (bis zu 60 Minuten für Google Analytics 360-Properties).
  • properties.audienceExports Eine Gruppe von Methoden, mit denen Sie Zielgruppen exporte erstellen können, die eine Momentaufnahme der Nutzer in einer Zielgruppe enthalten.
  • properties.recurringAudienceLists (Frühe Vorschau) Eine Gruppe von Methoden, mit denen Sie wiederkehrende Zielgruppenexporte verwalten 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 bei einer Aufgabe durchlaufen. So sehen Sie auf einen Blick, wie erfolgreich die einzelnen Schritte abgeschlossen werden.

Unterstützte Dimensionen und Messwerte

Eine Liste aller Dimensionen und Messwerte, die von der Data API unterstützt werden, finden Sie in der API-Schema-Dokumentation.