Gestisci 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 ogni posizionamento. La creazione di una configurazione di pubblicazione non crea un posizionamento corrispondente. L'eliminazione di una configurazione di pubblicazione comporta l'eliminazione del posizionamento corrispondente, mentre l'eliminazione di un posizionamento comporta l'eliminazione della configurazione di pubblicazione corrispondente.

Modifica configurazioni di pubblicazione

Puoi modificare le configurazioni di pubblicazione utilizzando la console Search for Retail o l'API.

Modifica 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 visualizzare la relativa pagina Dettagli, che elenca tutti i controlli di pubblicazione e a livello di sito per la configurazione in questione.

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

Sono necessari alcuni minuti perché le configurazioni di pubblicazione appena create o aggiornate siano pronte per gestire il traffico in tempo reale. Puoi testare subito le modifiche nella pagina Valuta.

Modifica configurazioni di pubblicazione in linea

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

Configurazioni di pubblicazione patch 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 oppure lascialo non impostato per aggiornare tutti i campi supportati.

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'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'

Aggiungi controlli alle configurazioni di pubblicazione in linea

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

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'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'

Rimuovi controlli dalle configurazioni di pubblicazione incorporati

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

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'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 Search for Retail o l'API.

Visualizza le configurazioni di pubblicazione nella console

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

Visualizza le configurazioni di pubblicazione in linea

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

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'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 incorporate, utilizza ServingConfig.list.

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

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'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'

Elimina una configurazione di pubblicazione

Puoi eliminare le configurazioni di pubblicazione utilizzando la console o l'API Search for Retail.

Elimina le configurazioni di pubblicazione nella console

Per eliminare una configurazione di pubblicazione nella console:

  1. Vai alla pagina Configurazioni di pubblicazione nella console di Search for Retail.

    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 in alto nella pagina.

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

Elimina una configurazione di pubblicazione incorporata

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

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'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'

Revisione delle statistiche della configurazione di pubblicazione

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

La percentuale di clic mostra il numero di clic per ricerca relativi alla configurazione di pubblicazione. Il tasso di conversione indica gli acquisti per ricerca della configurazione.