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.

Wenn Sie bestehende Placements haben oder neue Placements erstellen, erstellt Vertex AI Search for Retail automatisch eine Bereitstellungskonfiguration, 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.

Bereitstellungskonfigurationen bearbeiten

Sie können Bereitstellungskonfigurationen über die Search for Retail-Konsole oder die API bearbeiten.

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

Mit API-Methoden kannst du Bereitstellungskonfigurationsfelder aktualisieren, Bereitstellungssteuerungen hinzufügen und inline entfernen.

Bereitstellungskonfigurationen Inline patchen

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

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

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: Ein facetSpec-Steuerelement wird an der letzten Position von servingConfig.facetSpecIds angewendet.

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

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 ServingConfig.removeControl API-Referenz.

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 Retail-Konsole oder die API aufrufen.

Bereitstellungskonfigurationen in der Console ansehen

Sie können alle Ihre Bereitstellungskonfigurationen auf der Seite Bereitstellungskonfigurationen aufrufen.

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 ServingConfig.get API-Referenz.

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 von Ergebnissen festlegen, die zurückgegeben werden sollen. 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 findest du in der ServingConfig.list API-Referenz.

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 Bereitstellungskonfigurationen über die Retail Search Console oder die API löschen.

Bereitstellungskonfigurationen in der Console löschen

So löschen Sie eine Bereitstellungskonfiguration in der Console:

  1. Rufen Sie in der Search for Retail 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 ServingConfig.delete API-Referenz.

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.