Crea configurazioni di pubblicazione

In questa pagina viene descritto 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.

Prima di iniziare

Suggerimenti e configurazioni di pubblicazione delle ricerche hanno requisiti e opzioni diversi:

  • Per le configurazioni di pubblicazione dei suggerimenti è necessario 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 durante il processo di creazione, invece di 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 lo crei tu.

Crea una configurazione di pubblicazione

Puoi creare una configurazione di pubblicazione utilizzando:

Sono consentite fino a 100 configurazioni di pubblicazione per catalogo.

Se hai già dei posizionamenti o ne crei di nuovi, viene creata automaticamente una configurazione di pubblicazione associata a ciascun 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 in Pagina Configurazioni di pubblicazione nella Cerca la console 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.

    Consigli

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

    2. Specifica 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ò contengono spazi.

    4. Scegli o crea un modello da utilizzare per questa configurazione di pubblicazione per fornire consigli.

      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 disponibile per il modello selezionato.

      Con il re-ranking del prezzo, prodotti consigliati con un simile probabilità di essere ordinata per prezzo, con il valore per primi gli articoli con il prezzo più alto. La pertinenza viene ancora utilizzata per ordinare di articoli, pertanto attivare il riranking 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 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 di quanto diversificare i risultati dei suggerimenti.

    8. Se hai selezionato un modello di elementi simili per questa configurazione di pubblicazione, seleziona se attivare o meno 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 altri filtri quali prezzo, disponibilità e tag di 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 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 fornito e deve essere univoco per il progetto. Deve essere 50 e non possono 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 Pagina Configurazioni di pubblicazione.

    Potrebbero essere necessari alcuni minuti prima che la configurazione sia disponibile per l'uso 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 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 da utilizzare dipendono dal fatto che tu stia creando una configurazione di pubblicazione consigli o ricerche.

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

Consigli

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

  • servingConfigId: campo 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: campo obbligatorio. Nome leggibile ServingConfig visualizzato nella console Search for Retail.
  • modelID: campo obbligatorio. L'ID del modello da utilizzare al momento della pubblicazione.
  • priceRerankingLevel: facoltativo. Imposta l'importo necessario per il re-ranking del prezzo 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 grado di diversificazione dei risultati dei consigli. I valori consentiti sono no-diversity (impostazione predefinita), low-diversity, medium-diversity, high-diversity e auto-diversity. Se Il criterio diversityLevel non è impostato, quindi la diversità è disattivata.
  • diversityType: facoltativo. Imposta su RULE_BASED_DIVERSITY per diversificare risultati dei suggerimenti basati sulla categoria di prodotto. Imposta su DATA_DRIVEN_DIVERSITY per diversificare i consigli in base alle informazioni acquisite dai metadati di prodotto in modo da bilanciare la pertinenza e la diversità delle categorie. Se il criterio diversityLevel è impostato ma diversityType non è impostato, allora Per impostazione predefinita, diversityType è basato su regole. Per ulteriori informazioni, vedi Diversificazione.
  • enableCategoryFilterLevel: facoltativo. Consente di specificare se aggiungere filtri per le categorie sul modello Articoli simili. I valori consentiti sono relaxed-category-match (valore predefinito se non viene configurato) e no-category-match.
  • solutionTypes: campo obbligatorio. Impostato su 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 configurazione di gestione e un'istanza di ServingConfig contenuta nel corpo della richiesta.

  • servingConfigId: campo 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. Nome leggibile ServingConfig visualizzato nella console Search for Retail.
  • facetControlIds: facoltativo. ID dei controlli che hanno solo FacetSpec impostato.
  • dynamicFacetSpec.mode: facoltativo. Modalità della funzionalità DynamicFacet. I valori consentiti sono DISABLED (impostazione predefinita se non viene configurato) e ENABLED.
  • boostControlIds: facoltativo. ID dei controlli di pubblicazione con incremento.
  • filterControlIds: facoltativo. ID dei controlli di pubblicazione dei filtri.
  • redirectControlIds: facoltativo. ID dei controlli di pubblicazione dei reindirizzamenti.
  • twowaySynonymsControlIds: facoltativo. ID dei controlli per la pubblicazione di sinonimi bidirezionali.
  • onewaySynonymsControlIds: facoltativo. ID dei controlli della pubblicazione di sinonimi unidirezionali.
  • doNotAssociateControlIds: facoltativo. ID del servizio non associato i controlli di sicurezza.
  • replacementControlIds: facoltativo. ID dei controlli di pubblicazione sostitutivi.
  • ignoreControlIds: facoltativo. ID dei controlli di pubblicazione ignorati.
  • solutionTypes: campo obbligatorio. Impostato su 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