„Einzelhandel“ wird in „Vertex AI Search for Retail“ umbenannt. Wir aktualisieren derzeit unsere Inhalte gemäß dem neuen Branding.

Diese Seite wurde von der Cloud Translation API übersetzt.

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. Anschließend können Sie das neue einer Bereitstellungskonfiguration hinzu.

Bereitstellungskonfigurationen haben eine Multi-zu-Multi-Beziehung mit 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 (Empfehlungen oder Suche), verwendet werden können. Bereitstellungseinstellungen können nur mit Bereitstellungskonfigurationen verknüpft werden desselben Produkttyps an. Beispiel: Eine Auslieferungssteuerung, die für Empfehlungen können keiner Bereitstellungskonfiguration zugeordnet werden das für die Suche erstellt wurde.

Bereitstellungskonfigurationen verwalten, welche Steuerelemente bei einer Suche oder Vorhersageanfrage. Nur die Steuerelemente der aktiven Bereitstellungskonfiguration für eine werden zum Zeitpunkt der Auslieferung 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“ hervorgehoben. 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 Auslieferungseinstellungen 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 das Suchnetzwerk verfügbar.
Linguistisch: Passt die Linguistik der Suchanfrage an. Nur für die Suche verfügbar. Es gibt verschiedene linguistische Kontrollen, verfügbar:
- 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.

Beispiele für diese Steuerelemente finden Sie unter Bereitstellungseinstellungen.

Anleitung zur Weiterleitungssteuerung

In dieser Anleitung erfahren Sie, wie Sie die Weiterleitungssteuerung 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 Seite „Einstellungen“ im Menü Google Cloud Console oder inline mit der Controls.create-Methode

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

Steuerelement für die Betonung/Unterdrückung von Ergebnissen erstellen
Filterelement erstellen
Weiterleitungskontrollelement erstellen
Einstellung für bidirektionale Synonyme erstellen
Einseitiges Steuerelement für Synonyme erstellen
Steuerelement zum Nicht-Verknüpfen erstellen
Ignoriersteuerung erstellen
Steuerelement zum Ersetzen erstellen

Einstellung zum Hoch-/Herabstufen erstellen

Weitere Informationen zu diesem Steuerelementtyp finden Sie unter Hoch-/Herunterstufen-Steuerelemente.

Dieser Einstellungstyp ist für Such- und Empfehlungen.

Einstellung für die Auf-/Abwertung von Suchergebnissen erstellen
Einstellung zum Optimieren oder Unterdrücken von Empfehlungen erstellen

Steuerelement für die Auf-/Abwertung von Suchergebnissen erstellen

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

Console

Rufen Sie in der Search for Retail-Konsole die Seite Steuerelemente auf.

Zur Seite „Einstellungen“
Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung erstellen.

Der Bereich Steuerelement erstellen wird geöffnet.

Gehen Sie im Bereich Einstellungen so vor:

Geben Sie im Feld Steuerelementname einen Namen für das neue Steuerelement ein.
Optional: Wenn Sie die automatisch erstellte Einstellungs-ID ändern möchten, klicken Sie auf Bearbeiten und geben Sie eine neue Einstellungs-ID ein.
Wählen Sie im Bereich Produktauswahl die Option Suchen aus.
Wählen Sie als Steuerelementtyp Boost-/Bury-Steuerelemente aus.
Klicken Sie auf „Weiter“, um zum Bereich Trigger zu gelangen.

Legen Sie im Bereich Trigger Bedingungen fest, durch die das Steuerelement ausgelöst wird:

Wählen Sie aus, durch welche Art von Nutzerverhalten diese Einstellung ausgelöst wird:
- Kategorien durchsuchen: Die Regel wird ausgelöst, wenn ein Nutzer die Seiten auf Ihrer Website (search.request.query ist leer).
- Suche: Die Regel wird ausgelöst, wenn ein Nutzer auf Ihrer Website sucht. (search.request.query ist nicht leer).
Im nächsten Schritt können Sie bestimmte Kategorien oder Suchanfragen festlegen, die diese Funktion auslösen können. Um festzulegen, dass dieses Steuerelement ausgelöst wird, wenn eine Kategorie oder eine beliebige Abfrage gesucht wird, überspringen Sie den folgenden Schritt.
Optional: Legen Sie eine Kontrollbedingung fest, die die Regel auslöst, wenn eine bestimmte Kategorie aufgerufen oder eine bestimmte Suchanfrage verwendet wird.

