Nutzerereignisse in Echtzeit aufzeichnen

Auf dieser Seite wird beschrieben, wie Sie Nutzerereignisse in Echtzeit aufzeichnen. Vertex AI Search für den Einzelhandel verwendet Nutzerereignisse in Echtzeit, um Empfehlungen und Suchergebnisse zu generieren. Das Aufzeichnen von so vielen Typen von Nutzerereignissen mit gültigen Produktinformationen wie möglich erhöht die Qualität der Ergebnisse.

Die Aufzeichnungsverfahren auf dieser Seite gelten sowohl für Empfehlungen als auch für die Suche. Nachdem Sie Daten aufgezeichnet haben, können beide Dienste diese Ereignisse verwenden, sodass Sie dieselben Daten nicht zweimal hochladen müssen, wenn Sie beide Dienste nutzen.

Weitere Informationen zu Nutzerereignissen, einschließlich Nutzerereignistypen und Beispiel-JSON-Dateien für alle Typen, finden Sie unter Nutzerereignisse.

Es gibt mehrere Möglichkeiten, ein Nutzerereignis aufzuzeichnen:

Im Folgenden finden Sie Beispiele für die Aufzeichnung von Nutzerereignissen vom Typ detail-page-view für alle diese Vorgehensweisen. Informationen zu anderen Ereignistypen finden Sie unter Nutzerereignisse.

Sie können auch bisherige Nutzerereignisse importieren. Das Erfassen ausreichender Nutzerereignisdaten zum Trainieren Ihrer Modelle kann sehr lange dauern. Sie können aber das erste Modelltraining beschleunigen, wenn Sie Nutzerereignisdaten aus bisherigen Ereignissen im Bulk importieren. Weitere Informationen finden Sie unter Nutzerereignisse importieren.

Wenn das von Ihnen aufgezeichnete Nutzerereignis die erste Interaktion eines Nutzers mit einem Produkt auf der Grundlage einer zuvor bereitgestellten Empfehlung oder von Suchergebnissen ist, werden Leistungsmesswerte einschließlich eines Attributionstokens aktiviert. Das Einbinden eines Attributionstokens ist optional, wird aber dringend empfohlen. Informationen zur Verwendung von Attributionstokens finden Sie unter Attributionstoken.

Zum Aufzeichnen von Nutzerereignissen sind Besucher-IDs erforderlich. Informationen zu Besucher- und Nutzer-IDs finden Sie unter Informationen zu Nutzerinformationen.

Anleitung zum Schreiben von Nutzerereignissen

In dieser Anleitung wird gezeigt, wie Nutzerereignisse mit der Methode userEvents.write aufgezeichnet werden.

Klicken Sie auf Anleitung, um eine detaillierte Anleitung für diese Aufgabe direkt im Cloud Shell-Editor zu erhalten:

Anleitung

Hinweise

Vor der Aufzeichnung von Nutzerereignissen ist Folgendes erforderlich:

  • Erstellen eines Google Cloud-Projekts mit eingerichteter Authentifizierung.

  • Ein gültiger API-Schlüssel (für JavaScript Pixel oder Tag Manager) oder ein gültiges Dienstkonto mit der Rolle "Retail-Bearbeiter", wenn die API zum direkten Schreiben verwendet wird.

    Weitere Informationen finden Sie unter Vorbereitung.

Best Practices zum Aufzeichnen von Nutzerereignissen

Vertex AI Search für den Einzelhandel benötigt hochwertige Daten, um hochwertige Ergebnisse zu generieren. Wenn Ihre Daten unvollständig oder falsch sind, beeinträchtigt dies die Qualität die Ergebnisse.

Sorgen Sie dafür, dass beim Aufzeichnen von Nutzerereignissen die folgenden Best Practices verwendet werden:

  • Wenn Sie Nutzerereignisse vor oder während des Imports Ihres Katalogs aufzeichnen, fügen Sie alle Ereignisse noch einmal hinzu, die vor Abschluss des Katalogimports aufgezeichnet wurden.

    Sie können den Katalog vor, nach oder gleichzeitig importieren, wenn Sie Nutzerereignisse aufzeichnen. Durch parallele Ausführung dieser Aufgaben sparen Sie Zeit, wenn der Katalog umfangreich ist und viele Nutzerereignisse vorhanden sind. Sobald der Katalogimport abgeschlossen ist, müssen Sie die API verwenden, um Ereignisse, die vor Abschluss des Imports hochgeladen wurden, wieder zusammenzuführen.

    Vertex AI Search für den Einzelhandel versucht, aufgezeichnete Nutzerereignisse mit Metadaten aus dem Produktkatalog zusammenzuführen, wenn das Nutzerereignis erstellt wird. Für das Training werden nur erfolgreich verbundene Ereignisse verwendet. Achten Sie daher darauf, dass alle Ereignisse noch einmal hinzugefügt werden, die aufgezeichnet wurden, bevor der Katalog vollständig importiert wurde. Wenn sich ein Ereignis auf einen Artikel bezieht, das nicht im Katalog vorhanden ist, wird es verworfen oder nicht mit den richtigen Produkten verbunden. Das Gleiche gilt, wenn Sie Nutzerereignisse aus der Vergangenheit importieren. Der Katalog muss dann alle Produkte enthalten, auf die sie verweisen. Sie können ältere Produkte auch als OUT_OF_STOCK markieren, anstatt sie aus dem Katalog zu entfernen.

  • Halten Sie Ihren Katalog immer auf dem neuesten Stand.

    Wenn Sie Nutzerereignisse aufzeichnen, ist das im Nutzerereignis enthaltene Produkt mit Ihrem aktuellen Katalog verbunden. Wenn Sie ein Ereignis für ein Produkt aufzeichnen, das nicht im aktuellen Katalog enthalten ist, kann es nicht zum Trainieren Ihrer Modelle verwendet werden. Dies wird als „nicht verknüpftes“ Ereignis bezeichnet. Wenn Sie Ereignisse aufgezeichnet haben, bevor Ihr Katalog vollständig importiert wurde, müssen Sie die Ereignisse noch einmal verknüpfen, die während des Imports aufgezeichnet wurden. Es ist davon auszugehen, dass es einige nicht verbundene Ereignisse gibt. Wenn der Prozentsatz der nicht verknüpften Ereignisse jedoch 5% oder mehr Ihrer gesamten Nutzerereignisse erreicht, sollten Sie dafür sorgen, dass Ihr Katalog auf dem neuesten Stand ist, Ereignisse, die vor der vollständigen Aktualisierung des Katalogs aufgezeichnet wurden, noch einmal verknüpfen und untersuchen, warum die nicht verknüpften Ereignisse erstellt werden.

    Sie können Ihre nicht verbundenen Ereignisse mithilfe der Ereignisfilterung anzeigen lassen. Weitere Informationen

  • Stellen Sie so viele Informationen wie möglich mit Ihren Nutzerereignissen bereit.

    Jeder Nutzerereignistyp hat unterschiedliche Informationen, die erforderlich sind und akzeptiert werden. Weitere Informationen finden Sie unter Informationen zu Nutzerereignissen.

  • Richten Sie Cloud Monitoring-Benachrichtigungen ein, damit Sie informiert werden, wenn es zu Ausfällen bei den Prozessen zur Aufzeichnung von Nutzerereignissen kommt.

  • Für einen Bulk-Import von Nutzerereignissen müssen Sie die Größe der Daten begrenzen, die importiert werden sollen.

    Der Bulk-Import von Nutzerereignissen kann bis zu 24 Stunden dauern.

    Die einzelnen Dateien dürfen maximal 2 GB groß sein. Eine einzelne Importanfrage kann maximal 100 Dateien enthalten. Ein Ansatz dafür besteht darin, nur die Nutzerereignisse für jeweils einen Tag zu importieren.

  • Prüfen Sie nach dem Bulk-Import anhand Ihrer Fehlerberichte, ob Ihre Daten korrekt importiert wurden.

  • Fügen Sie beim Importieren von Nutzerereignisdaten einen exakten Zeitstempel für jedes Nutzerereignis hinzu und vermeiden Sie den Import sequenzieller Nutzerereignisse mit identischen Zeitstempeln.

    Geben Sie den Zeitstempel im Feld eventTime in dem von RFC 3339 festgelegten Format an.

  • Wenn Sie falsche Nutzerereignisse importiert haben, wenden Sie sich an Ihren Ansprechpartner für Vertex AI Search für den Einzelhandel, um das Problem zu beheben.

  • Sorgen Sie dafür, dass Nutzerereignisdaten nach Möglichkeit fortlaufend vorhanden sind.

    Lücken in den Nutzerereignisdaten können die Modellqualität beeinträchtigen.

  • Verwenden Sie eine sichere Form einer eindeutigen Kennung, um Nutzer für Vertex AI Search für den Einzelhandel anonym zu halten und die Privatsphäre Ihrer Nutzer zu schützen. Es liegt in Ihrer Verantwortung, dass keine personenidentifizierbaren Informationen wie E-Mail-Adressen oder Privatadressen in Ihren Daten vorhanden sind.

