Voraussetzungen für die Einrichtung

Bevor Sie die Agent Platform-Suche für den Einzelhandel für ein neues Projekt einrichten können, müssen Sie Folgendes tun:

  1. Neues Projekt erstellen oder vorhandenes Projekt einrichten
  2. Agent Platform-Suche für den Einzelhandel aktivieren
  3. Produktkatalog und Nutzerereignisse importieren

ein Projekt Google Cloud erstellen

  1. Wählen Sie in der Google Cloud Console auf der Seite Ressourcen verwalten ein Projekt aus oder erstellen Sie eines. Google Cloud

    Zur Seite "Ressourcen verwalten"

  2. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für ein Projekt aktiviert ist .

Agent Platform-Suche für den Einzelhandel einrichten

So verwenden Sie die Agent Platform-Suche für den Einzelhandel: Wenn Sie die Agent Platform-Suche für den Einzelhandel aktivieren und Empfehlungen verwenden, richten sich die Kosten nach der Anzahl der Abfragen. Weitere Informationen zu den Preisen der Agent Platform-Suche für den Einzelhandel finden Sie unter Gebühren für die Agent Platform-Suche für den Einzelhandel.

Für Ihr neues Projekt

So richten Sie die Agent Platform-Suche für den Einzelhandel ein:

  1. Rufen Sie in der Google Cloud Console die Seite Agent Platform-Suche für den Einzelhandel auf.

    Zur Seite „Suche für den Einzelhandel“

  2. Klicken Sie auf der Seite Agent Platform-Suche für den Einzelhandel einrichten auf API aktivieren.

  3. Wenn Agent Platform-Suche für den Einzelhandel und Recommendations AI als Aktiviert angezeigt werden, klicken Sie auf Weiter.

  4. Lesen Sie die Nutzungsbedingungen für die Agent Platform-Suche für die Branche zur Datennutzung zur Datennutzung und klicken Sie auf Akzeptieren , wenn Sie den Nutzungsbedingungen zustimmen. Sie erhalten eine Bestätigung von der Google Cloud Console, sobald die Nutzungsbedingungen für die Suche akzeptiert wurden.

  5. Wenn Sie das Projekt nur mit Empfehlungen verwenden möchten, klicken Sie auf Jetzt starten.

  6. So aktivieren Sie die Suche zusätzlich zu Empfehlungen:

    1. Klicken Sie auf Weiter und dann auf der Seite Suche aktivieren (optional) auf Aktivieren.
    2. Klicken Sie auf Jetzt starten.

    In der Google Cloud Console werden die Komponenten der Agent Platform-Suche für den Einzelhandel angezeigt, die Sie aktiviert haben. Sie können jetzt die ersten Einstellungen für Ihr Projekt konfigurieren.

Für ein vorhandenes Projekt

So fahren Sie mit einem vorhandenen Projekt fort:

  1. Rufen Sie in der Google Cloud Console für Ihr Projekt die Seite Suche für den Einzelhandel auf.

    Zur Seite „Suche für den Einzelhandel“

  2. Lesen Sie auf der Seite Nutzungsbedingungen die Nutzungsbedingungen für Discovery Solutions und klicken Sie auf Akzeptieren, wenn Sie den Nutzungsbedingungen zustimmen.

  3. Wenn Sie das Projekt nur mit Empfehlungen verwenden möchten, klicken Sie auf Jetzt starten.

  4. So aktivieren Sie die Suche zusätzlich zu Empfehlungen:

    1. Klicken Sie auf Weiter und dann auf der Seite Suche aktivieren (optional) auf Aktivieren.
    2. Klicken Sie auf Jetzt starten.

Suchfunktionen deaktivieren

Wenn Sie die Suche nicht mehr verwenden möchten, können Sie sie deaktivieren, indem Sie ein Support-Ticket einreichen.

