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 Suchkonfigurationen haben unterschiedliche Anforderungen und Optionen:

  • Für Konfigurationen für die Bereitstellung von 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 (erforderlich bei Verwendung der Methode ServingConfig.create).

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

    Sie können das Modell später wechseln, solange es sich um denselben Modelltyp handelt.

  • Suche kann Auslieferungseinstellungen verwenden, das ist aber nicht zwingend 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 neue Steuerelemente erstellen.

    Sie können die Bereitstellungskonfiguration nach dem Erstellen ändern oder neue Bereitstellungseinstellungen hinzufügen.

Bereitstellungskonfiguration erstellen

So erstellen Sie eine Bereitstellungskonfiguration:

Pro Katalog sind bis zu 100 Bereitstellungskonfigurationen zulässig.

Wenn Sie bereits Placements haben oder neue erstellen, wird für jedes Placement automatisch eine Auslieferungskonfiguration erstellt. Wenn Sie eine Bereitstellungskonfiguration erstellen, wird kein entsprechendes Placement erstellt. Beim Löschen einer Bereitstellungskonfiguration wird das entsprechende Placement gelöscht. Beim Löschen eines Placements wird die entsprechende Bereitstellungskonfiguration gelöscht.

Bereitstellungskonfiguration in der Console erstellen

Fügen Sie auf der Seite Bereitstellungskonfigurationen in der Search for Retail-Konsole eine neue Bereitstellungskonfiguration hinzu.

So erstellen Sie eine neue Bereitstellungskonfiguration:

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

    Zur Seite „Bereitstellungskonfigurationen“

  2. Klicken Sie auf Bereitstellungskonfiguration erstellen.

    Empfehlungen

    1. Wählen Sie Recommendation (Empfehlung) als Produkt aus, für das die Bereitstellungskonfiguration verwendet wird.

    2. Geben Sie einen Namen für die Bereitstellungskonfiguration ein.

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

      Weitere Informationen zum Erstellen neuer Modelle

    5. Wählen Sie aus, wie stark sich das Preis-Reranking auf die Empfehlungsergebnisse auswirken soll, sofern dies 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 die regelbasierte oder die datengetriebene Diversifizierung verwendet werden soll:

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

      • Datengetrieben: Bei der datengetriebenen Diversifizierung wird maschinelles Lernen verwendet, um in den Vorhersageergebnissen ein Gleichgewicht zwischen Kategoriediversität und -relevanz herzustellen.

      Weitere Informationen finden Sie unter Diversifizierung.

    7. Wählen Sie aus, wie stark die Empfehlungsergebnisse diversifiziert werden sollen.

    8. Wenn Sie für diese Bereitstellungskonfiguration ein ähnliches Modell ausgewählt haben, geben Sie an, ob der Kategorieabgleich aktiviert werden soll.

      Wenn der Kategorieabgleich aktiviert ist, werden nur Ergebnisse zurückgegeben, die mindestens eine Kategorie mit dem Kontextprodukt teilen. Der Kategorieabgleich kann mit anderen Filteroptionen wie Preis, Verfügbarkeit und Filter-Tags kombiniert werden.

    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 maximal 1.024 Zeichen lang sein und darf nur alphanumerische Zeichen, Unterstriche, Bindestriche und Leerzeichen enthalten.
    3. Optional: Aktualisieren Sie die ID bei Bedarf.

      Die ID wird aus dem von Ihnen angegebenen Namen generiert und muss in Ihrem Projekt eindeutig sein. Er darf maximal 50 Zeichen lang sein und darf keine Leerzeichen enthalten.
    4. Klicken Sie auf Weiter.
    5. Wählen Sie aus, ob dynamische Attribute für diese Bereitstellungskonfiguration aktiviert werden sollen.
    6. Wählen Sie Bereitstellungseinstellungen aus oder erstellen Sie Steuerelemente, 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 den Namen einer Bereitstellungskonfiguration und rufen Sie den Tab Bewerten auf, um eine Vorschau der Produkte anzusehen, die für diese Konfiguration zurückgegeben werden.

    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 für die Suche erstellen.

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

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 ServingConfig. Dieser Wert muss zwischen 4 und 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 Retail-Konsole angezeigt wird.
  • modelID: erforderlich. Die ID des Modells, das zum Zeitpunkt der Bereitstellung verwendet werden soll.
  • priceRerankingLevel: Optional. Legt fest, wie stark sich das Preis-Reranking auf die Empfehlungsergebnisse auswirken soll. Zulässige Werte sind no-price-reranking (Standardwert, falls nicht festgelegt), low-price-raranking, medium-price-reranking und high-price-reranking.
  • diversityLevel: Optional. Legt fest, um wie viel 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, wird die Diversität deaktiviert.
  • diversityType: Optional. Legen Sie RULE_BASED_DIVERSITY fest, um die Empfehlungsergebnisse je nach Produktkategorie zu diversifizieren. Legen Sie DATA_DRIVEN_DIVERSITY fest, um Empfehlungen basierend auf dem Lernen aus Produktmetadaten zu diversifizieren und ein Gleichgewicht zwischen Relevanz und Kategorievielfalt zu finden. Wenn diversityLevel festgelegt ist, aber diversityType nicht festgelegt ist, ist diversityType standardmäßig regelbasiert. Weitere Informationen finden Sie unter Diversifizierung.
  • enableCategoryFilterLevel: Optional. Legt fest, ob zusätzliche Kategoriefilter für das Modell „Ähnliche Elemente“ hinzugefügt werden sollen. Zulässige Werte sind relaxed-category-match (Standardwert, wenn nicht festgelegt) und no-category-match.
  • solutionTypes: erforderlich. Legen Sie diesen Wert für Empfehlungen zur Bereitstellung von Konfigurationen auf 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"

search

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

  • servingConfigId: erforderlich. Erstellt eine ID für ServingConfig. Dieser Wert muss zwischen 4 und 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 Retail-Konsole angezeigt wird.
  • facetControlIds: Optional. IDs von Steuerelementen, für die nur FacetSpec festgelegt ist.
  • dynamicFacetSpec.mode: Optional. Modus der Funktion „DynamicFacet“. Zulässige Werte sind DISABLED (Standard, wenn nicht festgelegt) und ENABLED.
  • boostControlIds: Optional. IDs der Steuerelemente zur Steigerung der Anzeigenbereitstellung.
  • filterControlIds: Optional. IDs der Steuerelemente für die Filterbereitstellung.
  • redirectControlIds: Optional. IDs der Steuerelemente für die Weiterleitung.
  • twowaySynonymsControlIds: Optional. IDs von Steuerelementen für die bidirektionale Synonymbereitstellung.
  • onewaySynonymsControlIds: Optional. IDs von Steuerelementen für die unidirektionale Synonymbereitstellung.
  • doNotAssociateControlIds: Optional. IDs von Bereitstellungseinstellungen, die nicht verknüpft werden sollen.
  • replacementControlIds: Optional. IDs der Ersatzsteuerelemente zur Bereitstellung.
  • ignoreControlIds: Optional. IDs der ignorierten Auslieferungseinstellungen.
  • solutionTypes: erforderlich. Legen Sie diesen Wert für die Suche in Bereitstellungskonfigurationen auf 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"

Weitere Informationen