Nutzerereignisse mit einem JavaScript-Pixel aufzeichnen

Im folgenden Beispiel wird ein detail-page-view-UserEvent mit einem JavaScript-Pixel aufgezeichnet.

<script type="text/javascript">
var user_event = {
  "eventType" : "detail-page-view",
  "visitorId": "visitor-id",
  "userInfo": {
      "userId": "user-id"
  },
  "attributionToken": "attribution-token",
  "experimentIds": "experiment-id",
  "productDetails": [
      {
        "product": {"id": "123"}
      }
  ]
};

var _gre = _gre || [];
// Credentials for project.
_gre.push(['apiKey', 'api-key']);
_gre.push(['logEvent', user_event]);
_gre.push(['projectId', 'project-id']);
_gre.push(['locationId', 'global']);
_gre.push(['catalogId', 'default_catalog']);

(function() {
  var gre = document.createElement('script'); gre.type = 'text/javascript'; gre.async = true;
  gre.src = 'https://www.gstatic.com/retail/v2_event.js';
  var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(gre, s);
})();

</script>

Wenn Sie Nutzerereignisse mit Google Analytics 360 importiert haben, legen Sie für visitorID die Google Analytics-Client-ID fest. Beachten Sie, dass die Google Analytics-Client-ID nur ein Teil des vollständigen _ga-Cookie-Namens ist (z. B. ist die Client-ID 123456789.123456789 Teil des _ga-Cookies GA1.3.123456789.123456789).

Weitere Informationen zum Abrufen der Client-ID finden Sie in der Google Analytics-Dokumentation.

Das folgende Beispiel zeigt ein gekürztes Beispiel mit dem Format zum Festlegen der Client-ID in einem Nutzerereignis. Ersetzen Sie dabei "UA-XXXXXX-N" durch Ihre Google Analytics-Tracking-ID.

<script type="text/javascript">
var tracker = ga.getByName('UA-XXXXXX-N');
var user_event = {
      "visitorId": tracker.get('clientId')
};
</script>

Nutzerereignisse mit der Methode userEvents.write aufzeichnen

Sie können mit der Methode userEvents.write Nutzerereignisse direkt vom Backend-Server an die API senden.

Zum Aufzeichnen von Nutzerereignissen senden Sie eine POST-Anfrage an die Methode userEvents.write und geben Sie den entsprechenden Anfragetext an.

curl

export GOOGLE_APPLICATION_CREDENTIALS=/tmp/my-key.json
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data "{
         'eventType': 'detail-page-view',
         'visitorId': 'visitor0',
         'eventTime': '2020-01-01T03:33:33.000001Z',
         'experimentIds': ['321'],
         'attributionToken': 'ABC',
         'attributes': {
            'example_text_attribute': {
              'text': ['text_1', 'text_2']
            },
            'example_number_attribute': {
               'numbers': [3.14, 42, 1.2345]
            }
         },
         'productDetails': [{
           'product': {
             'id': 'abc'
           }
          }],
         'userInfo': {
           'userId': 'abc',
           'ipAddress': '8.8.8.8',
           'userAgent': 'Mozilla/5.0',
           'directUserRequest': true
         },
         'uri': 'http://example',
         'referrerUri': 'http://example',
         'pageViewId': 'currentPageUri'
}" \
"https://retail.googleapis.com/v2/projects/PROJECT_ID/locations/global/catalogs/default_catalog/userEvents:write"

Java

public static UserEvent writeUserEvents(UserEvent eventToWrite)
    throws IOException, InterruptedException {
  UserEventServiceClient userEventsClient = getUserEventServiceClient();

  WriteUserEventRequest request = WriteUserEventRequest.newBuilder()
      .setParent(DEFAULT_CATALOG_NAME)
      .setUserEvent(eventToWrite)
      .build();

  UserEvent writtenUserEvent = userEventsClient.writeUserEvent(request);

  userEventsClient.shutdownNow();
  userEventsClient.awaitTermination(2, TimeUnit.SECONDS);

  return writtenUserEvent;
}

Nutzerereignisse mit Google Analytics 4 aufzeichnen

Sie können Google Analytics 4-Nutzerereignisdaten in Vertex AI Search für den Einzelhandel aufzeichnen.

Datenquelle prüfen

Achten Sie darauf, dass die zu importierenden Nutzerereignisdaten richtig formatiert sind.

Eine Tabelle der Google Analytics 4-Felder, die von Vertex AI Search für den Einzelhandel verwendet werden, und den Vertex AI Search für Einzelhandelsfelder, denen sie zugeordnet sind, finden Sie unter Google Analytics 4-Nutzerereignisfelder.

Informationen zu allen Google Analytics-Ereignisparametern finden Sie in der Referenzdokumentation zu Google Analytics-Ereignissen.

