Gestisci le configurazioni di pubblicazione

In questa pagina viene descritto come eliminare, modificare ed elencare le configurazioni di pubblicazione, nonché le statistiche relative a ogni configurazione.

Per informazioni sulla creazione di una nuova configurazione di pubblicazione, consulta Crea 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 comporta l'eliminazione del corrispondente posizionamento, mentre l'eliminazione di un posizionamento comporta l'eliminazione della corrispondente configurazione di pubblicazione.

Modifica 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 nel Pagina Configurazioni di pubblicazione. Fai clic su configurazione di pubblicazione per visualizzare la relativa pagina Dettagli, che elenca tutte le pubblicazioni controlli a livello di 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.

Modifica 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 di 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 ulteriori informazioni su questo metodo, consulta 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'

Aggiungi 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 del servingConfig.facetSpecIds.

Per ulteriori informazioni su questo metodo, consulta 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'

Rimuovi 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 Search for Retail o l'API.

Visualizzare le configurazioni di pubblicazione nella console

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

Visualizzare 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 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 trasmettere un token di pagina nel parametro pageToken di un list per recuperare la pagina successiva di 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 pubblicazione utilizzando la console di ricerca per la vendita al dettaglio o l'API.

Elimina 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 in corrispondenza 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.

Elimina 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 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 per ogni configurazione di pubblicazione nel 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.