Questa è la documentazione di Recommendations AI, Retail Search e la nuova console di Retail.

Gestisci configurazioni di pubblicazione

Questa pagina descrive come eliminare, modificare ed elencare le configurazioni di pubblicazione, nonché le statistiche di revisione su 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, l'API Retail crea automaticamente una configurazione di pubblicazione associata a ogni posizionamento. La creazione di una configurazione di pubblicazione non crea un posizionamento corrispondente. Se elimini una configurazione di pubblicazione, viene eliminato il relativo posizionamento. Se elimini un posizionamento, viene eliminata anche la configurazione di pubblicazione corrispondente.

Modifica delle configurazioni di pubblicazione

Puoi modificare le configurazioni di pubblicazione utilizzando la Console retail o l'API Retail.

Modifica delle 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 per la pubblicazione per visualizzare la relativa pagina Dettagli, che elenca tutti i controlli di pubblicazione e di tutto il sito per quella configurazione.

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

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

Modifica 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 dell'API Retail.

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

Per scoprire di più su questo metodo, consulta i riferimenti per le 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 alla pubblicazione delle configurazioni 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, viene applicato un controllo facetSpec nell'ultima posizione di servingConfig.facetSpecIds.

Per scoprire di più su questo metodo, consulta i riferimenti per le 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 dalla pubblicazione delle configurazioni in linea

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

Per scoprire di più su questo metodo, consulta i riferimenti per le 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 retail o l'API Retail.

Visualizza 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 un'unica configurazione di pubblicazione incorporata, utilizza ServingConfig.get.

Per scoprire di più su questo metodo, consulta i riferimenti per le 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 di pagina. Puoi passare un token di pagina nel parametro pageToken di una richiesta list per recuperare la pagina successiva dei risultati.

Per scoprire di più su questo metodo, consulta i riferimenti per le 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 retail o l'API Retail.

Elimina le configurazioni di pubblicazione nella console

Per eliminare una configurazione di pubblicazione nella console:

  1. Vai alla pagina Configurazioni di vendita al dettaglio in Google Cloud Console.

    Vai alla pagina Configurazioni di pubblicazione

  2. Fai clic sulla configurazione della 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 ridigitarne l'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 scoprire di più su questo metodo, consulta i riferimenti per le 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 di configurazione della pubblicazione

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

La percentuale di clic indica i clic per ricerca relativi alla configurazione di pubblicazione. Il tasso di conversione indica gli acquisti per la ricerca per la configurazione.