Steuerelemente für die Bereitstellung erstellen

Merchandising-Konsole

1. Klicken Sie auf die vom Administrator angegebene URL. Sign in (Anmelden).

   Daraufhin wird die Seite Einstellungen in der Merchandising Console geöffnet.

2. Klicken Sie auf add_boxSteuerelement erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitplan. 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 und dann den Steuerelementtyp Boost-/Bury-Element aus.

5. Konfigurieren Sie die Einstellung für Hoch-/Herabstufung:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diese Steuerung auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. enthält oder nicht im Bereich. Wenn kein Katalogattribut konfiguriert wurde, gilt diese Einstellung immer.

   2. Geben Sie einen Zeitraum ein, um einen Gültigen Zeitraum festzulegen. Wenn einer der angegebenen Zeiträume erfüllt ist, wird das Katalogattribut in diesem Zeitraum mit der Suchanfrage abgeglichen. Fügen Sie einen Zeitraum mit add_boxZeitraum hinzufügen hinzu.

   3. Definieren Sie die Boost-/Bury-Aktionen, die Sie mit diesem Steuerelement auslösen möchten. Diese Aktionen werden durch ein Katalogattribut wie colors, 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 sind „bury“ (begraben) und positive Zahlen sind „boost“ (Boost).

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

Cloud Console

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

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

   Der Bereich Steuerelement erstellen wird geöffnet.

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

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

