Empfohlene und benutzerdefinierte Ereignisse in Google Analytics

Mit der Data Manager API können Sie empfohlene und benutzerdefinierte Ereignisse an Google Analytics senden.

Weitere Informationen finden Sie unter Ereignisse senden.

Wenn Sie ein Upgrade vom Google Analytics Measurement Protocol durchführen, finden Sie unter Upgrade vom Measurement Protocol zur Data Manager API eine Anleitung.

Anwendungsfälle

Hier sind einige Anwendungsfälle für das Senden empfohlener und benutzerdefinierter Ereignisse mit der Data Manager API:

• Verknüpfen Sie Online- und Offlineaktionen.

• Client- und serverseitige Interaktionen messen

• Ereignisse senden, die außerhalb der standardmäßigen Nutzerinteraktionen stattfinden, etwa Offline-Conversions.

• Ereignisse von Geräten und Apps senden, die nicht automatisch einbezogen werden, etwa Kioske und Uhren

Von Nutzern bereitgestellte Daten

Sie können selbst erhobene Kundendaten wie gehashte E-Mail-Adressen, Telefonnummern und Adressen im Feld userData eines Event senden. So lassen sich Conversion-Analyse, Attribution und Zielgruppenerstellung in Google Analytics verbessern.

Beachten Sie beim Senden von von Nutzern bereitgestellten Daten Folgendes:

• Mit Ereignissen gesendet: In der Data Manager API müssen von Nutzern bereitgestellte Daten als Teil eines Event gesendet werden. Eigenständige Uploads ohne Ereignis werden nicht unterstützt.

• Formatierung und Hashing: Personenbezogene Kennungen wie E-Mail-Adresse, Telefonnummer, Name und Adresse müssen vor dem Hochladen normalisiert und mit SHA-256 gehasht werden. Andere Felder wie Stadt, Bundesland, Postleitzahl und Ländercode werden normalisiert, aber nicht gehasht. Hier finden Sie eine Anleitung zum Formatieren von Nutzerdaten.

• Verschlüsselung: Sie können gehashte Nutzerdaten optional verschlüsseln.

• Nutzer-ID: Wir empfehlen, die userId zusammen mit userData anzugeben, wenn eine einheitliche Nutzer-ID verfügbar ist.

• Implementierung: Eine Anleitung zum Erstellen von Anfragen finden Sie unter Von Nutzern bereitgestellte Daten hinzufügen.

Überlegungen zur Integration

Beachten Sie bei der Verwendung der Data Manager API Folgendes:

Remarketing

Google Analytics unterstützt das Remarketing auf demselben Gerät, wenn Sie Google-Signale aktivieren. Für geräteübergreifendes Remarketing ist userId erforderlich.

Außerdem können Sie von Nutzern bereitgestellte Daten senden, um den Abgleich von Zielgruppen mit selbst erhobenen Daten zu ermöglichen.

Werbe-IDs

In Google Analytics werden Werbe-IDs (z. B. GBRAID oder WBRAID), die bei Onlineinteraktionen erfasst werden, automatisch mit Data Manager API-Ereignissen zusammengeführt, die clientId oder appInstanceId verwenden.

Datenschutzeinstellungen

In Google Analytics werden Data Manager API-Ereignisse mit Onlineinteraktionen verknüpft. Dazu werden clientId oder appInstanceId verwendet, um die Datenschutzeinstellungen der Nutzer wie „nicht personalisierte Anzeigen“ und „Anzeigen-Tracking einschränken“ zu berücksichtigen.

Sie können die Einstellungen für die Nutzereinwilligung auch direkt für jedes Ereignis mit dem Objekt consent angeben.

Geografische Informationen und Geräteinformationen

In Google Analytics werden die neuesten geografischen Informationen und Geräteinformationen aus dem Tagging automatisch mit Data Manager API-Ereignissen zusammengeführt, die clientId oder appInstanceId verwenden. So werden Ihre Data Manager API-Ereignisse in Berichten mit geografischen Dimensionen und Geräte-Dimensionen berücksichtigt.

Wenn ein Data Manager API-Ereignis geografische Informationen und Geräteinformationen aus einer bestimmten Sitzung anstelle der neuesten Informationen für clientId oder appInstanceId enthalten soll, fügen Sie einen Eintrag in additionalEventParameters mit parameterName auf session_id und value auf die ID der bestimmten Sitzung ein und senden Sie das Ereignis innerhalb von 24 Stunden nach Beginn der Sitzung.

Sie können geografische Informationen und Geräteinformationen für Ereignisse über die Data Manager API bereitstellen.

Vollständige Server-zu-Server-Integration

Es ist zwar möglich, Ereignisse nur mit der Data Manager API an Google Analytics zu senden, aber es sind möglicherweise nur unvollständige Berichte verfügbar. Die Data Manager API dient dazu, vorhandene Ereignisse zu ergänzen, die mit gtag, Tag Manager oder Firebase erfasst werden. Einige Ereignis- und Parameternamen sind reserviert und können nur für die automatische Erfassung verwendet werden. Sie können nicht über die Data Manager API gesendet werden.

Ereignisse generieren oder umbenennen

Ereignisse, die mit der Data Manager API gesendet werden, lösen keine Regeln zum Generieren oder Umbenennen von Ereignissen aus. Ihre Anwendung sollte die Logik zum Senden benutzerdefinierter Ereignisse über die Data Manager API implementieren, ähnlich den in der Google Analytics-Benutzeroberfläche konfigurierten Regeln.