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

Bereitstellungseinstellungen erstellen

Auf dieser Seite wird beschrieben, wie Sie Steuerelemente für die Bereitstellung erstellen.

Bereitstellungssteuerungen sind Regeln, die Sie definieren und auf einzelne Bereitstellungskonfigurationen anwenden. Weitere Informationen zu Bereitstellungskonfigurationen finden Sie unter Bereitstellungskonfigurationen.

Mit Bereitstellungseinstellungen können Sie Regeln erstellen, mit denen die Bereitstellung von Ergebnissen durch Ihre Bereitstellungskonfigurationen angepasst wird.

Sie können in der Search for Retail-Konsole eine Bereitstellungssteuerung erstellen, die aus einer Bedingung besteht, die die Steuerung auslöst, und einer Aktion, die beim Auslösen der Bedingung ausgeführt wird. Anschließend können Sie die neue Bereitstellungssteuerung an eine Bereitstellungskonfiguration anhängen.

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

Wenn Sie Bereitstellungseinstellungen und Bereitstellungskonfigurationen erstellen, wählen Sie ein Produkt (Empfehlungen oder Suche) aus, für das es verwendet werden kann. Bereitstellungseinstellungen können nur mit Bereitstellungskonfigurationen desselben Produkttyps verknüpft werden. Beispielsweise kann eine Bereitstellungssteuerung, die für Empfehlungen erstellt wurde, keiner Bereitstellungskonfiguration zugeordnet werden, die für die Suche erstellt wurde.

Bereitstellungskonfigurationen verwalten, welche Steuerelemente bei einer Such- oder Vorhersageanfrage angewendet werden. Zum Zeitpunkt der Bereitstellung werden nur die Steuerelemente der aktiven Bereitstellungskonfiguration für eine Anfrage berücksichtigt. Angenommen, Sie haben zwei Steuerelemente erstellt: ein Steuerelement namens „gShoe Sale“, das die Ergebnisse für die Marke gShoe verbessert, wenn nach „schuhe“ gesucht wird, und ein Steuerelement mit dem Namen „Weitere Schuhe“, das Suchanfragen mit dem Begriff „laufschuhe“ um „sportschuhe“ erweitert. Wenn Sie nur das Steuerelement „gShoe Sale“ an eine Bereitstellungskonfiguration anhängen, steigern Suchanfragen mit dieser Bereitstellungskonfiguration die gShoe-Ergebnisse für Abfragen mit dem Begriff „schuhe“. Das Steuerelement „Weitere Schuhe“ hat jedoch keine Auswirkungen, da es nicht mit der von Ihnen verwendeten Bereitstellungskonfiguration verknüpft ist.

Sie können Steuerelemente erstellen und diese dann in eine Live-Bereitstellungskonfiguration einbinden oder von ihr ersetzen.

Sie können Steuerelemente für die Bereitstellung jederzeit auf der Seite Steuerelemente oder inline mit der Methode Controls.create erstellen oder ändern. In der Console können Sie optional Steuerelemente während der Erstellung der Bereitstellungskonfiguration erstellen.

Sie können bis zu 100 Auslieferungseinstellungen erstellen. Wenn Sie mehr Steuerelemente für die Bereitstellung benötigen, fordern Sie ein zusätzliches Kontingent an. Informationen zum Anfordern zusätzlicher Kontingente finden Sie unter Kontingente erhöhen. Eine Bereitstellungskonfiguration kann außer den Weiterleitungseinstellungen bis zu 100 Bereitstellungseinstellungen eines beliebigen Typs enthalten. Das Limit liegt bei 1.000 pro Bereitstellungskonfiguration.

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

Beispiele für diese Steuerelemente finden Sie unter Steuerelemente für die Bereitstellung.

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 in der Google Cloud Console auf der Seite „Steuerelemente“ oder inline mit der Methode Controls.create ein neues Steuerelement für die Bereitstellung.

Steuerelemente haben je nach Typ unterschiedliche Anforderungen. Gehen Sie zum Erstellungsverfahren für den Steuerungstyp, den Sie erstellen möchten:

