Einstellungen für die Auslieferung verwalten

Auf dieser Seite wird beschrieben, wie Sie Bereitstellungseinstellungen aufrufen, bearbeiten, löschen, exportieren und importieren.

Allgemeine Informationen zu Bereitstellungssteuerungen und eine Anleitung zum Erstellen von Bereitstellungssteuerungen finden Sie unter Bereitstellungssteuerungen und Bereitstellungssteuerungen erstellen.

Steuerelemente für die Bereitstellung aufrufen und bearbeiten

Sie können die Auslieferungssteuerungen für Vertex AI Search for Retail über die Console und die API aufrufen.

Steuerelemente für die Anzeigenbereitstellung in der Console ansehen und bearbeiten

Die Tab Steuerelemente für die Auslieferung auf der Seite „Einstellungen“ eine Liste aller Steuerelemente für die Anzeigenbereitstellung und der zugehörigen Bereitstellungskonfigurationen. Klicken Sie auf das Symbol für Bearbeitungssteuerelement zum Ändern eines Steuerelements Einstellungen und zugehörige Bereitstellungskonfigurationen finden Sie unter Steuerelement bearbeiten. . Klicken Sie auf das Symbol Steuerelement löschen ein Steuerelement, um es zu löschen, wodurch es auch aus allen Bereitstellungskonfigurationen entfernt wird.

Sie können die Steuerelemente für eine bestimmte Bereitstellungskonfiguration auf der Seite Bereitstellungskonfigurationen Klicken Sie auf eine Bereitstellungskonfiguration, um die zugehörige Seite Details aufzurufen, auf der alle Auslieferungssteuerung für diese Konfiguration. Klicken Sie auf das Symbol Steuerelement bearbeiten für ein Steuerelement, um die Einstellungen im Bereich Steuerelement bearbeiten zu ändern. Klicken Sie auf das Symbol Steuerelement entfernen, um die Verknüpfung des Steuerelements mit der Bereitstellungskonfiguration aufzuheben. Das Steuerelement wird dadurch nicht gelöscht.

Es dauert einige Minuten, bis neu erstellte oder aktualisierte Steuerelemente für die Bereitstellung von Live-Traffic verfügbar sind. Sie können testen, ob Ihre Änderungen auf der Seite Bewerten der Console.

Steuerelemente für die Anzeigenbereitstellung inline anzeigen

Um eine einzelne Auslieferungssteuerung inline zu sehen, verwenden Sie Control.get.

Weitere Informationen zu dieser Methode finden Sie in der Control.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/controls/CONTROL_ID'

Wenn Sie mehrere Steuerelemente für die Auslieferung inline auflisten möchten, verwenden Sie Controls.list.

Optional können Sie den Parameter pageSize verwenden, um eine maximale Anzahl von die zurückzugebenden Ergebnisse. Wenn weitere Ergebnisse verfügbar sind, enthält die Antwort list ein Seitentoken. Sie können ein Seitentoken im Parameter pageToken einer list übergeben. -Anforderung zum Abrufen der nächsten Ergebnisseite.

Wenn Sie nur die Steuerelemente auflisten möchten, die mit einer bestimmten Bereitstellungskonfiguration verknüpft sind, verwenden Sie den Abfrageparameter filter, um die ID der Bereitstellungskonfiguration anzugeben.

Weitere Informationen zu dieser Methode finden Sie in der Control.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/controls?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=servingConfig=SERVING_CONFIG_ID

Steuerelemente für die Patchbereitstellung inline einbinden

Verwenden Sie Controls.patch, um Felder in einer Auslieferungssteuerung zu aktualisieren. und fügen Sie eine Instanz von Control in den Anfragetext ein. Geben Sie die Felder, die mit dem Parameter updateMask aktualisiert werden sollen. Wenn Sie den Parameter nicht festlegen, wird er aktualisiert. alle unterstützten Felder.

Weitere Informationen zu dieser Methode finden Sie in der Controls.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/controls/CONTROL_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/controls/CONTROL_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

Inline-Steuerelemente zu Bereitstellungskonfigurationen hinzufügen

Verwenden Sie ServingConfig.addControl, um einer Bereitstellungskonfiguration ein Steuerelement hinzuzufügen.

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

Ein Beispiel für diese Methode finden Sie unter Bereitstellungskonfigurationen verwalten

Einstellungen 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.addControl API-Referenz

Ein Beispiel für diese Methode finden Sie unter Bereitstellungskonfigurationen verwalten

Steuerelement für die Bereitstellung löschen

Sie können ein Auslieferungskontrollelement über die Console oder inline mit der Methode Controls.delete löschen.

Bereitstellungssteuerung in der Console löschen

Sie können ein Steuerelement für die Bereitstellung löschen, um dieses Steuerelement aus allen Bereitstellungskonfigurationen zu entfernen, die es verwenden.

1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen auf.
   
   Zur Seite „Einstellungen“

2. Klicken Sie in der Tabellenzeile des Steuerelements, das Sie entfernen möchten, auf Löschen.

3. Klicken Sie im Bestätigungsfenster auf Löschen, um den Löschvorgang abzuschließen.

