Steuerelemente für die Bereitstellung erstellen

Cloud Console

1. Rufen Sie in der Konsole für AI Commerce Search in Gemini Enterprise for Customer Experience die Seite Controls (Steuerelemente) auf.
   
   Zur Seite „Steuerelemente“

2. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf add_boxSteuerung erstellen.

   Der Bereich Kontrollgruppe erstellen wird geöffnet.

3. Geben Sie im Bereich Einstellungen im Feld Name des Steuerelements einen Namen für das neue Steuerelement ein.

4. Optional: Wenn Sie die automatisch erstellte Kontroll-ID ändern möchten, klicken Sie auf Bearbeiten und geben Sie eine neue Kontroll-ID ein.

5. Wählen Sie im Abschnitt Produktauswahl die Option Suche aus.

6. Wählen Sie Boost-/Bury-Steuerelemente als Steuerungstyp aus. Klicken Sie auf Weiter.

7. Wählen Sie im Abschnitt Trigger aus, welche Art von Nutzerverhalten diese Kontrollgruppe auslöst.

   • Kategorien durchsuchen: Die Regel wird ausgelöst, wenn ein Nutzer Kategorien auf Ihrer Website durchsucht (search.request.query ist leer).

   • Suche: Die Regel wird ausgelöst, wenn ein Nutzer auf Ihrer Website sucht (search.request.query ist nicht leer). Wenn Sie möchten, dass dieser Kontrollpunkt ausgelöst wird, wenn eine beliebige Kategorie aufgerufen oder eine beliebige Suchanfrage eingegeben wird, überspringen Sie den folgenden Schritt.

8. Optional: Legen Sie bestimmte Kategorien oder Anfragen fest, die dieses Steuerelement auslösen können, je nachdem, ob eine bestimmte Kategorie aufgerufen oder nach einer bestimmten Anfrage gesucht wird.

   • Wenn Sie Kategorien durchsuchen ausgewählt haben: Geben Sie im Feld Kategorien ein, bei welchen Kategorien diese Steuerung ausgelöst werden soll.

   • Wenn Sie Suchen ausgewählt haben: Klicken Sie auf die Schaltfläche Abfrage hinzufügen, um Suchbegriffe (z. B. running shoes) hinzuzufügen, nach denen gefiltert werden soll. Wählen Sie für jeden Begriff entweder Teilübereinstimmung oder Vollständige Übereinstimmung aus.

9. Optional: Klicken Sie auf den Button Zeitraum hinzufügen, um einen oder mehrere Zeiträume hinzuzufügen, für die diese Einstellung gelten soll.

10. Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

11. Fügen Sie im Feld Boost-/Bury-Produkt Filter für Produktattribute hinzu.

    Verwenden Sie die unter Filtern und Sortieren dokumentierte Syntax des Filterausdrucks. So geben Sie beispielsweise rote und blaue Versionen von „product1“ und „product2“ an: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

12. Mit dem Schieberegler Boost/Bury-Wert können Sie die Stärke des Boosts festlegen. Positive Werte verbessern die Ergebnisse, negative Werte verschlechtern sie. Klicken Sie auf Weiter.

13. Wählen Sie im Abschnitt Bereitstellungskonfigurationen die Bereitstellungskonfigurationen aus, auf die das Steuerelement angewendet werden soll.

14. Übermitteln Sie Ihre Steuerungseinstellungen.

    Es dauert einige Minuten, bis neu erstellte oder aktualisierte Steuerelemente für die Bereitstellung von Live-Traffic verfügbar sind. Auf der Seite Bewerten in der Konsole können Sie testen, ob Ihre Änderungen angewendet wurden.

Das neue Steuerelement ist jetzt auf der Seite Steuerelemente auf dem Tab Steuerelemente für die Bereitstellung aufgeführt.

curl

Stellen Sie eine Control.create-Anfrage mit einer Kontroll-ID und einer Instanz von Control im Anfragetext.

Details zu den Feldern finden Sie in der Controls API-Referenz und der Controls.create API-Referenz.

Eine Steuerung zum Hervorheben/Unterdrücken kann ausgelöst werden, wenn ein Nutzer auf Ihrer Website in Kategorien stöbert (search.request.query ist leer) oder wenn ein Nutzer auf Ihrer Website sucht (search.request.query ist nicht leer).

