Crea configurazioni di pubblicazione

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 i risultati di ricerca o dei suggerimenti. Per ulteriori informazioni sulle configurazioni di pubblicazione, consulta Informazioni sulle configurazioni di pubblicazione.

Prima di iniziare

Le configurazioni di pubblicazione di suggerimenti e ricerca hanno requisiti e opzioni diversi:

Le configurazioni di pubblicazione dei suggerimenti richiedono un modello. Se prevedi di collegare un modello esistente a una nuova configurazione di pubblicazione, recupera l'ID del modello che intendi utilizzare (obbligatorio quando 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.
La ricerca può 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.

Crea una configurazione di pubblicazione

Puoi creare una configurazione di pubblicazione utilizzando:

La console Search for commerce.
L'ServingConfig.create API.

Sono consentite fino a 100 configurazioni di pubblicazione per catalogo.

La ricerca funziona con le configurazioni di pubblicazione non configurate. Qualsiasi serving_config_id può essere inserito nella richiesta di ricerca e questa default_search cercherà nel catalogo con la funzionalità di ricerca predefinita di Agent Platform Search for commerce.

Se hai posizionamenti esistenti 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 elimina il posizionamento corrispondente e 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 della console Search for commerce.

Per creare una nuova configurazione di pubblicazione:

Vai alla pagina Configurazioni di pubblicazione nella console Search for commerce.

Vai alla pagina Configurazioni di pubblicazione
Fai clic su Crea configurazione di pubblicazione.
Consigli
1. Seleziona Consigli come prodotto per cui verrà utilizzata la configurazione di pubblicazione.
2. Fornisci un nome per la configurazione di pubblicazione.
  
  Il nome deve contenere al massimo 1024 caratteri e può contenere solo caratteri alfanumerici, trattini bassi, trattini e spazi.
3. (Facoltativo) Se necessario, aggiorna l'ID.
  
  L'ID viene generato dal nome che fornisci e deve essere univoco nel progetto. Deve contenere al massimo 50 caratteri e non può contenere spazi.
4. Scegli o crea un modello per cui vuoi che questa configurazione di pubblicazione fornisca consigli.
  
  Scopri di più sulla creazione di nuovi modelli.
5. Se disponibile per il modello selezionato, seleziona la misura in cui il re-ranking del prezzo deve influire sui risultati dei consigli.
  
  Con il re-ranking del prezzo, i prodotti consigliati con una probabilità di consiglio simile vengono ordinati per prezzo, partendo dagli articoli di prezzo più alto. La pertinenza viene comunque utilizzata anche per ordinare gli articoli, quindi l'attivazione del re-ranking del prezzo non equivale all'ordinamento per prezzo.
6. Seleziona se utilizzare la diversificazione dei risultati basata su regole o sui dati:
  - Basata su regole: la diversificazione dei risultati basata su regole influisce sul fatto che i risultati restituiti da un'unica richiesta di previsione provengano da categorie diverse del catalogo dei prodotti.
  - Basata sui dati: la diversificazione dei risultati basata sui dati utilizza il machine learning per bilanciare la diversità delle categorie e la pertinenza nei risultati delle previsioni.
  Per ulteriori informazioni, consulta Diversificazione dei risultati.
7. Seleziona la misura in cui diversificare i risultati dei consigli.
8. Se hai selezionato un modello di articoli simili per questa configurazione di pubblicazione, seleziona se attivare la corrispondenza delle categorie.
  
  Quando la corrispondenza delle categorie è attivata, vengono restituiti solo i risultati dei prodotti che condividono almeno una categoria con il prodotto di contesto. La corrispondenza delle categorie può essere utilizzata in combinazione con altre opzioni di filtro, come prezzo, disponibilità e tag di filtro.
Cerca
1. Nella pagina Crea configurazione di pubblicazione, scegli Cerca come prodotto per cui verrà utilizzata la configurazione di pubblicazione.
2. Fornisci un nome per la configurazione di pubblicazione.
  
  Il nome deve contenere al massimo 1024 caratteri e può contenere solo caratteri alfanumerici, trattini bassi, trattini e spazi.
3. (Facoltativo) Se necessario, aggiorna l'ID.
  
  L'ID viene generato dal nome che fornisci e deve essere univoco nel progetto. Deve contenere al massimo 50 caratteri e non può contenere spazi.