Verstärkungs-/Herabstufungs-Steuerelement erstellen
Filtersteuerung erstellen
Steuerelement für die Weiterleitung erstellen
Zweiwege-Steuerung für Synonyme erstellen
Einseitige Synonymeinstellungen erstellen
Einstellung „Nicht verknüpfen“ erstellen
Steuerelement zum Ignorieren erstellen
Steuerelement für Ersatz erstellen

Verstärkungs-/Herabstufungsregelung erstellen

Weitere Informationen zu diesem Steuerelementtyp finden Sie unter Boost-/Herabstufungssteuerelemente.

Dieser Einstellungstyp ist für die Suche und Empfehlungen verfügbar.

Einstellung für Sucherhöhung/-verringerung erstellen
Optimierungs-/Herabstufungs-Kontrolle für Empfehlungen erstellen

Einstellung für Sucherhöhung/-verringerung erstellen

So erstellen Sie eine Einstellung für die Sucherhöhung/-verringerung:

Console

Rufen Sie in der Search for Retail-Konsole 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.

Im Bereich Einstellungen:

Geben Sie in das Feld Name der Einstellung einen Namen für das neue Steuerelement ein.
Optional: Klicken Sie zum Ändern der automatisch erstellten Einstellungs-ID auf Bearbeiten und geben Sie eine neue Einstellungs-ID ein.
Wählen Sie im Bereich Produktauswahl die Option Suchen aus.
Wählen Sie als Einstellungstyp Steuerungselemente zum Hoch-/Herauszoomen aus.
Klicken Sie auf „Weiter“, um zum Bereich Trigger zu gelangen.

Legen Sie im Bereich Trigger Bedingungen fest, die die Steuerung auslösen:

Wählen Sie aus, welche Art von Nutzerverhalten diese Einstellung auslöst:
- Kategorien durchsuchen: Die Regel wird ausgelöst, wenn ein Nutzer in Kategorien auf Ihrer Website 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).
Im folgenden Schritt können Sie bestimmte Kategorien oder Abfragen festlegen, die dieses Steuerelement auslösen können. Wenn dieses Steuerelement ausgelöst werden soll, wenn eine beliebige Kategorie durchsucht wird oder nach einer beliebigen Abfrage gesucht wird, überspringen Sie den folgenden Schritt.
Optional: Legen Sie eine Steuerbedingung fest, die die Regel abhängig davon auslöst, ob eine bestimmte Kategorie oder eine bestimmte Abfrage gesucht wird.

Wenn dieses Steuerelement bei jeder Kategorie oder Abfrage ausgelöst werden soll, überspringen Sie diesen Schritt.

Die verfügbare Option hängt davon ab, ob Sie Kategorien durchsuchen oder Suche ausgewählt haben:
- Bei Auswahl von Kategorien durchsuchen: Geben Sie im Feld Kategorien ein, welche Kategorien beim Stöbern dieses Steuerelement auslösen.
- Wenn Sie Suchen auswählen: Klicken Sie auf die Schaltfläche Abfrage hinzufügen, um Suchbegriffe (z. B. running shoes) hinzuzufügen, die gefiltert werden sollen. Wählen Sie dann für jeden Begriff eine der folgenden Optionen aus:
  - Teilübereinstimmung: Dieses Steuerelement wird angewendet, wenn eine Abfrage eine teilweise Übereinstimmung mit diesem Suchbegriff enthält.
  - Vollständige Übereinstimmung: Dieses Steuerelement gilt nur, wenn eine Abfrage eine vollständige Übereinstimmung mit diesem Suchbegriff enthält.
  Wenn einer dieser Begriffe in einer Suchanfrage enthalten ist, wird das Steuerelement angewendet.
Wenn Sie zusätzlich zu diesem Bedingungstyp auch Zeitraumbedingungen 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, in denen diese Einstellung angewendet werden kann.

Wenn Sie zusätzlich zu einer Bedingung für den Zeitraum eine Kategorie- oder Abfragebedingung angeben, wird die Einstellung nur angewendet, wenn beide Bedingungen erfüllt sind.
Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