Prüfen Sie, ob:

  1. Wenn Sie Kaufereignisse importieren, die einige Modelle von Vertex AI Search für den Einzelhandel erfordern, enthalten Ihre Ereignisberichte Währungscodes. Weitere Informationen finden Sie in der Google Analytics-Dokumentation unter purchase-Ereignisparameter.

  2. Wenn Sie search-Ereignisse importieren möchten, enthalten die Ereignisberichte Suchanfragen.

    Das Importieren von search-Ereignissen wird unterstützt. search-Ereignisse werden jedoch nicht auf die gleiche Weise wie andere Ereignistypen aus Google Analytics 4 zugeordnet, da Google Analytics 4 den Ereignistyp search von Vertex AI Search für den Einzelhandel nicht nativ unterstützt. Während des Imports werden search-Ereignisse aus Google Analytics 4 erstellt, indem Informationen aus den Ereignisparametern view_item_list und search_term kombiniert werden.

    Weitere Informationen finden Sie in der Google Analytics-Dokumentation unter search-Ereignisparameter.

Google Analytics 4-Ereignisse aufzeichnen

Zeichnen Sie ein Nutzerereignis auf. Nehmen Sie dazu URL-codierte JSON-Rohdaten für das Ereignis in den Aufruf der Methode userEvents.collect auf.

Verwenden Sie für den Parameter prebuilt_rule den Wert ga4_bq.

Im folgenden Beispiel für die Verwendung des userEvents.collect-Aufrufs wird zur besseren Lesbarkeit zuerst GA4_EVENT als Variable festgelegt, die die JSON-Rohdaten für ein Beispielereignis enthält. Durch den userEvents.collect-Aufruf in diesem Beispiel werden die Ereignisdaten dann mithilfe der Variablen GA4_EVENT URL-codiert.

  1. Wenn Sie die URL-Codierung später vereinfachen möchten, können Sie GA4_EVENT als Variable mit Ereignisdaten festlegen. Dieses Beispiel zeigt ein add-to-cart-Ereignis.

    GA4_EVENT='{
  "event_timestamp": 1622994083878241,
  "event_name": "add_to_cart",
  "user_pseudo_id": "352499268.1622993559",
  "items": [
    {
      "item_id": "11",
      "price": 29.99,
      "quantity": 3
    }
  ],
  "event_params": [
    {
      "key": "currency",
      "value": {
        "string_value": "CAD"
      }
    }
  ],
  "user_id": "Alice"
}'

  2. Führen Sie einen userEvents.collect-Aufruf aus, der die URL-codierten JSON-Rohdaten eines Nutzerereignisses enthält:

    curl \
-G \
--data-urlencode "raw_json=${GA4_EVENT}" \
-i \
"https://retail.googleapis.com/v2/projects/PROJECT_ID/locations/global/catalogs/default_catalog/userEvents:collect?key=EXAMPLEKEY1&prebuilt_rule=ga4_bq'"

Nutzerereignisse mit Google Tag Manager erfassen

Mit Tag Manager können Sie mehrere Tags verwalten und testen, ohne umfangreiche serverseitige Codeänderungen auf Ihrer Website vornehmen zu müssen.

Einige Entscheidungen, die Sie während der Einrichtung treffen, hängen davon ab, ob Sie Google Analytics oder Google Analytics E-Commerce verwenden. Google Analytics-E-Commerce kann mit Google Analytics 4 oder erweiterten E-Commerce-Berichten implementiert werden. Das Cloud Retail-Tag unterstützt beide.

Weder Google Analytics noch Google Analytics-E-Commerce sind erforderlich. Wenn Sie sie nicht verwenden, können Sie entweder beim Erstellen des Cloud Retail-Tags Variable – E-Commerce konfigurieren oder den Datenschichtcode Ihrer Website nach dem Erstellen des Tags manuell ausfüllen.

„Google Analytics-E-Commerce“ ist eine zusätzliche Konfiguration für Google Analytics, mit der Produkttitel, IDs, Preise, Transaktionsdetails und andere strukturierte E-Commerce-Daten an Google Analytics übergeben werden. Vertex AI Search für den Einzelhandel kann automatisch die E-Commerce-Datenschicht von Google Analytics verwenden. Wenn Sie diese bereits eingerichtet haben, kann die Konfiguration also einfacher sein. Wenn Sie Google Analytics-E-Commerce nicht für Google Analytics konfiguriert haben, es aber verwenden möchten, finden Sie weitere Informationen und eine Einrichtungsanleitung im GA4-Entwicklerleitfaden oder im Entwicklerleitfaden für erweiterte E-Commerce-Berichte.

Mit dieser einmaligen Vorgehensweise können Sie ein Cloud Retail-Tag in Tag Manager zur Aufzeichnung von Nutzerereignissen einrichten.

Variable für Besucher-ID erstellen

Der Wert visitorId dient zum Tracking von Nutzern. visitorId ist normalerweise eine Sitzungs-ID und für alle Ereignisse erforderlich. Richten Sie eine Variable ein, die Sitzungs-IDs als visitorId festlegt.

Wenn Sie Google Analytics verwenden, können Sie die Google Analytics-Besucher-ID nutzen. Zur entsprechenden Konfiguration verwenden Sie die folgenden Schritte, um den Besucher-ID-Wert für das Cloud Retail-Tag zu überschreiben. Dadurch wird das eigene Cookie "_ga" einer Tag Manager-Variablen namens "GA visitorId" zugeordnet. Dies ist auch für jedes Sitzungs-ID-Cookie möglich. Es muss also nicht aus Google Analytics stammen.

Bei dieser Vorgehensweise wird davon ausgegangen, dass Sie Google Analytics verwenden. Wenn nicht, können Sie ein anderes Cookie oder eine andere Variable verwenden oder die Besucher-ID aus der Datenschicht cloud_retail abrufen.

So legen Sie den Wert visitorID für eine Variable des Cloud Retail-Tags fest:

  1. Wechseln Sie in Tag Manager zum Tab Variablen und klicken Sie auf Neu, um eine neue benutzerdefinierte Variable zu erstellen.

  2. Geben Sie der Variable oben im Dialogfeld einen Namen, z. B. "GA visitorId".

  3. Geben Sie die Variableneinstellungen ein.

    Sie können die Client-ID oder die Cookie-ID verwenden, um sie als Quelle von Besucher-IDs festzulegen. Verwenden Sie immer eine konsistente Besucher-ID-Quelle, wenn Sie Verlaufsdaten und Echtzeit-Nutzerereignisse erfassen.

    Client-ID

    In Google Analytics 360 BigQuery ist diese Variable dem Feld clientID im BigQuery-Exportschema von Universal Analytics zugeordnet. In Google Analytics 4 ist diese Variable dem Feld user_pseudo_id im BigQuery-Exportschema für Google Analytics 4 zugeordnet.

    1. Legen Sie für Variablentyp die Option Benutzerdefiniertes JavaScript fest.

    2. Geben Sie das folgende Skript in das Feld Benutzerdefiniertes JavaScript ein.

      Ersetzen Sie dabei "UA-XXXXXX-N" durch Ihre Google Analytics-Tracking-ID. Informationen zur Ermittlung Ihrer Tracking-ID finden Sie unter Wo ist meine Tracking-ID? Weitere Informationen zum Abrufen der Client-ID erhalten Sie in der Google Analytics-Dokumentation.

      function() {
 var tracker = ga.getByName('UA-XXXXXX-N');
 return tracker.get('clientID');
}

    3. Klicken Sie auf Speichern, um die Variable zu speichern.

    1. Wählen Sie Eigenes Cookie als Variablentyp aus.

    2. Geben Sie im Feld Cookie Name _ga ein.

    3. Klicken Sie auf Formatwert, wählen Sie "Undefined" konvertieren in… aus und geben Sie "" ein (einen leeren String).

    4. Klicken Sie auf Speichern, um die Variable zu speichern.

      Dadurch wird das eigene Cookie "_ga" einer Tag Manager-Variablen namens "GA visitorId" zugeordnet.

