Bereitstellungskonfigurationen erstellen

Auf dieser Seite wird beschrieben, wie Sie Bereitstellungskonfigurationen erstellen. Eine Bereitstellungskonfiguration ist eine Bereitstellungsentität, die ein Modell oder eine Reihe von Steuerelementen verknüpft, die zum Generieren der Such- oder Empfehlungsergebnisse verwendet werden. Weitere Informationen zu Bereitstellungskonfigurationen finden Sie unter Informationen zu Bereitstellungskonfigurationen.

Hinweis

Für Bereitstellungskonfigurationen für Empfehlungen und die Suche gelten unterschiedliche Anforderungen und Optionen:

Für Bereitstellungskonfigurationen für Empfehlungen ist ein Modell erforderlich. Wenn Sie ein vorhandenes Modell an eine neue Bereitstellungskonfiguration anhängen möchten, rufen Sie die ID des Modells ab, das Sie verwenden möchten. Dies ist erforderlich, wenn Sie die Methode ServingConfig.create verwenden.

Wenn Sie die Bereitstellungskonfiguration über die Console erstellen, können Sie während des Erstellungsprozesses ein neues Modell erstellen, anstatt ein vorhandenes Modell anzuhängen.

Sie können Modelle später wechseln, solange sie vom selben Modelltyp sind.
Für die Suche können Bereitstellungssteuerelemente verwendet werden, sie sind jedoch nicht erforderlich. Wenn Sie vorhandene Steuerelemente an eine neue Bereitstellungskonfiguration anhängen möchten, rufen Sie die IDs der Steuerelemente ab, die Sie verwenden möchten.

Wenn Sie die Bereitstellungskonfiguration über die Console erstellen, können Sie während des Erstellungsprozesses auch neue Steuerelemente erstellen.

Sie können Bereitstellungssteuerelemente nach dem Erstellen der Bereitstellungskonfiguration wechseln oder hinzufügen.

Bereitstellungskonfiguration erstellen

Sie können eine Bereitstellungskonfiguration mit folgenden Tools erstellen:

Die Search for Commerce Console.
Die ServingConfig.create API.

Pro Katalog sind bis zu 100 Bereitstellungskonfigurationen zulässig.

Die Suche funktioniert auch mit nicht konfigurierten Bereitstellungskonfigurationen. Jede serving_config_id kann als Teil der Suchanfrage platziert werden. Bei dieser default_search wird der Katalog mit der Standardsuchfunktion von Agent Platform Search for Commerce durchsucht.

Wenn Sie bestehende Placements haben oder neue Placements erstellen, wird automatisch eine Bereitstellungskonfiguration erstellt, die mit jedem Placement verknüpft ist. Durch das Erstellen einer Bereitstellungskonfiguration wird kein entsprechendes Placement erstellt. Wenn Sie eine Bereitstellungskonfiguration löschen, wird auch das entsprechende Placement gelöscht. Wenn Sie ein Placement löschen, wird auch die entsprechende Bereitstellungskonfiguration gelöscht.

Bereitstellungskonfiguration in der Konsole erstellen

Fügen Sie auf der Seite „Bereitstellungskonfigurationen“ in der Search for Commerce Console eine neue Bereitstellungskonfiguration hinzu.

So erstellen Sie eine neue Bereitstellungskonfiguration:

Rufen Sie in der Search for Commerce Console die Seite Bereitstellungskonfigurationen auf.

Zur Seite „Bereitstellungskonfigurationen“
Klicken Sie auf Bereitstellungskonfiguration erstellen.
Empfehlungen
1. Wählen Sie Empfehlung als Produkt aus, für das die Bereitstellungskonfiguration verwendet wird.
2. Geben Sie einen Namen für die Bereitstellungskonfiguration an.
  
  Der Name darf höchstens 1.024 Zeichen lang sein und nur alphanumerische Zeichen, Unterstriche, Bindestriche und Leerzeichen enthalten.
3. Optional: Aktualisieren Sie bei Bedarf die ID.
  
  Die ID wird aus dem von Ihnen angegebenen Namen generiert und muss in Ihrem Projekt eindeutig sein. Sie darf maximal 50 Zeichen lang sein und keine Leerzeichen enthalten.
4. Wählen oder erstellen Sie ein Modell, für das diese Bereitstellungskonfiguration Empfehlungen abgeben soll.
  
  Weitere Informationen zum Erstellen neuer Modelle
5. Wählen Sie aus, wie stark das Preis-Reranking die Empfehlungsergebnisse beeinflussen soll, sofern es für das ausgewählte Modell verfügbar ist.
  
  Beim Preis-Reranking werden die empfohlenen Produkte mit einer ähnlichen Empfehlungswahrscheinlichkeit nach Preis sortiert, wobei die Elemente mit dem höchsten Preis zuerst aufgelistet werden. Die Relevanz wird ebenfalls verwendet, um Artikel zu sortieren. Daher entspricht das Aktivieren des Preis-Rerankings nicht dem Sortieren nach Preis.