5. Wählen Sie im Bereich Produktauswahl die Option Suchen aus.

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

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

   • In Kategorien stöbern: Die Regel wird ausgelöst, wenn ein Nutzer Kategorien auf Ihrer Website besucht (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 festlegen möchten, dass diese Steuerung ausgelöst wird, wenn eine Kategorie aufgerufen oder eine Suchanfrage gestellt wird, überspringen Sie den folgenden Schritt.

8. Optional: Legen Sie bestimmte Kategorien oder Suchanfragen fest, die diese Steuerung 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, welche Kategorien dieses Steuerelement beim Stöbern auslösen sollen.

   • 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 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 angewendet werden kann.

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 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 prüfen, 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.

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

Eine Funktion zum Optimieren oder Ausblenden kann ausgelöst werden, wenn ein Nutzer Kategorien auf Ihrer Website durchsucht (search.request.query ist leer) oder wenn ein Nutzer auf Ihrer Website sucht (search.request.query ist nicht leer).

Das folgende Beispiel zeigt Felder für ein durch das Surfen ausgelöstes Steuerelement, bei dem searchSolutionUseCase auf SEARCH_SOLUTION_USE_CASE_BROWSE gesetzt 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"

Das folgende Beispiel zeigt Felder für ein suchereignisabhängiges Steuerelement, bei dem searchSolutionUseCase auf SEARCH_SOLUTION_USE_CASE_SEARCH gesetzt 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 prüfen, 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 ServingConfig.addControl API-Referenz.

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

Merchandising-Konsole

1. Klicken Sie auf die vom Administrator angegebene URL. Sign in (Anmelden).

   Daraufhin wird die Seite Einstellungen in der Merchandising Console geöffnet.

2. Klicken Sie auf add_boxSteuerelement erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitplan. 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 Suchen und dann den Steuerelementtyp Boost-/Bury-Element aus.

5. Konfigurieren Sie die Einstellung für Hoch-/Herabstufung:

   1. Geben Sie unter Trigger die Seitenkategorien ein, die das Steuerelement auslösen sollen. Wenn keine Katalogattribute konfiguriert sind, ist diese Einstellung immer wirksam.

   2. Geben Sie einen Zeitraum ein, um einen Gültigen Zeitraum festzulegen. Wenn einer der angegebenen Zeiträume erfüllt ist, wird das Katalogattribut in diesem Zeitraum mit der Suchanfrage abgeglichen. Fügen Sie einen Zeitraum mit add_boxZeitraum hinzufügen hinzu.

   3. Definieren Sie die Boost-/Bury-Aktionen, die Sie mit diesem Steuerelement auslösen möchten. Diese Aktionen werden durch ein Katalogattribut wie colors, 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 sind „vergraben“, positive Zahlen sind „hervorgehoben“.

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

Cloud Console

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

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

   Der Bereich Steuerelement erstellen wird geöffnet.

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

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

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

6. Wählen Sie als Steuerelementtyp Boost-/Bury-Steuerelemente 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 Filterempfehlungen 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 Auslieferungskonfigurationen 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 prüfen, 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.

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

Verwenden Sie zum Erstellen eines Filterausdrucks die unter Filterempfehlungen dokumentierte Syntax.

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 prüfen, 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 ServingConfig.addControl API-Referenz.

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

Merchandising-Konsole

1. Klicken Sie auf die vom Administrator angegebene URL. Sign in (Anmelden).

   Daraufhin wird die Seite Einstellungen in der Merchandising Console geöffnet.

2. Klicken Sie auf add_boxSteuerelement erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitplan. 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 Suchen oder Durchsuchen aus und wählen Sie dann den Steuerelementtyp Filter aus.

5. Konfigurieren Sie das Steuerelement Filter:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diese Einstellung auslöst. 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, gilt diese Einstellung immer.

   2. Geben Sie einen Zeitraum ein, um einen Gültigen Zeitraum festzulegen. Wenn einer der angegebenen Zeiträume erfüllt ist, wird das Katalogattribut in diesem Zeitraum mit der Suchanfrage abgeglichen. Fügen Sie einen Zeitraum mit add_boxZeitraum hinzufügen hinzu.

   3. Definieren Sie die Filteraktionen, die Sie mit diesem Steuerelement auslösen möchten. Diese Aktionen werden durch ein Katalogattribut wie colors, 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 die Anfrage an einen Genehmiger zu senden. Den Status der eingereichten Anfragen kannst du in der Merchandising Console einsehen. Wenn Sie Ihre Meinung ändern, können Sie Ihren Antrag auf Datenleihe jederzeit löschen.

Cloud Console

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

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

   Der Bereich Steuerelement erstellen wird geöffnet.

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

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

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

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

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

   • In Kategorien stöbern: Die Regel wird ausgelöst, wenn ein Nutzer Kategorien auf Ihrer Website besucht (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 aufgerufen oder nach welcher Suchanfrage gesucht wird. Welche Option verfügbar ist, hängt davon ab, ob Sie Kategorien ansehen oder Suchen ausgewählt haben:

   • Wenn Sie Kategorien durchsuchen ausgewählt haben: Geben Sie im Feld Kategorien ein, welche Kategorien dieses Steuerelement beim Stöbern auslösen sollen.

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

     • Teilübereinstimmung: Diese Option gilt, wenn eine Suchanfrage eine Teilübereinstimmung mit diesem Suchbegriff enthält.
     • Vollständige Übereinstimmung: Diese Option 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 Einstellung 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 angewendet werden kann.

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 Auslieferungskonfigurationen 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 prüfen, 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.

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

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

Das folgende Beispiel zeigt Felder für ein durch das Surfen ausgelöstes Steuerelement, bei dem searchSolutionUseCase auf SEARCH_SOLUTION_USE_CASE_BROWSE gesetzt 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"

Das folgende Beispiel zeigt Felder für ein suchereignisabhängiges Steuerelement, bei dem searchSolutionUseCase auf SEARCH_SOLUTION_USE_CASE_SEARCH gesetzt 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 Bereitstellungskonfiguration ein Steuerelement hinzuzufügen:

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

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

Merchandising-Konsole

1. Klicken Sie auf die vom Administrator angegebene URL. Sign in (Anmelden).

   Daraufhin wird die Seite Einstellungen in der Merchandising Console geöffnet.

2. Klicken Sie auf add_boxSteuerelement erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitplan. 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 und dann den Steuerelementtyp Weiterleiten aus.

5. Konfigurieren Sie die Weiterleitung:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diese Steuerung auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. enthält oder nicht im Bereich. Wenn kein Katalogattribut konfiguriert wurde, gilt diese Einstellung immer.

   2. Geben Sie einen Zeitraum ein, um einen Gültigen Zeitraum festzulegen. Wenn einer der angegebenen Zeiträume erfüllt ist, wird das Katalogattribut in diesem Zeitraum mit der Suchanfrage abgeglichen. Fügen Sie einen Zeitraum mit add_boxZeitraum hinzufügen hinzu.

   3. Geben Sie die Weiterleitungsaktionen ein, die Sie mit diesem Steuerelement auslösen möchten.

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

Cloud Console

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

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

   Der Bereich Steuerelement erstellen wird geöffnet.

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

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

5. Wählen Sie als Steuerelementtyp Weiterleitungssteuerungen aus.

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

7. Erstellen Sie mindestens einen Trigger für Suchbegriffe oder einen Zeitbereich. Für Weiterleitungssteuerungen ist mindestens ein Trigger erforderlich:

8. Wählen Sie aus, durch welche Art von Nutzerverhalten diese Einstellung ausgelöst wird:

   • In Kategorien stöbern: Die Regel wird ausgelöst, wenn ein Nutzer Kategorien auf Ihrer Website besucht (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 aufgerufen oder nach welcher Suchanfrage gesucht wird. Welche Option verfügbar ist, hängt davon ab, ob Sie Kategorien ansehen oder Suchen ausgewählt haben:

   • Wenn Sie Kategorien durchsuchen ausgewählt haben: Geben Sie im Feld Kategorien ein, welche Kategorien dieses Steuerelement beim Stöbern auslösen sollen.

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

     • Teilübereinstimmung: Diese Option gilt, wenn eine Suchanfrage eine Teilübereinstimmung mit diesem Suchbegriff enthält.
     • Vollständige Übereinstimmung: Diese Option 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 Einstellung angewendet.

10. Klicken Sie auf die Schaltfläche Zeitraum hinzufügen, um einen oder mehrere Zeiträume hinzuzufügen, in denen 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 Auslieferungskonfigurationen 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 prüfen, 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.

Weitere Informationen 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 Kategorien auf Ihrer Website durchsucht (search.request.query ist leer) oder wenn ein Nutzer auf Ihrer Website sucht (search.request.query ist nicht leer).

Das folgende Beispiel zeigt Felder für ein durch das Surfen ausgelöstes Steuerelement, bei dem searchSolutionUseCase auf SEARCH_SOLUTION_USE_CASE_BROWSE gesetzt 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"

Das folgende Beispiel zeigt Felder für ein suchereignisabhängiges Steuerelement, bei dem searchSolutionUseCase auf SEARCH_SOLUTION_USE_CASE_SEARCH gesetzt 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 Bereitstellungskonfiguration ein Steuerelement hinzuzufügen:

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

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

Merchandising-Konsole

1. Klicken Sie auf die vom Administrator angegebene URL. Sign in (Anmelden).

   Daraufhin wird die Seite Einstellungen in der Merchandising Console geöffnet.

2. Klicken Sie auf add_boxSteuerelement erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitplan. 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 und dann den Steuerelementtyp Synonyme aus.

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

   1. Legen Sie unter Trigger fest, welches Katalogattribut diese Steuerung auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. enthält oder nicht im Bereich. Wenn kein Katalogattribut konfiguriert wurde, gilt diese Einstellung immer.

   2. Geben Sie einen Zeitraum ein, um einen Gültigen Zeitraum festzulegen. Wenn einer der angegebenen Zeiträume erfüllt ist, wird das Katalogattribut in diesem Zeitraum mit der Suchanfrage abgeglichen. Fügen Sie einen Zeitraum mit add_boxZeitraum hinzufügen hinzu.

   3. Legen Sie den Synonymtyp fest, den Sie mit diesem Steuerelement auslösen möchten. Wählen Sie Zwei-Wege aus. Weitere Informationen zu Synonymetypen finden Sie im Abschnitt Synonyme.

6. Klicken Sie auf Senden. Daraufhin wird der detaillierte Konfigurationsbildschirm für Zwei-Wege-Synonyme geöffnet.

7. Geben Sie die Synonyme in das Feld unter Zwei-Wege-Synonymeinträge ein. Bei dieser Aktion werden Begriffe bidirektional verknüpft, damit sie in den Suchergebnissen gleich behandelt werden. Eine Suchanfrage nach einem roten Sofa führt also zu Ergebnissen für ein rot-maroonfarbenes Sofa, aber Suchanfragen nach einem maroonfarbenen Sofa werden auf alle Arten von roten Sofas ausgeweitet, z. B. auf karmesinrote oder rosafarbene Sofas.

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

Cloud Console

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

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

3. Geben Sie im Feld Steuerelementname einen Namen für das neue Steuerelement ein.

   Der Bereich Steuerelement erstellen wird geöffnet.

4. Sie befinden sich jetzt im Bereich Einstellungen.

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

6. Wählen Sie als Steuerungstyp Einstellung für bidirektionale Synonyme 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 angewendet werden kann.

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

10. Geben Sie im Feld Synonyme zwei bis 100 Suchbegriffe ein (z. B. shirt und top), die Synonyme füreinander sein sollen.

    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 Auslieferungskonfigurationen 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 prüfen, 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.

Weitere Informationen 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 Bereitstellungskonfiguration ein Steuerelement hinzuzufügen. Weitere Informationen finden Sie unter Steuerelemente inline zu Bereitstellungskonfigurationen hinzufügen.

Merchandising-Konsole

1. Klicken Sie auf die vom Administrator angegebene URL. Sign in (Anmelden).

   Daraufhin wird die Seite Einstellungen in der Merchandising Console geöffnet.

2. Klicken Sie auf add_boxSteuerelement erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitplan. 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 und dann den Steuerelementtyp Synonyme aus.

5. Unidirektionale Synonymeinstellung konfigurieren:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diese Steuerung auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. enthält oder nicht im Bereich. Wenn kein Katalogattribut konfiguriert wurde, gilt diese Einstellung immer.

   2. Geben Sie einen Zeitraum ein, um einen Gültigen Zeitraum festzulegen. Wenn einer der angegebenen Zeiträume erfüllt ist, wird das Katalogattribut in diesem Zeitraum mit der Suchanfrage abgeglichen. Fügen Sie einen Zeitraum mit add_boxZeitraum hinzufügen hinzu.

   3. Legen Sie den Synonymtyp fest, den Sie mit diesem Steuerelement auslösen möchten. Wählen Sie Einweg aus. Weitere Informationen zu Synonymetypen finden Sie im Abschnitt Synonyme.

6. Klicken Sie auf Senden. Daraufhin wird ein detaillierter Konfigurationsbildschirm für Einwegsynonyme geöffnet.

7. Geben Sie Ihre Synonyme in das Feld unter Einweg-Synonymeinträge ein. Bei dieser Aktion werden Begriffe einseitig miteinander verknüpft, damit sie in den Suchergebnissen gleich behandelt werden. Eine Suchanfrage nach einem roten Sofa umfasst also auch bordeauxrote Sofas, eine Suchanfrage nach einem bordeauxroten Sofa hingegen nicht andere Arten von roten Sofas. Die Ergebnisse werden also auf bordeauxrote Sofas beschränkt.

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

Cloud Console

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

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

   Der Bereich Steuerelement erstellen wird geöffnet.

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

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

5. Wählen Sie als Steuerelementtyp Steuerelement für Einweg-Synonyme 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 angewendet werden kann.

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

9. Geben Sie im Feld Suchbegriffe Begriffe ein (z. B. shoes), für die Synonyme verknüpft werden sollen, wenn sie in einer Suchanfrage enthalten sind.

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

11. Klicken Sie auf Weiter, um zum Abschnitt Auslieferungskonfigurationen 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 prüfen, 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.

Weitere Informationen 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 Bereitstellungskonfiguration ein Steuerelement hinzuzufügen:

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

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

Merchandising-Konsole

1. Klicken Sie auf die vom Administrator angegebene URL. Sign in (Anmelden).

   Daraufhin wird die Seite Einstellungen in der Merchandising Console geöffnet.

2. Klicken Sie auf add_boxSteuerelement erstellen.

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

4. Wählen Sie ein Steuerelement aus. Geben Sie den Namen für die Steuerung ein, wählen Sie das Produkt Suche und dann den Steuerelementtyp Nicht verknüpfen aus.

5. Konfigurieren Sie das Steuerelement Nicht verknüpfen:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diese Steuerung auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. enthält oder nicht im Bereich. Wenn kein Katalogattribut konfiguriert wurde, gilt diese Einstellung immer.

   2. Geben Sie einen Zeitraum ein, um einen Gültigen Zeitraum festzulegen. Wenn einer der angegebenen Zeiträume erfüllt ist, wird das Katalogattribut in diesem Zeitraum mit der Suchanfrage abgeglichen. Fügen Sie einen Zeitraum mit add_boxZeitraum hinzufügen hinzu.

   3. Geben Sie unter Aktionen nicht verknüpfen die Begriffe an, die nicht mit den Suchbegriffen verknüpft werden sollen, die Sie im vorherigen Abschnitt Trigger eingegeben haben. Geben Sie sie in die Felder „Suchbegriffe“ und „Nicht verknüpfte Begriffe“ ein.

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

Cloud Console

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

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

   Der Bereich Steuerelement erstellen wird geöffnet.

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

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

5. Wählen Sie als Steuerelementtyp Steuerelement nicht verknüpfen 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 angewendet werden kann.

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

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

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

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

11. Klicken Sie auf Weiter, um zum Abschnitt Auslieferungskonfigurationen 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 prüfen, 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.

Weitere Informationen 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 Bereitstellungskonfiguration ein Steuerelement hinzuzufügen:

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

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

Merchandising-Konsole

1. Klicken Sie auf die vom Administrator angegebene URL. Sign in (Anmelden).

   Daraufhin wird die Seite Einstellungen in der Merchandising Console geöffnet.

2. Klicken Sie auf add_boxSteuerelement erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitplan. 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 und dann den Steuerelementtyp Ignorieren aus.

5. Konfigurieren Sie die Einstellung Ignorieren:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diese Steuerung auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. enthält oder nicht im Bereich. Wenn kein Katalogattribut konfiguriert wurde, gilt diese Einstellung immer.

   2. Geben Sie einen Zeitraum ein, um einen Gültigen Zeitraum festzulegen. Wenn einer der angegebenen Zeiträume erfüllt ist, wird das Katalogattribut in diesem Zeitraum mit der Suchanfrage abgeglichen. Fügen Sie einen Zeitraum mit add_boxZeitraum hinzufügen hinzu.

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

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

Cloud Console

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

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

   Der Bereich Steuerelement erstellen wird geöffnet.

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

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

5. Wählen Sie als Steuerelementtyp Steuerelement nicht verknüpfen 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 angewendet werden kann.

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 Auslieferungskonfigurationen 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 prüfen, 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.

Weitere Informationen 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 Bereitstellungskonfiguration ein Steuerelement hinzuzufügen:

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

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

Merchandising-Konsole

1. Klicken Sie auf die vom Administrator angegebene URL. Sign in (Anmelden).

   Daraufhin wird die Seite Einstellungen in der Merchandising Console geöffnet.

2. Klicken Sie auf add_boxSteuerelement erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitplan. 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 und dann den Steuerelementtyp Ersatz aus.

5. Konfigurieren Sie das Steuerelement Ersatz:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diese Steuerung auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. enthält oder nicht im Bereich. Wenn kein Katalogattribut konfiguriert wurde, gilt diese Einstellung immer.

   2. Geben Sie einen Zeitraum ein, um einen Gültigen Zeitraum festzulegen. Wenn einer der angegebenen Zeiträume erfüllt ist, wird das Katalogattribut in diesem Zeitraum mit der Suchanfrage abgeglichen. Fügen Sie einen Zeitraum mit add_boxZeitraum hinzufügen hinzu.

   3. Geben Sie unter Ersatzaktionen die Suchbegriffe,die ersetzt werden sollen, im ersten Feld und die Ersatzbegriffe im zweiten Feld an.

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

Cloud Console

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

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

   Der Bereich Steuerelement erstellen wird geöffnet.

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

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

5. Wählen Sie als Steuerelementtyp 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 angewendet werden kann.

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

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

10. Geben Sie im Feld Ersatzbegriff den Begriff ein, der die zuvor 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 Auslieferungskonfigurationen 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 prüfen, 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.

Weitere Informationen 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 Bereitstellungskonfiguration ein Steuerelement hinzuzufügen:

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

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

Merchandising-Konsole

1. Klicken Sie auf die vom Administrator angegebene URL. Sign in (Anmelden).

   Daraufhin wird die Seite Einstellungen in der Merchandising Console geöffnet.

2. Klicken Sie auf add_boxSteuerelement erstellen.

3. Definieren Sie die Ziele für Ihre Endnutzer und den erforderlichen Zeitplan. 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 und dann den Steuerelementtyp Anpinnen aus.

5. Konfigurieren Sie die Anpinning-Steuerung:

   1. Legen Sie unter Trigger fest, welches Katalogattribut diese Steuerung auslöst. Geben Sie dazu Kriterien für eine zugehörige Suchanfrage an, z. B. enthält oder nicht im Bereich. Wenn kein Katalogattribut konfiguriert wurde, gilt diese Einstellung immer.

   2. Geben Sie einen Zeitraum ein, um einen Gültigen Zeitraum festzulegen. Wenn einer der angegebenen Zeiträume erfüllt ist, wird das Katalogattribut in diesem Zeitraum mit der Suchanfrage abgeglichen. Fügen Sie einen Zeitraum mit add_boxZeitraum hinzufügen hinzu.

   3. Definieren Sie die Anpinnen-Aktionen, die Sie mit diesem Steuerelement auslösen möchten. Diese Aktionen werden durch die Produkt-ID und die Markierungsposition definiert, vorzugsweise eine Zahl unter 120 (die typische Seitengröße). Sie können auf add_boxProdukt hinzufügen klicken und bis zu zehn hinzufügen.

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

Cloud Console

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

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

   Der Bereich Steuerelement erstellen wird geöffnet.

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

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

5. Wählen Sie im Bereich Produktauswahl die Option Suchen oder Durchsuchen aus.

6. Wählen Sie als Steuerelementtyp Anpinnen-Steuerelement aus. Klicken Sie auf Weiter.

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

   • Kategorien durchsuchen: Bei Suchanfragen muss das Feld page_categories ausgefüllt sein und das Feld search.request.query darf nicht leer sein.

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

     Standardmäßig wird diese Einstellung durch alle Kategorien ausgelöst, die Sie durchsuchen, und alle Suchanfragen, die Sie stellen.

8. Optional: Legen Sie eine Bedingung fest, die die Regel auf Grundlage einer bestimmten Kategorie auslöst, die ein Nutzer aufgerufen hat, oder einer Suchanfrage, die er durchgeführt hat:

   • In Kategorien suchen: Geben Sie im Feld Kategorien ein, welche Kategorien das Steuerelement auslösen sollen.

   • Suchen: Wenn Sie Suchbegriffe hinzufügen möchten, die gefiltert werden sollen (z. B. running shoes), klicken Sie auf Suchanfrage hinzufügen. Wählen Sie für jeden Begriff Teilweise Übereinstimmung oder Vollständige Ü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 dieses Steuerelement angewendet werden kann.

10. Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen. Verwenden Sie den Schieberegler unter Anpinnen, um anzugeben, an welcher Position die Produkte angepinnt werden sollen. Der Schieberegler für den Wert der Markierung akzeptiert keine Werte von 0, negative Zahlen oder nicht ganzzahligen Werte.

    In Vertex AI Search for Commerce sind 10 Markierungen in der Markierungskarte jedes einzelnen Steuerelements zulässig. Die Position kann ein beliebiger Wert zwischen 1 und 120 sein (die maximale Seitengröße der Anfrage).

11. Klicken Sie auf Weiter, um zum Abschnitt Auslieferungskonfigurationen zu gelangen. Wählen Sie die Bereitstellungskonfigurationen aus, auf die die Einstellung angewendet werden soll, und reichen Sie die Einstellungen ein.

    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 prüfen, 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.

Weitere Informationen 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 sollte eine Ganzzahl zwischen [1,10] sein (jeweils einschließlich) und product_id muss in Ihrem Katalog vorhanden sein. Die maximale Anzahl zulässiger Elemente in der Markierungskarte beträgt für jedes Steuerelement 10.

Hängen Sie als Nächstes das Steuerelement für die Anpinning 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 das zuvor erstellte Anlegeelement id sein.

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

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

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

3. Geben Sie eine Testabfrage in das Suchanfragefeld ein.

4. Klicken Sie auf Suchvorschau.

5. Sehen Sie sich die Ergebnisse an, um sicherzustellen, dass 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"