Gestire le configurazioni di pubblicazione

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

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

Per il funzionamento della ricerca non è necessario configurare una configurazione di pubblicazione. Qualsiasi serving_config_id può essere inserito nell'ambito della richiesta di ricerca, nel qual caso viene impostato per impostazione predefinita su un controllo di pubblicazione vuoto o non configurato. Viene quindi eseguita la ricerca nel catalogo con la funzionalità di ricerca predefinita di Vertex AI Search for Commerce.

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 comporta la creazione di un posizionamento corrispondente. L'eliminazione di una configurazione di pubblicazione elimina il posizionamento corrispondente e l'eliminazione di un posizionamento elimina la configurazione di pubblicazione corrispondente.

Modifica configurazioni di pubblicazione

Puoi modificare le configurazioni di pubblicazione utilizzando la console Search for commerce 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 visualizzare la pagina Dettagli, che elenca tutti i controlli di pubblicazione e a livello di sito per quella configurazione.

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

Affinché le configurazioni di pubblicazione appena create o aggiornate siano pronte a gestire il traffico live, sono necessari alcuni minuti. Puoi testare immediatamente le modifiche nella pagina Valuta.

Modificare le configurazioni di pubblicazione in linea

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

Modifica in linea delle configurazioni di pubblicazione

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 saperne di più su questo metodo, consulta il riferimento 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 dei 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 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 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 configurazioni di pubblicazione

Puoi visualizzare le configurazioni di pubblicazione utilizzando la console di ricerca per il commercio 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 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 inline, utilizza ServingConfig.list.

Se vuoi, 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 di pagina. Puoi passare un token di pagina nel parametro pageToken di una richiesta list per recuperare la pagina successiva dei risultati.

Per saperne di più su questo metodo, consulta il riferimento 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 gestione utilizzando la console Search for commerce 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 Search for Commerce.
   
   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 deleteElimina nella barra dei pulsanti nella parte superiore della pagina.

4. Se la configurazione di pubblicazione è considerata attiva, devi digitare nuovamente 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 inline, utilizza ServingConfig.delete.

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

Esaminare 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.

La 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.