6. Wählen Sie aus, ob Sie die regelbasierte oder datengestützte Ergebnisdiversifizierung verwenden möchten:
  - Regelbasiert:Die regelbasierte Ergebnisdiversifizierung beeinflusst, ob die von einer einzelnen Vorhersageanfrage zurückgegebenen Ergebnisse aus verschiedenen Kategorien Ihres Produktkatalogs stammen.
  - Datengestützt:Die datengestützte Ergebnisdiversifizierung nutzt maschinelles Lernen, um ein Gleichgewicht zwischen Kategoriediversität und ‑relevanz in Ihren Vorhersageergebnissen herzustellen.
  Weitere Informationen finden Sie unter Ergebnisdiversifizierung.
7. Wählen Sie aus, wie stark die Empfehlungsergebnisse diversifiziert werden sollen.
8. Wenn Sie für diese Bereitstellungskonfiguration ein Modell für ähnliche Artikel ausgewählt haben, wählen Sie aus, ob die Kategorieübereinstimmung aktiviert werden soll.
  
  Wenn die Kategorieübereinstimmung aktiviert ist, werden nur Produkt-Ergebnisse zurückgegeben, die mindestens eine Kategorie mit dem Kontextprodukt gemeinsam haben. Die Kategorieübereinstimmung kann in Kombination mit anderen Filteroptionen wie Preis, Verfügbarkeit und Filter-Tags verwendet werden.
Suchen
1. Wählen Sie auf der Seite Bereitstellungskonfiguration erstellen die Option Suche als Produkt aus, für das die Bereitstellungskonfiguration verwendet wird.
2. Geben Sie einen Namen für die Bereitstellungskonfiguration an.
  
  Der Name darf höchstens 1.024 Zeichen lang sein und nur alphanumerische Zeichen, Unterstriche, Bindestriche und Leerzeichen enthalten.
3. Optional: Aktualisieren Sie bei Bedarf die ID.
  
  Die ID wird aus dem von Ihnen angegebenen Namen generiert und muss in Ihrem Projekt eindeutig sein. Sie darf maximal 50 Zeichen lang sein und keine Leerzeichen enthalten.
4. Klicken Sie auf Weiter.
5. Wählen Sie aus, ob das dynamische Attribut für diese Bereitstellungskonfiguration aktiviert werden soll.
6. Wählen Sie Bereitstellungssteuerelemente aus, um Ihre Suchanfragen zu optimieren.
  
  Weitere Informationen zu Steuerelementen finden Sie unter Steuerelemente erstellen und verwalten.
Klicken Sie auf Erstellen , um die neue Konfiguration anzulegen.

Die neue Konfiguration wird auf der Seite Bereitstellungskonfigurationen angezeigt.

Es kann einige Minuten dauern, bis die Konfiguration für die Verwendung in Suchanfragen verfügbar ist. Sie ist sofort für Empfehlungen verfügbar.
Optional: Klicken Sie auf der Seite „Bereitstellungskonfigurationen“ auf einen Namen für die Bereitstellungskonfiguration und gehen Sie zum Tab Bewerten , um eine Vorschau der Produkte anzuzeigen, die für diese Konfiguration zurückgegeben werden würden.

Mithilfe der Bewertungsvorschau können Sie prüfen, ob Ihre Konfiguration die erwartete Leistung bringt.

Bereitstellungskonfiguration mit `ServingConfig.create` erstellen

Sie können eine Bereitstellungskonfiguration mit der API-Methode ServingConfig.create erstellen. Die API-Referenzdokumentation für diese Methode finden Sie unter ServingConfig.create.

Welche Felder Sie verwenden, hängt davon ab, ob Sie eine Bereitstellungskonfiguration für Empfehlungen oder die Suche erstellen.

Weitere Informationen zu den ServingConfig Feldern finden Sie in der ServingConfigs API-Referenz.

Empfehlungen

Stellen Sie eine ServingConfig.create-Anfrage mit einer Bereitstellungskonfigurations-ID und einer Instanz von ServingConfig im Anfragetext.

servingConfigId: erforderlich. Erstellt eine ID für Ihre ServingConfig. Dieser Wert sollte 4 bis 63 Zeichen lang sein. Gültige Zeichen sind /[a-z][0-9]-_/.
displayName: erforderlich. Der für Menschen lesbare ServingConfig-Name, der in der Search for Commerce Console angezeigt wird.
modelID: erforderlich. Die ID des Modells, das zur Bereitstellungszeit verwendet werden soll.
priceRerankingLevel: optional. Legt fest, wie stark das Preis-Reranking die Empfehlungsergebnisse beeinflussen soll. Zulässige Werte sind no-price-reranking (Standardwert, wenn nicht festgelegt), low-price-raranking, medium-price-reranking und high-price-reranking.
diversityLevel: optional. Legt fest, wie stark die Empfehlungsergebnisse diversifiziert werden sollen. Zulässige Werte sind no-diversity (Standard), low-diversity, medium-diversity, high-diversity und auto-diversity. Wenn diversityLevel nicht festgelegt ist, ist die Diversifizierung deaktiviert.
diversityType: optional. Legen Sie RULE_BASED_DIVERSITY fest, um die Empfehlungsergebnisse nach Produktkategorie zu diversifizieren. Legen Sie DATA_DRIVEN_DIVERSITY fest, um Empfehlungen auf Grundlage von Produktmetadaten zu diversifizieren, um ein Gleichgewicht zwischen Relevanz und Kategoriediversität herzustellen. Wenn diversityLevel festgelegt ist, aber diversityType nicht, wird diversityType standardmäßig auf regelbasiert gesetzt. Weitere Informationen finden Sie unter Ergebnisdiversifizierung.
enableCategoryFilterLevel: optional. Legt fest, ob dem Modell für ähnliche Artikel zusätzliche Kategoriefilter hinzugefügt werden sollen. Zulässige Werte sind relaxed-category-match (Standardwert, wenn nicht festgelegt) und no-category-match.
solutionTypes: erforderlich. Legen Sie für Bereitstellungskonfigurationen für Empfehlungen SOLUTION_TYPE_RECOMMENDATION fest.

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",
              "modelId": "MODEL_ID",
              "priceRerankingLevel": "PRICE_RERANKING_LEVEL",
              "diversityType": "DIVERSITY_TYPE",
              "diversityLevel": "DIVERSITY_LEVEL",
              "enableCategoryFilterLevel": "CATEGORY_FILTER_LEVEL",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ]
            }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"

Suchen

Stellen Sie eine ServingConfig.create-Anfrage mit einer Bereitstellungskonfigurations-ID und einer Instanz von ServingConfig im Anfragetext.

servingConfigId: erforderlich. Erstellt eine ID für Ihre ServingConfig. Dieser Wert sollte 4 bis 63 Zeichen lang sein. Gültige Zeichen sind /[a-z][0-9]-_/.
displayName: erforderlich. Der für Menschen lesbare ServingConfig-Name, der in der Search for Commerce Console angezeigt wird.
facetControlIds: optional. IDs von Steuerelementen, für die nur FacetSpec festgelegt ist.
dynamicFacetSpec.mode: optional. Modus des Features DynamicFacet. Zulässige Werte sind DISABLED (Standardwert, wenn nicht festgelegt) und ENABLED.
boostControlIds: optional. IDs von Steuerelementen für die Boost-Bereitstellung.
filterControlIds: optional. IDs von Steuerelementen für die Filterbereitstellung.
redirectControlIds: optional. IDs von Steuerelementen für die Weiterleitungsbereitstellung.
twowaySynonymsControlIds: optional. IDs von Steuerelementen für die bidirektionale Synonymbereitstellung.
onewaySynonymsControlIds: optional. IDs von Steuerelementen für die unidirektionale Synonymbereitstellung.
doNotAssociateControlIds: optional. IDs von Steuerelementen für die Bereitstellung ohne Verknüpfung.
replacementControlIds: optional. IDs von Steuerelementen für die Bereitstellung von Ersetzungen.
ignoreControlIds: optional. IDs von Steuerelementen für die Bereitstellung von Ignorierungen.
solutionTypes: erforderlich. Legen Sie für Bereitstellungskonfigurationen für die Suche SOLUTION_TYPE_SEARCH fest.

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,
              "facetControlIds": [
                "FACET_CONTROL_ID_1",
                "FACET_CONTROL_ID_2"
              ],
              "dynamicFacetSpec": {
                "mode": "DYNAMIC_FACET_MODE"
              },
              "boostControlIds": [
                "BOOST_CONTROL_ID_1",
                "BOOST_CONTROL_ID_2"
              ],
              "filterControlIds": [
                "FILTER_CONTROL_ID_1",
                "FILTER_CONTROL_ID_2"
              ],
              "redirectControlIds": [
                "REDIRECT_CONTROL_ID_1",
                "REDIRECT_CONTROL_ID_2"
              ],
              "twowaySynonymsControlIds": [
                "TWO_WAY_SYNONYM_CONTROL_ID_1",
                "TWO_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "onewaySynonymsControlIds": [
                "ONE_WAY_SYNONYM_CONTROL_ID_1",
                "ONE_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "doNotAssociateControlIds": [
                "DO_NOT_ASSOCIATE_CONTROL_ID_1",
                "DO_NOT_ASSOCIATE_CONTROL_ID_2"
              ],
              "replacementControlIds": [
                "REPLACEMENT_CONTROL_ID_1",
                "REPLACEMENT_CONTROL_ID_2"
              ],
              "ignoreControlIds": [
                "IGNORE_CONTROL_ID_1",
                "IGNORE_CONTROL_ID_2"
              ],
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ]
    }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"

Nächste Schritte

Fordern Sie Vorhersagen zu Ihrem neuen Placement an.

Bereitstellungskonfigurationen erstellen Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Hinweis

Bereitstellungskonfiguration erstellen

Bereitstellungskonfiguration in der Konsole erstellen

Empfehlungen

Suchen

Bereitstellungskonfiguration mit ServingConfig.create erstellen

Empfehlungen

Suchen

Nächste Schritte

Bereitstellungskonfigurationen erstellen

Bereitstellungskonfiguration mit `ServingConfig.create` erstellen