Wählen Sie die folgenden Felder aus, um das Ticket der richtigen Komponente zuzuordnen:

  • Kategorie: Maschinelles Lernen
  • Komponente: Agent Platform-Suche für den Einzelhandel: Suche und Browsen
  • Unterkomponente: Kontoverwaltung und Abrechnung

Weitere Informationen zum Erstellen eines Support-Tickets finden Sie unter Support.

Agent Platform-Suche für den Einzelhandel deaktivieren

Sie können die Agent Platform-Suche für den Einzelhandel jederzeit deaktivieren. Dadurch werden sowohl Empfehlungen als auch die Suche deaktiviert.

So deaktivieren Sie die Agent Platform-Suche für den Einzelhandel:

  1. Rufen Sie in der Google Cloud Console die Seite Agent Platform-Suche für Retail API/Dienstdetails auf.

    Zur Agent Platform-Suche für den Einzelhandel API – Detailseite

  2. Klicken Sie auf API deaktivieren.

  3. Klicken Sie im Feld Agent Platform-Suche für den Einzelhandel API deaktivieren? auf Deaktivieren.

Erste Schritte mit der Agent Platform-Suche für den Einzelhandel

Wenn Sie die Agent Platform-Suche für den Einzelhandel für ein neues Projekt einrichten, werden in der Google Cloud Console die folgenden drei Bereiche angezeigt, die Ihnen bei der Konfiguration Ihres Agent Platform-Suche für den Einzelhandel-Projekts helfen:

  • Daten > Katalog: Hier wird Ihr Produktkatalog und ein Link zum Importieren Ihres Katalogs angezeigt.

  • Daten > Ereignisse: Hier werden Ihre Nutzerereignisse und ein Link zum Importieren von bisherigen Nutzerereignissen angezeigt.

  • Bereitstellungskonfigurationen: Hier finden Sie Details zu Ihrer Bereitstellungskonfiguration und einen Link zum Erstellen einer neuen Bereitstellungskonfiguration.

Mit diesen Bereichen können Sie Ihre Daten importieren und eine erste Konfiguration für Ihr Agent Platform-Suche für den Einzelhandel-Projekt erstellen.

Produktkatalog importieren

Führen Sie die Schritte für Ihre Datenquelle aus, um Ihren Produktkatalog zu importieren. Weitere Informationen zu Produktkatalogen finden Sie unter Kataloginformationen importieren.

Merchant Center-Synchronisierung

  1. Klicken Sie auf Produktkatalog importieren , um den Bereich Daten importieren zu öffnen.
  2. Wählen Sie Produktkatalog aus.
  3. Wählen Sie Merchant Center Sync als Datenquelle aus.
  4. Wählen Sie Ihr Merchant Center-Konto aus. Prüfen Sie den Nutzerzugriff, wenn Ihr Konto nicht angezeigt wird.
  5. Optional: Wählen Sie Merchant Center-Feeds filtern aus, um nur Angebote aus ausgewählten Feeds zu importieren.

    Wenn nichts angegeben ist, werden Angebote aus allen Feeds importiert (einschließlich zukünftiger Feeds).
  6. Optional: Wenn Sie nur Angebote importieren möchten, die auf bestimmte Länder oder Sprachen ausgerichtet sind, maximieren Sie Erweiterte Optionen anzeigen und wählen Sie die Merchant Center-Absatzländer und ‑Sprachen aus, nach denen gefiltert werden soll.
  7. Wählen Sie den Zweig aus, in den Sie Ihren Katalog hochladen.
  8. Klicken Sie auf Importieren.

