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

Für Konfigurationen für Empfehlungen und die Bereitstellung von Suchergebnissen 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 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 während des Erstellungsprozesses auch neue Steuerelemente erstellen.

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

Bereitstellungskonfiguration erstellen

Sie können eine Bereitstellungskonfiguration mit folgenden Tools erstellen:

• Search for Retail-Konsole
• ServingConfig.create API

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

Fügen Sie in der Console „Suchen für Einzelhandel“ auf der Seite Bereitstellungskonfigurationen eine neue Bereitstellungskonfiguration hinzu.

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

   Empfehlungen

   1. Wählen Sie Recommendation 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 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 Preis-Reranking die Empfehlungsergebnisse beeinflussen soll, sofern 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, ob die von einer einzelnen Vorhersageanfrage zurückgegebenen Ergebnisse aus verschiedenen Kategorien Ihres Produktkatalogs stammen.

      • Datengestützt:Bei der datengestützten Diversifizierung wird maschinelles Lernen eingesetzt, um bei den Prognoseergebnissen ein Gleichgewicht zwischen Kategoriediversität und -relevanz herzustellen.

      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 festlegen, ob die Kategorieabgleichsfunktion aktiviert werden soll.

      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.

   Suchen

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

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"
  

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.