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 überein, die in der Google Analytics Benutzeroberfläche angezeigt werden. Die Einstellungen für die Identität für die Berichterstellung, z. B. „Zusammengeführt“, „Beobachtet“ oder „Gerätebasiert“, die für Ihre Google Analytics Property konfiguriert sind, werden vollständig berücksichtigt.

Hier sind 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 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. „Zusammengeführt“, „Beobachtet“ oder „Gerätebasiert“ in den 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 für Clientbibliotheken. Informationen zum Erstellen von Abfragen, Filtern von Dimensionen und Lesen von Antworten finden Sie unter Bericht erstellen oder Abfragen 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 runReport-Endpunkt 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" }
  ]
}

Alternativ können Sie den entsprechenden curl Befehl mit Standardanmeldedaten für Anwendungen ausführen:

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 eine 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 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 generieren können.
  • runPivotReport Diese Methode gibt einen benutzerdefinierten Pivot-Bericht Ihrer Google Analytics Ereignisdaten 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 generieren können.
  • getMetadata : Diese Methode gibt Metadaten für Dimensionen und Messwerte zurück, die in Berichtsmethoden 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 : 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-Ereignis daten für Ihre Property zurück. Ereignisse werden in Echtzeitberichten angezeigt, wenige Sekunden nachdem sie an Google Analytics gesendet wurden. Echtzeitberichte enthalten Ereignis- und Nutzungsdaten für die Zeiträume vom aktuellen Zeitpunkt bis zu 30 Minuten zuvor (bis zu 60 Minuten für Google Analytics 360-Properties).
  • properties.audienceExports Eine Gruppe von Methoden, mit denen Sie Zielgruppen exporte generieren können, die eine Momentaufnahme 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 jeden Tag neue Zielgruppenlisten erstellt.
  • runFunnelReport (Frühe Vorabversion) : Diese Methode gibt einen benutzerdefinierten Trichter bericht 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.
  • properties.chat (Frühe Vorabversion) Diese Methode bietet programmatischen Zugriff auf Ask Advisor in Google Analytics. Sie können Fragen zu Ihren Ereignisdaten in natürlicher Sprache stellen, Leistungsänderungen diagnostizieren und strukturierte narrative und tabellarische Analysen erhalten.

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.