Auslieferungssteuerung inline löschen

Verwenden Sie Controls.delete, um Steuerelemente für die Bereitstellung inline zu löschen.

Weitere Informationen zu dieser Methode finden Sie in der Controls.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/controls/SERVING_CONTROL_ID'

Bereitstellungseinstellungen exportieren

Vorschau

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Sie können Ihre Bereitstellungseinstellungen in eine Datei in einem Cloud Storage-Bucket exportieren.

Es gibt zwei Gründe, warum Sie Bereitstellungseinstellungen exportieren und importieren sollten:

• Um Auslieferungseinstellungen von einem Projekt in ein anderes zu verschieben

• So führen Sie eine Bulk-Änderung an allen oder einigen Steuerelementen für die Bereitstellung durch: Bereitstellung exportieren Steuerelemente bearbeiten, die exportierte Datei bearbeiten und dann die Datei, die Sie ändern oder hinzufügen möchten, Auslieferungseinstellungen.

Sie können Daten über die Search for Retail-Konsole exportieren und importieren. Wenn Sie Bereitstellungseinstellungen exportieren, werden alle Bereitstellungseinstellungen im Projekt exportiert.

So exportieren Sie Auslieferungseinstellungen:

1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen auf.
   
   Zur Seite „Steuerelemente“

2. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerelemente exportieren.

3. Wählen Sie im Fenster Bereitstellungseinstellungen exportieren den Cloud Storage-Bucket aus. in die Sie die Kontrolldatei exportieren möchten.

4. Klicken Sie auf Exportieren.

   Die exportierten Steuerelemente werden in einer NDJSON-Datei im ausgewählten Bucket mit einen Namen im folgenden Format:

   projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

5. Nach Abschluss des Exportvorgangs können Sie den Status des Vorgangs in der Liste Bulk-Import, -Export, Löschung von Aktivitäten im Export Aktivitätsfenster. Öffnen Sie das Fenster Exportaktivität, indem Sie im Nachrichtenfenster auf Anzeigen klicken oder der Anleitung unter Status eines bestimmten Integrationsvorgangs ansehen folgen.

Einstellungen für die Anzeigenbereitstellung importieren

Vorschau

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Wenn Sie Steuerelemente für die Bereitstellung hinzufügen oder vorhandene in Bulk ändern möchten, können Sie die Änderungen in einer exportierten Steuerelementdatei vornehmen. Diese können Sie dann in in ein anderes Projekt übertragen Projekt arbeiten.

Wissenswertes zum Importieren von Bereitstellungseinstellungen:

• Sie können eine Datei mit Bereitstellungseinstellungen nicht importieren, wenn sie sowohl Bereitstellungseinstellungen für Suchergebnisse als auch für Empfehlungen enthält.

• Wenn Sie Bereitstellungseinstellungen importieren, werden alle Bereitstellungseinstellungen in der Datei mit der Bereitstellungskonfiguration verknüpft, die Sie beim Import angeben. Wenn eine Bereitstellungseinstellung bereits mit einer anderen Bereitstellungskonfiguration im Projekt verknüpft ist, wird diese Verknüpfung ebenfalls beibehalten.

So importierst du Einstellungen für die Auslieferung:

1. Bearbeiten und prüfen Sie eine exportierte Bereitstellungskontrolldatei und legen Sie sie in einem Cloud Storage-Bucket ab. Informationen zum Exportieren von Bereitstellungseinstellungen finden Sie in der vorherigen Aufgabe Bereitstellungseinstellungen exportieren)

   Achten Sie darauf, dass die Datei nur Steuerelemente für die Suchbereitstellung oder Einstellungen zur Auslieferung von Empfehlungen. Sie können keine Datei importieren, die beide Typen enthält.

2. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen auf.
   
   Zur Seite „Steuerelemente“

3. Klicken Sie auf dem Tab Steuerelemente für die Auslieferung auf Steuerelemente importieren.

4. Gehen Sie im Fenster Bereitstellungseinstellungen importieren so vor:

   1. Wählen Sie den Cloud Storage-Bucket und die NDJSON-Datei mit den Steuerelementen aus, die Sie importieren möchten.

   2. Wählen Sie die Bereitstellungskonfiguration aus, mit der Sie die importierten Bereitstellungseinstellungen verknüpfen möchten.

   3. Sehen Sie sich den Importvorschauplan an. Die Steuerelemente, die erstellt werden, werden auf dem Tab Neu angezeigt. Die Steuerelemente, die geändert werden, werden auf dem Tab Geändert angezeigt.

5. Klicken Sie auf Importieren.

   Ein lang andauernder Vorgang wird gestartet, um die neuen und geänderten Steuerelementen.

6. Nach Abschluss des Importvorgangs sehen Sie den Vorgangsstatus im Fenster Aktivitätsstatus auf dem Tab Steuerelemente. Öffnen Sie das Fenster Aktivitätsstatus, indem Sie im Nachrichtenfenster auf Anzeigen klicken oder der Anleitung unter Status eines bestimmten Integrationsvorgangs ansehen folgen.