Dies ist die Dokumentation nur für Recommendations AI. Wenn Sie Retail Search und die einheitliche Retail-Konsole in der eingeschränkten GA-Phase ausprobieren möchten, wenden Sie sich an den Cloud-Vertrieb. Wenn Sie Retail Search nicht verwenden möchten, können Sie das bis auf Weiteres in der Empfehlungskonsole bleiben.

Wenn Sie die v1beta-Version von Recommendations AI verwenden, migrieren Sie zur Retail API-Version.

Nutzerereignisse in Echtzeit aufzeichnen

Auf dieser Seite wird beschrieben, wie Sie Nutzerereignisse in Echtzeit aufzeichnen. Recommendations AI verwendet Echtzeit-Nutzerereignisse, um Empfehlungen für das nächste Element zu generieren. Das Aufzeichnen von sehr vielen Nutzerereignistypen mit gültigen Produktinformationen erhöht die Empfehlungsqualität.

Ausführliche Informationen zu Nutzerereignissen, einschließlich Nutzerereignistypen und JSON-Beispieldaten 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 erhalten 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 Bisherige Nutzerereignisse importieren.

Wenn das erfasste Nutzerereignis das erste Mal ist, dass ein Nutzer mit einem Produkt interagiert, basierend auf einer zuvor bereitgestellten Empfehlung, einschließlich eines Attributionstokens kann Recommendations AI Empfehlungsmesswertebereitstellen. Das Zugriffstoken ist jedoch optional. Informationen zur Verwendung von Attributionstokens finden Sie unter Attributionstoken.

Weitere Informationen zum Feld "userInfo" finden Sie unter Informationen zum Nutzerinformationsobjekt.

Hinweis

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

Recommendations AI erfordert hochwertige Daten, um qualitativ hochwertige Vorhersagen zu treffen. Wenn Ihre Daten unvollständig oder falsch sind, beeinträchtigt die Qualität der Vorhersagen.

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 während der Aufzeichnung der Nutzerereignisse in Recommendations AI importieren. Durch parallele Ausführung dieser Aufgaben sparen Sie Zeit, wenn der Katalog umfangreich ist und viele Nutzerereignisse vorhanden sind. Wenn der Import des Katalogs abgeschlossen ist, müssen Sie mit der API die Ereignisse noch einmal hinzufügen, die vor Abschluss des Imports hochgeladen wurden.

    Recommendations AI 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 Katalogelement mit Ihrem aktuellen Katalog verbunden. Wenn Sie ein Ereignis für ein Katalogelement erfassen, das nicht im aktuellen Katalog enthalten ist, kann es nicht von Recommendations AI zum Trainieren Ihrer Modelle verwendet werden. Ein solches Ereignis wird als "nicht verbundenes" Ereignis bezeichnet. Wenn Sie Ereignisse aufgezeichnet haben, bevor Ihr Katalog vollständig importiert wurde, müssen Sie die Ereignisse noch einmal hinzufügen, die während des Imports aufgezeichnet wurden. Es sollten nur wenige nicht verbundene Ereignisse vorhanden sein. Wenn der Prozentsatz der nicht verbundenen Ereignisse aber 5 % oder mehr Ihrer gesamten Nutzerereignisse erreicht, müssen Sie darauf achten, dass Ihr Katalog auf dem neuesten Stand ist. Fügen Sie dann noch einmal die Ereignisse hinzu, die aufgezeichnet wurden, bevor der Katalog vollständig aktualisiert wurde. Prüfen Sie, warum die nicht verbundenen Ereignisse erstellt werden.

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

  • Achten Sie darauf, dass Sie so viele Informationen wie möglich zu Ihren Nutzerereignissen bereitstellen.

    Jeder Nutzerereignistyp hat unterschiedliche Informationen, die erforderlich sind und akzeptiert werden. Weitere Erläuterungen finden Sie unter Nutzerereignisse.

  • Richten Sie Benachrichtigungen ein, damit Sie wissen, ob beim Aufzeichnen von Nutzerereignissen Ausfälle aufgetreten sind.

  • 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 angegebenen Format an.

  • Wenn Sie falsche Nutzerereignisse importiert haben, wenden Sie sich an Ihren Recommendations AI-Ansprechpartner, 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 Kennzeichnung, um Nutzer für Recommendations AI 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 Back-End-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 -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@example.com',
           '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"

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.

Manche Festlegungen während der Einrichtung hängen davon ab, ob Sie Google Analytics und erweiterte E-Commerce-Berichte verwenden. Keines von beidem ist erforderlich. Wenn Sie sie nicht verwenden, können Sie entweder eine E-Commerce-Variable beim Erstellen des Cloud Retail-Tags konfigurieren oder den Datenschichtcode der Website nach dem Erstellen des Tags manuell festlegen.

