Was ist die Core Reporting API?

Dieses Dokument bietet einen allgemeinen Überblick über die Google Analytics Core Reporting API Version 3.0. Eine ausführliche Referenz zur API findest du im Referenzhandbuch.

Einführung

Mit der Google Analytics Core Reporting API haben Sie Zugriff auf die meisten Berichtsdaten in Google Analytics. Die Core Reporting API bietet folgende Vorteile:

  • Benutzerdefinierte Dashboards zur Darstellung von Google Analytics-Daten erstellen
  • Sparen Sie Zeit durch die Automatisierung komplexer Berichterstellungsaufgaben.
  • Integrieren Sie Ihre Google Analytics-Daten in andere Geschäftsanwendungen.

Version auswählen

Wir haben vor Kurzem eine neue Version der Core Reporting API eingeführt.

  • Sie erstellen eine neue Anwendung? – Wir empfehlen, die neueste Version 3.0 zu verwenden.
  • Sie verwenden die alte Version 2.3? – Lesen Sie den Migrationsleitfaden, um zu erfahren, wie Sie Ihre Anwendung für die Verwendung der neuen Version aktualisieren.

Erste Schritte

Möchten Sie gleich beginnen? Lesen Sie die Anleitung zur Hello Analytics API.

Jede Anwendung, die die API verwendet, muss einige Schritte ausführen, um sich zu registrieren, den Nutzer zu autorisieren und mit der API zu arbeiten. In dieser Anleitung werden Sie Schritt für Schritt erklärt. Am Ende haben Sie eine funktionierende Anwendung, die Sie anpassen können.

Konzeptübersicht

Die Core Reporting API gibt Berichtsdaten aus Statistiken zurück, die aus den vom Google Analytics-Tracking-Code erfassten Daten abgeleitet werden. Jeder Bericht besteht aus Dimensionen und Messwerten. Mit der Core Reporting API können Sie Dimensionen und Messwerte abfragen, um benutzerdefinierte Berichte zu erstellen.

Die Core Reporting API beruht auf drei grundlegenden Konzepten:

  1. Beziehung zwischen Berichten und Nutzern (Profilen)
  2. Die Struktur eines Berichts und wie Abfragen erstellt werden
  3. Mit der API-Antwort arbeiten

Berichte, Nutzer und Datenansichten (Profile)

Zum Anfordern von Berichtsdaten für einen Nutzer muss die Anwendung den Nutzer identifizieren und eine Datenansicht (Profil) angeben, für die die Daten abgerufen werden sollen. Nutzer werden identifiziert, indem die Autorisierungsdaten abgerufen und in jeder API-Anfrage weitergegeben werden. Eine Datenansicht (Profil) ist in der Konfigurationshierarchie von Google Analytics enthalten und wird durch eine ID (Profil) gekennzeichnet.

Es gibt mehrere Möglichkeiten, Ihre Datenansichts-ID (Profil-ID) zu ermitteln.

  • Die Anwendung kann die Management API verwenden, um die Konfigurationshierarchie der Verwaltung zu durchlaufen und eine ID für eine Datenansicht (Profil) abzurufen.
  • In der URL jedes Berichts in Google Analytics
  • Klicken Sie in Google Analytics in der Menüleiste auf Verwaltung. Wählen Sie das Konto und die Property aus, zu denen die Datenansicht gehört. Klicken Sie in der Spalte DATENANSICHT auf Einstellungen der Datenansicht, um die ID der Datenansicht abzurufen.

Dimensionen und Messwerte abfragen

Sie fragen die API für Google Analytics-Berichtsdaten ab, die aus Dimensionen und Messwerten bestehen. Messwerte sind individuelle Messungen der Nutzeraktivität in Ihrer Property, z. B. Sitzungen und Seitenaufrufe. Mit Dimensionen werden Messwerte nach einigen gemeinsamen Kriterien aufgeschlüsselt, z. B. nach Land oder Browser. Wenn Sie eine Abfrage erstellen, geben Sie an, welche Dimensionen und Messwerte in die Berichtsdaten aufgenommen werden sollen.

Im interaktiven Referenzhandbuch für Dimensionen erfahren Sie mehr über die Dimensionen und Messwerte, die über die API zugänglich sind. Weitere Informationen zum Angeben von Dimensionen und Messwerten in einer API-Abfrage finden Sie im Core Reporting API-Referenzhandbuch.

Mit Berichten arbeiten

Die von der API zurückgegebenen Daten können Sie sich als Tabelle mit einem Header und einer Liste von Zeilen vorstellen. Jede API-Antwort besteht aus einem Header, der den Namen und Datentyp jeder Spalte beschreibt. Die Antwort enthält auch eine Liste mit Zeilen, wobei jede Zeile eine Liste von Zellen mit Daten in der gleichen Reihenfolge wie die Header enthält. Anhand der Informationen im Header bestimmen Sie den Datentyp in jeder Zelle.

Weitere Informationen zur API-Antwort finden Sie im Core Reporting API-Referenzhandbuch.

Zurück nach oben

Richtlinien zu Kontingenten und Versionen

Die Google Analytics API verarbeitet Millionen von Vorgängen. Damit das System nicht mehr Vorgänge empfangen kann, als es verarbeiten kann, und eine gerechte Verteilung der Systemressourcen sichergestellt werden muss, muss ein Kontingentsystem eingesetzt werden. Informationen zu bestimmten Limits finden Sie im Leitfaden Limits und Kontingente.

Ausführliche Informationen zum Umgang mit Änderungen an den Core Reporting API-Spalten (Dimensionen und Messwerten) finden Sie in der Richtlinie zur Einstellung von Daten. Informationen dazu, wie Sie mit der Metadata API nach verworfenen Spalten suchen können, finden Sie im Entwicklerleitfaden zur Metadata API.

Next Steps

Nachdem du jetzt die Funktionsweise der API kennst, haben wir eine Reihe von Ressourcen für den Einstieg:

  • Im Entwicklerleitfaden erfährst du mehr über die Arbeit mit der API.
  • Mit dem interaktiven Abfrage-Explorer können Sie Abfragen visuell erstellen und die Antwort über die API ansehen.
  • Im Artikel Allgemeine Abfragen finden Sie eine Liste der häufigsten Abfragen an die Core Reporting API.
  • Eine Liste aller über die API verfügbaren Daten finden Sie in der Referenz zu Dimensionen und Messwerten.
  • Auf der Seite Bibliotheken &Beispiele finden Sie eine Liste aller verfügbaren Clientbibliotheken, die mit dieser API verwendet werden können.

Zurück nach oben