Voraussetzungen für die Einrichtung

Bevor Sie Vertex AI Search for Retail für ein neues Projekt einrichten können, müssen Sie Folgendes tun:

  1. Erstellen Sie ein neues Projekt oder richten Sie ein vorhandenes Projekt ein.
  2. Aktivieren Sie Vertex AI Search for Retail.
  3. Produktkatalog und Nutzerereignisse importieren

Google Cloud-Projekt erstellen

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

    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.

Vertex AI Search for Retail einrichten

So verwenden Sie Vertex AI Search for Retail: Wenn Sie Vertex AI Search for Retail aktivieren und Empfehlungen verwenden, richten sich die Kosten nach der Anzahl der Abfragen. Weitere Informationen zu den Preisen für Vertex AI Search für den Einzelhandel finden Sie unter Gebühren für Vertex AI Search für den Einzelhandel.

Für Ihr neues Projekt

So richten Sie Vertex AI Search for Retail ein:

  1. Rufen Sie in der Google Cloud Console die Seite Vertex AI Search für den Einzelhandel auf.

    Zur Seite „Search for Retail“

  2. Klicken Sie auf der Seite Vertex AI Search for Retail einrichten auf API aktivieren.

  3. Wenn Vertex AI Search for Retail und Recommendations AI als An angezeigt werden, klicken Sie auf Weiter.

  4. Lesen Sie die Datennutzungsbedingungen für Vertex AI Search for Industry und klicken Sie auf Akzeptieren, wenn Sie den Datennutzungsbedingungen zustimmen. Sie erhalten eine Bestätigung in 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 zusätzlich zu den Empfehlungen die Suche:

    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 wird die Vertex AI Search für Einzelhandelskomponenten angezeigt, die Sie aktiviert haben. Sie können jetzt die ersten Einstellungen für Ihr Projekt konfigurieren.

Für ein bestehendes Projekt

So setzen Sie ein vorhandenes Projekt fort:

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

    Zur Seite „Search for Retail“

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

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

  4. Wenn Sie zusätzlich zu den Empfehlungen die Suche aktivieren möchten, gehen Sie so vor:

    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 Ihr Ticket der richtigen Abteilung zuzuweisen:

  • Kategorie: Maschinelles Lernen
  • Komponente: Vertex AI Search for Retail: Suche und Stöbern
  • Unterkomponente: Kontoverwaltung und Abrechnung

Weitere Informationen zum Erstellen eines Supporttickets finden Sie unter Support.

Vertex AI Search for Retail deaktivieren

Sie können Vertex AI Search for Retail jederzeit deaktivieren. Dadurch werden sowohl Empfehlungen als auch die Suche deaktiviert.

So deaktivieren Sie Vertex AI Search for Retail:

  1. Rufen Sie in der Google Cloud Console die Seite Vertex AI Search for Retail API/Service Details (Vertex AI Search – Details zur Retail API/zum Retail-Dienst) auf.

    Seite mit den Details zur Vertex AI Search for Retail API aufrufen

  2. Klicken Sie auf API deaktivieren.

  3. Klicken Sie im Feld Vertex AI Search for Retail API deaktivieren? auf Deaktivieren.

Erste Schritte mit Vertex AI Search for Retail

Wenn Sie Vertex AI Search for Retail für ein neues Projekt einrichten, werden in der Google Cloud Console die folgenden drei Bereiche angezeigt, die Ihnen bei der Konfiguration Ihres Vertex AI Search for Retail-Projekts helfen:

  • Daten > Katalog: Hier sehen Sie Ihren Produktkatalog und einen Link zum Importieren des Katalogs.

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

  • Bereitstellungskonfigurationen: Enthält Details zu Ihrer Bereitstellungskonfiguration und einen Link zum Erstellen einer neuen Bereitstellungskonfiguration.

Über diese Bereiche können Sie Ihre Daten importieren und eine erste Konfiguration für Ihr Vertex AI Search for Retail-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 das Feld 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. Wenn Sie Ihr Konto nicht sehen, setzen Sie ein Häkchen bei Nutzerzugriff.
  5. Optional: Wählen Sie Merchant Center-Feeds filtern aus, um nur Angebote aus ausgewählten Feeds zu importieren.

    Wenn Sie nichts auswählen, 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 Sie filtern möchten.
  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 das Feld 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 als Schema Retail Product Catalogs 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 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 für Projekte mit einem Produktkatalog, der als Varianten aufgenommen wurde, nicht aktivieren.
  7. Klicken Sie auf Importieren.

BigQuery

  1. Klicken Sie auf Produktkatalog importieren, um das Feld 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 keine Angabe erfolgt, wird ein Standardspeicherort verwendet. Wenn Sie einen Speicherort angeben, müssen sich BigQuery und der Cloud Storage-Bucket in derselben Region befinden.
  8. Wenn Sie die Suche nicht aktiviert haben und 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 für Projekte mit einem Produktkatalog, der als Varianten aufgenommen wurde, nicht aktivieren.
  9. Klicken Sie auf Importieren.

Bisherige Nutzerereignisse importieren

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

Cloud Storage

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

BigQuery

  1. Klicken Sie auf Nutzerereignisse importieren, um das Feld 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 Sie keinen Speicherort angeben, 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 keine Angabe erfolgt, 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 erstellst du eine Bereitstellungskonfiguration:

  1. Klicken Sie im Bereich Bereitstellungskonfigurationen auf Bereitstellungskonfiguration erstellen.
  2. Wählen Sie auf der Seite Bereitstellungskonfiguration erstellen Suche als Produkt aus, für das die Bereitstellungskonfiguration verwendet wird.
  3. Geben Sie einen Namen für die 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 Steuerelemente für die Auslieferung aus oder erstellen Sie sie, um Ihre Suchanfragen zu optimieren.

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

Ressourcen verwalten und Aktivitäten beobachten

Nachdem Sie die Erstkonfiguration Ihres Projekts abgeschlossen haben, wird im Google Cloud Console-Dashboard der Systemstatus Ihres Vertex AI Search for Retail-Projekts angezeigt. Über das Konsolen-Dashboard können Sie Ressourcen verwalten und Aktivitäten überwachen.

Zur Search for Retail-Konsole

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 zum Erfassen von Nutzerereignissen finden Sie unter Nutzerereignisse in Echtzeit aufzeichnen.

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

  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. Einige Datenschutzeinstellungen für Nutzer übergeben die Referrer-URL nicht.

    • 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 Vertex AI Search for Retail-Dienst unter https://retail.googleapis.com/* einzuschränken.

Nächste Schritte