Erweiterte E-Commerce-Berichte bieten eine zusätzliche Konfigurationsmöglichkeit für Google Analytics, mit der Produkttitel, IDs, Preise, Transaktionsdetails und andere strukturierte E-Commerce-Daten an Google Analytics übergeben werden können. Recommendations AI kann die Datenschicht im erweiterten E-Commerce automatisch verwenden. Wenn Sie diese bereits eingerichtet haben, ist die Konfiguration einfacher. Wenn Sie keine erweiterten E-Commerce-Berichte für Google Analytics konfiguriert haben, diese aber verwenden möchten, finden Sie ausführliche Informationen und eine Anleitung zu deren Einrichtung 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.

Google Tag Manager-Tag erstellen

Richten Sie ein Tag in Tag Manager ein, um Informationen zu Nutzerereignissen an die Retail API 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 ist Unbenannte Variable), z. B. "Recommendations AI".

  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 Recommendations AI erstellt haben.

    Ihre API-Schlüssel sind in der Cloud Console auf der Seite APIs & Dienste > Anmeldedaten verfügbar. Verwenden Sie keinen API-Schlüssel, den Sie für Recommendations AI für Vorhersageaufrufe registriert haben.

  6. Geben Sie die Projektnummer des Google Cloud-Projekts ein, in dem Recommendations AI aktiviert ist.

    Die Projektnummer ist im Cloud Console-Dashboard verfügbar.

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

    • E-Commerce-Datenschicht: Wählen Sie diese Option aus, wenn Sie erweiterte E-Commerce-Berichte über Tag Manager implementiert haben. Damit haben Sie die Möglichkeit, die Datenschicht für erweiterte E-Commerce-Berichte als Ereignisdatenquelle wiederzuverwenden, anstatt eine neue festzulegen.

      Sie können über diese Datenquelle nur add-to-cart-, purchase-complete- und detail-page-view-Ereignisse aufzeichnen.

    • Cloud Retail-Datenschicht: Wählen Sie diese Option aus, wenn Sie Google Analytics nicht verwenden und den Datenschichtcode manuell festlegen können. Weitere Informationen finden Sie im Tag Manager-Entwicklerleitfaden.

    • Cloud Retail-Nutzervariable: Wählen Sie diese Option aus, um eine Tag Manager-Variable mit den erforderlichen Feldern für Recommendations AI auszufüllen. Diese Option können Sie auswählen, wenn Sie kein erweitertes E-Commerce verwenden oder wenn das erweiterte E-Commerce-Dataset nicht über die für Recommendations AI erforderlichen Daten verfügt.

    • E-Commerce-Variable: Wählen Sie diese Option aus, wenn Sie keine erweiterten E-Commerce-Berichte in Ihrer Datenschicht verwenden und den Datenschichtcode nicht manuell festlegen können.

      Wählen Sie im angezeigten Feld E-Commerce-Daten von "User"-Variable ablesen eine Variable aus. Auf diese Weise kann Recommendations AI Daten von erweiterten E-Commerce-Nutzern aus einer von Ihnen erstellten benutzerdefinierten Variable lesen.

      Die Variable muss dem Format entsprechen, das im Entwicklerleitfaden für erweiterte E-Commerce-Berichte dokumentiert ist. Damit eine Variable im richtigen Format erstellt wird, verwenden Sie den Objekt-Builder für erweiterte E-Commerce-Berichte. Dies ist eine benutzerdefinierte Variablenvorlage aus der Community-Galerie für Vorlagen von Tag Manager. Community-Vorlagen werden nicht von Google verwaltet. Informationen zur Verwendung dieser Vorlage finden Sie auf der Galerieseite des Objekt-Builder für erweiterte E-Commerce-Berichte mit einer Dokumentation und anderen Materialien.

  8. Klicken Sie auf Speichern.

    Ihr Cloud Retail-Tag wird erstellt.

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 von Ihren Recommendations AI-Modellen verwendet werden.

Tag Manager-Tags müssen Trigger haben, die steuern, wann das Tag auf der Website ausgelöst werden soll. Trigger überwachen das Auftreten von Ereignissen, z. B. wenn ein Nutzer die Startseite aufruft oder einen Artikel in den Einkaufswagen legt, und fordern Ihr Tag an, um diese Nutzerereignisinformationen an die Retail API 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 wird das Tag so festgelegt, dass ein Trigger ausgelöst wird, wenn ein Nutzer eine Seite aufruft, die die für Recommendations AI erforderlichen Ereignisse enthält (z. B. Startseite, Produktdetailseiten, Einkaufswagenseiten oder Seite für die Bezahlung). 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 Front-End-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 Ihr Tag Manager-Tag erstellen

