Empfohlene und benutzerdefinierte Ereignisse in Google Analytics

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

Empfohlene und benutzerdefinierte Ereignisse senden

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

Workflowübersicht

So senden Sie Ereignisdaten mit der Data Manager API:

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

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

  3. Aufnahmeanfrage erstellen und senden:Senden Sie eine events.ingest-Anfrage mit Ihren destinations, Event-Datensätzen und encryptionInfo, wenn Sie userData verschlüsselt haben. Verwenden Sie validateOnly: true, um Ihre Nutzlast auf Fehler zu testen, die schnell erkannt werden können , bevor Sie Produktionsdaten senden. Informationen zu den Feldern und Codebeispiele finden Sie unter Ereignisse senden für.

  4. Diagnose prüfen: Rufen Sie die Diagnose der asynchronen Verarbeitung ab und prüfen Sie den Aufnahmestatus mit requestStatus.retrieve.

Anwendungsfälle

Hier 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, Telefon nummern und Postadressen im userData Feld eines Event senden. So lassen sich Conversion-Messung, Attribution und Zielgruppenaufbau 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 IDs (z. B. E-Mail-Adresse, Telefonnummer, Name und Adresse) müssen vor dem Upload normalisiert und mit SHA-256 gehasht werden. Andere Felder (z. B. Stadt, Bundesland oder Provinz, Postleitzahl und Ländercode) werden normalisiert, aber nicht gehasht. Informationen zu den spezifischen Anforderungen finden Sie im Leitfaden 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 konsistente Nutzer-ID verfügbar ist.

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

Ü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 Remarketing auf verschiedenen Geräten 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

Google Analytics verknüpft Werbe-IDs (z. B. GBRAID oder WBRAID) , die bei Onlineinteraktionen erfasst wurden, automatisch mit Data Manager API-Ereignissen über clientId oder appInstanceId.

Datenschutzeinstellungen

Google Analytics verknüpft Data Manager API-Ereignisse mit Onlineinteraktionen über clientId oder appInstanceId, um Datenschutzeinstellungen wie „Nicht personalisierte Anzeigen“ und „Anzeigen-Tracking einschränken“ zu übernehmen.

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

Geografische Daten und Geräteinformationen

Google Analytics verknüpft die neuesten geografischen Daten und Geräteinformationen aus dem Tagging automatisch mit Data Manager API-Ereignissen über clientId oder appInstanceId. So werden Ihre Data Manager API-Ereignisse in Berichten berücksichtigt, die geografische Dimensionen und Gerätedimensionen enthalten.

Wenn ein Data Manager API-Ereignis geografische Daten und Geräteinformationen aus einer bestimmten Sitzung widerspiegeln soll und nicht die neuesten Informationen für die clientId oder appInstanceId, fügen Sie einen Eintrag in additionalEventParameters ein, wobei parameterName auf session_id und value auf die ID der jeweiligen Sitzung festgelegt ist. Senden Sie das Ereignis innerhalb von 24 Stunden nach Beginn der Sitzung.

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

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 soll vorhandene Ereignisse ergänzen, die mit gtag, Tag Manager oder Firebase erfasst wurden. Einige Ereignis- und Parameternamen sind reserviert für die Verwendung durch automatische Erfassung 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 implementieren, um benutzerdefinierte Ereignisse über die Data Manager API zu senden, ähnlich den Regeln, die in der Google Analytics-Benutzeroberfläche konfiguriert sind.

Weiter
Ereignisse senden