Bereitstellungskonfigurationen verwalten

Auf dieser Seite wird beschrieben, wie Sie Bereitstellungskonfigurationen löschen, bearbeiten und auflisten sowie Statistiken zu jeder Konfiguration überprüfen.

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

Wenn Sie bereits Placements haben oder neue Placements erstellen, erstellt Vertex AI Search für den Einzelhandel automatisch eine Bereitstellungskonfiguration, die mit jedem Placement verknüpft ist. Beim Erstellen einer Bereitstellungskonfiguration wird kein entsprechendes Placement erstellt. Beim Löschen einer Bereitstellungskonfiguration wird das entsprechende Placement gelöscht. Beim Löschen eines Placements wird auch die entsprechende Bereitstellungskonfiguration gelöscht.

Bereitstellungskonfigurationen bearbeiten

Sie können Bereitstellungskonfigurationen mit der Search for Retail-Konsole oder der API bearbeiten.

Hinweis :Wenn Sie wesentliche Änderungen an einer Bereitstellungskonfiguration vornehmen, die ein Optimierungsmodell auf Seitenebene enthält, gibt das Modell zur Optimierung auf Seitenebene möglicherweise während des erneuten Trainings suboptimale Ergebnisse zurück. Da es sehr lange dauern kann, das Optimierungsmodell auf Seitenebene neu zu trainieren, empfiehlt es sich, das Modell und die zugehörige Bereitstellungskonfiguration neu zu erstellen.

Bereitstellungskonfigurationen in der Console bearbeiten

Auf der Seite Bereitstellungskonfigurationen können Sie die Steuerelemente für jede Bereitstellungskonfiguration ansehen und bearbeiten. Klicken Sie auf eine Bereitstellungskonfiguration, um die zugehörige Seite Details aufzurufen. Dort sind alle Bereitstellungs- und websiteweiten Steuerelemente für diese Konfiguration aufgeführt.

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 bereit sind. Sie können Änderungen sofort auf der Seite Bewerten testen.

Bereitstellungskonfigurationen inline bearbeiten

Mit API-Methoden können Sie Bereitstellungskonfigurationsfelder aktualisieren, Bereitstellungseinstellungen hinzufügen und Bereitstellungseinstellungen entfernen.

Bereitstellungskonfigurationen inline patchen

Verwenden Sie ServingConfig.patch und fügen Sie eine Instanz von ServingConfig in den Anfragetext ein, um Felder in einer Bereitstellungskonfiguration zu aktualisieren. Geben Sie die Felder an, die mit dem Parameter updateMask aktualisiert werden sollen, oder lassen Sie die Richtlinie nicht konfiguriert, 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. Beispielsweise wird das Steuerelement facetSpec 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 mit der Search for Retail-Konsole oder der API ansehen.

Bereitstellungskonfigurationen in der Console ansehen

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

Bereitstellungskonfigurationen inline ansehen

Wenn Sie eine einzelne Bereitstellungskonfiguration inline anzeigen 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 den Parameter pageSize verwenden, um die maximale Anzahl der zurückzugebenden Ergebnisse festzulegen. Wenn mehr Ergebnisse verfügbar sind, enthält die Antwort list 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 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 mit der Search for Retail-Konsole oder der API löschen.

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

Bereitstellungskonfigurationen in der Console löschen

So löschen Sie eine Bereitstellungskonfiguration in der Console:

1. Rufen Sie in der Search for Retail-Konsole 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 die ID noch einmal eingeben und auf Bestätigen klicken, um den Löschvorgang abzuschließen.

Bereitstellungskonfiguration inline löschen

Wenn Sie eine einzelne Bereitstellungskonfiguration inline löschen möchten, verwenden Sie ServingConfig.delete.

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 jeder Bereitstellungskonfiguration finden Sie auf der Seite Bereitstellungskonfigurationen. Klicken Sie für eine beliebige Konfiguration in der Tabelle auf Analysen ansehen, um die Statistiken aufzurufen.

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.