Im Bereich Aktionen:

Fügen Sie Filter für Produktattribute im Feld Boost/bury-Produkt 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 Abschnitt Bereitstellungskonfigurationen zu gelangen.

Gehen Sie im Bereich Bereitstellungskonfigurationen so vor:

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. Auf der Seite Bewerten der Console können Sie testen, ob Ihre Änderungen übernommen 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 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 Boost-/Herabstufungsregelung kann ausgelöst werden, wenn ein Nutzer in Kategorien auf Ihrer Website stöbert (search.request.query ist leer) oder wenn er auf Ihrer Website sucht (search.request.query ist nicht leer).

Das folgende Beispiel zeigt Felder für ein durch Stöbervorgänge ausgelöstes Steuerelement, wobei 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 durch eine Suche ausgelöstes Steuerelement, wobei 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. Auf der Seite Bewerten der Console können Sie testen, ob Ihre Änderungen übernommen wurden.

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

Weitere Informationen zu dieser Methode finden Sie in der ServingConfig.addControl API-Referenz.
Ein Beispiel für diese Methode finden Sie unter Bereitstellungskonfigurationen verwalten.

Empfängnisverhütung/Verringerung der Empfehlungen erstellen

So erstellen Sie eine Steuerung zur Erhöhung/Herabstufung von Empfehlungen:

Console

Rufen Sie in der Search for Retail-Konsole 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.

Im Bereich Einstellungen:

Geben Sie in das Feld Name der Einstellung 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 Empfehlung aus.
Wählen Sie als Einstellungstyp Steuerungselemente zum Hoch-/Herauszoomen aus.
Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

Im Bereich Aktionen:

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

Verwenden Sie die Filterausdruckssyntax, die unter Filterempfehlungen dokumentiert ist.

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 Abschnitt Bereitstellungskonfigurationen zu gelangen.

Gehen Sie im Bereich Bereitstellungskonfigurationen so vor:

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. Auf der Seite Bewerten der Console können Sie testen, ob Ihre Änderungen übernommen 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 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 Syntax für Filterausdrücke, die unter Filterempfehlungen dokumentiert 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_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"

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

Im Bereich Einstellungen:

Geben Sie in das Feld Name der Einstellung einen Namen für das neue Steuerelement ein.
Optional: Klicken Sie zum Ändern der automatisch erstellten Einstellungs-ID auf Bearbeiten und geben Sie eine neue Einstellungs-ID ein.
Wählen Sie als Einstellungstyp Filtersteuerungen aus.
Klicken Sie auf „Weiter“, um zum Bereich Trigger zu gelangen.

Im Bereich Trigger:

Wählen Sie aus, welche Art von Nutzerverhalten diese Einstellung auslöst:
- Kategorien durchsuchen: Die Regel wird ausgelöst, wenn ein Nutzer in Kategorien auf Ihrer Website 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).
Optional: Legen Sie eine Steuerbedingung fest, die die Regel basierend auf der durchsuchten Kategorie oder der Suchanfrage auslöst. Welche Option verfügbar ist, hängt davon ab, ob Sie Kategorien durchsuchen oder Suche ausgewählt haben:
- Bei Auswahl von Kategorien durchsuchen: Geben Sie im Feld Kategorien ein, welche Kategorien beim Stöbern dieses Steuerelement auslösen.
- Wenn Sie Suchen auswählen: Klicken Sie auf die Schaltfläche Abfrage hinzufügen, um Suchbegriffe (z. B. running shoes) hinzuzufügen, die gefiltert werden sollen. Wählen Sie dann für jeden Begriff eine der folgenden Optionen aus:
  - Teilübereinstimmung: Dieses Steuerelement wird angewendet, wenn eine Abfrage eine teilweise Übereinstimmung mit diesem Suchbegriff enthält.
  - Vollständige Übereinstimmung: Dieses Steuerelement gilt nur, wenn eine Abfrage eine vollständige Übereinstimmung mit diesem Suchbegriff enthält.
  Wenn einer dieser Begriffe in einer Suchanfrage enthalten ist, wird das Steuerelement angewendet.