4. Fai clic su Continua.
5. Scegli se attivare la suddivisione dinamica per questa configurazione di pubblicazione.
6. Scegli o crea controlli di pubblicazione per ottimizzare le ricerche.
  
  Per ulteriori informazioni sui controlli, consulta Creare e gestire i 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 sia 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 dell'API per questo metodo, consulta ServingConfig.create.

I campi che utilizzi dipendono dal fatto che tu stia creando una configurazione di pubblicazione per i consigli o per la ricerca.

Per ulteriori dettagli sui campi ServingConfig, consulta il ServingConfigs riferimento API.

Consigli

Invia una richiesta ServingConfig.create con un ID di configurazione di pubblicazione e un' istanza di ServingConfig contenuta nel corpo della richiesta.

servingConfigId: obbligatorio. Crea un ID per ServingConfig. Questo valore deve contenere da 4 a 63 caratteri. I caratteri validi sono /[a-z][0-9]-_/.
displayName: obbligatorio. Il nome ServingConfig leggibile visualizzato nella console Search for commerce.
modelID: obbligatorio. L'ID del modello da utilizzare al momento della pubblicazione.
priceRerankingLevel: facoltativo. Imposta la misura in cui il re-ranking del prezzo deve influire sui risultati dei consigli. I valori consentiti sono no-price-reranking (valore predefinito se non impostato), low-price-raranking, medium-price-reranking e high-price-reranking.
diversityLevel: facoltativo. Imposta la misura in cui diversificare i risultati dei consigli. I valori consentiti sono no-diversity (valore predefinito), low-diversity, medium-diversity, high-diversity e auto-diversity. Se diversityLevel non è impostato, la diversità è disattivata.
diversityType: facoltativo. Imposta RULE_BASED_DIVERSITY per diversificare i risultati dei consigli in base alla categoria di prodotto. Imposta DATA_DRIVEN_DIVERSITY per diversificare i consigli in base all'apprendimento dai metadati dei prodotti per bilanciare pertinenza e diversità delle categorie. Se diversityLevel è impostato, ma diversityType non lo è, diversityType viene impostato per impostazione predefinita su basato su regole. Per ulteriori informazioni, consulta Diversificazione dei risultati.
enableCategoryFilterLevel: facoltativo. Imposta se aggiungere filtri di categoria aggiuntivi al modello di articoli simili. I valori consentiti sono relaxed-category-match (valore predefinito se non impostato) e no-category-match.
solutionTypes: obbligatorio. Imposta SOLUTION_TYPE_RECOMMENDATION per le configurazioni di pubblicazione dei consigli.

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"

Cerca

Invia una richiesta ServingConfig.create con un ID di configurazione di pubblicazione e un' istanza di ServingConfig contenuta nel corpo della richiesta.

servingConfigId: obbligatorio. Crea un ID per ServingConfig. Questo valore deve contenere da 4 a 63 caratteri. I caratteri validi sono /[a-z][0-9]-_/.
displayName: obbligatorio. Il nome ServingConfig leggibile visualizzato nella console Search for commerce.
facetControlIds: facoltativo. ID dei controlli per cui è impostato solo FacetSpec.
dynamicFacetSpec.mode: facoltativo. Modalità della funzionalità DynamicFacet. I valori consentiti sono DISABLED (valore predefinito se non impostato) e ENABLED.
boostControlIds: facoltativo. ID dei controlli di pubblicazione di boost.
filterControlIds: facoltativo. ID dei controlli di pubblicazione di filtri.
redirectControlIds: facoltativo. ID dei controlli di pubblicazione di reindirizzamento.
twowaySynonymsControlIds: facoltativo. ID dei controlli di pubblicazione di sinonimi bidirezionali.
onewaySynonymsControlIds: facoltativo. ID dei controlli di pubblicazione di sinonimi unidirezionali.
doNotAssociateControlIds: facoltativo. ID dei controlli di pubblicazione di non associazione.
replacementControlIds: facoltativo. ID dei controlli di pubblicazione di sostituzione.
ignoreControlIds: facoltativo. ID dei controlli di pubblicazione di ignoranza.
solutionTypes: obbligatorio. Imposta SOLUTION_TYPE_SEARCH per le configurazioni di pubblicazione di ricerca.

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.

Crea configurazioni di pubblicazione Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Prima di iniziare

Crea una configurazione di pubblicazione

Crea una configurazione di pubblicazione nella console

Consigli

Cerca

Crea una configurazione di pubblicazione con ServingConfig.create

Consigli

Cerca

Passaggi successivi

Crea configurazioni di pubblicazione

Crea una configurazione di pubblicazione con `ServingConfig.create`