Übersicht über die Google Analytics Data API

Mit der Data API können Sie programmatisch auf Berichtsdaten von Google Analytics zugreifen.

Weitere Informationen zu Google Analytics Properties.

Die von der API zurückgegebenen Daten stimmen mit den Daten überein, die in der Google Analytics Benutzeroberfläche angezeigt werden. Dabei werden die Einstellungen für die Identität für die Berichterstellungvollständig berücksichtigt, z. B. „Kombiniert“, „Beobachtet“ oder „Gerätebasiert“, die für Ihre Google Analytics Property konfiguriert sind.

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 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 vollständig die Einstellungen für die Identität für die Berichterstellung, die für Ihre Google Analytics-Property konfiguriert sind. Die Nutzerzahlen, die Deduplizierung und die Datenmodellierung stimmen mit dem ausgewählten Identitätsbereich überein, z. B. „Kombiniert“, „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 : Mit dieser Methode wird ein benutzerdefinierter Bericht Ihrer 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 erstellen 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 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 : Mit dieser Methode werden Metadaten für Dimensionen und Messwerte zurückgegeben, 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 : Mit dieser Methode werden Dimensionen und Messwerte aufgelistet, die einer Berichtsanfrage hinzugefügt werden können, ohne die Kompatibilität zu beeinträchtigen.
  • runRealtimeReport : Mit dieser Methode wird ein benutzerdefinierter Bericht mit Echtzeit-Ereignisdaten für Ihre Property zurückgegeben. Ereignisse werden in Echtzeitberichten Sekunden nach dem Senden an Google Analytics angezeigt. 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) : Mit dieser Methode wird ein benutzerdefinierter Trichter bericht Ihrer Google Analytics-Ereignisdaten zurückgegeben. 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.