Als Nächstes erstellen Sie ein Cloud Retail-Tag in Tag Manager. Dieses Tag verwendet die Besucher-ID-Variable, die Sie gerade erstellt haben.

Google Tag Manager-Tag erstellen

Richten Sie in Tag Manager ein Tag ein, um Nutzerereignisinformationen an Vertex AI Search für den Einzelhandel zu senden.

  1. Melden Sie sich in Tag Manager an und wählen Sie den Container für Ihre Website aus.

  2. Wechseln Sie zum Tab Tags und klicken Sie auf Neu, um ein neues Tag hinzuzufügen.

  3. Geben Sie Ihrem Tag oben im Steuerfeld einen Namen (der Platzhalter lautet Unbenannte Variable), z. B. „Vertex AI Search for Retail“.

  4. Klicken Sie auf Tag-Konfiguration und wählen Sie das Tag Cloud Retail aus, um das Feld für die Tag-Konfiguration zu öffnen.

  5. Geben Sie Ihren API-Schlüssel ein.

    Verwenden Sie den Schlüssel, den Sie beim Einrichten von Vertex AI Search für den Einzelhandel erstellt haben.

    Die API-Schlüssel sind in der Google Cloud Console auf der Seite APIs und Dienste > Anmeldedaten verfügbar.

  6. Geben Sie die Projektnummer des Google Cloud-Projekts ein, in dem Vertex AI Search für den Einzelhandel aktiviert ist.

    Die Projektnummer finden Sie im Dashboard der Google Cloud Console.

  7. Legen Sie Im Feld Datenquelle für Nutzerereignis Folgendes fest:

    • Datenschicht (empfohlen): Wählen Sie eine der folgenden Implementierungen aus:

      • Sie haben Google Analytics-E-Commerce über Tag Manager implementiert. Verwenden Sie die Datenschicht wieder als Ereignisdatenquelle, anstatt eine neue Ebene zu füllen. Dabei wird das Google Analytics 4-Schema verwendet, falls vorhanden. Andernfalls wird erweiterte E-Commerce-Berichte in UA verwendet. Mit dieser Datenquelle können Sie nur add-to-cart-, purchase-complete-, detail-page-view- und search-Ereignisse aufzeichnen. search-Ereignisse werden mithilfe von E-Commerce-Impressionen in Kombination mit Suchanfragen erfasst (siehe Suchanfragevariable erstellen).

      • Sie verwenden Google Analytics E-Commerce und können den Datenschichtcode manuell ausfüllen. Weitere Informationen finden Sie im Tag Manager-Entwicklerleitfaden.

    • Variable – Cloud Retail: Wählen Sie diese Option aus, um eine Tag Manager-Variable mit den Pflichtfeldern für Vertex AI Search für den Einzelhandel zu füllen. Sie können diese Option auswählen, wenn Sie Google Analytics E-Commerce nicht verwenden oder wenn Google Analytics E-Commerce nicht über die für Vertex AI Search für den Einzelhandel erforderlichen Daten verfügt. Wenn Sie von der Legacy-Option „Datenschicht – Cloud Retail“ zu dieser Quelle wechseln, erstellen Sie auch eine Datenschichtvariable mit dem Schlüssel cloud_retail und verknüpfen Sie sie mit der Option Variable – Cloud Retail.

    • Variable – E-Commerce: Wählen Sie diese Option aus, wenn Sie in der Datenschicht kein Google Analytics-E-Commerce-Tool verwenden und den Datenschichtcode nicht manuell ausfüllen können.

      Wählen Sie im angezeigten Feld E-Commerce-Daten von "User"-Variable ablesen eine Variable aus. Dadurch kann Vertex AI Search für den Einzelhandel in Google Analytics E-Commerce-Nutzerereignisdaten aus einer von Ihnen erstellten benutzerdefinierten Variablen lesen.

      Die Variable muss dem Format entsprechen, das im GA4-Entwicklerleitfaden oder im Entwicklerleitfaden zu erweiterten E-Commerce-Berichten angegeben ist. Wenn Sie eine Variable im richtigen Format erstellen möchten, können Sie den erweiterten E-Commerce-Objekt-Builder verwenden, eine Vorlage für benutzerdefinierte Variablen aus der Vorlagengalerie der Tag Manager-Community. Community-Vorlagen werden nicht von Google verwaltet. Informationen zur Verwendung dieser Vorlage finden Sie auf der Galerieseite des erweiterten E-Commerce-Objekt-Builders. Dort finden Sie eine Dokumentation und weitere Ressourcen.

  8. Klicken Sie auf die Schaltfläche + Wert in UserEvent-Nachricht überschreiben.

  9. Wählen Sie für Feldselektor als Feld visitorId und für Feldwert die neue Besucher-ID-Variable aus, die Sie unter Variable vom Typ „Besucher-ID erstellen“ erstellt haben.

  10. Klicken Sie auf Speichern.

    Ihr Cloud Retail-Tag wird erstellt.

Optionen für Legacy-Datenquellen

Bisher waren Datenschicht – E-Commerce und Datenschicht – Cloud Retail als Datenquellenoptionen verfügbar. Diese Legacy-Optionen sind in neuen Tags nicht verfügbar. Wenn Sie ein vorhandenes Tag auf eine neue Datenquelle umstellen, sollten Sie es vor der Bereitstellung in der Vorschau mit Tag Manager überprüfen. Beim Wechsel:

  • Wenn Sie Datenschicht – E-Commerce verwendet haben, können Sie zur Datenschicht wechseln. Dabei wird das Google Analytics 4-Schema verwendet, sofern vorhanden. Andernfalls wird erweiterte E-Commerce-Berichte in UA verwendet.

  • Wenn Sie Datenschicht – Cloud Retail verwendet haben, wechseln Sie zur Option Variable – Cloud Retail. Erstellen Sie eine Datenschichtvariable mit dem Schlüssel cloud_retail und verknüpfen Sie sie mit der Option Variable – Cloud Retail.

Als Nächstes führen Sie Folgendes aus:

Variable für Suchanfragen erstellen