Überspringen Sie diesen Schritt, wenn Sie dieses Steuerelement so einrichten möchten, dass es bei jeder Kategorie oder Abfrage ausgelöst wird Schritt.

Die verfügbare Option hängt davon ab, ob Sie Kategorien durchsuchen oder Suche:
- 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: Dieses Steuerelement wird angewendet, wenn eine Abfrage eine teilweise Übereinstimmung mit diesem Suchbegriff.
  - 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.
Wenn Sie zusätzlich zu dieser Art von Bedingung verwendet wird, wird die Steuerung nur angewendet, wenn beide Bedingungen erfüllt sind.
Optional: Klicken Sie auf die Schaltfläche Zeitraum hinzufügen, um einen oder mehrere Zeiträume hinzuzufügen. Zeiträume, in denen diese Einstellung angewendet werden kann.

Wenn Sie neben einer Zeitangabe auch eine Kategorie oder wird die Einstellung nur angewendet, wenn beide Bedingungen erfüllt sind: erfüllt sind.
Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

Im Abschnitt Aktionen:

Fügen Sie im Feld Auffrischungs-/Herabstufungsprodukt 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"))
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, um zum Bereich Bereitstellungskonfigurationen zu gelangen.

Im Bereich Serving-Konfigurationen:

Wählen Sie aus, auf welche Bereitstellungskonfigurationen die Einstellung angewendet werden soll.
Ü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 Stöbern ausgelöstes Steuerelement, wobei searchSolutionUseCase ist auf SEARCH_SOLUTION_USE_CASE_BROWSE gesetzt.

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 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

Einstellung zum Hoch-/Herabstufen von Empfehlungen erstellen

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

Console

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

Zur Seite „Einstellungen“
Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung erstellen.

Der Bereich Steuerelement erstellen wird geöffnet.

Gehen Sie im Bereich Einstellungen so vor:

Geben Sie im Feld Name des Steuerelements einen Namen für das neue Steuerelement ein.
Optional: Wenn Sie die automatisch erstellte Einstellungs-ID ändern möchten, klicken Sie auf Bearbeiten und geben Sie eine neue Einstellungs-ID ein.
Klicken Sie unter Produktauswahl auf Empfehlung.
Wählen Sie als Steuerelementtyp Boost-/Bury-Steuerelemente aus.
Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

Im Abschnitt Aktionen:

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

Verwenden Sie die Syntax für Filterausdrücke in Empfehlungen filtern:

