Bereitstellungskonfigurationen verwalten

Auf dieser Seite wird beschrieben, wie Sie Bereitstellungskonfigurationen löschen, bearbeiten und auflisten sowie Statistiken zu den einzelnen Konfigurationen prüfen.

Informationen zum Erstellen einer neuen Bereitstellungskonfiguration finden Sie unter Bereitstellungskonfigurationen erstellen.

Es ist nicht erforderlich, eine Bereitstellungskonfiguration zu konfigurieren, damit die Suche funktioniert. Jede serving_config_id kann als Teil der Suchanfrage platziert werden. In diesem Fall wird standardmäßig eine leere oder nicht konfigurierte Bereitstellungssteuerung verwendet. Der Katalog wird dann mit der Standardsuchfunktion von Vertex AI Search for Commerce durchsucht.

Wenn Sie bestehende Placements haben oder neue Placements erstellen, wird in Vertex AI Search for Retail automatisch eine mit jedem Placement verknüpfte Bereitstellungskonfiguration erstellt. 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.

Bereitstellungskonfigurationen bearbeiten

Sie können Serving-Konfigurationen über die Search for Commerce Console oder die API bearbeiten.

Hinweis :Wenn Sie erhebliche Änderungen an einer Bereitstellungskonfiguration vornehmen, die ein Modell zur Optimierung auf Seitenebene enthält, liefert das Modell möglicherweise suboptimale Ergebnisse, während es neu trainiert wird. Da es lange dauern kann, das Optimierungsmodell auf Seitenebene neu zu trainieren, sollten Sie es und die zugehörige Bereitstellungskonfiguration neu erstellen.

Bereitstellungskonfigurationen in der Console bearbeiten

Die Steuerelemente für jede Bereitstellungskonfiguration können Sie auf der Seite „Bereitstellungskonfigurationen“ aufrufen und bearbeiten. Klicken Sie auf eine Bereitstellungskonfiguration, um die Seite Details aufzurufen, auf der alle Bereitstellungs- und Website-Steuerelemente für diese Konfiguration aufgeführt sind.

Auf dieser Seite können Sie Steuerelemente bearbeiten, neue Steuerelemente erstellen oder vorhandene Steuerelemente auf die Konfiguration anwenden.

Es dauert einige Minuten, bis neu erstellte oder aktualisierte Bereitstellungskonfigurationen für die Bereitstellung von Live-Traffic verwendet werden. Sie können Änderungen sofort auf der Seite Bewerten testen.

Bereitstellungskonfigurationen inline bearbeiten

Sie können Felder der Bereitstellungskonfiguration aktualisieren, Bereitstellungssteuerungen hinzufügen und Bereitstellungssteuerungen inline mit API-Methoden entfernen.

Bereitstellungskonfigurationen inline patchen

Wenn Sie Felder in einer Serving-Konfiguration aktualisieren möchten, verwenden Sie ServingConfig.patch und fügen Sie eine Instanz von ServingConfig in den Anfragetext ein. Geben Sie die zu aktualisierenden Felder mit dem Parameter updateMask an oder lassen Sie ihn leer, um alle unterstützten Felder zu aktualisieren.

Weitere Informationen zu dieser Methode finden Sie in der API-Referenz für ServingConfig.patch.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID",
      "FIELD_NAME_1": "NEW_FIELD_VALUE_1"
      "FIELD_NAME_2": "NEW_FIELD_VALUE_2"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

Steuerelemente inline zu Bereitstellungskonfigurationen hinzufügen

Verwenden Sie ServingConfig.addControl, um einer Bereitstellungskonfiguration ein Steuerelement hinzuzufügen. Das Steuerelement wird an der letzten Position der Liste der Steuerelemente hinzugefügt, zu der es gehört. Beispiel: Eine facetSpec-Steuerung wird an der letzten Position von servingConfig.facetSpecIds angewendet.

Weitere Informationen zu dieser Methode finden Sie in der API-Referenz für ServingConfig.addControl.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "controlID": "CONTROL_ID"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

