Steuerelemente für die Bereitstellung erstellen

Merchandising-Konsole

1. Klicken Sie auf die URL, die Sie vom Administrator erhalten haben. Sign in (Anmelden).

   Dadurch gelangen Sie in der Merchandising Console zur Seite Steuerelemente.

2. Klicken Sie auf add_boxKontrollgruppe erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitrahmen. Alle Fragen müssen beantwortet werden. Klicken Sie auf Weiter.

4. Wählen Sie ein Steuerelement aus. Geben Sie den Namen für die Kontrollvariable ein, wählen Sie das Produkt Suche aus und wählen Sie dann den Kontrollvariablentyp Boost/Bury aus.

5. Konfigurieren Sie die Einstellung Hoch-/Herabstufung:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diesen Kontrolllauf auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. contains (enthält) oder not in range (nicht im Bereich). Wenn kein Katalogattribut konfiguriert wurde, wird diese Einstellung immer angewendet.

   2. Legen Sie einen Gültigkeitszeitraum fest, indem Sie einen Zeitraum eingeben. Wenn eine der angegebenen Zeitraumvorgaben erfüllt ist, wird das Katalogattribut in einem der angegebenen Zeiträume mit der Anfrage abgeglichen. Fügen Sie mit add_boxZeitraum hinzufügen einen Zeitraum hinzu.

   3. Definieren Sie die Boost-/Bury-Aktionen, die Sie mit dieser Einstellung auslösen möchten. Diese Aktionen werden durch ein Katalogattribut wie Farben, ein Kriterium wie enthält und einen Wert wie Rot definiert.

   4. Klicken Sie auf add_boxAttribut hinzufügen, um weitere Attribute hinzuzufügen.

6. Mit dem Schieberegler können Sie den Boost/Bury-Wert festlegen. Negative Zahlen stehen für „Vergraben“ und positive Zahlen für „Boost“.

7. Klicken Sie auf Senden, um Ihre Anfrage an einen Genehmiger zu senden. Den Status eingereichter Anfragen können Sie in der Merchandising Console einsehen. Wenn Sie Ihre Meinung ändern, können Sie Ihren Antrag auf Kontrolle löschen.

Cloud Console

1. Rufen Sie in der Search for Commerce Console die Seite 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 diese Einstellung 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 Suchanfragen fest, die diese Funktion auslösen können, je nachdem, ob eine bestimmte Kategorie aufgerufen oder nach einer bestimmten Suchanfrage 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, die gefiltert werden sollen. Wählen Sie für jeden Begriff entweder Teilweise Übereinstimmung oder Vollständige Übereinstimmung aus.