Wenn Sie die Suche verwenden, können Sie in Tag Manager eine Variable für Suchanfragen erstellen und an Ihr Cloud Retail-Tag anhängen. Dadurch kann Vertex AI Search für den Einzelhandel Suchanfragen aus Analytics abrufen.

Welche Variablentypen Sie erstellen, hängt von der Datenquelle für Nutzerereignisse ab.

  • Variable – E-Commerce oder die Datenschicht mit dem E-Commerce-Schema von Google Analytics: Erstellen Sie eine URL- oder DOM-Elementvariable in Tag Manager und hängen Sie sie an Ihr Cloud Retail-Tag an. Aktivieren Sie außerdem die Option für Ihr Tag, mit der Google Analytics-E-Commerce-Impressionen zum Erstellen von Suchereignissen verwendet werden können.
  • Variable – Cloud Retail oder eine manuell ausgefüllte Datenschicht: Erstellen Sie eine URL- oder DOM-Elementvariable in Tag Manager und hängen Sie sie an Ihr Cloud Retail-Tag an. Damit Sie feststellen können, ob der Typ eines Nutzerereignisses search ist, müssen Sie außerdem Folgendes tun:

Tag Manager-Variable für Suchanfragen erstellen und anhängen

Wenn Sie die Suche verwenden, können Sie eine URL, ein DOM-Element oder eine benutzerdefinierte JavaScript-Variable erstellen, die mit auf Ihrer Website eingegebenen Suchanfragen gefüllt wird.

Als Alternative zu dieser Vorgehensweise können Sie die Datenschicht so konfigurieren, dass damit Informationen zur Suchanfrage bereitgestellt werden. Wenn Sie keinen Zugriff auf die Datenschicht haben oder die Datenschicht nicht konfigurieren möchten, haben Sie aber auch die Möglichkeit, Tag Manager-Variablen zu verwenden.

Sie können eine Variable vom Typ „URL“, „DOM-Elementtyp“ oder „JavaScript-Variable (Seite)“ erstellen. Welche Methode Sie erstellen und wie Sie sie konfigurieren, hängt von der Implementierung auf Ihrer Website ab:

  • Eine URL-Variable ruft Suchanfragen von den Suchergebnis-URLs Ihrer Website ab. Verwenden Sie diese Variable, wenn Ihre Website den Abfragestring in der URL ihrer Suchergebnisse enthält.
  • Eine DOM-Elementvariable ruft die Suchanfrageinformationen aus dem Document Object Model (DOM) Ihrer Website ab. Wenn Sie diese Variable verwenden möchten, müssen Sie das DOM nicht bearbeiten. Sie sollten aber das DOM lesen und verstehen können, um diese Variable korrekt zu konfigurieren.
  • Eine benutzerdefinierte JavaScript-Variable gibt Daten zurück, die mit einer JavaScript-Funktion formatiert wurden. Dies ist nützlich, wenn Sie vorhandene Daten haben, die Sie im Cloud Retail- oder E-Commerce-Schema formatieren möchten.

Erstellen Sie zuerst eine Tag Manager-Variable vom Typ „URL“, „DOM-Element“ oder „Benutzerdefiniertes JavaScript“:

  1. Wechseln Sie in Tag Manager zum Tab Variablen und klicken Sie auf Neu, um eine neue benutzerdefinierte Variable zu erstellen.

  2. Geben Sie der Variable oben im Dialogfeld einen Namen, z. B. "search_variable".

  3. Geben Sie die Einstellungen für die Variable ein:

    URL-Typ

    1. Legen Sie für Variablentyp die Option URL fest.

    2. Legen Sie für Komponententyp die Option Suchanfrage fest.

    3. Wenn Sie einen Anfrageschlüssel angeben, legen Sie dafür den Schlüssel fest, der der Suchanfrage in Ihrer URL vorangestellt ist.

      Wenn die URL beispielsweise http://example.com/?q=shoes lautet, ist der Anfrageschlüssel q. In diesem Beispiel wird für die Variable der Wert shoes verwendet.

    DOM-Elementtyp

    1. Legen Sie für Variablentyp die Option DOM-Element fest.

    2. Legen Sie die Auswahlmethode fest und geben Sie die Element-ID oder die Elementauswahl der Suchanfrage ein.

      Diese Einstellung hängt davon ab, ob Ihre Website eine Element-ID oder einen CSS-Selektor zur Ermittlung der Suchanfrage verwendet.

    3. Wenn Sie ein Attribut angeben, verwenden Sie dafür das Attribut, das die Suchanfrage enthält.

      Wenn die Suchanfrage in Ihrem DOM beispielsweise <id="search" value="shoes"> lautet, hat das Attribut den Wert value. In diesem Beispiel wird für den Wert Ihrer Variablen shoes festgelegt.

    Benutzerdefinierter JavaScript-Typ

    1. Legen Sie für Variablentyp die Option Benutzerdefiniertes JavaScript fest.

    2. Ersetzen Sie die Variablen im folgenden Code und fügen Sie ihn in den Bereich "Benutzerdefiniertes JavaScript" ein.

    3. Fügen Sie im Bereich „Benutzerdefiniertes JavaScript“ JavaScript-Code hinzu, der ein Suchereignis im Retail-Schema zurückgibt.

      Mit dem folgenden Beispielcode werden Daten in einer vorhandenen Ecommerce Items-Variable in das productDetails-Array umgewandelt, das vom Schema von Vertex AI Search für den Einzelhandel verwendet wird, und es wird ein vollständiges Ereignis zurückgegeben. Wenn Sie diesen Code verwenden möchten, müssen Sie Ecommerce Items, Search Query und Search Filter in der Tag Manager-Implementierung durch Variablen ersetzen.

      function () {

  var retail;
  var items = [];

  for (var i = 0; i < {{Ecommerce Items}}.length; i++) {
    var item = {'product':
                {
                  'id': {{Ecommerce Items}}[i].item_id
                }
               };

    items.push(item);
  }

  retail = {
    'eventType': 'search',
    'searchQuery': '{{Search Query}}',
    'filter': '{{Search Filter}}',
    'productDetails': items
  }

  return retail;
}

  4. Klicken Sie auf Speichern, um die Variable zu speichern.

Hängen Sie als Nächstes die Variable an Ihr Cloud Retail-Tag an:

  1. Klicken Sie auf der Seite Tag Manager, Tags auf Ihr Cloud Retail-Tag, um es zu bearbeiten.

  2. Wenn die Datenquelle des Nutzerereignisses für das Tag Variable – E-Commerce ist oder Sie die Datenschicht mit dem E-Commerce-Schema von Google Analytics verwenden, klicken Sie das Kästchen Erweiterte E-Commerce-Impressionen zum Erstellen von Suchereignissen verwenden an.

    Dadurch kann Vertex AI Search für den Einzelhandel anhand der Suchdaten, die von diesem Tag stammen, feststellen, ob der Typ eines Nutzerereignisses search ist.

  3. Klicken Sie im Abschnitt Nutzerereignisdaten auf die Schaltfläche + Wert in UserEvent-Nachricht überschreiben.

  4. Wählen Sie unter Feldauswahl searchQuery aus und legen Sie für Feldwert die Variable der Suchanfrage fest.

  5. Speichern Sie Ihr Tag.