Wenn Sie keine erweiterten E-Commerce-Berichte verwenden, erstellen Sie neue Ereignistrigger für alle Nutzerereignisse, die für Ihre Recommendations AI-Modelle erforderlich sind. 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 Ihre Recommendations AI-Modelle benötigen:

  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.

Richten Sie als Nächstes eine Variable ein, in der das Feld visitorId der Empfehlungs-AI auf die Nutzersitzungs-ID gesetzt wird.

Erweiterte E-Commerce-Trigger wiederverwenden

Wenn Sie erweiterte E-Commerce-Berichte über Tag Manager implementiert haben, verwenden Sie Ereignistrigger aus Ihrem erweiterten E-Commerce für Recommendations AI wieder.

Sie können über diese Datenquelle nur add-to-cart-, purchase-complete- und detail-page-view-Ereignisse aufzeichnen.

Für diese Schritte ist Folgendes erforderlich:

  • Ein in Tag Manager eingerichtetes Tag vom Tag-Typ Google Analytics – Universal Analytics und dafür aktivierte erweiterte E-Commerce-Berichte. Ausführliche Informationen dazu finden Sie in der Tag Manager-Dokumentation und im Entwicklerleitfaden für erweiterte E-Commerce-Berichte.
  • Ein in Tag Manager konfiguriertes Tag für erweiterte E-Commerce-Berichte, um Nutzerereignisse auszulösen, die Sie für Recommendations AI aufzeichnen möchten.
  • Ein in Tag Manager konfiguriertes Cloud Retail-Tag mit erweiterten E-Commerce-Berichten als Nutzerereignisdatenquelle. Weitere Informationen finden Sie unter Tag Manager-Tag erstellen.

So können Sie Trigger für erweiterte E-Commerce-Berichte wiederverwenden:

  1. Klicken Sie auf der Seite Tag Manager ,Tags auf Ihr Tag für erweiterte E-Commerce-Berichte (Tag-Typ Google Analytics – Universal Analytics), um es zu bearbeiten.

  2. Wählen Sie unter Erweiterte Einstellungen > Tag-Reihenfolge die Option Tag nach <Tag-Name des erweiterten E-Commerce-Berichts> auslösen aus.

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

    Wählen Sie Nicht auslösen von <Cloud Retail-Tag-Name>, wenn <Tag-Name des erweiterten E-Commerce-Berichts> fehlschlägt oder pausiert aus.

  4. Speichern Sie Ihr Tag.

Um die Tag-Einrichtung abzuschließen, überschreiben Sie das Feld visitorID mit einer Variable in Tag Manager, damit Recommendations AI Sitzungs-IDs verwenden kann, um Nutzer zu verfolgen.

Das Feld visitorID in Tag Manager festlegen

Recommendations AI verwendet den Wert visitorId, um Nutzer zu verfolgen. 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.

Bevor Sie diese Schritte starten, müssen Sie bereits ein Cloud Retail-Tag in Tag Manager erstellt haben (siehe Google Tag Manager-Tag erstellen).

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 Einstellungen für die Variable ein:

    Google Analytics 360

    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.

    Google Analytics

    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.

  4. Gehen Sie zum Tab Tags und klicken Sie auf Ihr Cloud Retail-Tag, um es zu bearbeiten.

  5. Klicken Sie Tag-Konfiguration und unter "Zu überschreibende Felder" auf die Schaltfläche + Wert in UserEvent-Nachricht überschreiben.

  6. Wählen Sie visitorId als Feld und die soeben erstellte Variable als Feldwert aus.

  7. Speichern Sie Ihr Cloud Retail-Tag.

Erstellen Sie als Nächstes eine Vorschau Ihres Tags und richten Sie das Monitoring von Ereignisaufzeichnungsfehlern sowie anderer Probleme ein, um zu gewährleisten, dass die Recommendations AI weiterhin Daten empfängt.

Wenn Sie die Datenebene cloud_retail als Nutzerereignisquelle verwenden, müssen Sie auch Ihre Datenebene 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 Front-End-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

Nutzerereignisse enthält alle erforderlichen Felder und Beispiele für Ereignistypen, 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>

Vorschau des Tag Manager-Tags aufrufen

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 Fehler in der Google Cloud Console kurz auf Fehler prüfen. Auf dieser Seite werden die meisten Fehler protokolliert, mit Ausnahme von Syntaxfehlern, die meist 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.

Importstatus überwachen

Das erfolgreiche Aufzeichnen von Nutzerereignissen ist Voraussetzung für qualitativ hochwertige Empfehlungen. 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.

Nächste Schritte