Wenn Sie zusätzlich zu dieser Bedingung eine Zeitraumbedingung angeben, wird die Kontrolle 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, in denen diese Einstellung angewendet werden kann.

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

Im Bereich 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 Abschnitt Bereitstellungskonfigurationen zu gelangen.

Gehen Sie im Bereich Bereitstellungskonfigurationen so vor:

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. Auf der Seite Bewerten der Console können Sie testen, ob Ihre Änderungen übernommen 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 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 Filtersteuerung kann ausgelöst werden, wenn ein Nutzer in Kategorien auf Ihrer Website stöbert (search.request.query ist leer) oder wenn er auf Ihrer Website sucht (search.request.query ist nicht leer).

Das folgende Beispiel zeigt Felder für ein durch Stöbervorgänge ausgelöstes Steuerelement, wobei 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 eine Suche ausgelöstes Steuerelement, wobei searchSolutionUseCase auf SEARCH_SOLUTION_USE_CASE_SEARCH gesetzt ist.

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

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

Weitere Informationen zu dieser Methode finden Sie in der ServingConfig.addControl API-Referenz.
Ein Beispiel für diese Methode finden Sie unter Bereitstellungskonfigurationen verwalten.

Weiterleitungssteuerung erstellen

Weitere Informationen zu diesem Einstellungstyp finden Sie unter Weiterleitungssteuerungen.

Console

Rufen Sie in der Search for Retail-Konsole 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.

Im Bereich Einstellungen:

Geben Sie in das Feld Name der Einstellung einen Namen für das neue Steuerelement ein.
Optional: Klicken Sie zum Ändern der automatisch erstellten Einstellungs-ID auf Bearbeiten und geben Sie eine neue Einstellungs-ID ein.
Wählen Sie als Einstellungstyp Weiterleitungssteuerungen aus.
Klicken Sie auf „Weiter“, um zum Bereich Trigger zu gelangen.

Erstellen Sie im Bereich Trigger mindestens einen Abfragebegriff oder einen Zeitraum-Trigger. Für Weiterleitungssteuerungen ist mindestens ein Trigger erforderlich:

Wählen Sie aus, welche Art von Nutzerverhalten diese Einstellung auslöst:
- Kategorien durchsuchen: Die Regel wird ausgelöst, wenn ein Nutzer in Kategorien auf Ihrer Website 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).
Legen Sie eine Steuerbedingung fest, die die Regel basierend auf der durchsuchten Kategorie oder der Suchanfrage auslöst. Welche Option verfügbar ist, hängt davon ab, ob Sie Kategorien durchsuchen oder Suche ausgewählt haben:
- Bei Auswahl von Kategorien durchsuchen: Geben Sie im Feld Kategorien ein, welche Kategorien beim Stöbern dieses Steuerelement auslösen.
- Wenn Sie Suchen auswählen: Klicken Sie auf die Schaltfläche Abfrage hinzufügen, um Suchbegriffe (z. B. running shoes) hinzuzufügen, die gefiltert werden sollen. Wählen Sie dann für jeden Begriff eine der folgenden Optionen aus:
  - Teilübereinstimmung: Dieses Steuerelement wird angewendet, wenn eine Abfrage eine teilweise Übereinstimmung mit diesem Suchbegriff enthält.
  - Vollständige Übereinstimmung: Dieses Steuerelement gilt nur, wenn eine Abfrage eine vollständige Übereinstimmung mit diesem Suchbegriff enthält.
  Wenn einer dieser Begriffe in einer Suchanfrage enthalten ist, wird das Steuerelement angewendet.
Wenn Sie zusätzlich zu dieser Bedingung eine Zeitraumbedingung angeben, wird die Kontrolle 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 dieser Zeitraumbedingung eine Kategorie- oder Abfragebedingung angeben, 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 Bereitstellungskonfigurationen zu gelangen.

Gehen Sie im Bereich Bereitstellungskonfigurationen so vor:

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. Auf der Seite Bewerten der Console können Sie testen, ob Ihre Änderungen übernommen 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 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 in Kategorien auf Ihrer Website stöbert (search.request.query ist leer) oder wenn er auf Ihrer Website sucht (search.request.query ist nicht leer).

