Questa pagina descrive come creare configurazioni di pubblicazione. Una configurazione di pubblicazione è un'entità di pubblicazione che associa un modello o un insieme di controlli utilizzati per generare risultati di ricerca o suggerimenti.
Prima di iniziare
I suggerimenti e le configurazioni di pubblicazione hanno requisiti e opzioni diversi:
per configurare le configurazioni di pubblicazione dei suggerimenti. Se prevedi di collegare un modello esistente a una nuova configurazione di pubblicazione, recupera l'ID del modello che intendi utilizzare (obbligatorio se utilizzi il metodo
ServingConfig.create
).Se crei la configurazione di pubblicazione utilizzando la console, puoi creare un nuovo modello durante il processo di creazione, anziché collegare un modello esistente.
Puoi cambiare modello in un secondo momento, purché sia dello stesso tipo.
possono utilizzare i controlli di pubblicazione, ma non sono obbligatori. Se prevedi di collegare i controlli esistenti a una nuova configurazione di pubblicazione, recupera gli ID dei controlli che intendi utilizzare.
Se crei la configurazione di pubblicazione utilizzando la console, puoi anche creare nuovi controlli durante il processo di creazione.
Puoi cambiare o aggiungere controlli di pubblicazione alla configurazione di pubblicazione dopo averla creata.
Creare una configurazione di pubblicazione
Puoi creare una configurazione di pubblicazione utilizzando:
Sono consentite fino a 100 configurazioni di pubblicazione per catalogo.
Se disponi già di posizionamenti o ne crei di nuovi, viene creata 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 elimina la configurazione di pubblicazione corrispondente.
Crea una configurazione di pubblicazione nella console
Aggiungi una nuova configurazione di pubblicazione nella pagina Configurazioni di pubblicazione nella console di Search for Retail.
Per creare una nuova configurazione di pubblicazione:
Vai alla pagina Configurazioni di pubblicazione nella console di Search for Retail.
Vai alla pagina Configurazioni di pubblicazioneFai clic su add_boxCrea configurazione di pubblicazione.
suggerimenti
Seleziona Consiglio come prodotto per il quale verrà utilizzata la configurazione di pubblicazione.
Specifica un nome per la configurazione di pubblicazione.
Il nome deve avere una lunghezza massima di 1024 caratteri e può contenere solo caratteri alfanumerici, trattini bassi, trattini e spazi.
(Facoltativo) Se necessario, aggiorna l'ID.
L'ID viene generato dal nome che fornisci e deve essere univoco in tutto il progetto. Deve contenere al massimo 50 caratteri e non può contenere spazi.
Scegli o crea un modello per cui questa configurazione di pubblicazione fornisce suggerimenti.
Scopri di più sulla creazione di nuovi modelli.
Seleziona in che misura il re-ranking del prezzo deve influire sui risultati dei suggerimenti, se disponibili per il modello selezionato.
Con il re-ranking del prezzo, i prodotti consigliati con una probabilità di consiglio simile vengono ordinati per prezzo, partendo dagli articoli con il prezzo più alto. La pertinenza viene ancora utilizzata anche per ordinare gli articoli, pertanto abilitare il re-ranking del prezzo non è la stessa cosa che ordinare per prezzo.
Scegli se utilizzare la diversificazione basata su regole o sui dati:
Basata su regole: la diversificazione basata su regole determina se i risultati restituiti da una singola richiesta di previsione provengono da categorie diverse del tuo catalogo dei prodotti.
Basato sui dati: la diversificazione basata sui dati utilizza il machine learning per bilanciare la diversità delle categorie e la pertinenza nei risultati delle previsioni.
Per ulteriori informazioni, consulta la sezione Diversificazione.
Seleziona in che misura diversificare i risultati dei suggerimenti.
Se hai selezionato un modello Elementi simili per questa configurazione di pubblicazione, scegli se abilitare la corrispondenza delle categorie.
Quando la corrispondenza delle categorie è attivata, gli unici risultati restituiti sono quelli che condividono almeno una categoria con il prodotto di contesto. La corrispondenza delle categorie può essere utilizzata in combinazione con altre opzioni di filtro, ad esempio prezzo, disponibilità e tag di filtro.
search
- Nella pagina Crea configurazione di pubblicazione, scegli Cerca come prodotto per cui verrà utilizzata la configurazione di pubblicazione.
- Specifica un nome per la configurazione di pubblicazione.
Il nome deve avere una lunghezza massima di 1024 caratteri e può contenere solo caratteri alfanumerici, trattini bassi, trattini e spazi. - (Facoltativo) Se necessario, aggiorna l'ID.
L'ID viene generato dal nome che hai fornito e deve essere univoco in tutto il progetto. Deve avere una lunghezza massima di 50 caratteri e non può contenere spazi. - Fai clic su Continua.
- Scegli se attivare il faceting dinamico per questa configurazione di pubblicazione.
- Scegli o crea controlli di pubblicazione con cui ottimizzare le ricerche.
Per ulteriori informazioni sui controlli, consulta Creazione e gestione dei controlli.
Fai clic su Crea per creare la nuova configurazione.
La nuova configurazione viene visualizzata nella pagina Configurazioni di pubblicazione.
Potrebbero essere necessari alcuni minuti prima che la configurazione diventi disponibile per l'utilizzo nelle richieste di ricerca. È immediatamente disponibile per i consigli.
(Facoltativo) Nella pagina Configurazioni di pubblicazione, fai clic sul nome di una configurazione di pubblicazione e vai alla scheda Valuta per visualizzare l'anteprima dei prodotti che verranno restituiti per questa configurazione.
L'anteprima della valutazione può aiutarti a verificare che la configurazione funzioni come previsto.
Crea una configurazione di pubblicazione con ServingConfig.create
Puoi creare una configurazione di pubblicazione con il metodo
API ServingConfig.create
. Per la documentazione di riferimento delle API per questo metodo, consulta
ServingConfig.create
.
I campi da utilizzare dipendono dal fatto che tu stia creando una configurazione di pubblicazione per i suggerimenti o la ricerca.
Per maggiori dettagli sui campi ServingConfig
, consulta la
documentazione di riferimento dell'API ServingConfigs
.
suggerimenti
Effettua una richiesta ServingConfig.create
con un ID configurazione di pubblicazione e un'istanza di ServingConfig
contenuta nel corpo della richiesta.
servingConfigId
: obbligatorio. Crea un ID per il tuoServingConfig
. Questo valore deve contenere da 4 a 63 caratteri. I caratteri validi sono/[a-z][0-9]-_/
.displayName
: obbligatorio. Il nome leggibile diServingConfig
visualizzato nella console di Search for Retail.modelID
: obbligatorio. L'ID del modello da utilizzare al momento della pubblicazione.priceRerankingLevel
: facoltativo. Imposta in che misura il re-ranking del prezzo influisce sui risultati dei suggerimenti. I valori consentiti sonono-price-reranking
(valore predefinito se non impostato),low-price-raranking
,medium-price-reranking
ehigh-price-reranking
.diversityLevel
: facoltativo. Imposta in che misura diversificare i risultati dei suggerimenti. I valori consentiti sonono-diversity
(predefinito),low-diversity
,medium-diversity
,high-diversity
eauto-diversity
. SediversityLevel
non è impostato, la diversità è disattivata.diversityType
: facoltativo. Imposta suRULE_BASED_DIVERSITY
per diversificare i risultati dei consigli in base alla categoria di prodotto. Imposta il valore suDATA_DRIVEN_DIVERSITY
per diversificare i suggerimenti in base all'apprendimento dai metadati dei prodotti per bilanciare pertinenza e diversità di categoria. SediversityLevel
è impostato, madiversityType
non è impostato,diversityType
per impostazione predefinita sarà basato su regole. Per ulteriori informazioni, consulta Diversificazione.enableCategoryFilterLevel
: facoltativo. Consente di stabilire se aggiungere altri filtri per le categorie al modello Articoli simili. I valori consentiti sonorelaxed-category-match
(valore predefinito se non impostato) eno-category-match
.solutionTypes
: obbligatorio. Impostalo suSOLUTION_TYPE_RECOMMENDATION
per le configurazioni di pubblicazione dei suggerimenti.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "modelId": "MODEL_ID", "priceRerankingLevel": "PRICE_RERANKING_LEVEL", "diversityType": "DIVERSITY_TYPE", "diversityLevel": "DIVERSITY_LEVEL", "enableCategoryFilterLevel": "CATEGORY_FILTER_LEVEL", "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ] }' \ "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
search
Effettua una richiesta ServingConfig.create
con un ID configurazione di pubblicazione e un'istanza di ServingConfig
contenuta nel corpo della richiesta.
servingConfigId
: obbligatorio. Crea un ID per il tuoServingConfig
. Questo valore deve contenere da 4 a 63 caratteri. I caratteri validi sono/[a-z][0-9]-_/
.displayName
: obbligatorio. Il nome leggibile diServingConfig
visualizzato nella console di Search for Retail.facetControlIds
: facoltativo. ID dei controlli che hanno impostato soloFacetSpec
.dynamicFacetSpec.mode
: facoltativo. Modalità della funzionalitàDynamicFacet
. I valori consentiti sonoDISABLED
(valore predefinito se non impostato) eENABLED
.boostControlIds
: facoltativo. ID dei controlli di aumento della pubblicazione.filterControlIds
: facoltativo. ID dei controlli di pubblicazione filtri.redirectControlIds
: facoltativo. ID dei controlli di pubblicazione reindirizzamento.twowaySynonymsControlIds
: facoltativo. ID dei controlli di pubblicazione dei sinonimi bidirezionale.onewaySynonymsControlIds
: facoltativo. ID dei controlli unidirezionali di pubblicazione dei sinonimi.doNotAssociateControlIds
: facoltativo. ID dei controlli di pubblicazione Non associare.replacementControlIds
: facoltativo. ID dei controlli di pubblicazione sostitutivi.ignoreControlIds
: facoltativo. ID dei controlli di pubblicazione per ignorare.solutionTypes
: obbligatorio. Impostalo suSOLUTION_TYPE_SEARCH
per le configurazioni di pubblicazione delle ricerche.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": DISPLAY_NAME, "facetControlIds": [ "FACET_CONTROL_ID_1", "FACET_CONTROL_ID_2" ], "dynamicFacetSpec": { "mode": "DYNAMIC_FACET_MODE" }, "boostControlIds": [ "BOOST_CONTROL_ID_1", "BOOST_CONTROL_ID_2" ], "filterControlIds": [ "FILTER_CONTROL_ID_1", "FILTER_CONTROL_ID_2" ], "redirectControlIds": [ "REDIRECT_CONTROL_ID_1", "REDIRECT_CONTROL_ID_2" ], "twowaySynonymsControlIds": [ "TWO_WAY_SYNONYM_CONTROL_ID_1", "TWO_WAY_SYNONYM_CONTROL_ID_2" ], "onewaySynonymsControlIds": [ "ONE_WAY_SYNONYM_CONTROL_ID_1", "ONE_WAY_SYNONYM_CONTROL_ID_2" ], "doNotAssociateControlIds": [ "DO_NOT_ASSOCIATE_CONTROL_ID_1", "DO_NOT_ASSOCIATE_CONTROL_ID_2" ], "replacementControlIds": [ "REPLACEMENT_CONTROL_ID_1", "REPLACEMENT_CONTROL_ID_2" ], "ignoreControlIds": [ "IGNORE_CONTROL_ID_1", "IGNORE_CONTROL_ID_2" ], "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ] }' \ "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"
Passaggi successivi
- Richiedi previsioni dal nuovo posizionamento.