Als Nächstes führen Sie Folgendes aus:

Konstante Variable erstellen und anhängen

Sie können dieses Verfahren verwenden, wenn Sie Variable – Cloud Retail oder eine manuell ausgefüllte Datenschicht als Nutzerereignisquelle für Ihr Cloud Retail-Tag auswählen.

Wenn Sie eine Variable vom Typ „Konstanter Typ“ für Suchereignisse erstellen und als Überschreibung von Nutzerereignissen in Ihrem Cloud Retail-Tag festlegen, kann Vertex AI Search für den Einzelhandel ermitteln, ob der Typ eines Nutzerereignisses search ist.

Alternativ können Sie den Nutzerereignistyp search über die Datenschicht- oder Cloud Retail-Variable angeben, die Sie als Ereignisquelle für das Tag verwenden. Andernfalls führen Sie die folgenden Schritte aus, um den Ereignistyp festzulegen.

Erstellen Sie als Erstes eine konstante Typvariable:

  1. Wechseln Sie in Tag Manager zum Tab Variablen und klicken Sie auf Neu, um eine neue benutzerdefinierte Variable zu erstellen.

  2. Geben Sie der Variablen oben im Dialogfeld einen Namen, z. B. "search_constant".

  3. Legen Sie für Variablentyp die Option Konstante fest.

  4. Geben Sie im Feld Wert den Wert search ein.

  5. Klicken Sie auf Speichern, um die Variable zu speichern.

Hängen Sie als Nächstes die Variable an Ihr Cloud Retail-Tag an:

  1. Klicken Sie auf der Seite Tag Manager, Tags auf Ihr Cloud Retail-Tag, um es zu bearbeiten.

  2. Klicken Sie im Abschnitt Nutzerereignisdaten auf die Schaltfläche + Wert in UserEvent-Nachricht überschreiben.

  3. Wählen Sie unter Feldauswahl eventType aus und legen Sie für Feldwert die Variable der Suchanfrage fest.

  4. Speichern Sie Ihr Tag.

Als Nächstes erstellen Sie Ereignistrigger für Ihr Tag.

Ereignistrigger für Ihr Tag Manager-Tag erstellen

Erstellen Sie Trigger für alle Nutzerereignistypen, die in Vertex AI Search für Einzelhandelsmodelle verwendet werden.

Tag Manager-Tags müssen Trigger haben, die steuern, wann das Tag auf der Website ausgelöst werden soll. Trigger erkennen, wenn Ereignisse auftreten (z. B. wenn ein Nutzer die Startseite aufruft oder einen Artikel in den Einkaufswagen legt) und fordern Ihr Tag auf, diese Nutzerereignisinformationen an Vertex AI Search für den Einzelhandel zu senden.

Tag Manager bietet einige Standard-Trigger. Beispielsweise ist Fenster geladen ein Trigger für detail-page-view-Ereignisse. Ausführliche Informationen zu den einzelnen Typen finden Sie in der Tag Manager-Dokumentation unter Triggertypen.

In der Regel legen Sie das Tag so fest, dass es ausgelöst wird, wenn ein Nutzer eine Seite aufruft, die die für Vertex AI Search für den Einzelhandel erforderlichen Ereignisse enthält (z. B. die Startseite, Produktdetailseiten, Einkaufswagenseiten oder die Seite für den Bezahlvorgang abgeschlossen). In diesen Fällen sollte das Tag ausgelöst werden, nachdem die Seite geladen wurde, damit Cookies verfügbar sind und alle Variablen der Datenschicht mit Werten versehen werden. Richten Sie dazu Ihre Trigger so ein, dass sie bei Fenster geladen oder DOM ist bereit ausgelöst werden.

Möglicherweise müssen Sie das Tag auslösen, wenn eine Aktion ausgeführt wird, und nicht beim Laden der Seite. Dies kann beispielsweise der Fall sein, wenn ein Nutzer einen Artikel in einen Einkaufswagen legt und dadurch keine Seite neu geladen wird. In diesen Fällen können Sie die Klickaktion auf Ihrer Website so konfigurieren, dass gleichzeitig Aktualisierungen in die Datenschicht übertragen werden und der Trigger mit dieser Aktion verbunden wird.

Wenn Sie beispielsweise einen Trigger für add-to-cart-Ereignisse erstellt haben, können Sie den Triggertyp Klicken – Nur Links auswählen und festlegen, dass er bei Klicken auf die ID (in diesem Beispiel addtocart) ausgelöst wird. Dann konfigurieren Sie den Link addtocart auf Ihrer Website so, dass auch die Datenschicht mit neuen Werten aktualisiert wird, wenn sie darauf klicken:

  <a id="addtocart" href="javascript:void(0);"
         onclick="dataLayer.push({
                  'cloud_retail': {
                  'eventType': 'add-to-cart',
                  'visitorId': '456',
                  'cartId': 'mobile',
                  'productDetails': [{
                  'product': {
                  'id': '54321'
                  },
                  'quantity': 1
                  }]}});">Add to Cart</a>

Für einige Nutzerereignisse müssen Sie einen benutzerdefinierten Trigger erstellen. In der Regel legen Sie einen benutzerdefinierten Trigger in Tag Manager mit dem Nutzerereignisnamen an. Wenn Sie Ihren Frontend-Code nicht ändern können, haben Sie die Möglichkeit, einen benutzerdefinierten Trigger mit JavaScript-Makros zu erstellen. Weitere Informationen zu benutzerdefinierten Triggern finden Sie unter Benutzerdefinierter Ereignistrigger.

So erstellen Sie Trigger in Tag Manager:

Neue Trigger für das Tag Manager-Tag erstellen

Wenn Sie Google Analytics E-Commerce nicht verwenden, erstellen Sie neue Ereignistrigger für alle Nutzerereignisse, die Ihre Vertex AI Search für Einzelhandelsmodelle benötigen. Verknüpfen Sie dann Ihre neuen Trigger mit dem Cloud Retail-Tag, das Sie in Tag Manager erstellt haben.

Bevor Sie die folgenden Schritte ausführen, müssen Sie ein Cloud Retail-Tag in Tag Manager erstellt haben. Weitere Informationen finden Sie unter Tag Manager-Tag erstellen.

Erstellen Sie zuerst die Trigger. Wiederholen Sie diesen Vorgang für alle Nutzerereignisse, die für Ihre Vertex AI Search für Einzelhandelsmodelle erforderlich sind:

  1. Klicken Sie in Tag Manager auf der Seite Trigger auf Neu > Triggerkonfiguration.

  2. Wählen Sie den Triggertyp für das Nutzerereignis aus, für das Sie einen Trigger erstellen.

  3. Speichern Sie den Trigger.

