Was ist die Core Reporting API – Übersicht

Dieses Dokument bietet eine allgemeine Übersicht über Version 3.0 der Google Analytics Core Reporting API. Eine detaillierte Referenz zur API finden Sie im Referenzhandbuch.

Einleitung

Mit der Google Analytics Core Reporting API haben Sie Zugriff auf die meisten Berichtsdaten in Google Analytics. Mit der Core Reporting API können Sie:

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

Version auswählen

Vor Kurzem haben wir eine neue Version der Core Reporting API eingeführt.

  • Sie erstellen eine neue Anwendung? – Wir empfehlen die Verwendung der neuesten Version 3.0.
  • Sie verwenden die alte Version 2.3? – Lesen Sie in der Migrationsanleitung nach, wie Sie Ihre Anwendung auf die neue Version aktualisieren.

Erste Schritte

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

Jede Anwendung, die die API verwendet, muss einige Schritte ausführen, um den Nutzer zu registrieren, zu autorisieren und mit der API zu arbeiten. In dieser Anleitung werden Sie durch die einzelnen Schritte geführt. Am Ende haben Sie eine funktionierende Anwendung, die Sie anpassen können.

Konzeptübersicht

Die Core Reporting API gibt Berichtsdaten aus, die aus Statistiken bestehen, die aus den Daten abgeleitet wurden, die vom Google Analytics-Tracking-Code erfasst wurden. Jeder Bericht ist als Dimensionen und Messwerte organisiert. Mit der Core Reporting API können Sie Dimensionen und Messwerte abfragen, um benutzerdefinierte Berichte zu erstellen.

Der Core Reporting API stützen sich auf drei grundlegende Konzepte:

  1. Beziehung zwischen Berichten und Nutzern und Datenansichten (Profilen)
  2. Aufbau eines Berichts und Erstellen von Abfragen
  3. Mit der API-Antwort arbeiten

Berichte, Nutzer und Datenansichten (Profile)

Zum Anfordern von Berichtsdaten für einen Nutzer muss Ihre Anwendung den Nutzer identifizieren und eine Datenansicht (Profil) angeben, für die die Daten abgerufen werden sollen. Ein Nutzer wird durch Abrufen von Autorisierungsanmeldedaten identifiziert und in jeder API-Anfrage übergeben. Eine Datenansicht (Profil) ist Teil der Konfigurationshierarchie von Google Analytics und wird durch ihre ID der Datenansicht bzw. des Profils identifiziert.

Es gibt mehrere Möglichkeiten, die ID der Datenansicht (Profil) zu finden.

  • Ihre Anwendung kann die Management API verwenden, um die Konfigurationshierarchie der Verwaltung zu durchlaufen und eine ID der Datenansicht bzw. des Profils 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 der 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. Dimensionen schlüsseln Messwerte nach einigen gängigen Kriterien auf, z. B. Land oder Browser. Wenn Sie eine Abfrage erstellen, geben Sie an, welche Dimensionen und Messwerte in Ihren Berichtsdaten enthalten sein sollen.

Im interaktiven Referenzhandbuch für Dimensionen und Messwerte erfahren Sie mehr über alle Dimensionen und Messwerte, die über die API zur Verfügung gestellt werden. Im Referenzhandbuch zur Core Reporting API erfahren Sie, wie Sie Dimensionen und Messwerte in einer API-Abfrage angeben.

Mit Berichten arbeiten

Die von der API zurückgegebenen Daten können Sie sich als eine Tabelle mit einer Kopfzeile und einer Liste von Zeilen vorstellen. Jede API-Antwort besteht aus einer Kopfzeile, die den Namen und den Datentyp der einzelnen Spalten beschreibt. Die Antwort enthält außerdem eine Liste von Zeilen, wobei jede Zeile eine Liste von Zellen mit Daten in derselben Reihenfolge wie die Kopfzeilen ist. Anhand der Informationen im Header bestimmen Sie den Datentyp in den einzelnen Zellen.

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

Zurück nach oben

Kontingent- und Einstellungsrichtlinien

Die Google Analytics API verarbeitet Millionen von Vorgängen. Es ist erforderlich, ein Kontingentsystem zu verwenden, um zu verhindern, dass das System mehr Vorgänge erhält, als es verarbeiten kann, und um eine gleichmäßige Verteilung der Systemressourcen zu gewährleisten. Informationen zu bestimmten Limits finden Sie im Leitfaden Limits und Kontingente.

Informationen dazu, wie Änderungen an Spalten der Core Reporting API (d.h. an Dimensionen und Messwerten) verarbeitet werden, finden Sie in der Richtlinie zur Einstellung von Daten. Informationen dazu, wie Sie mit der Metadata API nach eingestellten Spalten suchen können, finden Sie im Entwicklerleitfaden für die Metadata API.

Nächste Schritte

Da Sie jetzt mit der Funktionsweise der API vertraut sind, haben wir eine Reihe von Ressourcen für den Einstieg:

Zurück nach oben