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 Verfahren zur Aufzeichnung auf dieser Seite gelten sowohl für Empfehlungen und die Suche. Nach der Aufnahme können beide Dienste diese Ereignisse verwenden. Sie müssen diese Ereignisse also nicht dieselben Daten zweimal, wenn Sie beide Dienste nutzen.
Weitere Informationen zu Nutzerereignissen, einschließlich Nutzerereignistypen und Beispiel-JSON für für alle Typen, siehe Nutzerereignisse.
Es gibt mehrere Möglichkeiten, ein Nutzerereignis aufzuzeichnen:
Durch Verwendung eines JavaScript-Pixels.
Durch Senden von Ereignissen von Ihrem Backend-Server direkt an die API.
Durch Verwendung eines Tag Manager-Tags.
Im Folgenden finden Sie Beispiele für die Aufzeichnung von Nutzerereignissen vom Typ detail-page-view
für alle diese Vorgehensweisen. Für andere
Informationen zu Nutzerereignissen
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 im Hilfeartikel Bisherige Nutzerereignisse importieren.
Wenn das Nutzerereignis, das Sie aufzeichnen, das erste Mal ist, mit dem ein Nutzer interagiert ein Produkt auf der Grundlage einer zuvor bereitgestellten Empfehlung oder eines Suchergebnisses mit einem Attributionstoken Leistungsmesswerte. Für Vertex AI Search for Retail ist das Einfügen eines Attributionstokens erforderlich zu arbeiten. Informationen zur Verwendung von Attributionstokens finden Sie unter Attributionstoken.
Besucher-IDs sind erforderlich, wenn Nutzerereignisse aufgezeichnet werden. Informationen zu Besucher- und Nutzer-IDs Siehe Nutzerinformationen.
Anleitung zum Schreiben von Nutzerereignissen
In dieser Anleitung erfahren Sie, wie Sie Nutzerereignisse mit dem
userEvents.write
-Methode.
Klicken Sie auf Anleitung, um eine detaillierte Anleitung für diese Aufgabe direkt im Cloud Shell-Editor zu erhalten:
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. 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 importieren. vor, nach oder zur gleichzeitigen Aufzeichnung von Nutzerereignissen. 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, erneut verknüpfen.
Vertex AI Search for Retail versucht, aufgezeichnete Nutzerereignisse zusammenzuführen mit Metadaten aus dem Produktkatalog erhalten, 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 eine Produkt, das nicht im aktuellen Katalog enthalten ist, kann nicht für das Training verwendet werden Modelle zu erstellen. Dies wird als „nicht verbunden“ bezeichnet. . Wenn Sie Ereignisse vor dem vollständig importiert wurde, müssen Sie die Ereignisse, die während des Imports aufgezeichnet wurden. Wenn Sie einige werden nicht verknüpfte Ereignisse erwartet. Wenn der Prozentsatz nicht verbundener Ereignisse mindestens 5% Ihrer gesamten Nutzerereignisse erreicht, sollten Sie sicherstellen, Ereignisse wieder zusammenführen, die vor der vollständigen Aktualisierung des Katalogs erfasst wurden, 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 Nutzerereignisse.
Richten Sie Cloud Monitoring-Benachrichtigungen ein, damit Sie wissen, Bei der Aufzeichnung von Nutzerereignissen kommt es zu Ausfällen.
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 Größe jeder Datei muss 2 GB oder kleiner sein. Ich darf höchstens enthalten 100 in einer einzelnen Importanfrage. 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 Vertex AI Search für den Einzelhandel bezüglich der Problembehebung.
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 in Vertex AI Search für den Einzelhandel und schützen Sie die Datenschutz. 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', 'location-id']); _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 „G-XXXXXX“. mit deinem Google Analytics-Tracking-ID:
<script type="text/javascript"> var tracker = ga.getByName('G-XXXXXX'); 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
Nutzerereignisse mit Google Analytics 4 erfassen
Google Analytics 4-Nutzerereignisdaten lassen sich in Vertex AI Search for Retail.
Datenquelle prüfen
Die Nutzerereignisdaten, die Sie importieren möchten, müssen korrekt sein formatiert sind.
Tabelle mit Google Analytics 4-Feldern, die Vertex AI Search for Retail welche Felder von Vertex AI Search für den Einzelhandel verwendet werden und welchen Siehe Google Analytics 4-Nutzerereignisfelder.
Informationen zu allen Google Analytics-Ereignisparametern finden Sie in der Referenzdokumentation zu Google Analytics-Ereignissen
Prüfen Sie, ob:
Wenn Sie Kaufereignisse importieren, erforderlich sind, enthalten Ihre Ereignisberichte Währungscodes. Die
purchase
-Ereignisparameter finden Sie in der Google Analytics-Dokumentation.Wenn Sie
search
Ereignisse importieren möchten, enthalten Ihre Ereignisberichte die Suche Abfragen.Das Importieren von
search
-Ereignissen wird unterstützt, abersearch
-Ereignisse können nicht zugeordnet werden Google Analytics 4 genau wie andere Ereignistypen da Google Analytics 4 die Vertex AI Search for Retailsearch
-Ereignistyp. Während des Imports wurdensearch
Ereignisse werden aus Google Analytics 4 erstellt, indem Informationen aus den Ereignisparameternview_item_list
undsearch_term
.Die
search
-Ereignisparameter finden Sie in der Google Analytics-Dokumentation.
Google Analytics 4-Ereignisse aufzeichnen
Zeichnen Sie ein Nutzerereignis auf, indem Sie URL-codierte JSON-Rohdaten für das Ereignis in Ihren
userEvents.collect
aufrufen.
Verwenden Sie für den Parameter prebuilt_rule
den Wert ga4_bq
.
Das folgende Beispiel für den userEvents.collect
-Aufruf zur besseren Lesbarkeit
legt zuerst GA4_EVENT
als Variable fest, die die JSON-Rohdaten für ein Beispiel enthält.
. Mit dem userEvents.collect
-Aufruf in diesem Beispiel wird das Ereignis dann URL-codiert.
mit der Variablen GA4_EVENT
.
Für eine einfachere URL-Codierung später können Sie
GA4_EVENT
als Variable festlegen mit Ereignisdaten. Dieses Beispiel zeigt einadd-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" }'
Einen
userEvents.collect
-Aufruf ausführen, der die URL-codierten JSON-Rohdaten enthält eines Nutzerereignisses: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 aufzeichnen
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 und Google Analytics E-Commerce. Mit Google Analytics können Sie mit Google Analytics 4 oder erweiterten E-Commerce-Berichten implementiert werden. Das Cloud Retail-Tag unterstützt beides.
Weder Google Analytics noch Google Analytics E-Commerce ist erforderlich. wenn du Verwenden Sie diese nicht. Sie können entweder Variable – E-Commerce beim Erstellen Cloud Retail-Tag einfügen oder den Datenschichtcode Ihrer Website manuell einfügen, das Erstellen des Tags.
„E-Commerce“ in Google Analytics ist eine zusätzliche Konfiguration für Google Analytics, das Produkttitel, IDs, Preise, Transaktionen übergibt und andere strukturierte E-Commerce-Daten in Google Analytics hochladen. Vertex AI Search for Retail kann automatisch die Google Analytics-E-Commerce- der Datenschicht. Wenn Sie diese bereits eingerichtet haben, ist die Konfiguration einfacher. Wenn Sie haben die Google Analytics-E-Commerce-Funktionalität nicht für Google Analytics nutzen möchten, weitere Details und Einrichtung aufrufen im GA4-Entwicklerleitfaden oder in der Entwicklerleitfaden zu erweiterten E-Commerce-Berichten
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
Mit dem Wert visitorId
werden Nutzer erfasst.
visitorId
ist in der Regel 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:
Wechseln Sie in Tag Manager zum Tab Variablen und klicken Sie auf Neu, um eine neue benutzerdefinierte Variable zu erstellen.
Geben Sie der Variable oben im Dialogfeld einen Namen, z. B. "GA visitorId".
Geben Sie die Variableneinstellungen ein.
Sie können die Client-ID oder die Cookie-ID als Quelle des Besuchers festlegen. IDs. Verwenden Sie immer eine konsistente Besucher-ID-Quelle, wenn Sie Verlaufs- und Nutzerereignisse in Echtzeit.
Client-ID
In BigQuery von Google Analytics 360 ist dem Feld
clientID
im BigQuery-Exportschema für Universal Analytics. In Google Analytics 4 wird diese Variable dem Felduser_pseudo_id
im BigQuery-Exportschema für Google Analytics 4.Legen Sie für Variablentyp die Option Benutzerdefiniertes JavaScript fest.
Geben Sie das folgende Skript in das Feld Benutzerdefiniertes JavaScript ein.
Ersetzen Sie „G-XXXXXX“. mit deinem 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('G-XXXXXX'); return tracker.get('clientID'); }
Klicken Sie auf Speichern, um die Variable zu speichern.
Cookie-ID
Wählen Sie Eigenes Cookie als Variablentyp aus.
Geben Sie im Feld Cookie Name _ga ein.
Klicken Sie auf Formatwert, wählen Sie "Undefined" konvertieren in… aus und geben Sie "" ein (einen leeren String).
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, an das Nutzerereignisinformationen gesendet werden. Vertex AI Search for Retail.
Melden Sie sich in Tag Manager an. und wählen Sie den Container für Ihre Website aus.
Wechseln Sie zum Tab Tags und klicken Sie auf Neu, um ein neues Tag hinzuzufügen.
Geben Sie Ihrem Tag oben im Steuerfeld einen Namen (der Platzhalter ist Unbenannte Variable), z. B. „Vertex AI Search for Retail“.
Klicken Sie auf Tag-Konfiguration und wählen Sie das Tag Cloud Retail aus, um das Feld für die Tag-Konfiguration zu öffnen.
Geben Sie Ihren API-Schlüssel ein.
Verwenden Sie den von Ihnen erstellten Schlüssel, wenn Sie Vertex AI Search for Retail einrichten.
Ihre API-Schlüssel sind über die APIs und Dienste > Anmeldedaten in der Google Cloud Console.
Geben Sie die Projektnummer des Google Cloud-Projekts ein, in dem Vertex AI Search for Retail ist aktiviert.
Die Projektnummer finden Sie im Dashboard der Google Cloud Console.
Legen Sie Im Feld Datenquelle für Nutzerereignis Folgendes fest:
Datenschicht (empfohlen): Wählen Sie diese Option aus, wenn Sie Folgendes:
Sie haben die E-Commerce-Funktion von Google Analytics über Tag Manager. Datenschicht als Ereignisdatenquelle wiederverwenden anstatt eine neue auszufüllen. Dabei werden die Google Analytics- 4-Schema, falls vorhanden. Andernfalls werden erweiterte E-Commerce-Berichte für Universal Analytics verwendet. Mit dieser Datenquelle können nur
add-to-cart
,purchase-complete
,detail-page-view
undsearch
Termine.search
Ereignisse werden erfasst mit E-Commerce-Impressionen in Kombination mit Suchanfragen (siehe Erstellen Sie eine Suchanfragenvariable.Sie verwenden E-Commerce in Google Analytics und können Daten manuell ausfüllen Layer-Code. Weitere Informationen finden Sie in der Tag Manager-Entwicklerleitfaden
Variable – Cloud Retail: Wählen Sie diese Option aus, damit Daten in Tag Manager eingefügt werden. Variable mit den Pflichtfeldern für Vertex AI Search for Retail. Möglicherweise Wählen Sie diese Option aus, wenn Sie die E-Commerce-Funktion von Google Analytics nicht nutzen oder In der Google Analytics-E-Commerce-Website sind die erforderlichen Daten für Vertex AI Search for Retail. Wenn Sie von der alten Datenschicht zu dieser Quelle wechseln, gilt Folgendes: Cloud Retail-Option: Erstellen Sie außerdem eine Datenschichtvariable mit dem Schlüssel
cloud_retail
und verknüpfen Sie es mit dieser Variable – Cloud Retail. Option.Variable – E-Commerce: Wählen Sie diese Option aus, wenn Sie nicht Google Analytics-E-Commerce in der Datenschicht verwenden. Manuell ist dies nicht möglich. Datenschichtcode einfügen.
Wählen Sie im angezeigten Feld E-Commerce-Daten von "User"-Variable ablesen eine Variable aus. So kann Vertex AI Search for Retail Google Analytics-E-Commerce-Nutzerereignisdaten aus einer benutzerdefinierten Variablen die Sie erstellen.
Die Variable muss dem Format entsprechen, das im GA4-Entwicklerleitfaden oder in der Entwicklerleitfaden zu erweiterten E-Commerce-Berichten Um eine Variable im richtigen Format zu erstellen, können Sie Erweiterter E-Commerce-Objekt-Builder Vorlage für benutzerdefinierte Variablen aus dem Tag Manager-Community-Vorlagengalerie. Community-Vorlagen werden nicht von Google verwaltet. Um diese Vorlage zu verwenden, Dokumentation finden Sie auf der Galerieseite des erweiterten E-Commerce-Objekt-Builders und andere Ressourcen.
Klicken Sie auf die Schaltfläche + Wert in UserEvent-Nachricht überschreiben.
Wählen Sie für Feldauswahl
visitorId
als Feld aus. Feldwert: Wählen Sie die neue Variable für die Besucher-ID aus, die Sie in Erstellen Sie eine Variable für die Besucher-ID.Klicken Sie auf Speichern.
Ihr Cloud Retail-Tag wird erstellt.
Optionen für Legacy-Datenquellen
Bisher wurden Datenschicht – E-Commerce und Datenschicht – Cloud Retail Datenquellenoptionen verfügbar. Diese Legacy-Optionen sind in der neuen Version nicht verfügbar Tags. Wenn Sie ein vorhandenes Tag auf eine neue Datenquelle umstellen, Vorschau mit Tag Manager aufrufen, um den Bereitstellung. Beim Wechsel:
Wenn Sie Datenschicht – E-Commerce verwendet haben, können Sie zu Datenschicht: Dabei wird das Google Analytics 4-Schema verwendet, sofern vorhanden. Andernfalls werden erweiterte E-Commerce-Berichte für Universal Analytics verwendet.
Wenn Sie Datenschicht – Cloud Retail verwendet haben, wechseln Sie zu dieser Option. Variable – Cloud Retail Erstellen Sie eine Datenschichtvariable mit dem Schlüssel
cloud_retail
und verknüpfen Sie es mit der Option Variable – Cloud Retail.
Als Nächstes führen Sie Folgendes aus:
- Wenn Sie die Suche verwenden, erstellen Sie eine Variable für Suchanfragen und hängen Sie sie an Ihr neues Tag.
- Erstellen Sie Ereignistrigger für das Tag.
Suchanfragenvariable erstellen
Wenn Sie die Suche verwenden, können Sie eine Variable in Tag Manager für Suchanfragen und hängen Sie es an Ihr Cloud Retail-Tag an. So kann Vertex AI Search for Retail Suchanfragen von Analytics.
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 in Tag Manager eine Variable für URL oder DOM-Elemente und an Ihr Cloud Retail-Tag anhängen. Aktivieren Sie außerdem die Option für Ihre -Tag verwenden, um aus Google Analytics-E-Commerce-Impressionen Suchereignisse zu erstellen.
- Variable – Cloud Retail oder eine manuell ausgefüllte Datenschicht:
Erstellen Sie in Tag Manager eine Variable für URL oder DOM-Elemente und
an Ihr Cloud Retail-Tag anhängen. Um
um festzustellen, ob der Typ eines Nutzerereignisses
search
ist, müssen Sie außerdem eine der folgenden Aktionen ausführen: <ph type="x-smartling-placeholder">- </ph>
- Erstellen Sie eine konstante Typvariable für die Suchereignistypen und hängen Sie sie an Ihr Tag an.
- Legen Sie den Suchereignistyp in der Datenschicht oder der Cloud Retail-Variable fest.
Tag Manager-Variable für Suchanfragen erstellen und anhängen
Wenn Sie die Suche verwenden, können Sie eine URL, ein DOM-Element oder ein benutzerdefiniertes JavaScript-Variable, die mit Suchanfragen gefüllt wird, die auf Ihrem Website.
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-Element“ oder „Benutzerdefiniert“ JavaScript-Variable (Seite) Welche davon Sie erstellen und wie Sie es konfigurieren, hängt von der Implementierung 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 von einem JavaScript-Code . Dies ist nützlich, wenn Sie bereits Daten haben, in denen Sie diese formatieren möchten. das Cloud Retail- oder E-Commerce-Schema.
Erstellen Sie zuerst eine Tag Manager-Variable vom Typ „URL“, „DOM-Element“ oder „Benutzerdefiniert“ JavaScript:
Wechseln Sie in Tag Manager zum Tab Variablen und klicken Sie auf Neu, um eine neue benutzerdefinierte Variable zu erstellen.
Geben Sie der Variable oben im Dialogfeld einen Namen, z. B. "search_variable".
Geben Sie die Einstellungen für die Variable ein:
URL-Typ
Legen Sie für Variablentyp die Option URL fest.
Legen Sie für Komponententyp die Option Suchanfrage fest.
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üsselq
. In diesem Beispiel wird für die Variable der Wertshoes
verwendet.
DOM-Elementtyp
Legen Sie für Variablentyp die Option DOM-Element fest.
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.
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 Wertvalue
. In diesem Beispiel wird für den Wert Ihrer Variablenshoes
festgelegt.
Benutzerdefinierter JavaScript-Typ
Legen Sie für Variablentyp die Option Benutzerdefiniertes JavaScript fest.
Ersetzen Sie die Variablen im folgenden Code und fügen Sie ihn in den Benutzerdefinierter JavaScript-Bereich.
Fügen Sie im Bereich "Benutzerdefiniertes JavaScript" JavaScript-Code hinzu, der eine im Retail-Schema.
Mit dem folgenden Beispielcode werden Daten in einer vorhandenen
Ecommerce Items
-Variable in das verwendete productDetails-Array umgewandelt. durch das Vertex AI Search for Retail-Schema und gibt ein vollständiges Ereignis zurück. Um diesen Code zu verwenden, Ersetzen SieEcommerce Items
,Search Query
undSearch Filter
durch Variablen in Ihrer Tag Manager-Implementierung verwenden.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; }
Klicken Sie auf Speichern, um die Variable zu speichern.
Hängen Sie als Nächstes die Variable an Ihr Cloud Retail-Tag an:
Klicken Sie auf der Seite Tag Manager, Tags auf Ihr Cloud Retail-Tag, um es zu bearbeiten.
Wenn die Datenquelle für Nutzerereignisse des Tags Variable – E-Commerce ist oder Sie die Datenschicht mit dem E-Commerce-Schema von Google Analytics, Mit erweiterten E-Commerce-Impressionen Suchereignisse konstruieren
So kann Vertex AI Search for Retail feststellen, ob der Typ eines Nutzerereignisses
search
basiert auf Suchdaten, die über dieses Tag abgerufen werden.Klicken Sie im Abschnitt Nutzerereignisdaten auf die Schaltfläche + Wert in UserEvent-Nachricht überschreiben.
Wählen Sie unter Feldauswahl
searchQuery
aus und legen Sie für Feldwert die Variable der Suchanfrage fest.Speichern Sie Ihr Tag.
Als Nächstes führen Sie Folgendes aus:
- Wenn Sie eine Cloud Retail-Variable oder manuell ausgefüllte Daten ausgewählt haben als Nutzerereignisquelle für Ihr Cloud Retail-Tag verwenden, siehe Eine konstante Variable erstellen und anhängen
- Erstellen Sie Ereignistrigger für das Tag.
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 Cloud Retail Tag.
Variable vom Typ „Konstante“ für Suchereignisse erstellen und als Nutzer festlegen
können Sie mit Vertex AI Search for Retail
Ermittelt, ob der Typ eines Nutzerereignisses search
ist.
Alternativ können Sie das Nutzerereignis search
angeben.
Datenebene oder Cloud Retail-Variable ein, die Sie als Ihre
die Ereignisquelle des Tags. Andernfalls führen Sie die folgenden Schritte aus, um den Ereignistyp festzulegen.
Erstellen Sie als Erstes eine konstante Typvariable:
Wechseln Sie in Tag Manager zum Tab Variablen und klicken Sie auf Neu, um eine neue benutzerdefinierte Variable zu erstellen.
Geben Sie der Variablen oben im Dialogfeld einen Namen, z. B. "search_constant".
Legen Sie für Variablentyp die Option Konstante fest.
Geben Sie im Feld Wert den Wert
search
ein.Klicken Sie auf Speichern, um die Variable zu speichern.
Hängen Sie als Nächstes die Variable an Ihr Cloud Retail-Tag an:
Klicken Sie auf der Seite Tag Manager, Tags auf Ihr Cloud Retail-Tag, um es zu bearbeiten.
Klicken Sie im Abschnitt Nutzerereignisdaten auf die Schaltfläche + Wert in UserEvent-Nachricht überschreiben.
Wählen Sie unter Feldauswahl
eventType
aus und legen Sie für Feldwert die Variable der Suchanfrage fest.Speichern Sie Ihr Tag.
Als Nächstes erstellen Sie Ereignistrigger für Ihr Tag.
Ereignistrigger für Ihr Tag Manager-Tag erstellen
Trigger für alle Nutzerereignistypen Ihrer Vertex AI Search for Retail-Modelle erstellen verwendet.
Tag Manager-Tags müssen Trigger haben, die steuern, wann das Tag auf der Website ausgelöst werden soll. Auslösungen sorgen dafür, dass Ereignisse eintreten, z. B. wenn ein Nutzer der Aufruf der Startseite oder das Hinzufügen eines Artikels zum Einkaufswagen) angezeigt wird, und fordert Ihr Tag dazu auf, diese Nutzerereignisinformationen an Vertex AI Search for Retail 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 mit dem Ereignisse, die für Vertex AI Search for Retail erforderlich sind (z. B. Startseite, Produktdetails) Einkaufswagen-Seiten oder die Seite für abgeschlossene Bezahlvorgänge). 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:
- Wenn keine vorhandenen Trigger konfiguriert sind, erstellen Sie neue Trigger für Ihr Tag Manager-Tag.
- Wenn Sie bereits E-Commerce-Trigger in Google Analytics eingerichtet haben: Sie können Verwenden Sie die Trigger, die Sie für E-Commerce in Google Analytics konfiguriert haben, indem Sie neue erstellen. Weitere Informationen finden Sie unter E-Commerce-Trigger von Google Analytics wiederverwenden
Neue Trigger für Tag Manager-Tags erstellen
Wenn Sie die E-Commerce-Funktion von Google Analytics nicht verwenden, erstellen Sie neue Ereignistrigger für alle Nutzerereignisse, die Ihre Vertex AI Search for Retail-Modelle 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-Tags erstellen.
Erstellen Sie zuerst die Trigger. Wiederholen Sie diesen Vorgang für alle Nutzerereignisse, Vertex AI Search für Einzelhandelsmodelle erfordert:
Klicken Sie in Tag Manager auf der Seite Trigger auf Neu > Triggerkonfiguration.
Wählen Sie den Triggertyp für das Nutzerereignis aus, für das Sie einen Trigger erstellen.
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.
Klicken Sie auf der Seite Tag Manager, Tags auf Ihr Cloud Retail-Tag, um es zu bearbeiten.
Klicken Sie auf Trigger, wählen Sie die neuen Trigger aus und klicken Sie auf Hinzufügen.
Speichern Sie Ihr Tag.
Sehen Sie sich als Nächstes das Tag in der Vorschau ansehen an. Monitoring für Fehler bei der Ereignisaufzeichnung und andere Probleme einrichten, um sicherzustellen, dass Daten weiterhin erfolgreich empfangen werden.
Wenn Sie die Datenschicht cloud_retail
als Nutzerereignisquelle verwenden, müssen Sie auch Ihre Datenschicht einrichten.
Google Analytics-E-Commerce-Trigger wiederverwenden
Wenn Sie E-Commerce von Google Analytics über Tag Manager implementiert haben, Ereignistrigger aus Ihrem Google Analytics-E-Commerce wiederverwenden für Vertex AI Search for Retail.
Mit dieser Datenquelle können nur add-to-cart
, purchase-complete
,
detail-page-view
und search
Termine. search
Ereignisse werden erfasst mit
E-Commerce-Impressionen in Kombination mit Suchanfragen (siehe
Erstellen Sie eine Suchanfragenvariable.
In der folgenden Tabelle sehen Sie, wie die E-Commerce- und Erweiterte E-Commerce-Ereignisse werden Vertex AI Search für Einzelhandelsereignisse zugeordnet.
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 (in Kombination mit dem Feld searchQuery ) |
Für diese Schritte ist Folgendes erforderlich:
- Richten Sie in Tag Manager ein Tag vom Typ Google Analytics – Universal Analytics oder Google Analytics – GA4-Ereignis und aktiviert erweiterten E-Commerce oder GA4. Weitere Informationen finden Sie unter Tag Manager-Dokumentation und den GA4-Entwicklerleitfaden oder in der Entwicklerleitfaden zu erweiterten E-Commerce-Berichten .
- Erweiterte E-Commerce- oder GA4-Tags in Tag Manager konfiguriert zum Auslösen von Nutzerereignissen, die Sie für Vertex AI Search for Retail aufzeichnen möchten.
- Es wurde ein Cloud Retail-Tag in Tag Manager erstellt, mit „Datenschicht“ oder „Variable – E-Commerce“ als Datenquelle für Nutzerereignisse (siehe Erstellen Sie ein Tag Manager-Tag.
So verwenden Sie E-Commerce-Trigger von Google Analytics wieder:
Am Tag Manager Tags auf Ihr E-Commerce-Tag für Google Analytics. (Tag-Typ Google Analytics – Universal Analytics oder Google Analytics – GA4-Ereignis), um es zu bearbeiten.
Unter Erweiterte Einstellungen > Tag-Reihenfolge: Wählen Sie Tag auslösen nach <Name des erweiterten E-Commerce- oder GA4-Tags> Bränden.
Wählen Sie für Ihr Cloud Retail-Tag Cleanup-Tag aus.
Wählen Sie <Name des Cloud Retail-Tags nicht auslösen> aus. wenn <Name des erweiterten E-Commerce- oder GA4-Tags> schlägt fehl oder wird pausiert.
Speichern Sie Ihr Tag.
Sehen Sie sich als Nächstes das Tag in der Vorschau ansehen an. Monitoring für Fehler bei der Ereignisaufzeichnung und andere Probleme einrichten, um sicherzustellen, dass Daten weiterhin erfolgreich empfangen werden.
Wenn Sie die Datenschicht cloud_retail
als Nutzerereignisquelle verwenden, müssen Sie auch Ihre Datenschicht einrichten.
Die 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 Informationen zu Nutzerereignissen finden Sie alle Pflichtfelder und Beispiele für
Ereignistypen, die an die Datenschicht cloud_retail
übergeben werden sollen.
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 in der 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.
Klicken Sie auf der Übersichtsseite von Tag Manager auf Vorschau.
Der Vorschaumodus von Tag Manager wird in einem neuen Browsertab geöffnet.
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.
Rufen Sie auf Ihrer Website eine beliebige Seite auf, auf der das Cloud Retail-Tag ausgelöst werden soll.
Prüfen Sie, ob im Tag Assistant das Cloud Retail-Tag auf dem Tab Tags im Abschnitt Ausgelöste Tags aufgeführt wird.
Ö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 im Suchen Sie in der Retail-Konsole nach Fehlern. Auf dieser Seite werden die meisten Fehler protokolliert, außer auf Syntaxfehler, die normalerweise nur in Anfrageergebnissen angezeigt werden.
Mit den folgenden Schritten können Sie mit Chrome-Entwicklertools nach generierten Fehlern suchen, auch nach Syntaxfehlern.
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.
Rufen Sie bei geöffnetem Vorschaumodus die Entwicklertools auf und klicken Sie auf den Tab Netzwerk.
Laden Sie die Seite neu.
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.
- Eine
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, dassvisitorId
nicht korrekt festgelegt wurde.Wenn kein
userEvent
ausgelöst wird, prüfen Sie den Tab Console der Entwicklertools auf Syntaxfehler in der Datenschicht.
Nutzerereignisse mit serverseitigem Tagging aufzeichnen
Beim serverseitigen Tagging können Sie einen einzelnen serverseitigen Container mit für viele Downstream-Kunden. Dadurch wird eine Single Source Of Truth für den Client erstellt. mit vielen serverseitigen Nutzern. Bei dieser Architektur wird die Last und auf den Server übertragen. Dadurch ist es für Nutzer sinnvoll, die Leistung ihrer Websites zu verbessern.
Der andere Vorteil des serverseitigen Taggings besteht darin, dass ein einzelnes serverseitiges Tag unterstützen auch viele Upstream-Kunden, z. B. Web und Mobilgeräte. Weitere Informationen zum Einrichten des serverseitigen Taggings
Vertex AI Search for Retail stellt ein 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 (für die Authentifizierung)
- Überschreibungen für wichtige Felder wie
visitorId
undsearchQuery
Der Hauptunterschied zwischen der Server- und der Webversion der Cloud Retail-Tag 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.
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
Sie können Messwerte für die Ereignisintegration auf dem Tab Ereignisse in der Search for Retail-Konsole ansehen. Seite Daten: Auf dieser Seite werden alle Ereignisse angezeigt, die im letzten Jahr geschrieben oder importiert wurden. Messwerte können bis zu bis 24 Stunden nach erfolgreicher Datenaufnahme angezeigt werden.
Nächste Schritte
- Mehr über Nutzerereignisse erfahren
- Ereignisse noch einmal hinzufügen, die vor Abschluss des Katalogimports aufgezeichnet wurden
- Nutzerereignisse importieren und verwalten
- Vorhersagen abrufen.
- Hochladen von Daten überwachen und dafür Fehler beheben
- Mehr über Tag Manager erfahren