Verknüpfen Sie als Nächstes Ihre neuen Trigger mit Ihrem Cloud Retail-Tag. Dies muss nur einmal ausgeführt werden.

  1. Klicken Sie auf der Seite Tag Manager, Tags auf Ihr Cloud Retail-Tag, um es zu bearbeiten.

  2. Klicken Sie auf Trigger, wählen Sie die neuen Trigger aus und klicken Sie auf Hinzufügen.

  3. Speichern Sie Ihr Tag.

Sehen Sie sich als Nächstes eine Vorschau des Tags an und richten Sie das Monitoring von Fehlern bei der Ereignisaufzeichnung und anderen Problemen ein, um sicherzustellen, dass Daten weiterhin erfolgreich empfangen werden.

Wenn Sie die Datenebene cloud_retail als Nutzerereignisquelle verwenden, müssen Sie auch Ihre Datenebene einrichten.

E-Commerce-Trigger aus Google Analytics wiederverwenden

Wenn Sie Google Analytics-E-Commerce über Tag Manager implementiert haben, können Sie Ereignistrigger aus Google Analytics-E-Commerce-Berichten für Vertex AI Search für den Einzelhandel wiederverwenden.

Mit dieser Datenquelle können Sie nur add-to-cart-, purchase-complete-, detail-page-view- und search-Ereignisse aufzeichnen. search-Ereignisse werden mithilfe von E-Commerce-Impressionen in Kombination mit Suchanfragen erfasst (siehe Suchanfragevariable erstellen).

Die folgende Tabelle zeigt, wie E-Commerce-Ereignisse und erweiterte E-Commerce-Ereignisse von Google Analytics Vertex AI Search für Einzelhandelsereignisse zugeordnet werden.

Google Analytics 4 Erweiterte E-Commerce-Berichte Vertex AI Search für den Einzelhandel
add_to_cart add add-to-cart
purchase purchase purchase-complete
view_item detail detail-page-view
view_item_list oder view_search_results impressions search (wenn mit Feld searchQuery kombiniert)

Für diese Schritte ist Folgendes erforderlich:

  • Richten Sie in Tag Manager ein Tag vom Tag-Typ Google Analytics – Universal Analytics oder Google Analytics – GA4-Ereignis ein und aktivieren Sie erweiterte E-Commerce-Berichte oder GA4 dafür. Weitere Informationen finden Sie in der Tag Manager-Dokumentation, im GA4-Entwicklerleitfaden oder im Entwicklerleitfaden zu erweiterten E-Commerce-Berichten.
  • Sie haben Ihr erweitertes E-Commerce- oder GA4-Tag in Tag Manager so konfiguriert, dass es bei den Nutzerereignissen ausgelöst wird, die Sie für Vertex AI Search für den Einzelhandel aufzeichnen möchten.
  • Sie haben in Tag Manager ein Cloud Retail-Tag mit „Datenschicht“ oder „Variable – E-Commerce“ als Datenquelle für das Nutzerereignis erstellt. Weitere Informationen finden Sie unter Tag Manager-Tag erstellen.

So verwenden Sie E-Commerce-Trigger aus Google Analytics wieder:

  1. Klicken Sie auf der Seite Tags in Tag Manager auf Ihr Google Analytics-E-Commerce-Tag (Tag-Typ Google Analytics – Universal Analytics oder Google Analytics – GA4-Ereignis), um es zu bearbeiten.

  2. Wählen Sie unter Erweiterte Einstellungen > Tag-Reihenfolge die Option Tag auslösen, nachdem <Name des erweiterten E-Commerce- oder GA4-Tags> ausgelöst wird aus.

  3. Wählen Sie für Ihr Cloud Retail-Tag Cleanup-Tag aus.

    Wählen Sie <Name des Cloud Retail-Tags> nicht auslösen, wenn <Name des erweiterten E-Commerce- oder GA4-Tags> fehlschlägt oder pausiert ist.

  4. Speichern Sie Ihr Tag.

Sehen Sie sich als Nächstes eine Vorschau des Tags an und richten Sie das Monitoring von Fehlern bei der Ereignisaufzeichnung und anderen Problemen ein, um sicherzustellen, dass Daten weiterhin erfolgreich empfangen werden.

Wenn Sie die Datenebene cloud_retail als Nutzerereignisquelle verwenden, müssen Sie auch Ihre Datenebene einrichten.

Datenschicht cloud_retail mit Tag Manager verwenden

Wenn Sie Ihr Cloud Retail-Tag in Tag Manager erstellt haben, um die Datenschicht cloud_retail als Nutzerereignisquelle zu verwenden, richten Sie die Variable dataLayer in Ihrem Quell-HTML ein, wie im Tag Manager-Entwicklerleitfaden erläutert.

Informationen zur Datenschicht

Die meisten Tag Manager-Tags erfordern Daten, die sich je nach Nutzer oder Seite ändern, z. B. Nutzer-IDs oder Produkt-IDs. Für das Cloud Retail-Tag müssen diese Daten über eine Datenschicht in strukturierter Form verfügbar sein, damit Tag Manager sie nutzen kann.

Die Datenschicht ist ein JavaScript-Objekt, das in der Regel mithilfe von serverseitigem Code oder im Frontend-Code mit HTML oder einer Vorlage zu einer Seite hinzugefügt wird. Wenn eine Seite mit der Datenschicht konfiguriert ist, enthält sie Code wie etwa den folgenden:

dataLayer = dataLayer || [];
dataLayer.push({
  'cloud_retail': {
    'eventType': 'home-page-view',
    'visitorId': 'visitor_a',

    'userInfo': {
      'userId': '789'
    },
  }
});

Mit diesem Code wird das Objekt dataLayer erstellt und ihm die cloud_retail-Struktur als Arrayelement zugewiesen.

Erforderliche Felder in der Datenschicht cloud_retail

Unter Nutzerereignisse werden alle Pflichtfelder und Beispiele für Ereignistypen aufgelistet, die an die Datenschicht cloud_retail übergeben werden müssen.

Ihr serverseitiger Code oder Ihre Vorlagen müssen auf jeder Seite, von der Sie Ereignisse senden, die richtigen Skript-Tags haben. Nachdem das Objekt dataLayer auf jeder Seite korrekt mit Daten versehen wurde, sollten Sie das Cloud Retail-Tag testen können.

Einige Felder wie visitorId sind für die UserEvent-Nachricht erforderlich, stehen aber beim Ausfüllen der Datenschicht möglicherweise nicht zur Verfügung. Beispiel: visitorId wird aus dem Cookie des Nutzers abgeleitet oder experimentIds aus dem A/B-Test-Framework. Verwenden Sie in diesem Fall eine Variable, um das Feld im Tag Manager-Tag zu überschreiben.

Sie können die folgenden Felder überschreiben:

  • visitorId
  • userInfo.userId
  • attributionToken
  • experimentIds

Informationen zum Überschreiben eines UserEvent-Felds in Tag Manager finden Sie unter Feld visitorID in Tag Manager festlegen. Dabei wird gezeigt, wie der Feldwert visitorId mit einer benutzerdefinierten Variable überschrieben wird.