9. Optional: Klicken Sie auf die Schaltfläche 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 Bereich Bereitstellungskonfigurationen aus, auf welche Bereitstellungskonfigurationen 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. Sie können auf der Seite Bewerten in der Konsole 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 Kategorien durchsucht (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. Sie können auf der Seite Bewerten in der Konsole testen, ob Ihre Änderungen angewendet wurden.

Verwenden Sie die Methode ServingConfig.addControl, um einer Serving-Konfiguration eine Kontrollgruppe 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.

Merchandising-Konsole

1. Klicken Sie auf die URL, die Sie vom Administrator erhalten haben. Sign in (Anmelden).

   Dadurch gelangen Sie in der Merchandising Console zur Seite Steuerelemente.

2. Klicken Sie auf add_boxKontrollgruppe erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitrahmen. Alle Fragen müssen beantwortet werden. Klicken Sie auf Weiter.

4. Wählen Sie ein Steuerelement aus. Geben Sie einen Namen für das Steuerelement ein, wählen Sie das Produkt Browse (Durchsuchen) aus und wählen Sie dann den Steuerelementtyp Boost/Bury (Hervorheben/Ausblenden) aus.

5. Konfigurieren Sie die Einstellung Hoch-/Herabstufung:

   1. Geben Sie unter Trigger die Seitenkategorien ein, mit denen das Steuerelement ausgelöst werden soll. Wenn keine Katalogattribute konfiguriert sind, ist die Einstellung immer wirksam.

   2. Legen Sie einen Gültigkeitszeitraum fest, indem Sie einen Zeitraum eingeben. Wenn eine der angegebenen Zeitraumvorgaben erfüllt ist, wird das Katalogattribut in einem der angegebenen Zeiträume mit der Anfrage abgeglichen. Fügen Sie mit add_boxZeitraum hinzufügen einen Zeitraum hinzu.

   3. Definieren Sie die Boost-/Bury-Aktionen, die Sie mit dieser Einstellung auslösen möchten. Diese Aktionen werden durch ein Katalogattribut wie Farben, ein Kriterium wie enthält und einen Wert wie Rot definiert.

   4. Klicken Sie auf add_boxAttribut hinzufügen, um weitere Attribute hinzuzufügen.

6. Mit dem Schieberegler können Sie den Boost/Bury-Wert festlegen. Negative Zahlen bedeuten, dass die Inhalte vergraben werden, positive Zahlen, dass sie beworben werden.

7. Klicken Sie auf Senden, um Ihre Anfrage an einen Genehmiger zu senden. Den Status eingereichter Anfragen können Sie in der Merchandising Console einsehen. Wenn Sie Ihre Meinung ändern, können Sie Ihren Antrag auf Kontrolle löschen.

Cloud Console

1. Rufen Sie in der Search for Commerce Console die Seite 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 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. Sie können auf der Seite Bewerten in der Konsole 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. Sie können auf der Seite Bewerten in der Konsole testen, ob Ihre Änderungen angewendet wurden.

Verwenden Sie die Methode ServingConfig.addControl, um einer Serving-Konfiguration eine Kontrollgruppe 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.

Merchandising-Konsole

1. Klicken Sie auf die URL, die Sie vom Administrator erhalten haben. Sign in (Anmelden).

   Dadurch gelangen Sie in der Merchandising Console zur Seite Steuerelemente.

2. Klicken Sie auf add_boxKontrollgruppe erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitrahmen. Alle Fragen müssen beantwortet werden. Klicken Sie auf Weiter.

4. Wählen Sie ein Steuerelement aus. Geben Sie den Namen für das Steuerelement ein, wählen Sie das Produkt Suche oder Durchsuchen aus und wählen Sie dann den Steuerelementtyp Filter aus.

5. Konfigurieren Sie das Steuerelement Filter:

   1. Legen Sie unter Auslöser fest, durch welches Katalogattribut diese Einstellung ausgelöst wird. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage oder Seitenkategorie an, z. B. enthält oder nicht im Bereich. Wenn kein Katalogattribut konfiguriert wurde, wird diese Einstellung immer angewendet.

   2. Legen Sie einen Gültigkeitszeitraum fest, indem Sie einen Zeitraum eingeben. Wenn eine der angegebenen Zeitraumvorgaben erfüllt ist, wird das Katalogattribut in einem der angegebenen Zeiträume mit der Anfrage abgeglichen. Fügen Sie mit add_boxZeitraum hinzufügen einen Zeitraum hinzu.

   3. Definieren Sie die Filteraktionen, die Sie mit dieser Einstellung auslösen möchten. Diese Aktionen werden durch ein Katalogattribut wie Farben, ein Kriterium wie enthält und einen Wert wie Rot definiert.

   4. Klicken Sie auf add_boxAttribut hinzufügen, um weitere Attribute hinzuzufügen.

6. Klicken Sie auf Senden, um Ihre Anfrage an einen Genehmiger zu senden. Den Status eingereichter Anfragen können Sie in der Merchandising Console einsehen. Wenn Sie Ihre Meinung ändern, können Sie Ihren Antrag auf Kontrolle löschen.

Cloud Console

1. Rufen Sie in der Search for Commerce Console die Seite 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 Suche 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, und wählen Sie für jeden Begriff eine der folgenden Optionen aus:

     • Teilübereinstimmung: Diese Regel gilt, 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 Steuerung angewendet.

9. Optional: Klicken Sie auf die Schaltfläche 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. Sie können auf der Seite Bewerten in der Konsole 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" \
     --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"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "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": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

Verwenden Sie die Methode ServingConfig.addControl, um einer Serving-Konfiguration eine Kontrollgruppe 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.

Merchandising-Konsole

1. Klicken Sie auf die URL, die Sie vom Administrator erhalten haben. Sign in (Anmelden).

   Dadurch gelangen Sie in der Merchandising Console zur Seite Steuerelemente.

2. Klicken Sie auf add_boxKontrollgruppe erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitrahmen. Alle Fragen müssen beantwortet werden. Klicken Sie auf Weiter.

4. Wählen Sie ein Steuerelement aus. Geben Sie den Namen für die Einstellung ein, wählen Sie das Produkt Suche aus und wählen Sie dann den Einstellungstyp Weiterleitung aus.

5. Konfigurieren Sie die Steuerung Weiterleitung:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diesen Kontrolllauf auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. contains (enthält) oder not in range (nicht im Bereich). Wenn kein Katalogattribut konfiguriert wurde, wird diese Einstellung immer angewendet.

   2. Legen Sie einen Gültigkeitszeitraum fest, indem Sie einen Zeitraum eingeben. Wenn eine der angegebenen Zeitraumvorgaben erfüllt ist, wird das Katalogattribut in einem der angegebenen Zeiträume mit der Anfrage abgeglichen. Fügen Sie mit add_boxZeitraum hinzufügen einen Zeitraum hinzu.

   3. Definieren Sie die Weiterleitungsaktionen, die Sie mit dieser Einstellung auslösen möchten, indem Sie die Weiterleitungs-URL eingeben.

6. Klicken Sie auf Senden, um Ihre Anfrage an einen Genehmiger zu senden. Den Status eingereichter Anfragen können Sie in der Merchandising Console einsehen. Wenn Sie Ihre Meinung ändern, können Sie Ihren Antrag auf Kontrolle löschen.

Cloud Console

1. Rufen Sie in der Search for Commerce Console die Seite 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 Weiterleitungs-Kontrollvariablen als Kontrollvariablentyp aus.

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

7. Erstellen Sie mindestens einen Trigger für Suchbegriffe oder Zeiträume. Für Weiterleitungseinstellungen ist mindestens ein Trigger erforderlich:

8. 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).

