Gestire le configurazioni di pubblicazione

Questa pagina descrive come eliminare, modificare ed elencare le configurazioni di pubblicazione, nonché esaminare le statistiche relative a ogni configurazione.

Per assistenza sulla creazione di una nuova configurazione di pubblicazione, consulta Creare configurazioni di pubblicazione.

Se hai posizionamenti esistenti o ne crei di nuovi, Vertex AI Search for Retail crea automaticamente una configurazione di pubblicazione associata a ciascun posizionamento. La creazione di una configurazione di pubblicazione non genera un posizionamento corrispondente. L'eliminazione di una configurazione di pubblicazione elimina il corrispondente posizionamento e l'eliminazione di un posizionamento elimina la corrispondente configurazione di pubblicazione.

Modificare le configurazioni di pubblicazione

Puoi modificare le configurazioni di pubblicazione utilizzando la console di ricerca per la vendita al dettaglio o l'API.

Modificare le configurazioni di pubblicazione nella console

Puoi visualizzare e modificare i controlli per ogni configurazione di pubblicazione nella pagina Configurazioni di pubblicazione. Fai clic su una configurazione di pubblicazione per visualizzarne la pagina Dettagli, che elenca tutti i controlli di pubblicazione e per l'intero sito per quella configurazione.

In questa pagina puoi modificare i controlli, crearne di nuovi o applicare quelli esistenti alla configurazione.

Le configurazioni di pubblicazione appena create o aggiornate devono essere pronte per gestire il traffico in tempo reale in pochi minuti. Puoi testare subito le modifiche nella pagina Valuta.

Modificare le configurazioni di pubblicazione in linea

Puoi aggiornare i campi di configurazione di pubblicazione, aggiungere controlli di pubblicazione e rimuovere i controlli di pubblicazione in linea utilizzando i metodi API.

Esegui il patching delle configurazioni di pubblicazione in linea

Per aggiornare i campi in una configurazione di pubblicazione, utilizza ServingConfig.patch e includi un'istanza di ServingConfig nel corpo della richiesta. Specifica i campi da aggiornare con il parametro updateMask o lascialo non impostato per aggiornare tutti i campi supportati.

Per saperne di più su questo metodo, consulta il riferimento all'API 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'

Aggiungere controlli alle configurazioni di pubblicazione in linea

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza ServingConfig.addControl. Il controllo viene aggiunto all'ultima posizione dell'elenco di controlli a cui appartiene. Ad esempio, un controllo facetSpec viene applicato nell'ultima posizione di servingConfig.facetSpecIds.

Per saperne di più su questo metodo, consulta il riferimento all'API 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'

Rimuovere i controlli dalle configurazioni di pubblicazione in linea

Per rimuovere un controllo da una configurazione di pubblicazione, utilizza ServingConfig.removeControl.

Per saperne di più su questo metodo, consulta il riferimento all'API 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'

Visualizza le configurazioni di pubblicazione

Puoi visualizzare le configurazioni di pubblicazione utilizzando la console di ricerca per la vendita al dettaglio o l'API.

Visualizzare le configurazioni di pubblicazione nella console

Puoi visualizzare tutte le configurazioni di pubblicazione nella pagina Configurazioni di pubblicazione.

Visualizza le configurazioni di pubblicazione in linea

Per visualizzare una singola configurazione di pubblicazione in linea, utilizza ServingConfig.get.

Per saperne di più su questo metodo, consulta il riferimento all'API 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'

Per elencare tutte le configurazioni di pubblicazione in linea, utilizza ServingConfig.list.

Facoltativamente, puoi utilizzare il parametro pageSize per impostare un numero massimo di risultati da restituire. Se sono disponibili altri risultati, la risposta list include un token pagina. Puoi passare un token di pagina nel parametro pageToken di una richiesta list per recuperare la pagina di risultati successiva.

Per saperne di più su questo metodo, consulta il riferimento all'API 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'

Eliminare una configurazione di pubblicazione

Puoi eliminare le configurazioni di pubblicazione utilizzando la console di Ricerca per la vendita al dettaglio o l'API.

Eliminare le configurazioni di pubblicazione nella console

Per eliminare una configurazione di pubblicazione nella console:

  1. Vai alla pagina Configurazioni di pubblicazione nella console Ricerca per la vendita al dettaglio.

    Vai alla pagina Configurazioni di pubblicazione

  2. Fai clic sulla configurazione di pubblicazione che vuoi eliminare per aprire la relativa pagina dei dettagli.

  3. Fai clic su Elimina nella barra dei pulsanti nella parte superiore della pagina.

  4. Se la configurazione di pubblicazione è considerata attiva, devi digitare di nuovo il relativo ID e fare clic su Conferma per completare l'eliminazione.

Eliminare una configurazione di pubblicazione in linea

Per eliminare una singola configurazione di pubblicazione in linea, utilizza ServingConfig.delete.

Per saperne di più su questo metodo, consulta il riferimento all'API 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'

Esamina le statistiche della configurazione di pubblicazione

Puoi visualizzare i dettagli di ogni configurazione di pubblicazione nella pagina Configurazioni di pubblicazione. Per qualsiasi configurazione nella tabella, fai clic su Visualizza analisi per visualizzarne le statistiche.

Percentuale di clic mostra i clic per ricerca per la configurazione di pubblicazione. Il tasso di conversione indica gli acquisti per ricerca per la configurazione.