Steuerelemente für die Bereitstellung erstellen

Auf dieser Seite wird beschrieben, wie Sie Bereitstellungssteuerungen erstellen.

Steuerelemente für die Bereitstellung sind Regeln, die Sie definieren und auf einzelne Bereitstellungskonfigurationen anwenden. Weitere Informationen zu Bereitstellungskonfigurationen finden Sie unter Bereitstellungskonfigurationen.

Mit Steuerelementen für die Bereitstellung können Sie Regeln erstellen, die festlegen, wie Ihre Bereitstellungskonfigurationen Ergebnisse ausgeben.

Sie haben die Möglichkeit, in der Retail Search Console ein Steuerelement für die Bereitstellung zu erstellen. Das Steuerelement besteht aus einer Bedingung, die die Regel auslöst, und aus einer Aktion, die ausgeführt wird, wenn die Bedingung zutrifft. Sie können dann das neue Steuerelement für die Bereitstellung an eine Bereitstellungskonfiguration anhängen.

Bereitstellungskonfigurationen haben eine Multi-zu-Multi-Beziehung zu Steuerelementen. Sie können einer Bereitstellungskonfiguration mehrere Steuerelemente hinzufügen und ein einzelnes Steuerelement kann mehreren Bereitstellungskonfigurationen zugeordnet werden.

Wenn Sie Bereitstellungssteuerungen und Bereitstellungskonfigurationen erstellen, wählen Sie ein Produkt (Empfehlungen oder Suche) aus, für das sie verwendet werden können. Bereitstellungssteuerungen können nur Bereitstellungskonfigurationen desselben Produkttyps zugeordnet werden. Ein Bereitstellungskontrollelement, das für Empfehlungen erstellt wurde, kann beispielsweise nicht mit einer Bereitstellungskonfiguration verknüpft werden, die für die Suche erstellt wurde.

Mit Bereitstellungskonfigurationen wird festgelegt, welche Steuerelemente bei einer Such- oder Prognoseanfrage angewendet werden. Beim Ausliefern werden nur die Steuerelemente in der aktiven Auslieferungskonfiguration für eine Anfrage berücksichtigt. Angenommen, Sie haben zwei Steuerelemente erstellt: ein Steuerelement namens „gShoe-Angebot“, das die Ergebnisse für die Marke gShoe bei der Suche nach „Schuhe“ hervorhebt, und ein Steuerelement namens „Weitere Schuhe“, das Suchanfragen mit dem Begriff „Laufschuhe“ auf „Sportschuhe“ ausweitet. Wenn Sie nur das Steuerelement „gShoe-Angebot“ an eine Bereitstellungskonfiguration anhängen, werden bei Suchanfragen mit dieser Bereitstellungskonfiguration gShoe-Ergebnisse für Suchanfragen mit dem Begriff „Schuhe“ optimiert. Das Steuerelement „Weitere Schuhe“ hat jedoch keine Auswirkungen, da es nicht an die von Ihnen verwendete Bereitstellungskonfiguration angehängt ist.

Sie haben auch die Möglichkeit, erstellte Steuerelemente einer Live-Bereitstellungskonfiguration hinzuzufügen oder dafür auszutauschen.

Auf der Seite Steuerungen oder mithilfe der Methode Controls.create können Sie jederzeit Steuerelemente für die Bereitstellung erstellen und ändern. In der Console können Sie optional Steuerelemente erstellen, während Sie die Bereitstellungskonfiguration erstellen.

Sie können bis zu 100 Steuerelemente für die Bereitstellung erstellen. Wenn Sie mehr Einstellungen für die Auslieferung benötigen, beantragen Sie ein zusätzliches Kontingent. Informationen zum Anfordern zusätzlicher Kontingente finden Sie unter Kontingente erhöhen. Eine Bereitstellungskonfiguration kann bis zu 100 Steuerelemente für die Bereitstellung beliebigen Typs haben, mit Ausnahme von Weiterleitungssteuerungen, deren Limit 1.000 pro Bereitstellungskonfiguration beträgt.

Steuerelemente für die Bereitstellung sind verfügbar für:

  • Boost/Bury: Wirkt sich auf die Rangfolge und Reihenfolge der Ergebnisse in der zurückgegebenen Ergebnisliste aus. Verfügbar für Suche und Empfehlungen.
  • Filter: Entfernt Ergebnisse, die nicht den Filter enthalten, aus der zurückgegebenen Ergebnisliste. Nur für die Suche verfügbar.
  • Weiterleiten: Leitet Ihre Nutzer je nach Suchanfrage an eine bestimmte Seite weiter. Nur für die Suche verfügbar.
  • Linguistisch: Passt die Linguistik der Suchanfrage an. Nur für die Suche verfügbar. Es gibt verschiedene Arten von linguistischen Steuerelementen:
    • Synonym: Maximiert Synonyme als Synonyme für eine Suchanfrage.
    • Einweg-Synonym: Maximiert Synonyme für bestimmte Begriffe unidirektional.
    • Nicht verknüpfen: Verhindert, dass eine bestimmte Gruppe von Begriffen in der Suche verwendet wird.
    • Ignorieren: Verhindert, dass ein Begriff in Suchanfragen verwendet wird.
    • Ersetzung: Ersetzt Begriffe in der Suchanfrage.
  • Anpinnen: Wirkt sich auf die Reihenfolge der Ergebnisse aus, indem ein Ergebnis an einer bestimmten Position platziert wird, z. B. an Position 4. Sie können nach ihnen suchen und sie durchsuchen.

