La funzionalità Retail verrà rinominata in Vertex AI Search for Retail. Stiamo aggiornando i contenuti in base al nuovo branding.

Questa pagina è stata tradotta dall'API Cloud Translation.

Crea controlli di pubblicazione

In questa pagina viene descritto come creare controlli di pubblicazione.

I controlli della pubblicazione sono regole che definisci e applichi alle singole configurazioni di pubblicazione. Per ulteriori informazioni sulle configurazioni di pubblicazione, consulta Informazioni sulle configurazioni di pubblicazione.

I controlli di pubblicazione ti consentono di creare regole che personalizzano il modo in cui configurazioni generano risultati.

Puoi creare un controllo di pubblicazione nella console di Search for Retail costituito da una condizione, che attiva il controllo, e da un'azione che dei pod quando la condizione si attiva. Dopodiché puoi collegare il nuovo controllo di pubblicazione a una configurazione di pubblicazione.

Le configurazioni di pubblicazione hanno una relazione multi-to-multi con i controlli. Puoi aggiungere più controlli a una configurazione di pubblicazione e un singolo controllo può essere associato a più configurazioni di pubblicazione.

Quando crei controlli di pubblicazione e configurazioni di pubblicazione, seleziona un prodotto (suggerimenti o ricerca) per il quale possono essere utilizzati. I controlli di pubblicazione possono essere associati solo alle configurazioni di pubblicazione dello stesso tipo di prodotto. Ad esempio, un controllo di pubblicazione creato per i consigli non può essere associato a una configurazione di pubblicazione creata per la ricerca.

Le configurazioni di pubblicazione gestiscono i controlli da applicare durante una richiesta di ricerca o di previsione. Al momento della pubblicazione vengono presi in considerazione solo i controlli nella configurazione di pubblicazione attiva per una richiesta. Ad esempio, supponiamo che tu abbia creato due controlli: uno denominato "Sconto gShoe" che migliora i risultati per il brand gShoe quando viene cercata la parola "scarpe" e un altro denominato "Altre scarpe" che espande le query che utilizzano il termine "scarpe da corsa" in modo da includere "scarpe sportive". Se allegare solo il tag "gShoe Sale" a una configurazione di pubblicazione, quindi cerca le richieste questa configurazione di pubblicazione aumenta i risultati di gShoe per le query che utilizzano il termine "scarpe", ma il campo "Altre scarpe" non ha effetto perché non è collegato alla configurazione di pubblicazione che stai utilizzando.

Puoi creare controlli e poi aggiungerli o scambiarli in una configurazione di pubblicazione dinamica.

Crea o modifica i controlli di pubblicazione in qualsiasi momento nella pagina Controlli o in linea utilizzando il metodo Controls.create. Nella console, puoi facoltativamente creare controlli durante la procedura di creazione della configurazione di pubblicazione.

Puoi creare fino a 100 controlli di pubblicazione. Se hai bisogno di più controlli di pubblicazione, e richiedere una quota aggiuntiva. Per scoprire come richiedere una quota aggiuntiva, consulta Aumentare le quote. Una configurazione di pubblicazione può avere fino 100 controlli di pubblicazione di qualsiasi tipo oltre ai controlli di reindirizzamento, il cui limite è 1000 per ogni configurazione di pubblicazione.

I controlli di pubblicazione sono disponibili per:

Migliora/nascondi: influisce sul ranking e sull'ordine dei risultati nell'elenco dei risultati restituiti. Disponibile per la ricerca e i consigli.
Filtro: rimuove i risultati che non superano il filtro dalla ricerca restituita nell'elenco dei risultati. Disponibile solo per la ricerca.
Reindirizzamento: reindirizza gli utenti a una pagina specifica a seconda del la query di ricerca. Disponibile solo per la ricerca.
Linguistica: personalizza la linguistica delle query di ricerca. Disponibile per solo sulla ricerca. Diversi tipi di controlli linguistici disponibili:
- Sinonimi: espande i sinonimi considerati per una query di ricerca.
- Sinonimi unidirezionali: espande i sinonimi considerati in modo unidirezionale per termini specifici.
- Non associare: impedisce l'utilizzo di un gruppo di termini nella ricerca quando vengono visualizzati termini specifici.
- Ignora: impedisce che un termine venga utilizzato nelle ricerche.
- Sostituisci: sostituisce i termini nella query di ricerca.