9. 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 Suche 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, und wählen Sie für jeden Begriff eine der folgenden Optionen aus:

     • Teilübereinstimmung: Diese Regel gilt, 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 Steuerung angewendet.

10. Klicken Sie auf die Schaltfläche Zeitraum hinzufügen, um einen oder mehrere Zeiträume hinzuzufügen, für die diese Einstellung angewendet werden kann.

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

12. Geben Sie den URI ein, zu dem weitergeleitet werden soll, wenn dieses Steuerelement ausgelöst wird.

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

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

15. Übermitteln Sie Ihre Steuerungseinstellungen.

    Es dauert einige Minuten, bis neu erstellte oder aktualisierte Steuerelemente für die Bereitstellung von Live-Traffic verfügbar sind. Sie können auf der Seite Bewerten in der Konsole 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.

Eine Weiterleitungssteuerung kann ausgelöst werden, wenn ein Nutzer auf Ihrer Website nach Kategorien sucht (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": {
                  "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"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "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"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

Verwenden Sie die Methode ServingConfig.addControl, um einer Serving-Konfiguration eine Kontrollgruppe 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.

Merchandising-Konsole

1. Klicken Sie auf die URL, die Sie vom Administrator erhalten haben. Sign in (Anmelden).

   Dadurch gelangen Sie in der Merchandising Console zur Seite Steuerelemente.

2. Klicken Sie auf add_boxKontrollgruppe erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitrahmen. Alle Fragen müssen beantwortet werden. Klicken Sie auf Weiter.

4. Wählen Sie ein Steuerelement aus. Geben Sie einen Namen für die Einstellung ein, wählen Sie das Produkt Suche aus und wählen Sie dann den Einstellungstyp Synonyme aus.

5. Konfigurieren Sie die Einstellung Bidirektionale Synonyme:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diesen Kontrolllauf auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. contains (enthält) oder not in range (nicht im Bereich). Wenn kein Katalogattribut konfiguriert wurde, wird diese Einstellung immer angewendet.

   2. Legen Sie einen Gültigkeitszeitraum fest, indem Sie einen Zeitraum eingeben. Wenn eine der angegebenen Zeitraumvorgaben erfüllt ist, wird das Katalogattribut in einem der angegebenen Zeiträume mit der Anfrage abgeglichen. Fügen Sie mit add_boxZeitraum hinzufügen einen Zeitraum hinzu.

   3. Definieren Sie den Synonymtyp, den Sie mit dieser Einstellung auslösen möchten. Wählen Sie Bidirektional aus. Weitere Informationen zu Synonymtypen finden Sie im Abschnitt Synonyme.

6. Klicken Sie auf Senden. Daraufhin wird ein detaillierter Konfigurationsbildschirm für bidirektionale Synonyme angezeigt.

7. Geben Sie die Synonyme im Feld unter Two-way synonym actions (Aktionen mit bidirektionalen Synonymen) ein. Bei dieser Aktion werden Begriffe bidirektional verknüpft, damit sie in den Suchergebnissen gleich behandelt werden. Wenn also nach einem roten Sofa gesucht wird, werden auch rote Sofas in Kastanienbraun angezeigt. Bei der Suche nach einem kastanienbraunen Sofa werden alle Arten von roten Sofas berücksichtigt, z. B. karmesinrote oder rosafarbene.

8. Klicken Sie noch einmal auf Senden, um Ihre Anfrage an einen Genehmiger zu senden. Den Status eingereichter Anfragen können Sie in der Merchandising Console einsehen. Wenn Sie Ihre Meinung ändern, können Sie Ihren Antrag auf Kontrolle löschen.

Cloud Console

1. Rufen Sie in der Search for Commerce Console die Seite Steuerelemente auf.
   
   Zur Seite „Steuerelemente“

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

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

   Der Bereich Kontrollgruppe erstellen wird geöffnet.

4. Sie befinden sich dann im Abschnitt Einstellungen.

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

6. Wählen Sie Einstellung für bidirektionale Synonyme als Steuerungstyp aus.

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

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

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

10. Geben Sie im Feld Synonyms (Synonyme) 2 bis 100 Suchbegriffe ein, die Synonyme voneinander sein sollen, z. B. shirt und top.

    Wenn einer dieser Begriffe in einer Suchanfrage enthalten ist, betrachtet die Suche die anderen Suchbegriffe als Synonyme des enthaltenen Begriffs.

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

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

13. Übermitteln Sie Ihre Steuerungseinstellungen.

    Es dauert einige Minuten, bis neu erstellte oder aktualisierte Steuerelemente für die Bereitstellung von Live-Traffic verfügbar sind. Sie können auf der Seite Bewerten in der Konsole 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.

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" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                    ]
                },
                "twoWaySynonymAction": {
                  "synonyms": [
                    "SYNONYM_1",
                    "SYNONYM_2"
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

Verwenden Sie die Methode ServingConfig.addControl, um einer Serving-Konfiguration eine Kontrollgruppe hinzuzufügen. Weitere Informationen finden Sie unter Steuerelemente inline zu Bereitstellungskonfigurationen hinzufügen.

Merchandising-Konsole

1. Klicken Sie auf die URL, die Sie vom Administrator erhalten haben. Sign in (Anmelden).

   Dadurch gelangen Sie in der Merchandising Console zur Seite Steuerelemente.

2. Klicken Sie auf add_boxKontrollgruppe erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitrahmen. Alle Fragen müssen beantwortet werden. Klicken Sie auf Weiter.

4. Wählen Sie ein Steuerelement aus. Geben Sie einen Namen für die Einstellung ein, wählen Sie das Produkt Suche aus und wählen Sie dann den Einstellungstyp Synonyme aus.

5. Konfigurieren Sie die Einstellung für unidirektionale Synonyme:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diesen Kontrolllauf auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. contains (enthält) oder not in range (nicht im Bereich). Wenn kein Katalogattribut konfiguriert wurde, wird diese Einstellung immer angewendet.

   2. Legen Sie einen Gültigkeitszeitraum fest, indem Sie einen Zeitraum eingeben. Wenn eine der angegebenen Zeitraumvorgaben erfüllt ist, wird das Katalogattribut in einem der angegebenen Zeiträume mit der Anfrage abgeglichen. Fügen Sie mit add_boxZeitraum hinzufügen einen Zeitraum hinzu.

   3. Definieren Sie den Synonymtyp, den Sie mit dieser Einstellung auslösen möchten. Wählen Sie Einfache Fahrt aus. Weitere Informationen zu Synonymtypen finden Sie im Abschnitt Synonyme.

6. Klicken Sie auf Senden. Sie gelangen zu einem detaillierten Konfigurationsbildschirm für unidirektionale Synonyme.

7. Geben Sie Ihre Synonyme in das Feld unter Aktionen für unidirektionale Synonyme ein. Bei dieser Aktion werden Begriffe unidirektional verknüpft, damit sie in Suchergebnissen gleich behandelt werden. Wenn also nach einem roten Sofa gesucht wird, werden auch weinrote Sofas berücksichtigt. Wenn jedoch nach einem weinroten Sofa gesucht wird, werden keine anderen Arten von roten Sofas zurückgegeben. Die Ergebnisse werden also auf weinrote Sofas beschränkt.

8. Klicken Sie noch einmal auf Senden, um Ihre Anfrage an einen Genehmiger zu senden. Den Status eingereichter Anfragen können Sie in der Merchandising Console einsehen. Wenn Sie Ihre Meinung ändern, können Sie Ihren Antrag auf Kontrolle löschen.

Cloud Console

1. Rufen Sie in der Search for Commerce Console die Seite 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 Steuerelement für Einweg-Synonyme als Steuerungstyp aus.

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

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

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

9. Geben Sie im Feld Suchbegriffe Begriffe ein (z. B. shoes), denen Synonyme zugeordnet werden sollen, wenn einer von ihnen in einer Suchanfrage enthalten ist.

10. Geben Sie im Feld Synonyme Begriffe ein, die als Synonyme für die von Ihnen angegebenen Suchbegriffe verwendet werden sollen (z. B. sneakers und sandals als unidirektionale Synonyme für den Suchbegriff shoes).

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

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

13. Übermitteln Sie Ihre Steuerungseinstellungen.

    Es dauert einige Minuten, bis neu erstellte oder aktualisierte Steuerelemente für die Bereitstellung von Live-Traffic verfügbar sind. Sie können auf der Seite Bewerten in der Konsole 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.

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" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "oneWaySynonymAction": {
                  "synonyms": [
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "synonyms": [
                      "SYNONYM_1",
                      "SYNONYM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

Verwenden Sie die Methode ServingConfig.addControl, um einer Serving-Konfiguration eine Kontrollgruppe 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.

Merchandising-Konsole

1. Klicken Sie auf die URL, die Sie vom Administrator erhalten haben. Sign in (Anmelden).

   Dadurch gelangen Sie in der Merchandising Console zur Seite Steuerelemente.

2. Klicken Sie auf add_boxKontrollgruppe erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitrahmen. Alle Fragen müssen beantwortet werden. Klicken Sie auf Weiter.

4. Wählen Sie ein Steuerelement aus. Geben Sie den Namen für die Kontrollgruppe ein, wählen Sie das Produkt Suche aus und wählen Sie dann den Kontrollgruppentyp Nicht zuordnen aus.

5. Konfigurieren Sie das Steuerelement Nicht verknüpfen:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diesen Kontrolllauf auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. contains (enthält) oder not in range (nicht im Bereich). Wenn kein Katalogattribut konfiguriert wurde, wird diese Einstellung immer angewendet.

   2. Legen Sie einen Gültigkeitszeitraum fest, indem Sie einen Zeitraum eingeben. Wenn eine der angegebenen Zeitraumvorgaben erfüllt ist, wird das Katalogattribut in einem der angegebenen Zeiträume mit der Anfrage abgeglichen. Fügen Sie mit add_boxZeitraum hinzufügen einen Zeitraum hinzu.

   3. Geben Sie unter Aktionen nicht verknüpfen die Begriffe an, die nicht mit den Suchbegriffen verknüpft werden sollen, die Sie zuvor im Abschnitt Trigger eingegeben haben. Geben Sie sie in die entsprechenden Felder ein.

6. Klicken Sie auf Senden, um Ihre Steuerungsanfrage an einen Genehmiger zu senden. Den Status eingereichter Anfragen können Sie in der Merchandising Console einsehen. Wenn Sie Ihre Meinung ändern, können Sie Ihren Antrag auf Kontrolle löschen.

Cloud Console

1. Rufen Sie in der Search for Commerce Console die Seite 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 Do-Not-Associate-Steuerelement als Steuerelementtyp aus.

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

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

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

9. Geben Sie im Feld Suchbegriffe Begriffe ein, die Sie explizit von anderen unterscheiden möchten, z. B. gShoe.

10. Geben Sie im Feld Nicht verknüpfte Begriffe Begriffe ein, die nicht mit den von Ihnen angegebenen Suchbegriffen in den Suchergebnissen verknüpft werden sollen.

    Sie können beispielsweise den Suchbegriff gShoe vom Begriff cheap trennen.

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

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

13. Übermitteln Sie Ihre Steuerungseinstellungen.

    Es dauert einige Minuten, bis neu erstellte oder aktualisierte Steuerelemente für die Bereitstellung von Live-Traffic verfügbar sind. Sie können auf der Seite Bewerten in der Konsole 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.

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" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "doNotAssociateAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "doNotAssociateTerms": [
                      "DISSOCIATED_TERM_1",
                      "DISSOCIATED_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

Verwenden Sie die Methode ServingConfig.addControl, um einer Serving-Konfiguration eine Kontrollgruppe 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.

Merchandising-Konsole

1. Klicken Sie auf die URL, die Sie vom Administrator erhalten haben. Sign in (Anmelden).

   Dadurch gelangen Sie in der Merchandising Console zur Seite Steuerelemente.

2. Klicken Sie auf add_boxKontrollgruppe erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitrahmen. Alle Fragen müssen beantwortet werden. Klicken Sie auf Weiter.

4. Wählen Sie ein Steuerelement aus. Geben Sie den Namen für die Einstellung ein, wählen Sie das Produkt Suche aus und wählen Sie dann den Einstellungstyp Ignorieren aus.

5. Konfigurieren Sie die Einstellung Ignorieren:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diesen Kontrolllauf auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. contains (enthält) oder not in range (nicht im Bereich). Wenn kein Katalogattribut konfiguriert wurde, wird diese Einstellung immer angewendet.

   2. Legen Sie einen Gültigkeitszeitraum fest, indem Sie einen Zeitraum eingeben. Wenn eine der angegebenen Zeitraumvorgaben erfüllt ist, wird das Katalogattribut in einem der angegebenen Zeiträume mit der Anfrage abgeglichen. Fügen Sie mit add_boxZeitraum hinzufügen einen Zeitraum hinzu.

   3. Geben Sie unter Aktionen ignorieren die Begriffe ein, die ignoriert werden sollen.

6. Klicken Sie auf Senden, um Ihre Anfrage an einen Genehmiger zu senden. Den Status eingereichter Anfragen können Sie in der Merchandising Console einsehen. Wenn Sie Ihre Meinung ändern, können Sie Ihren Antrag auf Kontrolle löschen.

Cloud Console

1. Rufen Sie in der Search for Commerce Console die Seite 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 Do-Not-Associate-Steuerelement als Steuerelementtyp aus.

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

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

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

9. Geben Sie im Feld Begriffe ignorieren Begriffe ein (z. B. shoddy), die bei einer Suche ignoriert werden sollen, wenn sie als Suchbegriffe eingegeben werden.

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. Sie können auf der Seite Bewerten in der Konsole 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.

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" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "ignoreAction": {
                  "ignoreTerms": [
                      "IGNORE_TERM_1",
                      "IGNORE_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

Verwenden Sie die Methode ServingConfig.addControl, um einer Serving-Konfiguration eine Kontrollgruppe 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.

Merchandising-Konsole

1. Klicken Sie auf die URL, die Sie vom Administrator erhalten haben. Sign in (Anmelden).

   Dadurch gelangen Sie in der Merchandising Console zur Seite Steuerelemente.

2. Klicken Sie auf add_boxKontrollgruppe erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitrahmen. Alle Fragen müssen beantwortet werden. Klicken Sie auf Weiter.

4. Wählen Sie ein Steuerelement aus. Geben Sie den Namen für die Einstellung ein, wählen Sie das Produkt Suche aus und wählen Sie dann den Einstellungstyp Ersatz aus.

5. Konfigurieren Sie die Kontrollgruppe Replacement:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diesen Kontrolllauf auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. contains (enthält) oder not in range (nicht im Bereich). Wenn kein Katalogattribut konfiguriert wurde, wird diese Einstellung immer angewendet.

   2. Legen Sie einen Gültigkeitszeitraum fest, indem Sie einen Zeitraum eingeben. Wenn eine der angegebenen Zeitraumvorgaben erfüllt ist, wird das Katalogattribut in einem der angegebenen Zeiträume mit der Anfrage abgeglichen. Fügen Sie mit add_boxZeitraum hinzufügen einen Zeitraum hinzu.

   3. Geben Sie unter Ersetzungsaktionen im ersten Feld die Abfragebegriffe ein,die ersetzt werden sollen, und im zweiten Feld die Ersatzbegriffe.

6. Klicken Sie auf Senden, um Ihre Steuerungsanfrage an einen Genehmiger zu senden. Den Status eingereichter Anfragen können Sie in der Merchandising Console einsehen. Wenn Sie Ihre Meinung ändern, können Sie Ihren Antrag auf Kontrolle löschen.

Cloud Console

1. Rufen Sie in der Search for Commerce Console die Seite 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 als Steuerungstyp Steuerelement zur Ersetzung aus.

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

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

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

9. Geben Sie im Feld Suchbegriffe Suchbegriffe ein, die durch den Ersatzbegriff ersetzt werden sollen (z. B. gShoe).

10. Geben Sie im Feld Ersatzbegriff den Begriff ein, der die von Ihnen angegebenen Suchbegriffe ersetzen soll.

    Sie können beispielsweise den Suchbegriff gShoe durch den Ersatzbegriff Google Shoe ersetzen.

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

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

13. Übermitteln Sie Ihre Steuerungseinstellungen.

    Es dauert einige Minuten, bis neu erstellte oder aktualisierte Steuerelemente für die Bereitstellung von Live-Traffic verfügbar sind. Sie können auf der Seite Bewerten in der Konsole 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.

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" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "replacementAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "replacementTerm": "REPLACEMENT_TERM"
                  }
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
  

Verwenden Sie die Methode ServingConfig.addControl, um einer Serving-Konfiguration eine Kontrollgruppe 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.

Merchandising-Konsole

1. Klicken Sie auf die URL, die Sie vom Administrator erhalten haben. Sign in (Anmelden).

   Dadurch gelangen Sie in der Merchandising Console zur Seite Steuerelemente.

2. Klicken Sie auf add_boxKontrollgruppe erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitrahmen. Alle Fragen müssen beantwortet werden. Klicken Sie auf Weiter.

4. Wählen Sie ein Steuerelement aus. Geben Sie den Namen für die Kontrollgruppe ein, wählen Sie das Produkt Suche aus und wählen Sie dann den Kontrollgruppentyp Anpinnen aus.

5. Konfigurieren Sie die Einstellung Anpinnen:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diesen Kontrolllauf auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. contains (enthält) oder not in range (nicht im Bereich). Wenn kein Katalogattribut konfiguriert wurde, wird diese Einstellung immer angewendet.

   2. Legen Sie einen Gültigkeitszeitraum fest, indem Sie einen Zeitraum eingeben. Wenn eine der angegebenen Zeitraumvorgaben erfüllt ist, wird das Katalogattribut in einem der angegebenen Zeiträume mit der Anfrage abgeglichen. Fügen Sie mit add_boxZeitraum hinzufügen einen Zeitraum hinzu.

   3. Definieren Sie die Aktionen zum Anpinnen, die Sie mit dieser Einstellung auslösen möchten. Diese Aktionen werden durch die Produkt-ID und die Position des Pins definiert, vorzugsweise eine Zahl unter 120 (der typischen Seitengröße). Sie können auf add_boxProdukt hinzufügen klicken und bis zu 10 Produkte hinzufügen.

6. Klicken Sie auf Senden, um Ihre Anfrage an einen Genehmiger zu senden. Den Status eingereichter Anfragen können Sie in der Merchandising Console einsehen. Wenn Sie Ihre Meinung ändern, können Sie Ihren Antrag auf Kontrolle löschen.

Cloud Console

1. Rufen Sie in der Search for Commerce Console die Seite 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 im Bereich Produktauswahl die Option Suchen oder durchsuchen aus.

6. Wählen Sie Steuerung durch Anpinnen als Steuerungstyp aus. Klicken Sie auf Weiter.

7. Wählen Sie im Abschnitt Trigger das Nutzerverhalten aus, das diese Steuerung auslöst:

   • Kategorien durchsuchen: Bei Browse-Anfragen muss das Feld page_categories ausgefüllt sein und search.request.query muss leer sein.

   • Suche: Für Suchanfragen muss nur search.request.query ausgefüllt werden.

     Standardmäßig wird diese Einstellung durch alle aufgerufenen Kategorien und Suchanfragen ausgelöst.

8. Optional: Legen Sie eine Bedingung fest, die die Regel basierend auf einer bestimmten Kategorie oder Suchanfrage auslöst:

   • Kategorien durchsuchen: Geben Sie im Feld Kategorien ein, welche Kategorien die Kontrollgruppe auslösen.

   • Suche: Wenn Sie Suchbegriffe hinzufügen möchten, nach denen gefiltert werden soll (z. B. running shoes), klicken Sie auf Suchanfrage hinzufügen. Wählen Sie für jeden Begriff Teilübereinstimmung oder Genaue Übereinstimmung aus.

9. Optional: Klicken Sie auf Zeitraum hinzufügen oder 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. Verwenden Sie für Pin location (Position anpinnen) den Schieberegler, um die Position anzugeben, an der die Produkte angepinnt werden sollen. Der Schieberegler für den Pin-Wert akzeptiert keine Werte von 0, keine negativen Zahlen und keine nicht ganzzahligen Werte.

    Mit Vertex AI Search for Commerce können Sie bis zu 10 Pins in der Pin-Karte einer einzelnen Kontrollgruppe platzieren. Die Position kann ein beliebiger Wert zwischen 1 und 120 (der maximalen Seitengröße für Anfragen) sein.

11. Klicken Sie auf Weiter, um zum Abschnitt Serving-Konfigurationen zu gelangen. Wählen Sie die Bereitstellungskonfigurationen aus, auf die das Steuerelement angewendet werden soll, und senden Sie Ihre Steuerungseinstellungen.

    Es dauert einige Minuten, bis neu erstellte oder aktualisierte Steuerelemente für die Bereitstellung von Live-Traffic verfügbar sind. Sie können auf der Seite Bewerten in der Konsole 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.

curl -X POST \
 -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 -H "Content-Type: application/json; charset=utf-8" \
 -H "X-Goog-User-Project: PROJECT_NUMBER" \
 --data '{
          "displayName": "DisplayName",
          "solutionTypes": "SOLUTION_TYPE_SEARCH",
          "searchSolutionUseCase": ["SEARCH_SOLUTION_USE_CASE_SEARCH"],
     "rule": {
            "condition": {
 "queryTerms": [
                {
                  "value": "Term1",
                  "fullMatch": "boolean: true / false"
                },
                {
                  "value": "Term2",
                  "fullMatch": "boolean: true / false"
                },
             ],
             "activeTimeRange": [
               {
                 "startTime": timestamp1,
                 "endTime": timestamp2
               },
               {
                 "startTime": timestamp3,
                 "endTime": timestamp4
               }
             ]
            },
            "pinAction": {
               "pinMap" :  {
                        "pin_position1": "product_id",
                      "pin_position2": "product_id>"
                    }
            }
              }
}' \
"https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/controls?controlId=CONTROL_ID"

pin_position muss eine Ganzzahl zwischen 1 und 10 (jeweils einschließlich) sein und product_id muss in Ihrem Katalog vorhanden sein. Die maximal zulässige Anzahl von Elementen in der Pin-Karte beträgt 10 für jedes Steuerelement.

Hängen Sie als Nächstes das Steuerelement für das Anpinnen an Ihre Bereitstellungskonfiguration an:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "X-Goog-User-Project: PROJECT_NUMBER" \
-d '{
      "controlId": "CONTROL_ID"
  }' \
'https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

In diesem Fall sollte CONTROL_ID die zuvor erstellte Fixierungssteuerung id sein.

Verwenden Sie die Methode ServingConfig.addControl, um einer Serving-Konfiguration eine Kontrollgruppe 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 Search for Commerce Console die Seite Bewerten auf.
   
   Zur Seite „Bewerten“

2. Rufen Sie den Tab Suche auf.

3. Geben Sie eine Testanfrage in das Feld „Suchanfrage“ ein.

4. Klicken Sie auf Suchvorschau.

5. Sehen Sie sich die Ergebnisse an, um zu prüfen, ob die ausgewählten Produkte angepinnt sind.

curl

curl -s -X POST -H "Authorization: Bearer " -H "Content-Type: application/json"
--data "{'query': '','visitorId': ''}" \ "https://retail.googleapis.com/v2/projects/PROJECT/locations/global/catalogs/CATALOG/placements/default_search:search"