Im folgenden Beispiel werden Felder für eine durch das Browsen ausgelöste Kontrollgruppe gezeigt, wobei searchSolutionUseCase auf SEARCH_SOLUTION_USE_CASE_BROWSE festgelegt ist.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Im folgenden Beispiel werden Felder für eine durch die Suche ausgelöste Kontrollgruppe gezeigt, wobei searchSolutionUseCase auf SEARCH_SOLUTION_USE_CASE_SEARCH festgelegt ist.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

Es dauert einige Minuten, bis neu erstellte oder aktualisierte Steuerelemente für die Bereitstellung von Live-Traffic verfügbar sind. Auf der Seite Bewerten in der Konsole können Sie testen, ob Ihre Änderungen angewendet wurden.

Verwenden Sie die Methode ServingConfig.addControl, um einer Bereitstellungskonfiguration ein Steuerelement hinzuzufügen:

• Weitere Informationen zu dieser Methode finden Sie in der API-Referenz für ServingConfig.addControl.

• Ein Beispiel für diese Methode finden Sie unter Bereitstellungskonfigurationen verwalten.

Cloud Console

1. Rufen Sie in der Konsole für AI Commerce Search in Gemini Enterprise for Customer Experience die Seite Controls (Steuerelemente) auf.
   
   Zur Seite „Steuerelemente“

2. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf add_boxSteuerung erstellen.

   Der Bereich Kontrollgruppe erstellen wird geöffnet.

3. Geben Sie im Abschnitt Einstellungen im Feld Name des Steuerelements einen Namen für das neue Steuerelement ein.

4. Optional: Wenn Sie die automatisch erstellte Einstellungs-ID ändern möchten, klicken Sie auf Bearbeiten und geben Sie eine neue Einstellungs-ID ein.

5. Wählen Sie im Abschnitt Produktauswahl die Option Empfehlung aus.

6. Wählen Sie Boost-/Bury-Steuerelemente als Steuerungstyp aus.

7. Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

8. Fügen Sie im Feld Boost-/Bury-Produkt Filter für Produktattribute hinzu.

   Verwenden Sie die unter Empfehlungen filtern dokumentierte Syntax des Filterausdrucks.

   So geben Sie beispielsweise rote und blaue Versionen von „product1“ und „product2“ an: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

9. Mit dem Schieberegler Boost/Bury-Wert können Sie die Stärke des Boosts festlegen. Positive Werte verbessern die Ergebnisse, negative Werte verschlechtern sie.

10. Klicken Sie auf Weiter, um zum Abschnitt Serving-Konfigurationen zu gelangen.

11. Wählen Sie die Bereitstellungskonfigurationen aus, auf die das Steuerelement angewendet werden soll.

12. Übermitteln Sie Ihre Steuerungseinstellungen.

    Es dauert einige Minuten, bis neu erstellte oder aktualisierte Steuerelemente für die Bereitstellung von Live-Traffic verfügbar sind. Auf der Seite Bewerten in der Konsole können Sie testen, ob Ihre Änderungen angewendet wurden.

Das neue Steuerelement ist auf der Seite Steuerelemente auf dem Tab Steuerelemente für die Bereitstellung aufgeführt.

curl

Stellen Sie eine Control.create-Anfrage mit einer Kontroll-ID und einer Instanz von Control im Anfragetext.

Details zu den Feldern finden Sie in der Controls API-Referenz und der Controls.create API-Referenz.

Verwenden Sie zum Erstellen eines Filterausdrucks die in Filterempfehlungen dokumentierte Syntax des Filterausdrucks.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ],
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
   

Es dauert einige Minuten, bis neu erstellte oder aktualisierte Steuerelemente für die Bereitstellung von Live-Traffic verfügbar sind. Auf der Seite Bewerten in der Konsole können Sie testen, ob Ihre Änderungen angewendet wurden.

Verwenden Sie die Methode ServingConfig.addControl, um einer Bereitstellungskonfiguration ein Steuerelement hinzuzufügen:

• Weitere Informationen zu dieser Methode finden Sie in der API-Referenz für ServingConfig.addControl.

• Ein Beispiel für diese Methode finden Sie unter Bereitstellungskonfigurationen verwalten.

Cloud Console

1. Rufen Sie in der Konsole für AI Commerce Search in Gemini Enterprise for Customer Experience die Seite Controls (Steuerelemente) auf.
   
   Zur Seite „Steuerelemente“

2. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf add_boxSteuerung erstellen.

   Der Bereich Kontrollgruppe erstellen wird geöffnet.

3. Geben Sie im Abschnitt Einstellungen im Feld Name des Steuerelements einen Namen für das neue Steuerelement ein.

4. Optional: Wenn Sie die automatisch erstellte Kontroll-ID ändern möchten, klicken Sie auf Bearbeiten und geben Sie eine neue Kontroll-ID ein.

5. Wählen Sie Steuerelemente zum Filtern als Steuerungstyp aus.

6. Klicken Sie auf „Weiter“, um zum Abschnitt Trigger zu gelangen.

7. Wählen Sie aus, welche Art von Nutzerverhalten diese Einstellung auslöst:

   • Kategorien durchsuchen: Die Regel wird ausgelöst, wenn ein Nutzer Kategorien auf Ihrer Website durchsucht (search.request.query ist leer).

   • Suche: Die Regel wird ausgelöst, wenn ein Nutzer auf Ihrer Website sucht (search.request.query ist nicht leer).

8. Optional: Legen Sie eine Kontrollbedingung fest, die die Regel auslöst, je nachdem, welche Kategorie durchsucht wird oder nach welcher Anfrage gesucht wird. Die verfügbare Option hängt davon ab, ob Sie Kategorien durchsuchen oder Suchen ausgewählt haben:

   • Wenn Sie Kategorien durchsuchen ausgewählt haben: Geben Sie im Feld Kategorien ein, bei welchen Kategorien diese Steuerung ausgelöst werden soll.

   • Wenn Sie Suchen ausgewählt haben: Klicken Sie auf die Schaltfläche Abfrage hinzufügen, um zu filternde Suchbegriffe (z. B. running shoes) hinzuzufügen, und wählen Sie für jeden Begriff eine der folgenden Optionen aus:

     • Teilübereinstimmung: Dieses Steuerelement wird angewendet, wenn eine Suchanfrage eine Teilübereinstimmung mit diesem Suchbegriff enthält.
     • Vollständige Übereinstimmung: Dieses Steuerelement gilt nur, wenn eine Suchanfrage eine vollständige Übereinstimmung mit diesem Suchbegriff enthält.

     Wenn einer dieser Begriffe in einer Suchanfrage enthalten ist, wird die Einschränkung angewendet.

9. Optional: Klicken Sie auf den Button Zeitraum hinzufügen, um einen oder mehrere Zeiträume hinzuzufügen, für die diese Einstellung gelten soll.

10. Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

11. Fügen Sie im Feld Filteraktion Filter für Produktattribute hinzu.

    Verwenden Sie die unter Filtern und Sortieren dokumentierte Syntax des Filterausdrucks.

    So geben Sie beispielsweise rote und blaue Versionen von „product1“ und „product2“ an: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

12. Klicken Sie auf Weiter, um zum Abschnitt Serving-Konfigurationen zu gelangen.

13. Wählen Sie die Bereitstellungskonfigurationen aus, auf die das Steuerelement angewendet werden soll.

14. Übermitteln Sie Ihre Steuerungseinstellungen.

    Es dauert einige Minuten, bis neu erstellte oder aktualisierte Steuerelemente für die Bereitstellung von Live-Traffic verfügbar sind. Auf der Seite Bewerten in der Konsole können Sie testen, ob Ihre Änderungen angewendet wurden.

Das neue Steuerelement ist auf der Seite Steuerelemente auf dem Tab Steuerelemente für die Bereitstellung aufgeführt.

curl

Stellen Sie eine Control.create-Anfrage mit einer Kontroll-ID und einer Instanz von Control im Anfragetext.

Details zu den Feldern finden Sie in der Controls API-Referenz und der Controls.create API-Referenz.

Ein Filtersteuerelement kann ausgelöst werden, wenn ein Nutzer auf Ihrer Website in Kategorien stöbert (search.request.query ist leer) oder wenn ein Nutzer auf Ihrer Website sucht (search.request.query ist nicht leer).

Im folgenden Beispiel werden Felder für eine durch das Browsen ausgelöste Kontrollgruppe gezeigt, wobei searchSolutionUseCase auf SEARCH_SOLUTION_USE_CASE_BROWSE festgelegt ist.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \