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.

Hinweise

Empfehlungen und Konfigurationen der Suchbereitstellung haben 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 bei Verwendung der Methode ServingConfig.create erforderlich.

    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 das Modell später wechseln, sofern es sich um denselben Modelltyp handelt.

  • Für die Suche können Bereitstellungssteuerungen verwendet werden, sie sind aber 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 auch neue Steuerelemente hinzufügen.

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

Bereitstellungskonfiguration erstellen

Sie können eine Bereitstellungskonfiguration erstellen mit:

Pro Katalog sind bis zu 100 Auslieferungskonfigurationen zulässig.

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. Löschen eines Bereitstellungskonfiguration löscht das entsprechende Placement und löscht ein Placement löscht die entsprechende Bereitstellungskonfiguration.

Bereitstellungskonfiguration in der Console erstellen

Fügen Sie eine neue Bereitstellungskonfiguration für Seite "Bereitstellungskonfigurationen" in der Search for Retail-Konsole.

So erstellen Sie eine neue Bereitstellungskonfiguration:

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

    Zur Seite „Bereitstellungskonfigurationen“

  2. Klicken Sie auf Bereitstellungskonfiguration erstellen.

    Empfehlungen

    1. Wählen Sie Empfehlung als Produkt in der Bereitstellungskonfiguration aus. für die Daten verwendet werden.

    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 Sie ein Modell aus 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 sich das Preis-Reranking auf die Empfehlungsergebnisse auswirken soll. falls für das ausgewählte Modell verfügbar.

      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 eine regelbasierte oder eine datengetriebene Diversifizierung verwenden möchten:

      • Regelbasiert:Die regelbasierte Diversifizierung wirkt sich darauf aus, Ergebnisse, die von einer einzelnen Vorhersageanfrage zurückgegeben werden, stammen von verschiedene Kategorien Ihres Produktkatalogs.

      • Datengetrieben:Bei der datengetriebenen Diversifizierung kommt maschinelles Lernen zum Einsatz. um ein Gleichgewicht zwischen Kategoriediversität und Relevanz in Ihrer Vorhersage zu finden. Ergebnisse.

      Weitere Informationen finden Sie unter Diversifikation.

    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, können Sie die Kategorieabgleichsfunktion aktivieren.

      Wenn die Kategorieabgleich-Funktion aktiviert ist, werden nur Produktergebnisse zurückgegeben, die mindestens eine Kategorie mit dem Kontextprodukt teilen. Die Kategorisierung kann in Kombination mit anderen Filteroptionen wie Preis, Verfügbarkeit und Filter-Tags verwendet werden.

    1. Wählen Sie auf der Seite Bereitstellungskonfiguration erstellen 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. Muss 50 sein Zeichen oder weniger und darf 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 Steuerelemente für die Auslieferung aus oder erstellen Sie sie, um Ihre Suchanfragen zu optimieren.

      Weitere Informationen zu Steuerelementen finden Sie unter Steuerelemente erstellen und verwalten.

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

  4. 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 ServingConfig.create API erstellen . Die API-Referenzdokumentation zu dieser 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 ID der Auslieferungskonfiguration und einer Instanz von ServingConfig im Anfragetext.

  • servingConfigId: erforderlich. Erstellt eine ID für Ihr ServingConfig. Dieses muss zwischen 4 und 63 Zeichen lang sein. Gültige Zeichen sind /[a-z][0-9]-_/.
  • displayName: erforderlich. Der für Menschen lesbare Name ServingConfig, der angezeigt wird in der Search for Retail-Konsole.
  • modelID: erforderlich. Die ID des Modells, das bei der Auslieferung verwendet werden soll.
  • priceRerankingLevel: Optional. Hier legen Sie 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 Empfehlungen diversifiziert werden sollen Ergebnisse. Zulässige Werte sind no-diversity (Standard), low-diversity, medium-diversity, high-diversity und auto-diversity. Wenn diversityLevel ist nicht festgelegt, dann wird die Vielfalt deaktiviert.
  • diversityType: Optional. Legen Sie RULE_BASED_DIVERSITY fest, um Empfehlungsergebnisse nach Produktkategorie zu diversifizieren. Festlegen auf DATA_DRIVEN_DIVERSITY, um die Empfehlungen basierend auf Lerninhalten zu diversifizieren von Produktmetadaten, um ein ausgewogenes Verhältnis zwischen Relevanz und Kategorievielfalt zu schaffen. Wenn diversityLevel festgelegt ist, diversityType aber nicht, wird diversityType standardmäßig auf „regelbasiert“ gesetzt. Weitere Informationen finden Sie unter Diversifizierung:
  • enableCategoryFilterLevel: Optional. Legen Sie fest, ob dem Modell „Ähnliche Artikel“ zusätzliche Kategoriefilter hinzugefügt werden sollen. Zulässige Werte sind relaxed-category-match (Standardwert, falls nicht festgelegt) und no-category-match.
  • solutionTypes: erforderlich. Auf SOLUTION_TYPE_RECOMMENDATION festlegen für Konfiguration von Empfehlungen zur Bereitstellung von Empfehlungen.
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 einem Instanz von ServingConfig im Anfragetext.

  • servingConfigId: erforderlich. Erstellt eine ID für Ihr ServingConfig. Dieses muss zwischen 4 und 63 Zeichen lang sein. Gültige Zeichen sind /[a-z][0-9]-_/.
  • displayName: erforderlich. Der für Menschen lesbare Name ServingConfig, der angezeigt wird in der Search for Retail-Konsole.
  • facetControlIds: Optional. IDs von Einstellungen, die nur FacetSpec enthalten festgelegt.
  • dynamicFacetSpec.mode: Optional. Modus der DynamicFacet-Funktion. Zulässige Werte sind DISABLED (Standardwert, wenn nicht festgelegt) und ENABLED.
  • boostControlIds: Optional. IDs der Einstellungen für die Boost-Bereitstellung.
  • filterControlIds: Optional. IDs der Filterbereitstellungssteuerungen.
  • redirectControlIds: Optional. IDs der Einstellungen für die Weiterleitungsbereitstellung.
  • twowaySynonymsControlIds: Optional. IDs der bidirektionalen Bereitstellung von Synonymen Steuerelementen.
  • onewaySynonymsControlIds: Optional. IDs der einseitigen Synonymbereitstellung Steuerelementen.
  • doNotAssociateControlIds: Optional. IDs der Steuerelemente für die Auslieferung ohne Verknüpfung.
  • replacementControlIds: Optional. IDs der Ersatzsteuerelemente für die Auslieferung.
  • ignoreControlIds: Optional. IDs der Steuerelemente für die Auslieferung ignorieren
  • solutionTypes: erforderlich. Auf SOLUTION_TYPE_SEARCH festlegen für in Bereitstellungskonfigurationen suchen.
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