Das folgende Beispiel zeigt Felder für ein durch Stöbervorgänge ausgelöstes Steuerelement, wobei 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 eine Suche ausgelöstes Steuerelement, wobei searchSolutionUseCase auf SEARCH_SOLUTION_USE_CASE_SEARCH gesetzt ist.

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

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

Weitere Informationen zu dieser Methode finden Sie in der ServingConfig.addControl API-Referenz.
Ein Beispiel für diese Methode finden Sie unter Bereitstellungskonfigurationen verwalten.

Zweiseitiges Synonymsteuerelement erstellen

Weitere Informationen zu diesem Einstellungstyp finden Sie unter Zweiwege-Synonymsteuerelemente.

Console

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

Zur Seite „Einstellungen“
Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerung erstellen.
Geben Sie in das Feld Name der Einstellung einen Namen für das neue Steuerelement ein.

Der Bereich Steuerelement erstellen wird geöffnet.

Im Bereich Einstellungen:

Optional: Klicken Sie zum Ändern der automatisch erstellten Einstellungs-ID auf Bearbeiten und geben Sie eine neue Einstellungs-ID ein.
Wählen Sie als Einstellungstyp Zweiwege-Synonymsteuerung 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, in denen diese Einstellung angewendet werden kann.
Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

Im Bereich Aktionen:

Geben Sie in das Feld Synonyme 2 bis 100 Suchbegriffe ein, z. B. shirt und top, die Synonyme miteinander sein sollen.

Wenn einer dieser Begriffe in einer Suchanfrage enthalten ist, werden die anderen Suchbegriffe als Synonyme des enthaltenen Begriffs betrachtet.
Klicken Sie auf Weiter, um zum Abschnitt Bereitstellungskonfigurationen zu gelangen.

Gehen Sie im Bereich Bereitstellungskonfigurationen so vor:

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. Auf der Seite Bewerten der Console können Sie testen, ob Ihre Änderungen übernommen 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 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 zu Bereitstellungskonfigurationen inline hinzufügen.

Einseitiges Synonymsteuerelement erstellen

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

Console

Rufen Sie in der Search for Retail-Konsole 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.

Im Bereich Einstellungen:

Geben Sie in das Feld Name der Einstellung einen Namen für das neue Steuerelement ein.
Optional: Klicken Sie zum Ändern der automatisch erstellten Einstellungs-ID auf Bearbeiten und geben Sie eine neue Einstellungs-ID ein.
Wählen Sie als Einstellungstyp 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, in denen 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), mit denen Synonyme verknüpft sein sollten, wenn sie in einer Abfrage enthalten sind.
Geben Sie in das Feld Synonyme Begriffe ein, die als Synonyme für die angegebenen Suchbegriffe verwendet werden sollen, z. B. sneakers und sandals als Einwegsynonyme für den Suchbegriff shoes.
Klicken Sie auf Weiter, um zum Abschnitt Bereitstellungskonfigurationen zu gelangen.

Gehen Sie im Bereich Bereitstellungskonfigurationen so vor:

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. Auf der Seite Bewerten der Console können Sie testen, ob Ihre Änderungen übernommen 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 einer Instanz von Control im Anfragetext.

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "oneWaySynonymAction": {
                  "synonyms": [
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "synonyms": [
                      "SYNONYM_1",
                      "SYNONYM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

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

Weitere Informationen zu dieser Methode finden Sie in der ServingConfig.addControl API-Referenz.
Ein Beispiel für diese Methode finden Sie unter Bereitstellungskonfigurationen verwalten.

Einstellung „Nicht verknüpfen“ erstellen

Weitere Informationen zu diesem Einstellungstyp finden Sie unter Steuerelemente vom Typ „Nicht verknüpfen“.

Console

Rufen Sie in der Search for Retail-Konsole 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.

Im Bereich Einstellungen:

Geben Sie in das Feld Name der Einstellung einen Namen für das neue Steuerelement ein.
Optional: Klicken Sie zum Ändern der automatisch erstellten Einstellungs-ID auf Bearbeiten und geben Sie eine neue Einstellungs-ID ein.
Wählen Sie als Einstellungstyp Steuerelement nicht verknüpfen 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, in denen diese Einstellung angewendet werden kann.
Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

Im Abschnitt Aktionen:

Geben Sie im Feld Abfragebegriffe Begriffe ein, z. B. gShoe, die Sie explizit von anderen unterscheiden möchten.
Geben Sie in das Feld Nicht verknüpfte Begriffe Begriffe ein, die in den Suchergebnissen nicht mit den von Ihnen angegebenen Suchbegriffen in Verbindung gebracht werden sollen.

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

Gehen Sie im Bereich Bereitstellungskonfigurationen so vor:

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. Auf der Seite Bewerten der Console können Sie testen, ob Ihre Änderungen übernommen 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 einer Instanz von Control im Anfragetext.

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "doNotAssociateAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "doNotAssociateTerms": [
                      "DISSOCIATED_TERM_1",
                      "DISSOCIATED_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

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

Weitere Informationen zu dieser Methode finden Sie in der ServingConfig.addControl API-Referenz.
Ein Beispiel für diese Methode finden Sie unter Bereitstellungskonfigurationen verwalten.

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

Im Bereich Einstellungen:

Geben Sie in das Feld Name der Einstellung einen Namen für das neue Steuerelement ein.
Optional: Klicken Sie zum Ändern der automatisch erstellten Einstellungs-ID auf Bearbeiten und geben Sie eine neue Einstellungs-ID ein.
Wählen Sie als Einstellungstyp Steuerelement nicht verknüpfen 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, in denen 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 der Eingabe als Suchbegriffe ignoriert werden sollen.
Klicken Sie auf Weiter, um zum Abschnitt Bereitstellungskonfigurationen zu gelangen.

Gehen Sie im Bereich Bereitstellungskonfigurationen so vor:

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. Auf der Seite Bewerten der Console können Sie testen, ob Ihre Änderungen übernommen 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 einer Instanz von Control im Anfragetext.

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

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

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

Weitere Informationen zu dieser Methode finden Sie in der ServingConfig.addControl API-Referenz.
Ein Beispiel für diese Methode finden Sie unter Bereitstellungskonfigurationen verwalten.

Ersetzungssteuerelement erstellen

Weitere Informationen zu diesem Einstellungstyp finden Sie unter Steuerelemente für die Ersetzung.

Console

Rufen Sie in der Search for Retail-Konsole 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.

Im Bereich Einstellungen:

Geben Sie in das Feld Name der Einstellung einen Namen für das neue Steuerelement ein.
Optional: Klicken Sie zum Ändern der automatisch erstellten Einstellungs-ID auf Bearbeiten und geben Sie eine neue Einstellungs-ID ein.
Wählen Sie als Einstellungstyp Ersetzungseinstellung 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, in denen diese Einstellung angewendet werden kann.
Klicken Sie auf Weiter, um zum Abschnitt Aktionen zu gelangen.

Im Bereich Aktionen:

Geben Sie im Feld Abfragebegriffe Suchbegriffe (z. B. gShoe) ein, die durch den Ersatzbegriff ersetzt werden sollen.
Geben Sie im Feld Ersatzbegriff den Begriff ein, der die von Ihnen angegebenen Abfragebegriffe ersetzen soll.

Sie können beispielsweise den Abfragebegriff gShoe durch den Ersatzbegriff Google Shoe ersetzen.
Klicken Sie auf Weiter, um zum Abschnitt Bereitstellungskonfigurationen zu gelangen.

Gehen Sie im Bereich Bereitstellungskonfigurationen so vor:

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. Auf der Seite Bewerten der Console können Sie testen, ob Ihre Änderungen übernommen 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 einer Instanz von Control im Anfragetext.

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

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

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

Weitere Informationen zu dieser Methode finden Sie in der ServingConfig.addControl API-Referenz.
Ein Beispiel für diese Methode finden Sie unter Bereitstellungskonfigurationen verwalten.