Empfohlene und benutzerdefinierte Ereignisse in Google Analytics

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

Empfohlene und benutzerdefinierte Ereignisse senden

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

Workflowübersicht

So senden Sie Ereignisdaten mit der Data Manager API:

  1. Ziele vorbereiten:Definieren Sie die Destination-Objekte für das Feld destinations der Aufnahme-Anfrage, um das Zielkonto und das Conversion- oder Ereignisziel anzugeben. Weitere Informationen finden Sie unter Ziele vorbereiten.

  2. Ereignisdaten und Kennungen vorbereiten:Füllen Sie die Event-Felder mit Ereignisdetails und erforderlichen Kennungen (z. B. Kennungen für Anzeigenklicks, Clients oder App-Instanzen). Wenn Sie Nutzerkontaktdaten in userData angeben, müssen Sie die Kennungen gemäß den Formatierungsrichtlinien normalisieren und mit SHA-256 hashen. Optional können Sie sie auch verschlüsseln. Weitere Informationen finden Sie unter Ereignisdaten vorbereiten.

  3. Aufnahme-Anfrage erstellen und senden: Senden Sie eine events.ingest-Anfrage mit Ihrer destinations, Ihren Event-Einträgen und encryptionInfo, wenn Sie userData verschlüsselt haben. Verwenden Sie validateOnly: true, um Ihre Nutzlast auf Fast-Fail-Fehler zu testen, bevor Sie Produktionsdaten senden. Informationen zu Feldanforderungen und Codebeispiele finden Sie unter Ereignisse senden.

  4. Diagnoseinformationen ansehen: Rufen Sie Diagnoseinformationen zur asynchronen Verarbeitung ab und prüfen Sie den Aufnahmestatus mit requestStatus.retrieve.

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 Postanschriften im Feld userData einer Event senden. So lassen sich Conversion-Analyse, Attribution und Zielgruppenerstellung in Google Analytics verbessern.

Beachten Sie beim Senden von Nutzern bereitgestellter 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 (z. B. E-Mail-Adresse, Telefonnummer, Name und Adresse) müssen vor dem Hochladen normalisiert und mit SHA-256 gehasht werden. Andere Felder (z. B. Stadt, Bundesland, Postleitzahl und Ländercode) werden normalisiert, aber nicht gehasht. Spezifische Anforderungen finden Sie im Leitfaden Nutzerdaten formatieren.

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

  • User-ID: Wir empfehlen, die userId zusammen mit der 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 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. Dazu wird clientId oder appInstanceId verwendet.

Datenschutzeinstellungen

In Google Analytics werden Data Manager API-Ereignisse mit Onlineinteraktionen über clientId oder appInstanceId zusammengeführt, um Datenschutzeinstellungen für Nutzer wie „Nicht personalisierte Anzeigen“ und „Kein Anzeigen-Tracking“ zu übernehmen.

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

Geografische und Geräteinformationen

In Google Analytics werden die neuesten geografischen und Geräteinformationen aus dem Tagging automatisch mit Data Manager API-Ereignissen zusammengeführt. Dazu wird die clientId oder die appInstanceId verwendet. So werden Ihre Data Manager API-Ereignisse in Berichten mit geografischen und Gerätedimensionen berücksichtigt.

Wenn Sie möchten, dass ein Data Manager API-Ereignis die geografischen und Geräteinformationen einer bestimmten Sitzung anstelle der neuesten Informationen für die clientId oder appInstanceId widerspiegelt, fügen Sie einen Eintrag in additionalEventParameters hinzu, wobei parameterName auf session_id und value auf die ID der bestimmten Sitzung festgelegt ist. Senden Sie das Ereignis innerhalb von 24 Stunden nach Beginn der Sitzung.

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

Vollständige Server-zu-Server-Integration

Es ist zwar möglich, Ereignisse ausschließlich mit der Data Manager API an Google Analytics zu senden, aber möglicherweise sind dann 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 wurden. Einige Ereignis- und Parameternamen sind für die automatische Erfassung reserviert und 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 wie die in der Google Analytics-Benutzeroberfläche konfigurierten Regeln.

Weiter
Ereignisse senden