Beispiele für diese Steuerelemente finden Sie unter Bereitstellungseinstellungen.

Anleitung zur Weiterleitungssteuerung

In dieser Anleitung erfahren Sie, wie Sie das Steuerelement für Weiterleitungen verwenden.

Klicken Sie auf Anleitung, um eine detaillierte Anleitung für diese Aufgabe direkt im Cloud Shell-Editor zu erhalten:

Anleitung

Neue Steuerelemente für die Bereitstellung erstellen

Erstellen Sie auf der Seite „Steuerelemente“ in der Google Cloud Console oder inline mit der Methode Controls.create eine neue Bereitstellungssteuerung.

Je nach Art der Steuerelemente gelten unterschiedliche Anforderungen. Rufen Sie die Anleitung zum Erstellen des gewünschten Steuerelements auf:

Steuerelement zum Hoch-/Herabstufen erstellen

Weitere Informationen zu diesem Steuerungstyp finden Sie unter Boost-/Bury-Steuerelemente.

Dieser Steuerelementtyp ist für Suchanfragen und Empfehlungen verfügbar.

So erstellen Sie eine Einstellung für die Aufwertung oder Unterdrückung von Suchergebnissen:

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen auf.

    Zur Seite „Steuerelemente“

  2. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung 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, durch welches Nutzerverhalten diese Einstellung ausgelöst wird.

    • In Kategorien stöbern: Die Regel wird ausgelöst, wenn ein Nutzer auf Ihrer Website in Kategorien stöbert (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 dieses Steuerelement 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 dieses Steuerelement auslösen können, je nachdem, ob eine bestimmte Kategorie aufgerufen oder eine bestimmte Suchanfrage verwendet 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:

Einstellung zum Hoch-/Herabstufen von Empfehlungen erstellen

So erstellen Sie eine Boost-/Bury-Steuerung für Empfehlungen:

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen auf.

    Zur Seite „Steuerelemente“

  2. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung 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:

Filtersteuerung erstellen

Weitere Informationen zu diesem Steuerungstyp finden Sie unter Steuerelemente zum Filtern.

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen auf.

    Zur Seite „Steuerelemente“

  2. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung 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 Suchen 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:

Weiterleitungskontrollelement erstellen

Weitere Informationen zu diesem Steuerungstyp finden Sie unter Steuerelemente zum Weiterleiten.

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen auf.

    Zur Seite „Steuerelemente“

  2. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung 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:

Einstellung für bidirektionale Synonyme erstellen

Weitere Informationen zu diesem Steuerungstyp finden Sie unter Steuerelemente für Zwei-Wege-Synonyme.

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen auf.

    Zur Seite „Steuerelemente“

  2. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung 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.

Unidirektionale Synonymsteuerelemente erstellen

Weitere Informationen zu diesem Steuerungstyp finden Sie unter Steuerelemente für Einweg-Synonyme.

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen auf.

    Zur Seite „Steuerelemente“

  2. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung 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), die Synonyme haben sollten, wenn einer davon 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. 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:

Steuerelement zum Nicht-Verknüpfen erstellen

Weitere Informationen zu diesem Steuerungstyp finden Sie unter Do-Not-Associate-Steuerelemente.

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen auf.

    Zur Seite „Steuerelemente“

  2. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung 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:

Ignoriersteuerung erstellen

Weitere Informationen zu diesem Steuerungstyp finden Sie unter Steuerelemente ignorieren.

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen auf.

    Zur Seite „Steuerelemente“

  2. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung 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:

Ersatzkontrollelement erstellen

Weitere Informationen zu diesem Steuerungstyp finden Sie unter Steuerelemente zur Ersetzung.

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen auf.

    Zur Seite „Steuerelemente“

  2. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung 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:

Anlegeelement erstellen

So erstellen Sie ein Anlegeelement:

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen auf.

    Zur Seite „Steuerelemente“

  2. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung 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 stöbern aus.

  6. Wählen Sie als Steuerelementtyp Anpinnen 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 für den Einzelhandel sind 10 Markierungen in der Markierungskarte einer einzelnen Steuerung 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 muss eine Ganzzahl zwischen 1 und 10 sein. product_id muss in Ihrem Katalog vorhanden sein. Die maximale Anzahl zulässiger Elemente in der Pin-Zuordnung beträgt für jedes Steuerelement 10.

Hängen Sie als Nächstes das Anpinnen-Steuerelement 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:

Testen Sie abschließend die Konfiguration, indem Sie eine Suchanfrage stellen. Damit das Anpinnen auf eine Anfrage angewendet werden kann, müssen Sie Suchbegriffe (in der Suche) oder Seitenkategorien (in der Suche) verwenden, die mit den Begriffen/Kategorien übereinstimmen, die Sie in den vorherigen Schritten im Steuerelement angegeben haben.

Console

  1. Rufen Sie in der Console „Suchen für Einzelhandel“ 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"

Einschränkungen für die Fehlerprüfung

Beachten Sie bei der Fehlerprüfung Folgendes:

  • Zwei Produkte können nicht an derselben Position angepinnt werden. Das bedeutet, dass die Produkte „a“ und „b“ nicht beide die Position 2 einnehmen können.
  • Umgekehrt kann ein Produkt nicht an mehr als einer Stelle angepinnt werden. Das heißt, Produkt „a“ kann nicht gleichzeitig für die gleiche Suchanfrage an den Positionen 2 und 3 angepinnt werden.
  • Die product_id muss als Produkt im Katalog vorhanden sein, vorausgesetzt, es werden keine Filter oder Sortierungen angewendet.