Cloud Storage

  1. Klicken Sie auf Produktkatalog importieren , um den Bereich Daten importieren zu öffnen.
  2. Wählen Sie Produktkatalog als Datenquelle aus.
  3. Wählen Sie den Zweig aus, in den Sie Ihren Katalog hochladen.
  4. Wählen Sie Schema von Produktkatalogen für den Einzelhandel als Schema aus.
  5. Geben Sie den Cloud Storage-Speicherort Ihrer Daten ein.
  6. Wenn die Suche nicht aktiviert ist, wählen Sie die Produktebenen aus.

    Sie müssen die Produktebenen auswählen, wenn Sie Ihren Katalog zum ersten Mal importieren oder Sie den Katalog nach dem Löschen noch einmal importieren. Weitere Informationen zu Produktebenen. Das Ändern von Produktebenen nach dem Importieren von Daten erfordert einen erheblichen Aufwand.

    Wichtig: Sie können die Suche nicht für Projekte mit einem Produktkatalog aktivieren, der als Varianten aufgenommen wurde.
  7. Klicken Sie auf Importieren.

BigQuery

  1. Klicken Sie auf Produktkatalog importieren , um den Bereich Daten importieren zu öffnen.
  2. Wählen Sie Produktkatalog aus.
  3. Wählen Sie BigQuery als Datenquelle aus.
  4. Wählen Sie den Zweig aus, in den Sie Ihren Katalog hochladen.
  5. Wählen Sie eines der folgenden Schemas aus:
  6. Geben Sie die BigQuery-Tabelle an, wo sich die Daten befinden.
  7. Optional: Geben Sie unter Erweiterte Optionen anzeigen den Speicherort eines Cloud Storage-Bucket in Ihrem Projekt als temporären Speicherort für Ihre Daten ein.

    Wenn nichts angegeben ist, wird ein standardmäßiger Standort verwendet. Wenn Sie einen Speicherort angeben, müssen sich BigQuery und der Cloud Storage-Bucket in derselben Region befinden.
  8. Wenn die Suche nicht aktiviert ist und Sie das Merchant Center-Schema verwenden, wählen Sie die Produktebene aus.

    Sie müssen die Produktebene auswählen, wenn Sie Ihren Katalog zum ersten Mal importieren oder den Katalog nach dem Löschen noch einmal importieren. Weitere Informationen zu Produktebenen. Das Ändern von Produktebenen nach dem Importieren von Daten erfordert einen erheblichen Aufwand.

    Wichtig: Sie können die Suche nicht für Projekte mit einem Produktkatalog aktivieren, der als Varianten aufgenommen wurde.
  9. Klicken Sie auf Importieren.

Bisherige Nutzerereignisse importieren

Führen Sie die Schritte für Ihre Datenquelle aus, um Ihre bisherigen Nutzerereignisse zu importieren. Weitere Informationen zu bisherigen Nutzerereignissen finden Sie unter Vergangene Nutzerereignisse importieren.

Cloud Storage

  1. Klicken Sie auf Nutzerereignisse importieren , um den Bereich Daten importieren zu öffnen.
  2. Wählen Sie Nutzerereignisse aus.
  3. Wählen Sie Google Cloud Storage als Datenquelle aus.
  4. Wählen Sie Schema für Nutzerereignisse im Einzelhandel als Schema aus.
  5. Geben Sie den Cloud Storage-Speicherort Ihrer Daten ein.
  6. Klicken Sie auf Importieren.

BigQuery

  1. Klicken Sie auf Nutzerereignisse importieren , um den Bereich Daten importieren zu öffnen.
  2. Wählen Sie Nutzerereignisse aus.
  3. Wählen Sie BigQuery als Datenquelle aus.

  4. Wählen Sie das Datenschema aus.

  5. Geben Sie die BigQuery-Tabelle an, wo sich die Daten befinden.
  6. Optional: Geben Sie den Speicherort eines Cloud Storage-Bucket in Ihrem Projekt als temporären Speicherort für Ihre Daten ein.
    Wenn nichts angegeben ist, wird ein Standardspeicherort verwendet. Wenn Sie einen Speicherort angeben, müssen sich BigQuery und der Cloud Storage-Bucket in derselben Region befinden.
  7. Optional: Geben Sie unter Erweiterte Optionen anzeigen den Speicherort eines Cloud Storage-Bucket in Ihrem Projekt als temporären Speicherort für Ihre Daten ein.

    Wenn nichts angegeben ist, wird ein Standardspeicherort verwendet. Wenn Sie einen Speicherort angeben, müssen sich BigQuery und der Cloud Storage-Bucket in derselben Region befinden.
  8. Klicken Sie auf Importieren.

