Crea configurazioni di pubblicazione

Questa pagina descrive come creare le 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.

Prima di iniziare

Le configurazioni di pubblicazione dei consigli e della ricerca hanno requisiti e opzioni diversi:

• Le configurazioni di pubblicazione dei consigli richiedono un modello. Se prevedi di collegare un modello esistente a una nuova configurazione di pubblicazione, ottieni l'ID del modello che prevedi di utilizzare (obbligatorio quando si utilizza il metodo ServingConfig.create).

  Se crei la configurazione di pubblicazione utilizzando la console, puoi creare un nuovo modello durante il processo di creazione anziché collegarne uno 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 associare i controlli esistenti a una nuova configurazione di pubblicazione, recupera gli ID dei controlli che prevedi di 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 Retail.
• L'API ServingConfig.create.

Per catalogo sono consentite fino a 100 configurazioni di pubblicazione.

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.

Creare una configurazione di pubblicazione nella console

Aggiungi una nuova configurazione di pubblicazione nella pagina Configurazioni di pubblicazione della console Ricerca per il retail.

Per creare una nuova configurazione di pubblicazione:

1. Vai alla pagina Configurazioni di pubblicazione nella console Ricerca per la vendita al dettaglio.
   
   Vai alla pagina Configurazioni di pubblicazione

2. Fai clic su add_boxCrea configurazione di pubblicazione.

   Consigli

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

   2. Fornisci un nome per la configurazione di pubblicazione.

      Il nome deve contenere 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 fornito e deve essere univoco nel progetto. Deve contenere al massimo 50 caratteri e non può contenere spazi.

   4. Scegli o crea un modello per il quale vuoi che questa configurazione di pubblicazione fornisca consigli.

      Scopri di più sulla creazione di nuovi modelli.

   5. Seleziona l'impatto che il ricoordinamento dei prezzi deve avere sui risultati dei consigli, se disponibile per il modello selezionato.

      Con il re-ranking del prezzo, i prodotti consigliati con una probabilità di suggerimento simile vengono ordinati per prezzo, partendo dagli articoli di prezzo più alto. La pertinenza viene comunque utilizzata anche per ordinare gli articoli, pertanto l'attivazione del ricoordinamento in base al prezzo non è la stessa cosa dell'ordinamento in base al prezzo.

   6. Scegli se utilizzare la diversificazione basata su regole o sui dati:

      • Basata su regole:la diversificazione basata su regole influisce sul fatto che i risultati restituiti da una singola richiesta di previsione provengano da categorie diverse del tuo catalogo dei prodotti.

      • Basata sui dati:la diversificazione basata sui dati utilizza il machine learning per bilanciare la diversità e la pertinenza delle categorie nei risultati di previsione.

      Per ulteriori informazioni, consulta la sezione Diversificazione.

   7. Seleziona il livello di diversificazione dei risultati dei consigli.

   8. Se hai selezionato un modello di articoli simili per questa configurazione di pubblicazione, scegli se attivare la corrispondenza delle categorie.

      Quando la corrispondenza delle categorie è attivata, gli unici risultati di prodotto restituiti sono quelli che condividono almeno una categoria con il prodotto del contesto. La corrispondenza delle categorie può essere utilizzata in combinazione con altre opzioni di filtro, come prezzo, disponibilità e tag filtro.

   Cerca

   1. Nella pagina Crea configurazione di pubblicazione, scegli Ricerca come prodotto per il quale verrà utilizzata la configurazione di pubblicazione.
   2. Fornisci un nome per la configurazione di pubblicazione.
      
      Il nome deve essere costituito da 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 fornito e deve essere univoco in tutto il progetto. Deve contenere al massimo 50 caratteri e non può contenere spazi.
   4. Fai clic su Continua.
   5. Scegli se attivare la suddivisione in elementi dinamici per questa configurazione di pubblicazione.
   6. Scegli o crea controlli di pubblicazione per ottimizzare le tue ricerche.
      
      Per ulteriori informazioni sui controlli, consulta Creare e gestire i 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 sia 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 relativa scheda Valuta per visualizzare l'anteprima dei prodotti che verranno restituiti per questa configurazione.

   L'anteprima della valutazione può aiutarti a verificare che il rendimento della configurazione sia quello previsto.

Crea una configurazione di pubblicazione con ServingConfig.create

Puoi creare una configurazione di pubblicazione con il metodo ServingConfig.create API. 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 la ricerca.

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

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"
  

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 le previsioni dal nuovo posizionamento.