Google Analytics Data API – Übersicht

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

Weitere Informationen zu Google Analytics-Properties

Die von der API zurückgegebenen Daten stimmen mit den Daten in der Google Analytics-Benutzeroberfläche überein und entsprechen den Einstellungen für die Identität für die Berichterstellung, die für Ihre Google Analytics-Property konfiguriert sind, z. B. „Zusammengeführt“, „Beobachtet“ oder „Gerätebasierte“.

Hier sind einige Beispiele, die Sie mit der Google Analytics Data API v1 erfassen können:

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

Mit der Google Analytics Data API v1 können Sie außerdem 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 wie die Google Analytics-Oberfläche zu. Die von der API zurückgegebenen Daten entsprechen den Einstellungen für die Identität für die Berichterstellung, die für Ihre Google Analytics-Property konfiguriert sind. Nutzerzahlen, Deduplizierung und Datenmodellierung entsprechen also dem ausgewählten Identitätsbereich (z. B. „Zusammengeführt“, „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

Informationen zu den ersten Schritten mit einer Clientbibliothek in Java, Python, Node.js, PHP, C#, Go oder Ruby finden Sie in der Kurzanleitung zur Clientbibliothek. Informationen zum Erstellen von Abfragen, Filtern von Dimensionen und Lesen von Antworten finden Sie unter Bericht erstellen. Sie können Abfragen auch interaktiv im Query Explorer testen.

Beispiel für eine runReport-Anfrage und -Antwort

Wenn Sie Ereignisdaten über REST abfragen möchten, senden Sie eine POST-Anfrage an den Endpunkt runReport mit einem RunReportRequest-JSON-Text, in dem Sie dateRanges, dimensions und metrics angeben:

POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport
{
  "dateRanges": [
    { "startDate": "7daysAgo", "endDate": "yesterday" }
  ],
  "dimensions": [
    { "name": "country" }
  ],
  "metrics": [
    { "name": "activeUsers" }
  ]
}

Oder führen Sie den entsprechenden curl-Befehl mit Standardanmeldedaten für Anwendungen aus:

curl -X POST \
  "https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID:runReport" \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  -H "x-goog-user-project: PROJECT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "dateRanges": [
      { "startDate": "7daysAgo", "endDate": "yesterday" }
    ],
    "dimensions": [
      { "name": "country" }
    ],
    "metrics": [
      { "name": "activeUsers" }
    ]
  }'

Die API gibt ein RunReportResponse mit Spaltenüberschriften und Datenzeilen zurück:

{
  "dimensionHeaders": [
    { "name": "country" }
  ],
  "metricHeaders": [
    { "name": "activeUsers", "type": "TYPE_INTEGER" }
  ],
  "rows": [
    {
      "dimensionValues": [{ "value": "United States" }],
      "metricValues": [{ "value": "4820" }]
    },
    {
      "dimensionValues": [{ "value": "Japan" }],
      "metricValues": [{ "value": "2541" }]
    }
  ],
  "rowCount": 2,
  "kind": "analyticsData#runReport"
}

Verfügbare Methoden

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

  • 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 runReport-Methode, 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 reguläre Berichte. Jeder Pivot beschreibt die sichtbaren Dimensionsspalten und -zeilen in der Berichtsantwort.
  • batchRunPivotReports Dies ist eine Batchversion der runPivotReport-Methode, mit der Sie mehrere Berichte mit einem einzigen API-Aufruf generieren können.
  • getMetadata: Diese Methode gibt Metadaten für Dimensionen und Messwerte zurück, die in Berichterstellungsmethoden verfügbar sind. 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 angezeigt, sobald sie an Google Analytics gesendet wurden. Echtzeitberichte enthalten Ereignisse und Nutzungsdaten für Zeiträume, die vom aktuellen Moment bis 30 Minuten zurück reichen (bei Google Analytics 360-Properties bis zu 60 Minuten).
  • properties.audienceExports Eine Gruppe von Methoden, mit denen Sie Zielgruppenexporte generieren können, die einen Snapshot der Nutzer in einer Zielgruppe enthalten.
  • properties.recurringAudienceLists (Frühe Vorabversion) Eine Gruppe von Methoden, mit denen Sie wiederkehrende Zielgruppenexporte verwalten können. Bei einem wiederkehrenden Zielgruppenexport werden täglich neue Zielgruppenlisten erstellt.
  • runFunnelReport (Frühe Vorabversion) Mit dieser Methode wird ein benutzerdefinierter Trichterbericht 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.
  • properties.chat (Frühe Vorabversion) Diese Methode bietet programmatischen, konversationellen Zugriff auf Ask Advisor in Google Analytics. Sie können Fragen zu Ihren Ereignisdaten in natürlicher Sprache stellen, Leistungsänderungen diagnostizieren und strukturierte, beschreibende und tabellarische Statistiken erhalten.

Unterstützte Dimensionen und Messwerte

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