Bereitstellungskonfiguration erstellen

Eine Bereitstellungskonfiguration ist eine Bereitstellungsentität, die ein Modell oder eine Reihe von Steuerelementen verknüpft, die zum Generieren der Such- oder Empfehlungsergebnisse verwendet werden.

So erstellen Sie eine Bereitstellungskonfiguration:

  1. Klicken Sie im Bereich Bereitstellungskonfigurationen auf Bereitstellungskonfiguration erstellen.
  2. Wählen Sie auf der Seite Bereitstellungskonfiguration erstellen die Option Suche als Produkt aus, für das die Bereitstellungskonfiguration verwendet wird.
  3. Geben Sie einen Namen für Ihre Bereitstellungskonfiguration an.

    Der Name darf höchstens 1.024 Zeichen lang sein und nur alphanumerische Zeichen, Unterstriche, Bindestriche und Leerzeichen enthalten.
  4. Optional: Aktualisieren Sie bei Bedarf die ID.

    Die ID wird aus dem von Ihnen angegebenen Namen generiert und muss in Ihrem Projekt eindeutig sein. Sie darf maximal 50 Zeichen lang sein und keine Leerzeichen enthalten.
  5. Klicken Sie auf Weiter.
  6. Wählen Sie aus, ob das dynamische Attribut für diese Bereitstellungskonfiguration aktiviert werden soll.
  7. Wählen Sie Bereitstellungssteuerelemente aus, um Ihre Suchanfragen zu optimieren.

    Weitere Informationen zu Steuerelementen finden Sie unter Steuerelemente erstellen und verwalten.

Ressourcen verwalten und Aktivität überwachen

Nachdem Sie die erste Konfiguration Ihres Projekts abgeschlossen haben, wird auf dem Google Cloud Console-Dashboard der Systemstatus Ihres Agent Platform-Suche für den Einzelhandel-Projekts angezeigt. Über das Console-Dashboard können Sie Ressourcen verwalten und Aktivitäten überwachen.

Zur Console für die Suche für den Einzelhandel

API-Schlüssel erstellen

Ein API-Schlüssel ist erforderlich, wenn Sie ein JavaScript-Pixel oder ein Tag Manager-Tag verwenden, um Nutzerereignisse aus den Browsern der Nutzer zu erfassen. Weitere Informationen zu Möglichkeiten zum Erfassen von Nutzerereignissen finden Sie unter Nutzerereignisse in Echtzeit aufzeichnen.

So erstellen Sie einen API-Schlüssel für Aufrufe der userEvents.Collect Methode:

  1. Rufen Sie in der Google Cloud Console die Seite Anmeldedaten auf.

  2. Wählen Sie im Drop-down-Menü oben auf der Google Cloud Console-Seite Ihr Projekt aus (das Projekt ist möglicherweise bereits ausgewählt).

  3. Klicken Sie auf Anmeldedaten erstellen und wählen Sie anschließend API-Schlüssel aus. Fügen Sie keine Einschränkungen für Websiteanwendungen hinzu. Bei einigen Datenschutzeinstellungen für Nutzer wird die Referrer-URL nicht übergeben.

    • Notieren Sie sich den generierten API-Schlüssel, da Sie ihn beim Aufrufen des Nutzerereignis-Loggings verwenden.

  4. Für mehr Sicherheit fügen Sie Ihrem API-Schlüssel eine API-Einschränkung hinzu, um den Zugriff auf den Agent Platform-Suche für den Einzelhandel-Dienst unter https://retail.googleapis.com/* einzuschränken.

Nächste Schritte