Per esempi di questi controlli, vedi Informazioni sui controlli di pubblicazione.

Tutorial sul controllo del reindirizzamento

Questo tutorial mostra come utilizzare il controllo del reindirizzamento.

Per seguire una guida passo passo per questa attività direttamente nel Editor di Cloud Shell, fai clic su Procedura guidata:

Procedura guidata

Creare un nuovo controllo di pubblicazione

Crea un nuovo controllo di pubblicazione nella pagina Controlli della console Google Cloud o in linea utilizzando il metodo Controls.create.

I controlli hanno requisiti diversi a seconda del tipo. Vai alla procedura di creazione per il tipo di controllo che prevedi di creare:

Creare un controllo di messa in evidenza/seppellimento
Creare un controllo filtro
Creare un controllo di reindirizzamento
Creare un controllo dei sinonimi bidirezionale
Creare un controllo dei sinonimi unidirezionale
Creare un controllo per non associare i dati
Creare un controllo per ignorare
Creare un controllo sostitutivo

Crea un controllo boost/bury

Per scoprire di più su questo tipo di controllo, consulta Controlli di messa in evidenza/nascondimento.

Questo tipo di controllo è disponibile per la ricerca e per i consigli.

Creare un controllo boost/bury delle ricerche
Creare un controllo boost/bury dei suggerimenti

Creare un controllo boost/bury per la rete di ricerca

Per creare un controllo di aumento/seppellimento della visibilità nella rete di ricerca:

Console

Vai alla pagina Controlli nella console di Search for Retail.

Vai alla pagina Controlli
Nella scheda Controlli pubblicazione, fai clic su Crea controllo.

Viene visualizzato il riquadro Crea controllo.

Nella sezione Preferenze:

