Was ist die Multi-Channel-Trichter-Berichterstellungs-API?

Dieses Dokument bietet einen allgemeinen Überblick über die Google Analytics Multi-Channel Trichter Reporting API. Eine ausführliche Referenz zur API finden Sie im Referenzhandbuch.

Hinweis: Diese API unterstützt keine Google Analytics 4-Properties (GA4).

Einführung

Mit der Multi-Channel-Trichter-Berichterstellungs-API können Sie Multi-Channel-Trichterdaten für einen authentifizierten Nutzer anfordern. Die Daten werden aus Conversion-Pfaddaten abgeleitet, die Nutzerinteraktionen mit verschiedenen Besucherquellen über mehrere Sitzungen hinweg vor der Conversion anzeigen. So kannst du analysieren, wie sich mehrere Marketingkanäle auf Conversions im Laufe der Zeit auswirken. Weitere Informationen zu den verfügbaren Daten findest du in den Artikeln Multi-Channel-Trichter und Multi-Channel-Trichterdaten.

Mit der Multi-Channel Trichter Reporting API können Sie:

• Mit Multi-Channel-Trichterdaten benutzerdefinierte Berichte erstellen Mit den Daten zu Top-Conversion-Pfaden können Sie beispielsweise Berichte zu Attributen wie der relativen Position von Interaktionen in einem Conversion-Pfad erstellen.
• Binden Sie Multi-Channel-Trichterdaten in Ihre Geschäftsdaten ein. Sie könnten beispielsweise Online-Conversion-Daten mit Offline-Verkaufsdaten und Daten zu Mediakosten in Beziehung setzen, um ein umfassenderes Bild vom Marketing-ROI zu erhalten.
• Multi-Channel-Trichter in neuen Umgebungen anzeigen Beispielsweise können Sie Visualisierungen und andere Datenpräsentationen erstellen, die den Wert verschiedener Marketingkanäle zur Steigerung von Conversions vermitteln.

Hinweis: Die Daten in den Berichten zu Multi-Channel-Trichtern können sich um 24 bis 36 Stunden verzögern.

Konzeptübersicht

Die Multi-Channel-Trichter-Berichterstellungs-API umfasst die folgenden grundlegenden Konzepte:

• Beziehung zwischen Berichten und Nutzern (Profilen)
• Die Struktur eines Berichts und die Erstellung von Abfragen
• Conversion-Pfaddaten und Attributionskonzepte.
• Mit der API-Antwort arbeiten.

Berichte, Nutzer und Datenansichten (Profile)

Wenn Sie Berichtsdaten für einen Nutzer anfordern möchten, muss Ihre 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) wird durch eine ID (Profil) identifiziert. Datenansichten sind unter anderem Teil der Konfigurationshierarchie von Google Analytics. Ihre Anwendung kann die Management API verwenden, um diese Hierarchie zu durchsuchen und eine ID für ein Profil (Profil) 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, z. B. Anzahl der Conversions und Werte. Mit Dimensionen werden Messwerte nach einigen gemeinsamen Kriterien aufgeschlüsselt. Sie können entweder einfache Werte sein, die einzelne Interaktionsereignisse in Conversion-Pfaden darstellen, oder Sequenzen, die die Reihe von Interaktionsereignissen ganzer Conversion-Pfade darstellen.

Im Leitfaden zu Dimensionen und Messwerten finden Sie alle Dimensionen und Messwerte, die über die API verfügbar sind. Lesen Sie außerdem das Referenzhandbuch für die Multi-Channel Trichter Reporting API, um zu erfahren, wie Dimensionen und Messwerte in einer API-Abfrage angegeben werden.

Conversion-Pfaddaten und Attributionskonzepte

Berichte zu Multi-Channel-Trichtern werden anhand von Conversion-Pfaden erstellt, also der Abfolge von Interaktionen (z.B. Klicks/Verweise von Channels), die zu einer Conversion oder Transaktion geführt haben. Die Conversion-Pfade werden über das Google Analytics-Cookie erfasst, mit dem Interaktionen desselben Browsers und Computers aufgezeichnet werden. Die Multi-Channel-Trichterdaten kombinieren die Google Analytics-Conversion-Daten mit der Abfolge der im Cookie erfassten Interaktionen.

In Berichten zu Multi-Channel-Trichtern werden Daten basierend auf einer Stichprobe von 1 Million Conversion-Pfaden zurückgegeben. Wenn der Zeitraum eine Conversion-Gesamtanzahl von maximal 1 Million umfasst, erfolgt die Gesamtdatenanalyse des Berichts. Andernfalls wird eine Beispielgruppe von 1 Million verwendet, um die Ergebnisse zu generieren. Dies steht im Gegensatz zur Core Reporting-Funktion, die auf Sitzungen basiert. Weitere Informationen zu den Daten und zugehörigen Konzepten finden Sie unter Multi-Channel-Trichterdaten. Außerdem kannst du dir den Artikel Channelbeiträge analysieren ansehen, in dem grundlegende Konzepte wie vorbereitete Conversions definiert sind.

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 enthält, deren Daten in derselben Reihenfolge wie die Header vorliegen. Weitere Informationen zur API-Antwort findest du im Referenzleitfaden für die Multi-Channel Trichter Reporting API.

Jeder Zellenwert enthält entweder einen einfachen Stringtyp oder einen Conversion-Pfadwert. Dieser Wert für den Conversion-Pfad ist ein Array von Objekten, die alle Knoten dieses Pfads darstellen. Wir können die Typinformationen in den Spaltenüberschriften verwenden, um jeden Zellenwert in den entsprechenden Typ zu parsen. Weitere Informationen

Kontingentrichtlinie

Mit der Multi-Channel-Trichterdatenabfrage werden Millionen von Vorgängen verarbeitet. 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. Weitere Informationen finden Sie unter Limits und Kontingente.

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 Google APIs Explorer können Sie Abfragen erstellen und die Antwort über die API ansehen.
• Eine Liste aller über die API verfügbaren Daten finden Sie im Leitfaden zu Dimensionen und Messwerten.
• Auf der Seite Bibliotheken und Beispiele finden Sie eine Liste aller verfügbaren Clientbibliotheken, die mit dieser API verwendet werden können.