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. Vertex AI Search for Retail aktivieren
  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 außerdem Vertex AI Search für den Einzelhandel und die Nutzungsempfehlungen, wissen, dass die Kosten auf dem 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 for Retail 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. Sobald die Nutzungsbedingungen für die Suche akzeptiert wurden, erhalten Sie eine Bestätigung von der Google Cloud Console.

  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 Aktivieren auf der Aktivieren Suchseite (optional).
    2. Klicken Sie auf Jetzt starten.

    In der Google Cloud Console werden die von Ihnen aktivierten Vertex AI Search for Retail-Komponenten angezeigt. 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 Aktivieren auf der Aktivieren Suchseite (optional).
    2. Klicken Sie auf Jetzt starten.

Suchfunktionen deaktivieren

Wenn du die Suche nicht mehr verwenden möchtest, kannst du sie folgendermaßen deaktivieren: Support-Ticket einreichen.

Wählen Sie die folgenden Felder aus, um die richtige Komponente für Ihr Ticket festzulegen:

  • 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.

Führen Sie die folgenden Schritte aus, um Vertex AI Search for Retail zu deaktivieren:

  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: Zeigt Ihren Produktkatalog und einen Link zum Importieren an für Ihren Katalog.

  • Daten > Ereignisse: Zeigt Ihre Nutzerereignisse und einen Link zum Importieren an. frühere Nutzerereignisse.

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

Sie können diese Bereiche verwenden, um Ihre Daten zu importieren und eine Konfiguration Ihres Vertex AI Search for Retail-Projekts.

Produktkatalog importieren

Führen Sie die Schritte für Ihre Datenquelle aus, um den 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. Wenn Sie Ihr Konto nicht sehen, setzen Sie ein Häkchen bei Nutzerzugriff.
  5. Optional: Wählen Sie Filter für Merchant Center-Feeds aus, um nur Angebote aus ausgewählten Feeds zu importieren.

    Wenn nicht angegeben, werden Angebote aus allen Feeds importiert (einschließlich zukünftige 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 im 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 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 Produktebenen. Wird geändert Produktebenen nach dem Import von Daten ist mit einem erheblichen Aufwand verbunden.

    Wichtig:Sie können die Suche nach Projekten mit einer Produktkatalog, 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-Buckets 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 durchzuführen. Weitere Informationen zu bisherigen Nutzerereignissen finden Sie unter Bisherige 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 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 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-Buckets 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-Buckets in Ihrem Projekt als temporären Speicherort für Ihre Daten ein.

    Wenn keine Angabe erfolgt, wird ein Standardstandort verwendet. Wenn angegeben, werden die BigQuery- und Der Cloud Storage-Bucket muss sich 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 die Option Suche als Produkt in der Bereitstellungskonfiguration aus für die Daten verwendet werden.
  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 die ID bei Bedarf.

    Die ID wird aus dem 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 Auslieferungseinstellungen aus oder erstellen Sie sie, um Ihre Suchanfragen zu optimieren.

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

Ressourcen verwalten und Aktivitäten im Blick behalten

Wenn Sie die Erstkonfiguration Ihres Projekts abgeschlossen haben, Das Google Cloud Console-Dashboard zeigt den Systemstatus Ihrer Vertex AI Search for Retail-Projekt. Ü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 zu den Möglichkeiten, Nutzerereignisse zu erfassen, siehe Nutzerereignisse in Echtzeit aufzeichnen.

So erstellen Sie einen API-Schlüssel für Aufrufe der userEvents.Collect führen Sie die folgenden Schritte aus:

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

  2. Wählen Sie oben auf der Seite der Google Cloud Console im Drop-down-Menü für Projekte Ihr Projekt (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 Website-Anwendungen hinzu. Einige Datenschutzeinstellungen für Nutzer übergeben die Referrer-URL nicht.

    • Notieren Sie sich den generierten API-Schlüssel, den Sie beim Aufrufen von Nutzerereignis-Logging.

  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