Im folgenden Beispiel wird gezeigt, welche Datenschicht für ein detail-page-view-UserEvent mit Tag Manager in Ihre Seite eingefügt werden muss:

<script>
  dataLayer = dataLayer || [];
  dataLayer.push({
    'cloud_retail': {
      'eventType' : 'detail-page-view',
      'visitorId': 'visitor_a',
      'userInfo': {
          // The user and visitor ID fields can typically be
          // be populated from a client-side JavaScript
          // variable such as a cookie. If you set the user
          // and/or visitor ID values from the server,
          // populate the `userID`.
          'userId': 'user_a'
      },
      'attributionToken': 'attribution-token',
      // In most cases, the experiment ID field is populated from a
      // client side JavaScript variable as defined by the experiment
      // manager.
      // If you set the experiment ID value from the server,
      // populate the `experimentIds` field here.
      'productDetails': [
            {
              'product': {'id': '123'}
            }
      ],
    // You can use the 'cloud_retail' data layer element along with other
    // data layer elements.
    'ecommerce': {
      ...
    },
  }];
</script>

Tag Manager-Tag als Vorschau ansehen

Mit dem Vorschaumodus von Tag Manager können Sie neue Tags testen, bevor Sie sie auf Ihrer Website veröffentlichen.

Weitere Informationen zum Vorschaumodus finden Sie in der Tag Manager-Dokumentation unter Vorschaumodus.

Prüfen Sie mit den folgenden Schritten, ob Ihr Tag korrekt ausgelöst wird.

  1. Klicken Sie auf der Übersichtsseite von Tag Manager auf Vorschau.

    Der Vorschaumodus von Tag Manager wird in einem neuen Browsertab geöffnet.

  2. Geben Sie Ihre Websiteinformationen ein und klicken Sie auf Starten, um den Tag Assistant zu starten.

    Im aktuellen Browsertab wird dann der Tag Assistant gestartet und Ihre Website in einem neuen Tab geöffnet.

  3. Rufen Sie auf Ihrer Website eine beliebige Seite auf, auf der das Cloud Retail-Tag ausgelöst werden soll.

  4. Prüfen Sie, ob im Tag Assistant das Cloud Retail-Tag auf dem Tab Tags im Abschnitt Ausgelöste Tags aufgeführt wird.

  5. Öffnen Sie im Tag Assistant den Tab Datenschicht und prüfen Sie, ob die richtigen Werte aus cloud_retail oder der E-Commerce-Datenschicht angezeigt werden.

Auf Tag-Fehler prüfen

Wenn einige Felder in der Vorschau des Tags fehlerhafte Werte enthalten oder nicht vorhanden sind, gibt das Tag in der Regel einen Fehler zurück, sofern es überhaupt ausgelöst wird.

Sie können die Seite Monitoring in der Search for Retail-Konsole auf Fehler prüfen. Auf dieser Seite werden die meisten Fehler protokolliert, mit Ausnahme von Syntaxfehlern, die normalerweise nur in Anfrageergebnissen auftreten.

Mit den folgenden Schritten können Sie mit Chrome-Entwicklertools nach generierten Fehlern suchen, auch nach Syntaxfehlern.

  1. Aktivieren Sie in Tag Manager den Vorschaumodus für Ihre Website in einem Chrome-Browser und rufen Sie eine Seite auf, auf der das Cloud Retail-Tag ausgelöst werden soll.

  2. Rufen Sie bei geöffnetem Vorschaumodus die Entwicklertools auf und klicken Sie auf den Tab Netzwerk.

  3. Laden Sie die Seite neu.

  4. Suchen Sie in den Entwicklertools nach userEvent.

    Im Tab "Netzwerk" werden das Ereignis userEvent:collect und sein Statuscode angezeigt.

    • Eine 200-Antwort gibt an, dass sich Ihr Tag in einem fehlerfreien Status befindet.
    • Andere Antworten, z. B. ein 400-Fehler und ein rot hervorgehobenes Ereignis, zeigen an, dass ein Debugging erforderlich ist.

  5. Doppelklicken Sie auf den Ereignisnamen, um die Anfrage auszuführen. Anschließend wird eine vollständige Antwort mit weiteren Fehlerinformationen angezeigt.

    Beispielsweise kann ein 400-Fehler mit der Meldung "'visitorId' ist erforderlich und darf nicht leer sein" angezeigt werden. Dies weist darauf hin, dass visitorId nicht korrekt festgelegt wurde.

  6. Wenn kein userEvent ausgelöst wird, prüfen Sie den Tab Console der Entwicklertools auf Syntaxfehler in der Datenschicht.

Nutzerereignisse mit serverseitigem Tagging erfassen

Beim serverseitigen Tagging können Sie einen einzelnen serverseitigen Container mit vielen nachgelagerten Clients bereitstellen. Dadurch wird auf Clientseite eine einzige Datenquelle mit vielen serverseitigen Nutzern erstellt. Diese Architektur verlagert die Last aus dem Web auf den Server, was sie für Nutzer sinnvoll ist, die die Leistung ihrer Websites maximieren möchten.

Der weitere Vorteil des serverseitigen Taggings besteht darin, dass ein einzelnes serverseitiges Tag auch viele Upstream-Clients unterstützen kann, z. B. sowohl im Web als auch auf Mobilgeräten. Weitere Informationen zum Einrichten des serverseitigen Taggings

Vertex AI Search für den Einzelhandel stellt sein eigenes natives serverseitiges Tag bereit.

Das serverseitige Tag von Cloud Retail erfordert und akzeptiert ähnliche Parameter wie das Cloud Retail-Web-Tag, z. B.:

  • Projektnummer
  • API-Schlüssel (zur Authentifizierung)
  • Überschreibungen für wichtige Felder wie visitorId und searchQuery

Der Hauptunterschied zwischen der Serverversion und der Webversion des Cloud Retail-Tags besteht darin, dass Sie die Datenquelle nicht definieren können. Die Datenquelle für Server-Tags ist ein Datenstream, der vom Google-Tag im GA4-Schema gesendet wird.

Cloud Retail-Tag einrichten

Importzustand überwachen

Das erfolgreiche Aufzeichnen von Nutzerereignissen ist Voraussetzung für qualitativ hochwertige Ergebnisse. Deshalb sollten Sie die Fehlerraten der Ereignisaufzeichnung überwachen und gegebenenfalls Maßnahmen ergreifen. Weitere Informationen finden Sie unter Benachrichtigungen für Probleme beim Hochladen von Daten einrichten.

Aufgezeichnete Ereignisse ansehen

Sehen Sie sich auf der Seite Daten der Search for Retail-Konsole auf dem Tab Ereignisse die Messwerte für die Ereignisintegration an. Auf dieser Seite werden alle Ereignisse angezeigt, die im letzten Jahr geschrieben oder importiert wurden. Nach erfolgreicher Datenaufnahme kann es bis zu einer Stunde dauern, bis Messwerte in der Console angezeigt werden.

Zur Seite "Daten"

Nächste Schritte