Creazione di 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 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:

• La console Search for Retail.
• L'API ServingConfig.create.

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:

1. Vai alla pagina Configurazioni di pubblicazione nella console di Search for Retail.
   
   Vai alla pagina Configurazioni di pubblicazione

2. Fai clic su Crea configurazione di pubblicazione.

   suggerimenti

   1. Seleziona Consiglio come prodotto per il quale verrà utilizzata la configurazione di pubblicazione.

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

   3. (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.

   4. Scegli o crea un modello per cui questa configurazione di pubblicazione fornisce suggerimenti.

      Scopri di più sulla creazione di nuovi modelli.

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

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

   7. Seleziona in che misura diversificare i risultati dei suggerimenti.

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

   1. Nella pagina Crea configurazione di pubblicazione, scegli Cerca come prodotto per cui verrà utilizzata la configurazione di pubblicazione.
   2. 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.
   3. (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.
   4. Fai clic su Continua.
   5. Scegli se attivare il faceting dinamico per questa configurazione di pubblicazione.
   6. Scegli o crea controlli di pubblicazione con cui ottimizzare le ricerche.
      
      Per ulteriori informazioni sui controlli, consulta Creazione e gestione dei controlli.

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

4. (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 tuo ServingConfig. Questo valore deve contenere da 4 a 63 caratteri. I caratteri validi sono /[a-z][0-9]-_/.
• displayName: obbligatorio. Il nome leggibile di ServingConfig 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 sono no-price-reranking (valore predefinito se non impostato), low-price-raranking, medium-price-reranking e high-price-reranking.
• diversityLevel: facoltativo. Imposta in che misura diversificare i risultati dei suggerimenti. I valori consentiti sono no-diversity (predefinito), low-diversity, medium-diversity, high-diversity e auto-diversity. Se diversityLevel non è impostato, la diversità è disattivata.
• diversityType: facoltativo. Imposta su RULE_BASED_DIVERSITY per diversificare i risultati dei consigli in base alla categoria di prodotto. Imposta il valore su DATA_DRIVEN_DIVERSITY per diversificare i suggerimenti in base all'apprendimento dai metadati dei prodotti per bilanciare pertinenza e diversità di categoria. Se diversityLevel è impostato, ma diversityType 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 sono relaxed-category-match (valore predefinito se non impostato) e no-category-match.
• solutionTypes: obbligatorio. Impostalo su SOLUTION_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 tuo ServingConfig. Questo valore deve contenere da 4 a 63 caratteri. I caratteri validi sono /[a-z][0-9]-_/.
• displayName: obbligatorio. Il nome leggibile di ServingConfig visualizzato nella console di Search for Retail.
• facetControlIds: facoltativo. ID dei controlli che hanno 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 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 su SOLUTION_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.