Hinweise

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

Wenn Sie Vertex AI Search for Retail zusammen mit Empfehlungen verwenden möchten, müssen Sie Vertex AI Search for Retail aktivieren und die Nutzungsbedingungen von Vertex AI Search for Industry für die Datennutzung akzeptieren. Wenn Sie auch die Suche verwenden, müssen Sie sie aktivieren. Bei Verwendung der Suche fallen je nach Anzahl der Abfragen zusätzliche Kosten an. Weitere Informationen finden Sie unter Gebühren suchen.

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

  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 On (Ein) angezeigt werden, klicken Sie auf Continue (Weiter).

  4. Lesen Sie die Datennutzungsbedingungen von Vertex AI Search for Industry und klicken Sie auf Akzeptieren, wenn Sie den Datennutzungsbedingungen zustimmen.

    Wenn Sie die Datennutzungsbedingungen akzeptieren, wird in der Google Cloud Console angezeigt, dass die Datennutzungsbedingungen von Vertex AI Search for Retail akzeptiert werden.

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

  6. Wenn Sie die Suche zusätzlich zu den Empfehlungen 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.

In der Google Cloud Console werden die von Ihnen aktivierten Vertex AI Search for Retail-Komponenten angezeigt. Sie können jetzt die Anfangseinstellungen Ihres Projekts konfigurieren.

Für ein vorhandenes Projekt einrichten

Wenn Sie Vertex AI Search for Retail vor dem Inkrafttreten der Nutzungsbedingungen für die Datennutzung am 4. April 2022 in einem Google Cloud-Projekt eingerichtet haben, müssen Sie die Nutzungsbedingungen von Vertex AI Search for Industry akzeptieren, um Vertex AI Search for Retail mit diesem Projekt weiterhin verwenden zu können. Gegebenenfalls müssen Sie auch die Suche für dieses Projekt aktivieren.

Führen Sie die folgenden Schritte aus, um die Nutzungsbedingungen von Vertex AI Search for Industry für ein vorhandenes Projekt zu akzeptieren:

  1. Rufen Sie in der Google Cloud Console die Seite Search for Retail für Ihr Projekt auf.

    Zur Seite „Search for Retail“

  2. Lesen Sie auf der Seite Datennutzungsbedingungen die Datennutzungsbedingungen von 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. Wenn Sie die Suche zusätzlich zu den Empfehlungen 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.

Suche oder Vertex AI Search for Retail deaktivieren

Suche 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 die richtige Komponente für Ihr Ticket festzulegen:

  • Kategorie: Maschinelles Lernen
  • Komponente: Vertex AI Search for Retail: Suchen und Surfen
  • Unterkomponente: Kontoverwaltung und Abrechnung

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

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/Dienstdetails auf.

    Zur Seite „Dienstdetails“ der Vertex AI Search for Retail API

  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, in denen Sie Ihr Vertex AI Search for Retail-Projekt konfigurieren können:

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

  • Daten > Ereignisse: Hier werden Ihre Nutzerereignisse und ein Link zum Import bisheriger Nutzerereignisse angezeigt.

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

Sie können diese Bereiche verwenden, um Ihre Daten zu importieren und eine Erstkonfiguration für Ihr Vertex AI Search for Retail-Projekt zu erstellen.

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. Wird Ihr Konto nicht angezeigt, überprüfen Sie die Option 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 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 als Schema Retail Product Catalogs Schema (Schema für Retail-Produktkataloge) 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 dauerhaften Löschen noch einmal importieren. Weitere Informationen zu Produktebenen Das Ändern der Produktebenen nach dem Import von Daten ist mit einem erheblichen Aufwand verbunden.

    Wichtig:Sie können die Suche nach Projekten mit einem Produktkatalog, der als Varianten aufgenommen wurde, nicht aktivieren.
  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 keine Angabe erfolgt, wird ein Standardstandort verwendet. Wenn angegeben, 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.

    Wählen Sie die Produktebene aus, wenn Sie Ihren Katalog zum ersten Mal importieren oder den Katalog nach dem dauerhaften Löschen noch einmal importieren. Weitere Informationen zu Produktebenen Das Ändern der Produktebenen nach dem Import von Daten ist mit einem erheblichen Aufwand verbunden.

    Wichtig:Sie können die Suche nach Projekten 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 Ihre bisherigen Nutzerereignisse zu importieren. Weitere Informationen zu Nutzerereignissen finden Sie unter Nutzerverlauf 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 Retail User Events Schema 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 nicht angegeben, wird ein Standardspeicherort verwendet. Wenn angegeben, 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 Standardstandort verwendet. Wenn angegeben, 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 Ihrer Such- oder Empfehlungsergebnisse verwendet werden.

Führen Sie die folgenden Schritte aus, um eine Bereitstellungskonfiguration zu erstellen:

  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 werden soll.
  3. Geben Sie einen Namen für die Bereitstellungskonfiguration an.

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

    Die ID wird aus dem von Ihnen angegebenen Namen generiert und muss innerhalb Ihres Projekts eindeutig sein. Er darf maximal 50 Zeichen lang sein und darf keine Leerzeichen enthalten.
  5. Klicken Sie auf Weiter.
  6. Wählen Sie aus, ob dynamische Attribute für diese Bereitstellungskonfiguration aktiviert werden sollen.
  7. Wählen Sie Bereitstellungseinstellungen aus oder erstellen Sie sie, um Ihre Suchanfragen zu optimieren.

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

Das Dashboard

Wenn Sie die Erstkonfiguration Ihres Projekts abgeschlossen haben, wird in der Search for Retail-Konsole der Systemstatus Ihres Vertex AI Search for Retail-Projekts angezeigt. Mit der Konsole 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 oben auf der Seite der Google Cloud Console im Drop-down-Menü 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 Website-Anwendungen hinzu. Es ist bekannt, dass bei einigen Datenschutzeinstellungen die Verweis-URL nicht übergeben wird.

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

  4. Zur Erhöhung der Sicherheit fügen Sie Ihrem API-Schlüssel eine API-Einschränkung hinzu, um den Zugriff auf den Dienst Vertex AI Search for Retail unter https://retail.googleapis.com/* einzuschränken.

Nächste Schritte