So geben Sie beispielsweise rote und blaue Versionen von „product1“ und „product2“ an: (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
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, um zum Bereich Bereitstellungskonfigurationen zu gelangen.

Im Bereich Serving-Konfigurationen:

Wählen Sie aus, auf welche Bereitstellungskonfigurationen die Einstellung angewendet werden soll.
Ü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 testen, ob Ihre Änderungen auf der Seite Bewerten der Console.

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 Einstellungs-ID und einem 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 dokumentierte Syntax für Filterausdrücke finden Sie unter Empfehlungen filtern.

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 testen, ob Ihre Änderungen auf der Seite Bewerten der Console.

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

Filtersteuerung erstellen

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

Console

Rufen Sie in der Search for Retail-Konsole die Seite Steuerelemente auf.

Zur Seite „Einstellungen“
Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung erstellen.

Der Bereich Steuerelement erstellen wird geöffnet.

Gehen Sie im Bereich Einstellungen so vor:

Geben Sie im Feld Steuerelementname einen Namen für das neue Steuerelement ein.
Optional: Wenn Sie die automatisch erstellte Einstellungs-ID ändern möchten, klicken Sie auf Bearbeiten und geben Sie eine neue Einstellungs-ID ein.
Wählen Sie als Steuerelementtyp Steuerelemente zum Filtern aus.
Klicken Sie auf „Weiter“, um zum Abschnitt Trigger zu gelangen.

Im Bereich Trigger:

Wählen Sie aus, bei welcher Art von Nutzerverhalten diese Einstellung ausgelöst wird:
- Kategorien durchsuchen: Die Regel wird ausgelöst, wenn ein Nutzer die Seiten auf Ihrer Website (search.request.query ist leer).
- Suche: Die Regel wird ausgelöst, wenn ein Nutzer auf Ihrer Website sucht (search.request.query ist nicht leer).
Optional: Legen Sie eine Kontrollbedingung fest, durch die die Regel ausgelöst wird. angesehen wird oder nach welcher Suchanfrage gesucht wird. Die verfügbare Option hängt davon ab, ob Sie Kategorien durchsuchen oder Suchen ausgewählt haben:
- Wenn Sie Kategorien durchsuchen auswählen: Geben Sie in das Feld Kategorien welche Kategorien dieses Steuerelement beim Stöbern auslösen.
- 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: Dieses Steuerelement wird angewendet, wenn eine Abfrage eine teilweise Übereinstimmung mit diesem Suchbegriff.
  - 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.
Wenn Sie zusätzlich zu dieser Bedingung eine Zeitraumbedingung angeben, wird die Steuerung nur angewendet, wenn beide Bedingungen erfüllt sind.
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.

Wenn Sie zusätzlich zu diesem Attribut eine Kategorie oder Zeitraumbedingung wird die Steuerung nur angewendet, wenn beide Bedingungen erfüllt sind.
Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

Im Abschnitt Aktionen:

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"))
Klicken Sie auf Weiter, um zum Bereich Bereitstellungskonfigurationen zu gelangen.

Im Bereich Serving-Konfigurationen:

Wählen Sie aus, auf welche Bereitstellungskonfigurationen die Einstellung angewendet werden soll.
Ü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 Einstellungs-ID und einem Instanz von Control im Anfragetext.

Details zu den Feldern finden Sie in der Controls API-Referenz und die 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 Stöbern 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 durch die Suche ausgelöstes Steuerelement, wobei searchSolutionUseCase ist auf SEARCH_SOLUTION_USE_CASE_SEARCH gesetzt.

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.

Weiterleitungskontrollelement erstellen

Weitere Informationen zu diesem Steuerelementtyp finden Sie unter Weiterleitungssteuerung.

Console

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

Zur Seite „Einstellungen“
Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung erstellen.

Der Bereich Steuerelement erstellen wird geöffnet.

Gehen Sie im Bereich Einstellungen so vor:

Geben Sie im Feld Steuerelementname einen Namen für das neue Steuerelement ein.
Optional: Wenn Sie die automatisch erstellte Steuerelement-ID ändern möchten, klicken Sie auf Bearbeiten und geben Sie eine neue Steuerelement-ID ein.
Wählen Sie als Typ der Steuerelemente Weiterleitungssteuerung aus.
Klicken Sie auf „Weiter“, um zum Abschnitt Trigger zu gelangen.

Erstellen Sie im Bereich Trigger mindestens einen Trigger für Suchbegriffe oder einen Zeitbereich. Für die Weiterleitungssteuerung ist mindestens ein Trigger erforderlich:

Wählen Sie aus, durch welche Art von Nutzerverhalten diese Einstellung ausgelöst wird:
- Kategorien durchsuchen: Die Regel wird ausgelöst, wenn ein Nutzer die Seiten auf Ihrer Website (search.request.query ist leer).
- Suche: Die Regel wird ausgelöst, wenn ein Nutzer auf Ihrer Website sucht (search.request.query ist nicht leer).
Legen Sie eine Kontrollbedingung fest, die die Regel anhand dessen auslöst angesehen wird oder nach welcher Suchanfrage gesucht wird. Die verfügbare Option hängt davon ab, ob Sie Kategorien durchsuchen oder Suchen ausgewählt haben:
- Wenn Sie Kategorien durchsuchen auswählen: Geben Sie in das Feld Kategorien welche Kategorien dieses Steuerelement beim Stöbern auslösen.
- 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: Dieses Steuerelement wird angewendet, wenn eine Abfrage eine teilweise Übereinstimmung mit diesem Suchbegriff.
  - 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.
Wenn Sie zusätzlich zu dieser Bedingung eine Zeitraumbedingung angeben, wird nur angewendet, wenn beide Bedingungen erfüllt sind.
Klicken Sie auf die Schaltfläche Zeitraum hinzufügen, um einen oder mehrere Zeiträume hinzuzufügen, in denen diese Einstellung angewendet werden kann.

Wenn Sie zusätzlich zu diesem Attribut eine Kategorie oder Zeitraumbedingung wird die Steuerung nur angewendet, wenn beide Bedingungen erfüllt sind.
Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

Im Abschnitt Aktionen:

Geben Sie den URI ein, an den weitergeleitet werden soll, wenn dieses Steuerelement ausgelöst wird.
Klicken Sie auf Weiter, um zum Abschnitt Auslieferungskonfigurationen zu gelangen.

Im Bereich Serving-Konfigurationen:

Wählen Sie aus, auf welche Bereitstellungskonfigurationen die Einstellung angewendet werden soll.
Ü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 testen, ob Ihre Änderungen auf der Seite Bewerten der Console.

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 Stöbern 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 durch die Suche ausgelöstes Steuerelement, wobei searchSolutionUseCase ist auf SEARCH_SOLUTION_USE_CASE_SEARCH gesetzt.

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

Zweiweg-Synonymsteuerelement erstellen

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

Console

Rufen Sie in der Search for Retail-Konsole die Seite Steuerelemente auf.

Zur Seite „Steuerelemente“
Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung erstellen.
Geben Sie im Feld Steuerelementname einen Namen für das neue Steuerelement ein.

Der Bereich Steuerelement erstellen wird geöffnet.

Im Abschnitt Einstellungen:

Optional: Wenn Sie die automatisch erstellte Einstellungs-ID ändern möchten, klicken Sie auf Bearbeiten und geben Sie eine neue Einstellungs-ID ein.
Wählen Sie als Steuerungstyp Einstellung für bidirektionale Synonyme aus.
Klicken Sie auf „Weiter“, um zum Abschnitt Trigger zu gelangen.

Im Bereich Trigger:

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.
Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

Im Abschnitt Aktionen:

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 vorkommt, betrachtet die anderen Suchbegriffe als Synonyme des enthaltenen Begriffs.
Klicken Sie auf Weiter, um zum Bereich Bereitstellungskonfigurationen zu gelangen.

Im Bereich Serving-Konfigurationen:

Wählen Sie aus, auf welche Bereitstellungskonfigurationen die Einstellung angewendet werden soll.
Ü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 testen, ob Ihre Änderungen auf der Seite Bewerten der Console.

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.

Einseitiges Steuerelement für Synonyme erstellen

Weitere Informationen zu diesem Steuerelement finden Sie unter Einweg-Synonym-Steuerelemente. Typ.

Console

Rufen Sie in der Search for Retail-Konsole die Seite Steuerelemente auf.

Zur Seite „Einstellungen“
Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung erstellen.

Der Bereich Steuerelement erstellen wird geöffnet.

Gehen Sie im Bereich Einstellungen so vor:

Geben Sie im Feld Steuerelementname einen Namen für das neue Steuerelement ein.
Optional: Wenn Sie die automatisch erstellte Steuerelement-ID ändern möchten, klicken Sie auf Bearbeiten und geben Sie eine neue Steuerelement-ID ein.
Wählen Sie als Steuerelementtyp Einweg-Synonymsteuerelement aus.
Klicken Sie auf „Weiter“, um zum Bereich Trigger zu gelangen.

Im Bereich Trigger:

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.
Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

Im Abschnitt Aktionen:

Geben Sie im Feld Suchbegriffe Begriffe ein (z. B. shoes), die Synonyme haben sollten, wenn einer davon in einer Suchanfrage enthalten ist.
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.
Klicken Sie auf Weiter, um zum Abschnitt Auslieferungskonfigurationen zu gelangen.

Im Bereich Serving-Konfigurationen:

Wählen Sie aus, auf welche Bereitstellungskonfigurationen die Einstellung angewendet werden soll.
Ü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 testen, ob Ihre Änderungen auf der Seite Bewerten der Console.

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 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

Steuerelement zum Nicht-Verknüpfen erstellen

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

Console

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

Zur Seite „Steuerelemente“
Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung erstellen.

Der Bereich Steuerelement erstellen wird geöffnet.

Gehen Sie im Bereich Einstellungen so vor:

Geben Sie im Feld Steuerelementname einen Namen für das neue Steuerelement ein.
Optional: Wenn Sie die automatisch erstellte Einstellungs-ID ändern möchten, klicken Sie auf Bearbeiten und geben Sie eine neue Einstellungs-ID ein.
Wählen Sie als Steuerelementtyp Steuerelement nicht verknüpfen aus.
Klicken Sie auf „Weiter“, um zum Abschnitt Trigger zu gelangen.

Im Bereich Trigger:

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.
Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

Gehen Sie im Bereich Aktionen so vor:

Geben Sie im Feld Suchbegriffe Begriffe ein, z. B. gShoe. die Sie ausdrücklich von anderen unterscheiden möchten.
Geben Sie in das Feld Dissoziierte Begriffe Begriffe ein, die nicht verwendet werden dürfen. mit den von Ihnen angegebenen Suchbegriffen verknüpft ist.

Sie können beispielsweise den Suchbegriff gShoe vom Begriff cheap trennen.
Klicken Sie auf Weiter, um zum Abschnitt Auslieferungskonfigurationen zu gelangen.

Im Bereich Serving-Konfigurationen:

Wählen Sie aus, auf welche Bereitstellungskonfigurationen die Einstellung angewendet werden soll.
Ü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 testen, ob Ihre Änderungen auf der Seite Bewerten der Console.

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

curl

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

Details zu den Feldern finden Sie in der Controls API-Referenz und die 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.

Steuerelement zum Ignorieren erstellen

Weitere Informationen zu diesem Steuerungstyp finden Sie unter Steuerelemente ignorieren.

Console

Rufen Sie in der Search for Retail-Konsole die Seite Steuerelemente auf.

Zur Seite „Einstellungen“
Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung erstellen.

Der Bereich Steuerelement erstellen wird geöffnet.

Gehen Sie im Bereich Einstellungen so vor:

Geben Sie im Feld Steuerelementname einen Namen für das neue Steuerelement ein.
Optional: Wenn Sie die automatisch erstellte Einstellungs-ID ändern möchten, klicken Sie auf Bearbeiten und geben Sie eine neue Einstellungs-ID ein.
Wählen Sie als Steuerelementtyp Steuerelement nicht verknüpfen aus.
Klicken Sie auf „Weiter“, um zum Abschnitt Trigger zu gelangen.

Im Bereich Trigger:

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.
Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

Im Abschnitt Aktionen:

Geben Sie im Feld Begriffe ignorieren Begriffe ein (z. B. shoddy), die bei einer Suche ignoriert werden sollen, wenn sie als Suchbegriffe eingegeben werden.
Klicken Sie auf Weiter, um zum Bereich Bereitstellungskonfigurationen zu gelangen.

Im Bereich Serving-Konfigurationen:

Wählen Sie aus, auf welche Bereitstellungskonfigurationen die Einstellung angewendet werden soll.
Ü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 testen, ob Ihre Änderungen auf der Seite Bewerten der Console.

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 Einstellungs-ID und einem Instanz von Control im Anfragetext.

Details zu den Feldern finden Sie in der Controls API-Referenz und die 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 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.

Steuerelement zum Ersetzen erstellen

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

Console

Rufen Sie in der Search for Retail-Konsole die Seite Steuerelemente auf.

Zur Seite „Einstellungen“
Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung erstellen.

Der Bereich Steuerelement erstellen wird geöffnet.

Gehen Sie im Bereich Einstellungen so vor:

Geben Sie im Feld Steuerelementname einen Namen für das neue Steuerelement ein.
Optional: Wenn Sie die automatisch erstellte Steuerelement-ID ändern möchten, klicken Sie auf Bearbeiten und geben Sie eine neue Steuerelement-ID ein.
Wählen Sie als Einstellungstyp Steuerelement ersetzen aus.
Klicken Sie auf „Weiter“, um zum Bereich Trigger zu gelangen.

Im Bereich Trigger:

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.
Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

Im Abschnitt Aktionen:

Geben Sie in das Feld Suchbegriffe Suchbegriffe ein, z. B. gShoe) durch den Ersatzbegriff ersetzt werden soll.
Geben Sie im Feld Ersatzbegriff den Begriff ein, der die zuvor angegebenen Suchbegriffe ersetzen soll.

Beispielsweise können Sie den Suchbegriff gShoe durch den Ersatz ersetzen. Begriff Google Shoe.
Klicken Sie auf Weiter, um zum Abschnitt Auslieferungskonfigurationen zu gelangen.

Im Bereich Serving-Konfigurationen:

Wählen Sie aus, auf welche Bereitstellungskonfigurationen die Einstellung angewendet werden soll.
Ü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.

Details zu den Feldern finden Sie in der Controls API-Referenz und die 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 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.