Dies ist die Dokumentation für Recommendations AI, Retail Search und die neue Retail Console.

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.

Hinweis

Für Empfehlungen und die Konfigurationen der Einzelhandelssuche in AI Search gelten unterschiedliche Anforderungen und Optionen:

  • Für KI-Auslieferungskonfigurationen 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 gewünschten Modells ab. Dies ist erforderlich, wenn Sie die Methode ServingConfig.create verwenden.

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

    Sie können später zu einem anderen Modell wechseln, sofern es sich um denselben Modelltyp handelt.

  • Die Funktion „Einzelhandelssuche“ kann zwar Steuerelemente zur Anzeigenauslieferung verwenden, ist aber nicht erforderlich. Wenn Sie vorhandene Steuerelemente an eine neue Bereitstellungskonfiguration anhängen möchten, rufen Sie die IDs der zu verwendenden Steuerelemente ab.

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

    Sie können die Steuerelemente für die Bereitstellung ändern oder der Bereitstellungskonfiguration hinzufügen, nachdem Sie sie erstellt haben.

Bereitstellungskonfiguration erstellen

Sie können eine Bereitstellungskonfiguration erstellen:

Pro Katalog sind bis zu 100 Auslieferungskonfigurationen zulässig.

Wenn Sie vorhandene Placements oder neue Placements haben, wird von der Retail API automatisch eine Bereitstellungskonfiguration für jedes Placement erstellt. Wenn Sie eine Bereitstellungskonfiguration erstellen, 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 in der Google Cloud Console auf der Seite Bereitstellungskonfigurationen eine neue Bereitstellungskonfiguration hinzu.

So erstellen Sie eine neue Bereitstellungskonfiguration:

  1. Rufen Sie in der Google Cloud Console die Seite „Konfigurationen für den Einzelhandel“ auf.

    Zur Seite "Bereitstellungskonfigurationen"

  2. Klicken Sie auf Bereitstellungskonfiguration erstellen.

    Recommendations AI

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

    2. Geben Sie einen Namen für Ihre 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 Preis-Reranking die Empfehlungsergebnisse beeinflussen soll.

      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, wie stark die Empfehlungsergebnisse diversifiziert werden sollen.

      Die Diversifizierung beeinflusst, ob die von einer einzelnen Vorhersageanfrage zurückgegebenen Ergebnisse aus verschiedenen Kategorien Ihres Produktkatalogs stammen.

    7. Wenn Sie das Modell „Ähnliche Artikel“ für diese Bereitstellungskonfiguration ausgewählt haben, müssen Sie angeben, ob der Kategorieabgleich aktiviert werden soll.

      Wenn der Kategorieabgleich aktiviert ist, gibt die Retail API nur Produktergebnisse zurück, die mindestens eine Kategorie mit dem Kontextprodukt teilen. Die Kategorieübereinstimmung kann in Kombination mit anderen Filteroptionen wie Preis, Verfügbarkeit und Filter-Tags verwendet werden.

    1. Wählen Sie auf der Seite Bereitstellungskonfiguration erstellen die Option Suche als Produkt aus, in dem die Bereitstellungskonfiguration verwendet werden soll.
    2. Geben Sie einen Namen für die Bereitstellungskonfiguration ein.

      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.

      Die ID wird anhand des von Ihnen angegebenen Namens generiert und muss in Ihrem Projekt eindeutig sein. Er darf nicht länger als 50 Zeichen sein und darf keine Leerzeichen enthalten.
    4. Klicken Sie auf Weiter.
    5. Wählen Sie aus, ob die dynamische Attribute für diese Bereitstellungskonfiguration aktiviert werden sollen.
    6. Wählen Sie Steuerelemente zur Anzeigenbereitstellung 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 API-Methode ServingConfig.create erstellen. Informationen zur API-Referenz für diese Methode findest du unter ServingConfig.create.

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

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

Recommendations AI

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

  • servingConfigId: erforderlich. Erstellt eine ID für Ihr 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 Name ServingConfig, der in der Retail Console angezeigt wird.
  • modelID: erforderlich. Die ID des Modells, das bei der Auslieferung verwendet werden soll.
  • priceRerankingLevel: optional. Legt fest, wie sich der 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.
  • enableCategoryFilterLevel: optional. Gibt an, ob zusätzliche Kategoriefilter für das Modell „Ähnliche Elemente“ hinzugefügt werden sollen. Zulässige Werte sind relaxed-category-match (Standardwert, falls nicht festgelegt) und no-category-match.
  • solutionTypes: erforderlich. Wählen Sie für Recommendations AI-Auslieferungskonfigurationen die Einstellung SOLUTION_TYPE_RECOMMENDATION aus.
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",
              "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"
  

Retail 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 Ihr 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 Name ServingConfig, der in der Retail Console angezeigt wird.
  • facetControlIds: optional. IDs von Steuerelementen, für die nur FacetSpec festgelegt sind.
  • dynamicFacetSpec.mode: optional. Modus der Funktion DynamicFacet. Zulässige Werte sind DISABLED (Standardeinstellung, wenn nicht festgelegt) und ENABLED.
  • boostControlIds: optional. IDs der Steuerelemente für die verbesserte Auslieferung.
  • filterControlIds: optional. IDs der Filtersteuerungen.
  • redirectControlIds: optional. IDs der Steuerelemente für die Weiterleitung.
  • twowaySynonymsControlIds: optional. IDs von Zwei-Wege-Syndikations-Steuerelementen
  • onewaySynonymsControlIds: optional. IDs von Einweg-Synthese-Steuerelementen
  • doNotAssociateControlIds: optional. IDs von Auslieferungssteuerungen, die nicht miteinander verknüpft sind.
  • replacementControlIds: optional. IDs der Ersatzbereitstellungssteuerungen
  • ignoreControlIds: optional. IDs der Steuerelemente für die Anzeigenbereitstellung ignorieren.
  • solutionTypes: erforderlich. Gibt den Wert für SOLUTION_TYPE_SEARCH für Konfigurationen der Einzelhandelssuche an.
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