Nel campo Nome controllo, inserisci un nome per il nuovo controllo.
(Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.
Nella sezione Selezione dei prodotti, seleziona Ricerca.
Scegli Controlli boost/bury come tipo di controllo.
Fai clic su Continua per passare alla sezione Attivatori.

Nella sezione Attivatori, imposta le condizioni che attivano il controllo:

Seleziona il tipo di comportamento utente che attiva questo controllo:
- Sfoglia categorie: la regola viene attivata quando un utente sfoglia le categorie. categorie sul tuo sito (search.request.query è vuoto).
- Ricerca: la regola viene attivata quando un utente esegue una ricerca sul tuo sito. (search.request.query non è vuoto).
Puoi impostare categorie o query specifiche che possono attivare questo controllo nel passaggio successivo. Per impostare questo controllo in modo che si attivi quando viene visualizzata una categoria o viene eseguita una ricerca, salta il passaggio che segue.
(Facoltativo) Imposta una condizione di controllo che attivi la regola in base al fatto che: viene sfogliata una categoria specifica o una determinata query.

Per impostare l'attivazione di questo controllo per qualsiasi categoria o query, salta questo passaggio.

L'opzione disponibile dipende dal fatto che tu abbia scelto Sfoglia categorie o Cerca:
- Se hai scelto Sfoglia categorie: nel campo Categorie, inserisci le categorie che attiveranno questo controllo quando vengono visualizzate.
- Se hai scelto Ricerca: fai clic sul pulsante Aggiungi query per aggiungere i termini di query (ad es. running shoes) da filtrare e poi seleziona una delle seguenti opzioni per ogni termine:
  - Corrispondenza parziale: questo controllo si applica quando una query contiene una una corrispondenza parziale con questo termine di query.
  - Corrispondenza completa: questo controllo si applica solo quando una query contiene una la corrispondenza completa con questo termine di query.
  Quando uno di questi termini è incluso in una query, viene applicato il controllo.
Se specifichi condizioni per l'intervallo di tempo oltre a questo tipo di , il controllo viene applicato solo se sono soddisfatte entrambe le condizioni.
(Facoltativo) Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali può essere applicato questo controllo.

Se specifichi una categoria o una condizione termine di query in aggiunta a un intervallo condizioni di intervallo, il controllo viene applicato solo quando entrambe le condizioni sono sono soddisfatte determinate condizioni.
Fai clic su Continua per passare alla sezione Azioni.

Nella sezione Azioni:

Aggiungi filtri per gli attributi del prodotto nel campo Prodotto Boost/bury.

Utilizza la sintassi dell'espressione di filtro descritta in Filtro e ordinamento.

Ad esempio, per specificare le versioni rossa e blu di "prodotto1" e "prodotto2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
Per Valore di miglioramento/seppellimento, utilizza il cursore per impostare l'intensità del miglioramento. I valori positivi aumentano i risultati, mentre quelli negativi che li rappresentano.
Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

Nella sezione Configurazioni di pubblicazione:

Seleziona le configurazioni di pubblicazione a cui applicare il controllo.
Invia le impostazioni di controllo.

Occorrono alcuni minuti prima che i controlli appena creati o aggiornati siano pronti per gestire il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Effettua una richiesta Control.create con un ID controllo e un istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, vedi Riferimento API Controls e Riferimento API Controls.create.

Un controllo di aumento/seppellimento può essere attivato quando un utente sfoglia le categorie sul tuo sito (search.request.query è vuoto) o quando un utente esegue una ricerca sul tuo sito (search.request.query non è vuoto).

L'esempio seguente mostra i campi per un controllo attivato dalla navigazione, dove searchSolutionUseCase impostata su SEARCH_SOLUTION_USE_CASE_BROWSE.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

L'esempio seguente mostra i campi di un controllo attivato dalla ricerca, dove searchSolutionUseCase impostata su SEARCH_SOLUTION_USE_CASE_SEARCH.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza ServingConfig.addControl :

Per saperne di più su questo metodo, consulta il riferimento API ServingConfig.addControl.
Per un esempio di questo metodo, consulta Gestisci le configurazioni di pubblicazione.

Creare un controllo boost/bury dei suggerimenti

Per creare un controllo boost/bury dei suggerimenti:

Console

Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.

Vai alla pagina Controlli
Nella scheda Controlli pubblicazione, fai clic su Crea controllo.

Viene visualizzato il riquadro Crea controllo.

Nella sezione Preferenze:

Nel campo Nome controllo, inserisci un nome per il nuovo controllo.
(Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.
Nella sezione Selezione dei prodotti, seleziona Consiglio.
Scegli Controlli boost/bury come tipo di controllo.
Fai clic su Continua per passare alla sezione Azioni.

Nella sezione Azioni:

Aggiungi filtri per gli attributi del prodotto nel campo Prodotto Boost/bury.

Utilizza la sintassi dell'espressione di filtro descritta in Filtrare i consigli.

Ad esempio, per specificare le versioni rossa e blu di "prodotto1" e "prodotto2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
Per Valore di miglioramento/seppellimento, utilizza il cursore per impostare l'intensità del miglioramento. I valori positivi aumentano i risultati, mentre quelli negativi che li rappresentano.
Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

Nella sezione Configurazioni di pubblicazione:

Seleziona le configurazioni di pubblicazione a cui applicare il controllo.
Invia le impostazioni di controllo.

I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli per la pubblicazione della pagina Controlli.

curl

Invia una richiesta Control.create con un ID controllo e un'istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, consulta il riferimento all'API Controls e il riferimento all'API Controls.create.

Per creare un'espressione di filtro, utilizza la sintassi documentata dell'espressione di filtro in Filtrare i 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",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ],
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl:

Per ulteriori informazioni su questo metodo, consulta Riferimento API ServingConfig.addControl.
Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Creare un controllo filtro

Per saperne di più su questo tipo di controllo, consulta Controlli filtro.

Console

Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.

Vai alla pagina Controlli
Nella scheda Controlli pubblicazione, fai clic su Crea controllo.

Viene visualizzato il riquadro Crea controllo.

Nella sezione Preferenze:

Nel campo Nome controllo, inserisci un nome per il nuovo controllo.
(Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.
Scegli Controlli filtro come tipo di controllo.
Fai clic su Continua per passare alla sezione Attivatori.

Nella sezione Attivatori:

Seleziona il tipo di comportamento dell'utente che attiva questo controllo:
- Sfoglia categorie: la regola viene attivata quando un utente sfoglia le categorie. categorie sul tuo sito (search.request.query è vuoto).
- Ricerca: la regola viene attivata quando un utente esegue una ricerca sul tuo sito (search.request.query non è vuoto).
(Facoltativo) Imposta una condizione di controllo che attivi la regola in base a cosa categoria è sfogliata o quale query viene cercata. L'opzione disponibile dipende da se hai scelto Sfoglia categorie o Cerca:
- Se hai scelto Sfoglia categorie: nel campo Categorie, inserisci le categorie che attiveranno questo controllo quando vengono visualizzate.
- Se hai scelto Ricerca: fai clic sul pulsante Aggiungi query per aggiungere i termini di query (ad es. running shoes) da filtrare e poi seleziona una delle seguenti opzioni per ogni termine:
  - Corrispondenza parziale: questo controllo si applica quando una query contiene una una corrispondenza parziale con questo termine di query.
  - Corrispondenza completa: questo controllo si applica solo quando una query contiene una la corrispondenza completa con questo termine di query.
  Quando uno di questi termini è incluso in una query, il controllo viene applicato.
Se specifichi una condizione di intervallo di tempo oltre a questa, il controllo viene applicato solo se entrambe le condizioni sono soddisfatte.
(Facoltativo) Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali può essere applicato questo controllo.

Se specifichi una condizione di categoria o termine di query oltre a questa condizione di intervallo di tempo, il controllo viene applicato solo quando sono soddisfatte entrambe le condizioni.
Fai clic su Continua per passare alla sezione Azioni.

Nella sezione Azioni:

Aggiungi i filtri per gli attributi del prodotto nel campo Azione filtro.

Utilizza la sintassi delle espressioni di filtro documentata in Filtri e ordinamento.

Ad esempio, per specificare le versioni rossa e blu di "prodotto1" e "prodotto2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

Nella sezione Configurazioni di pubblicazione:

Seleziona le configurazioni di pubblicazione a cui applicare il controllo.
Invia le impostazioni di controllo.

I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Effettua una richiesta Control.create con un ID controllo e un istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, consulta il riferimento all'API Controls e il riferimento all'API Controls.create.

Un controllo filtro può essere attivato quando un utente sfoglia le categorie sui tuoi sito (search.request.query è vuoto) o quando un utente ricerche sul tuo sito (search.request.query non è vuoto).

L'esempio seguente mostra i campi per un controllo attivato dalla navigazione, in cui searchSolutionUseCase è impostato su SEARCH_SOLUTION_USE_CASE_BROWSE.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

L'esempio seguente mostra i campi per un controllo attivato dalla ricerca, in cui searchSolutionUseCase è impostato su SEARCH_SOLUTION_USE_CASE_SEARCH.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl:

Per saperne di più su questo metodo, consulta il riferimento API ServingConfig.addControl.
Per un esempio di questo metodo, consulta Gestisci le configurazioni di pubblicazione.

Creare un controllo di reindirizzamento

Per ulteriori informazioni su questo tipo di controllo, consulta Controlli di reindirizzamento.

Console

Vai alla pagina Controlli nella console di Search for Retail.

Vai alla pagina Controlli
Nella scheda Controlli per la pubblicazione, fai clic su Crea controllo.

Viene visualizzato il riquadro Crea controllo.

Nella sezione Preferenze:

Nel campo Nome controllo, inserisci un nome per il nuovo controllo.
(Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.
Scegli Controlli di reindirizzamento come tipo di controllo.
Fai clic su Continua per passare alla sezione Attivatori.

Nella sezione Trigger, crea almeno un trigger per termine di query o intervallo di tempo. I controlli di reindirizzamento richiedono almeno un attivatore:

Seleziona il tipo di comportamento dell'utente che attiva questo controllo:
- Sfoglia categorie: la regola si attiva quando un utente naviga tra le categorie sul tuo sito (search.request.query è vuoto).
- Ricerca: la regola viene attivata quando un utente esegue una ricerca sul tuo sito (search.request.query non è vuoto).
Imposta una condizione di controllo che attivi la regola in base alla categoria visualizzata o alla query cercata. L'opzione disponibile dipende dal fatto che tu abbia scelto Sfoglia categorie o Cerca:
- Se hai scelto Sfoglia categorie: nel campo Categorie, inserisci le categorie che attiveranno questo controllo quando vengono visualizzate.
- Se hai scelto Ricerca: fai clic sul pulsante Aggiungi query per aggiungere i termini di query (ad es. running shoes) da filtrare e poi seleziona una delle seguenti opzioni per ogni termine:
  - Corrispondenza parziale: questo controllo si applica quando una query contiene una una corrispondenza parziale con questo termine di query.
  - Corrispondenza completa: questo controllo si applica solo quando una query contiene una la corrispondenza completa con questo termine di query.
  Quando uno di questi termini è incluso in una query, il controllo viene applicato.
Se specifichi una condizione di intervallo di tempo oltre a questa condizione, viene applicato solo se entrambe le condizioni sono soddisfatte.
Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.

Se specifichi una categoria o una condizione termine di query oltre a condizione di intervallo di tempo, il controllo viene applicato solo quando entrambe le condizioni sono soddisfatti.
Fai clic su Continua per passare alla sezione Azioni.

Nella sezione Azioni:

Inserisci l'URI a cui reindirizzare quando viene attivato questo controllo.
Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

Nella sezione Configurazioni di pubblicazione:

Seleziona le configurazioni di pubblicazione a cui applicare il controllo.
Invia le impostazioni di controllo.

Occorrono alcuni minuti prima che i controlli appena creati o aggiornati siano pronti per gestire il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli per la pubblicazione della pagina Controlli.

curl

Invia una richiesta Control.create con un ID controllo e un'istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, vedi Riferimento API Controls e Riferimento API Controls.create.

Un controllo di reindirizzamento può essere attivato quando un utente naviga tra le categorie sul tuo sito (search.request.query è vuoto) o quando un utente esegue una ricerca sul tuo sito (search.request.query non è vuoto).

L'esempio seguente mostra i campi per un controllo attivato dalla navigazione, dove searchSolutionUseCase impostata su SEARCH_SOLUTION_USE_CASE_BROWSE.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_BROWSE"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

L'esempio seguente mostra i campi per un controllo attivato dalla ricerca, in cui searchSolutionUseCase è impostato su SEARCH_SOLUTION_USE_CASE_SEARCH.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "searchSolutionUseCase": [
                "SEARCH_SOLUTION_USE_CASE_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl:

Per saperne di più su questo metodo, consulta il riferimento API ServingConfig.addControl.
Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Creare un controllo dei sinonimi bidirezionale

Per saperne di più su questo tipo di controllo, consulta Controlli sinonimi bidirezionali.

Console

Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.

Vai alla pagina Controlli
Nella scheda Controlli pubblicazione, fai clic su Crea controllo.
Nel campo Nome controllo, inserisci un nome per il nuovo controllo.

Viene visualizzato il riquadro Crea controllo.

Nella sezione Preferenze:

(Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.
Scegli Controllo sinonimi bidirezionali come tipo di controllo.
Fai clic su Continua per passare alla sezione Attivatori.

Nella sezione Attivatori:

(Facoltativo) Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.
Fai clic su Continua per passare alla sezione Azioni.

Nella sezione Azioni:

Nel campo Sinonimi, inserisci da 2 a 100 termini di query (ad es. shirt e top) che devono essere sinonimi tra loro.

Quando uno qualsiasi di questi termini è incluso in una query, considera gli altri termini di query come sinonimi del termine incluso.
Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

Nella sezione Configurazioni di pubblicazione:

Seleziona le configurazioni di pubblicazione a cui applicare il controllo.
Invia le impostazioni di controllo.

I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Effettua una richiesta Control.create con un ID controllo e un istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, vedi Riferimento API Controls e Riferimento API Controls.create.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                    ]
                },
                "twoWaySynonymAction": {
                  "synonyms": [
                    "SYNONYM_1",
                    "SYNONYM_2"
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza ServingConfig.addControl. Consulta Aggiungere controlli alle configurazioni di pubblicazione in linea.

Crea un controllo dei sinonimi unidirezionali

Per saperne di più su questo tipo di controllo, consulta Controlli di sinonimi unidirezionali.

Console

Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.

Vai alla pagina Controlli
Nella scheda Controlli per la pubblicazione, fai clic su Crea controllo.

Viene visualizzato il riquadro Crea controllo.

Nella sezione Preferenze:

Nel campo Nome controllo, inserisci un nome per il nuovo controllo.
(Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.
Scegli Controllo dei sinonimi unidirezionale come tipo di controllo.
Fai clic su Continua per passare alla sezione Attivatori.

Nella sezione Attivatori:

(Facoltativo) Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.
Fai clic su Continua per passare alla sezione Azioni.

Nella sezione Azioni:

Nel campo Termini query, inserisci i termini (ad es. shoes) che devono essere associati con sinonimi quando vengono inclusi in una query.
Nel campo Sinonimi, inserisci i termini da utilizzare come sinonimi. per i termini di query specificati (ad esempio, sneakers e sandals come sinonimi unidirezionali per il termine di query shoes).
Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

Nella sezione Configurazioni di pubblicazione:

Seleziona le configurazioni di pubblicazione a cui applicare il controllo.
Invia le impostazioni di controllo.

I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Invia una richiesta Control.create con un ID controllo e un'istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, consulta il riferimento all'API Controls e il riferimento all'API Controls.create.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "oneWaySynonymAction": {
                  "synonyms": [
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "synonyms": [
                      "SYNONYM_1",
                      "SYNONYM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza ServingConfig.addControl :

Per ulteriori informazioni su questo metodo, consulta Riferimento API ServingConfig.addControl.
Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Creare un controllo di mancata associazione

Per saperne di più su questo tipo di controllo, consulta Controlli di mancata associazione.

Console

Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.

Vai alla pagina Controlli
Nella scheda Controlli per la pubblicazione, fai clic su Crea controllo.

Viene visualizzato il riquadro Crea controllo.

Nella sezione Preferenze:

Nel campo Nome controllo, inserisci un nome per il nuovo controllo.
(Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.
Scegli Non associare il controllo come tipo di controllo.
Fai clic su Continua per passare alla sezione Attivatori.

Nella sezione Attivatori:

(Facoltativo) Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.
Fai clic su Continua per passare alla sezione Azioni.

Nella sezione Azioni:

Nel campo Termini query, inserisci i termini (ad es. gShoe) che vuoi distinguere in modo esplicito dagli altri.
Nel campo Termini disaccoppiati, inserisci i termini che non devono essere associati nei risultati di ricerca ai termini di query che hai specificato.

Ad esempio, puoi dissociare il termine di query gShoe dal termine cheap.
Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

Nella sezione Configurazioni di pubblicazione:

Seleziona le configurazioni di pubblicazione a cui applicare il controllo.
Invia le impostazioni di controllo.

I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Effettua una richiesta Control.create con un ID controllo e un istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, consulta il riferimento all'API Controls e il riferimento all'API Controls.create.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "doNotAssociateAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "doNotAssociateTerms": [
                      "DISSOCIATED_TERM_1",
                      "DISSOCIATED_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl:

Per ulteriori informazioni su questo metodo, consulta Riferimento API ServingConfig.addControl.
Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Crea un controllo per ignorare

Per saperne di più su questo tipo di controllo, consulta Ignorare i controlli.

Console

Vai alla pagina Controlli nella console di Search for Retail.

Vai alla pagina Controlli
Nella scheda Controlli pubblicazione, fai clic su Crea controllo.

Viene visualizzato il riquadro Crea controllo.

Nella sezione Preferenze:

Nel campo Nome controllo, inserisci un nome per il nuovo controllo.
(Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.
Scegli Non associare il controllo come tipo di controllo.
Fai clic su Continua per passare alla sezione Attivatori.

Nella sezione Attivatori:

(Facoltativo) Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.
Fai clic su Continua per passare alla sezione Azioni.

Nella sezione Azioni:

Nel campo Ignora termini, inserisci i termini (ad esempio shoddy) che vuoi che una ricerca ignori quando vengono inseriti come termini di query.
Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

Nella sezione Configurazioni di pubblicazione:

Seleziona le configurazioni di pubblicazione a cui applicare il controllo.
Invia le impostazioni di controllo.

I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli pubblicazione della pagina Controlli.

curl

Effettua una richiesta Control.create con un ID controllo e un istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, vedi Riferimento API Controls e Riferimento API Controls.create.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "ignoreAction": {
                  "ignoreTerms": [
                      "IGNORE_TERM_1",
                      "IGNORE_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza ServingConfig.addControl :

Per saperne di più su questo metodo, consulta il riferimento API ServingConfig.addControl.
Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Crea un controllo sostitutivo

Per saperne di più su questo tipo di controllo, consulta Controlli di sostituzione.

Console

Vai alla pagina Controlli nella console di Search for Retail.

Vai alla pagina Controlli
Nella scheda Controlli pubblicazione, fai clic su Crea controllo.

Viene visualizzato il riquadro Crea controllo.

Nella sezione Preferenze:

Nel campo Nome controllo, inserisci un nome per il nuovo controllo.
(Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.
Scegli Controllo sostitutivo come tipo di controllo.
Fai clic su Continua per passare alla sezione Attivatori.

Nella sezione Attivatori:

(Facoltativo) Fai clic sul pulsante Aggiungi intervallo di tempo per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.
Fai clic su Continua per passare alla sezione Azioni.

Nella sezione Azioni:

Nel campo Termini query, inserisci i termini di query (ad esempio, gShoe) che vuoi sostituire con il termine sostitutivo.
Nel campo Termine sostitutivo, inserisci il termine che deve sostituire il i termini della query che hai specificato.

Ad esempio, puoi sostituire il termine di query gShoe con il termine di sostituzione Google Shoe.
Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione.

Nella sezione Configurazioni di pubblicazione:

Seleziona le configurazioni di pubblicazione a cui applicare il controllo.
Invia le impostazioni di controllo.

Occorrono alcuni minuti prima che i controlli appena creati o aggiornati siano pronti per gestire il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nella scheda Controlli per la pubblicazione della pagina Controlli.

curl

Invia una richiesta Control.create con un ID controllo e un'istanza di Control contenuta nel corpo della richiesta.

Per i dettagli dei campi, consulta il riferimento all'API Controls e il riferimento all'API Controls.create.

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",
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "replacementAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "replacementTerm": "REPLACEMENT_TERM"
                  }
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl:

Per ulteriori informazioni su questo metodo, consulta Riferimento API ServingConfig.addControl.
Per un esempio di questo metodo, consulta Gestisci le configurazioni di pubblicazione.