Steuerelemente inline aus Bereitstellungskonfigurationen entfernen

Verwenden Sie ServingConfig.removeControl, um ein Steuerelement aus einer Bereitstellungskonfiguration zu entfernen.

Weitere Informationen zu dieser Methode finden Sie in der API-Referenz für ServingConfig.removeControl.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "controlID": "CONTROL_ID"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:removeControl'

Bereitstellungskonfigurationen ansehen

Sie können Bereitstellungskonfigurationen über die Search for Commerce-Konsole oder die API aufrufen.

Bereitstellungskonfigurationen in der Console ansehen

Alle Ihre Bereitstellungskonfigurationen finden Sie auf der Seite Bereitstellungskonfigurationen.

Bereitstellungskonfigurationen inline ansehen

Wenn Sie eine einzelne Bereitstellungskonfiguration inline aufrufen möchten, verwenden Sie ServingConfig.get.

Weitere Informationen zu dieser Methode finden Sie in der API-Referenz für ServingConfig.get.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID'

Verwenden Sie ServingConfig.list, um alle Bereitstellungskonfigurationen inline aufzulisten.

Optional können Sie mit dem Parameter pageSize eine maximale Anzahl der zurückzugebenden Ergebnisse festlegen. Wenn weitere Ergebnisse verfügbar sind, enthält die list-Antwort ein Seitentoken. Sie können ein Seitentoken im Parameter pageToken einer list-Anfrage übergeben, um die nächste Ergebnisseite abzurufen.

Weitere Informationen zu dieser Methode finden Sie in der API-Referenz für ServingConfig.list.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

Bereitstellungskonfiguration löschen

Sie können Serving-Konfigurationen über die Search for Commerce Console oder die API löschen.

Hinweis :Wenn Sie eine Serving-Konfiguration löschen, die von einem Optimierungsmodell auf Seitenebene verwendet wird, müssen Sie auch das Optimierungsmodell auf Seitenebene löschen und neu erstellen. Andernfalls gibt das Optimierungsmodell auf Seitenebene die gelöschte Bereitstellungskonfiguration zurück.

Bereitstellungskonfigurationen in der Konsole löschen

So löschen Sie eine Bereitstellungskonfiguration in der Console:

1. Rufen Sie in der Search for Commerce Console die Seite Bereitstellungskonfigurationen auf.
   
   Zur Seite „Bereitstellungskonfigurationen“

2. Klicken Sie auf die Bereitstellungskonfiguration, die Sie löschen möchten, um die zugehörige Detailseite zu öffnen.

3. Klicken Sie am oberen Seitenrand in der Schaltflächenleiste auf Löschen.

4. Wenn die Bereitstellungskonfiguration als aktiv gilt, müssen Sie ihre ID noch einmal eingeben und auf Bestätigen klicken, um den Löschvorgang abzuschließen.

Bereitstellungskonfiguration inline löschen

Verwenden Sie ServingConfig.delete, um eine einzelne Bereitstellungskonfiguration inline zu löschen.

Weitere Informationen zu dieser Methode finden Sie in der API-Referenz für ServingConfig.delete.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID'

Statistiken zur Bereitstellungskonfiguration prüfen

Details zu den einzelnen Bereitstellungskonfigurationen finden Sie auf der Seite „Bereitstellungskonfigurationen“. Klicken Sie für eine beliebige Konfiguration in der Tabelle auf Analysen ansehen, um die Statistiken aufzurufen.

Die Klickrate gibt die Klicks pro Suche für die Bereitstellungskonfiguration an. Conversion-Rate gibt die Käufe pro Suche für die Konfiguration an.

Hinweis: Die Zeiträume für Statistiken werden in der Zeitzone "Pacific Time" angegeben. Tägliche Statistiken stellen beispielsweise Daten für den Zeitraum von gestern um Mitternacht Pacific Time bis heute um Mitternacht Pacific Time dar.