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 ricerche 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 prevedi di 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é 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 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:

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 questo default_search eseguirà la ricerca nel catalogo con la funzionalità di ricerca predefinita di Vertex AI 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 comporta la creazione di 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 nella console Search for commerce.

Per creare una nuova configurazione di pubblicazione:

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

    Vai alla pagina Configurazioni di pubblicazione

  2. Fai clic su Crea configurazione di pubblicazione.

    Consigli

    1. Seleziona Consiglio come prodotto per il quale 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 all'interno del 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 riposizionamento dei prezzi deve avere sui risultati dei suggerimenti, se disponibile per il modello selezionato.

      Con il re-ranking del prezzo, i prodotti suggeriti con una probabilità di suggerimento simile vengono ordinati per prezzo, partendo dagli articoli di prezzo più alto. La pertinenza viene comunque utilizzata per ordinare gli elementi, pertanto l'attivazione del riposizionamento in base al prezzo non equivale all'ordinamento in base al 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à e la pertinenza delle categorie nei risultati della previsione.

      Per saperne di più, consulta Diversificazione dei risultati.

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

    8. Se hai selezionato un modello di elementi simili per questa configurazione di pubblicazione, seleziona 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 contestuale. La corrispondenza delle categorie può essere utilizzata in combinazione con altre opzioni di filtro, come prezzo, disponibilità e tag filtro.

    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 contenere un massimo 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 all'interno del progetto. Deve contenere al massimo 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 per ottimizzare le ricerche.

      Per ulteriori informazioni sui controlli, vedi Creazione e gestione dei controlli.

  3. Fai clic su Crea per creare la nuova configurazione.

    La nuova configurazione viene visualizzata nella pagina Configurazione 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 Configurazione pubblicazione, fai clic sul nome di una configurazione 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 dell'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 suggerimenti o per la ricerca.

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

Consigli

Invia 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 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 ranking dei prezzi deve influire 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 il livello di diversificazione dei 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 suggerimenti in base alla categoria di prodotto. Imposta su DATA_DRIVEN_DIVERSITY per diversificare i suggerimenti in base all'apprendimento dai metadati di prodotto per bilanciare pertinenza e diversità delle categorie. Se diversityLevel è impostato, ma diversityType non lo è, allora diversityType viene impostato per impostazione predefinita su basato su regole. Per saperne di più, consulta la sezione Diversificazione dei risultati.
  • enableCategoryFilterLevel: (Facoltativo) Specifica se aggiungere filtri di categoria aggiuntivi al modello Elementi 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 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"

Cerca

Invia 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 ServingConfig leggibile visualizzato nella console Search for commerce.
  • facetControlIds: (Facoltativo) ID dei controlli per cui è stato 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 del boost.
  • filterControlIds: (Facoltativo) ID dei controlli di pubblicazione dei filtri.
  • redirectControlIds: (Facoltativo) ID dei controlli di pubblicazione del reindirizzamento.
  • twowaySynonymsControlIds: (Facoltativo) ID dei controlli di pubblicazione dei sinonimi bidirezionali.
  • onewaySynonymsControlIds: (Facoltativo) ID dei controlli di pubblicazione dei sinonimi unidirezionali.
  • doNotAssociateControlIds: (Facoltativo) ID dei controlli di pubblicazione non associati.
  • replacementControlIds: (Facoltativo) ID dei controlli di pubblicazione sostitutivi.
  • ignoreControlIds: (Facoltativo) ID dei controlli di pubblicazione da ignorare.
  • solutionTypes: obbligatorio. Imposta su SOLUTION_TYPE_SEARCH per le configurazioni di pubblicazione della 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