Retail è stato rinominato Vertex AI Search for Retail. Stiamo aggiornando i contenuti per riflettere il nuovo branding.

Creare controlli di pubblicazione

In questa pagina viene descritto come creare controlli di pubblicazione.

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

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

Nella console di Search for Retail puoi creare un controllo di pubblicazione costituito da una condizione che attiva il controllo e da un'azione che viene eseguita quando viene attivata la condizione. Puoi quindi 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 e configurazioni di pubblicazione, selezioni un prodotto (consigli o ricerca) per cui utilizzarlo. I controlli di pubblicazione possono essere associati solo a configurazioni di pubblicazione dello stesso tipo di prodotto. Ad esempio, un controllo di pubblicazione creato per i suggerimenti non può essere associato a una configurazione di pubblicazione creata per la ricerca.

Le configurazioni di pubblicazione gestiscono i controlli applicati durante una richiesta di ricerca o previsione. Al momento della pubblicazione vengono presi in considerazione solo i controlli nella configurazione di pubblicazione attiva per una richiesta. Ad esempio, supponi di aver creato due controlli: un controllo chiamato "saldi calzature" che aumenta i risultati per il brand gShoe quando viene cercata la parola "scarpe" e un controllo chiamato "Altre scarpe" che espande le query utilizzando il termine "scarpe da corsa" per includere "scarpe sportive". Se alleghi solo il controllo "gShoe Sale" a una configurazione di pubblicazione, le richieste di ricerca con questa configurazione di pubblicazione aumentano i risultati di gShoe per le query che utilizzano il termine "scarpe", ma il controllo "Altre scarpe" non ha alcun effetto perché non è collegato alla configurazione di pubblicazione in uso.

Puoi creare i controlli e quindi aggiungerli o scambiarli in una configurazione di pubblicazione in tempo reale.

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

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

I controlli di pubblicazione sono disponibili per:

Boost/bury: influisce sul ranking e sull'ordine dei risultati nell'elenco dei risultati restituiti. Disponibili per la ricerca e i consigli.
Filtro: rimuove i risultati che non superano il filtro dall'elenco dei risultati restituiti. Disponibile solo per la ricerca.
Reindirizzamento: reindirizza gli utenti a una pagina specifica in base alla query di ricerca. Disponibile solo per la ricerca.
Linguistico: personalizza la linguistica delle query di ricerca. Disponibile solo per la ricerca. Sono disponibili diversi tipi di controlli linguistici:
- Sinonimo: espande i sinonimi considerati per una query di ricerca.
- Sinonimo unidirezionale: espande i sinonimi considerati unidirezionali per termini specifici.
- Non associare: impedisce l'utilizzo di un gruppo di termini nella ricerca quando vengono visualizzati termini specifici.
- Ignora: impedisce l'utilizzo di un termine nelle ricerche.
- Sostituzione: sostituisce i termini nella query di ricerca.

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

Tutorial sul controllo del reindirizzamento

Questo tutorial mostra come utilizzare il controllo del reindirizzamento.

Per seguire le indicazioni dettagliate per questa attività direttamente nell'editor di Cloud Shell, fai clic su Aiuto:

Guidami

Crea un nuovo controllo di pubblicazione

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

I requisiti di controllo variano in base al tipo. Vai alla procedura di creazione per il tipo di controllo che intendi creare:

Crea un controllo boost/bury
Creare un controllo filtro
Creare un controllo del reindirizzamento
Creare un controllo per sinonimo bidirezionale
Creare un controllo per i sinonimi unidirezionale
Crea un controllo da non associare
Creare un controllo per ignorare
Creare un controllo sostitutivo

Crea un controllo boost/bury

Per ulteriori informazioni su questo tipo di controllo, consulta Controlli Boost/bury.

Questo tipo di controllo è disponibile per ricerca e consigli.

Creare un boost di ricerca/un controllo bury
Creare un controllo boost/bury dei suggerimenti

Crea un controllo boost/bury

Per creare un booster di ricerca/un controllo bury:

Console

Vai alla pagina Controlli nella console di Search for Retail.

Vai alla pagina Controlli
Nella scheda Controlli di 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 degli utenti che attiva questo controllo:
- Sfoglia categorie: la regola viene attivata quando un utente sfoglia le categorie nel tuo sito (la regola search.request.query è vuota).
- 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 l'attivazione di questo controllo quando sfoglia una categoria o una query qualsiasi, salta il passaggio seguente.
(Facoltativo) Imposta una condizione di controllo che attivi la regola in base all'eventuale visualizzazione di una categoria specifica o della ricerca di una query specifica.

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

L'opzione disponibile dipende dalla tua scelta tra Sfoglia categorie o Cerca:
- Se hai scelto Sfoglia categorie: nel campo Categorie, inserisci le categorie che attiveranno questo controllo quando verranno sfogliate.
- Se hai scelto Cerca: fai clic sul pulsante Aggiungi query per aggiungere termini di query (ad esempio running shoes) da filtrare e seleziona una delle seguenti opzioni per ogni termine:
  - Corrispondenza parziale: questo controllo si applica quando una query contiene una corrispondenza parziale con questo termine di query.
  - Corrispondenza completa: questo controllo si applica solo quando una query contiene una corrispondenza completa a 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 in aggiunta a questo tipo di condizione, 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 è possibile applicare il controllo.

Se specifichi una categoria o una condizione del termine di query oltre a una condizione relativa all'intervallo di tempo, il controllo viene applicato solo quando entrambe le condizioni sono soddisfatte.
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 delle espressioni di filtro documentata in Filtri e ordinamento.

Ad esempio, per specificare le versioni in rosso e blu di "product1" e "product2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
Per Valore Boost/bury, utilizza il dispositivo di scorrimento per impostare l'intensità del boost. I valori positivi aumentano i risultati e quelli negativi li nascondono.
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.

Sono necessari alcuni minuti perché i controlli appena creati o aggiornati siano pronti per pubblicare il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nell'elenco della scheda Controlli di pubblicazione della pagina Controlli.

arricciatura

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 dell'API Controls e il riferimento dell'API di Controls.create.

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

L'esempio seguente mostra i campi per un controllo attivato dalla consultazione, dove 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"
                    }
                  ]
                },
                "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 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"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Sono necessari alcuni minuti perché i controlli appena creati o aggiornati siano pronti per pubblicare 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, usa il metodo ServingConfig.addControl:

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'API ServingConfig.addControl.
Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Crea un controllo boost/bury dei suggerimenti

Per creare un controllo boost/bury dei suggerimenti:

Console

Vai alla pagina Controlli nella console di Search for Retail.

Vai alla pagina Controlli
Nella scheda Controlli di 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 delle espressioni di filtro documentata in Suggerimenti sui filtri.

Ad esempio, per specificare le versioni in rosso e blu di "product1" e "product2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))
Per Valore Boost/bury, utilizza il dispositivo di scorrimento per impostare l'intensità del boost. I valori positivi aumentano i risultati e quelli negativi li nascondono.
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.

Sono necessari alcuni minuti perché i controlli appena creati o aggiornati siano pronti per pubblicare il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nell'elenco della scheda Controlli di pubblicazione della pagina Controlli.

arricciatura

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 dell'API Controls e il riferimento dell'API di Controls.create.

Per creare un'espressione di filtro, utilizza la sintassi dell'espressione di filtro documentata in Suggerimenti sui filtri.

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, usa il metodo ServingConfig.addControl:

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'API ServingConfig.addControl.
Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Creare un controllo filtro

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

Console

Vai alla pagina Controlli nella console di Search for Retail.

Vai alla pagina Controlli
Nella scheda Controlli di 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 degli utenti che attiva questo controllo:
- Sfoglia categorie: la regola viene attivata quando un utente sfoglia le categorie nel tuo sito (la regola search.request.query è vuota).
- 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 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 verranno sfogliate.
- Se hai scelto Cerca: fai clic sul pulsante Aggiungi query per aggiungere termini di query (ad esempio running shoes) da filtrare e seleziona una delle seguenti opzioni per ogni termine:
  - Corrispondenza parziale: questo controllo si applica quando una query contiene una corrispondenza parziale con questo termine di query.
  - Corrispondenza completa: questo controllo si applica solo quando una query contiene una corrispondenza completa a questo termine di query.
  Quando uno di questi termini è incluso in una query, viene applicato il controllo.
Se specifichi una condizione di intervallo di tempo oltre a questa condizione, 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 è possibile applicare il controllo.

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

Nella sezione Azioni:

Aggiungi 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 in rosso e blu di "product1" e "product2": (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.

Sono necessari alcuni minuti perché i controlli appena creati o aggiornati siano pronti per pubblicare il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nell'elenco della scheda Controlli di pubblicazione della pagina Controlli.

arricciatura

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 dell'API Controls e il riferimento dell'API di Controls.create.

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

L'esempio seguente mostra i campi per un controllo attivato dalla consultazione, dove 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, usa il metodo ServingConfig.addControl:

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'API ServingConfig.addControl.
Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Crea un controllo del reindirizzamento

Per saperne di più 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 di 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 termine di query o un attivatore di intervallo di tempo. I controlli di reindirizzamento richiedono almeno un attivatore:

Seleziona il tipo di comportamento degli utenti che attiva questo controllo:
- Sfoglia categorie: la regola viene attivata quando un utente sfoglia le categorie nel tuo sito (la regola search.request.query è vuota).
- 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 verranno sfogliate.
- Se hai scelto Cerca: fai clic sul pulsante Aggiungi query per aggiungere termini di query (ad esempio running shoes) da filtrare e seleziona una delle seguenti opzioni per ogni termine:
  - Corrispondenza parziale: questo controllo si applica quando una query contiene una corrispondenza parziale con questo termine di query.
  - Corrispondenza completa: questo controllo si applica solo quando una query contiene una corrispondenza completa a questo termine di query.
  Quando uno di questi termini è incluso in una query, viene applicato il controllo.
Se specifichi una condizione di intervallo di tempo oltre a questa condizione, il controllo 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 del termine di query in aggiunta a questa condizione di intervallo di tempo, il controllo viene applicato solo quando entrambe le condizioni sono soddisfatte.
Fai clic su Continua per passare alla sezione Azioni.

Nella sezione Azioni:

Inserisci l'URI a cui reindirizzare quando questo controllo viene attivato.
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.

Sono necessari alcuni minuti perché i controlli appena creati o aggiornati siano pronti per pubblicare il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nell'elenco della scheda Controlli di pubblicazione della pagina Controlli.

arricciatura

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 dell'API Controls e il riferimento dell'API di Controls.create.

Un controllo del reindirizzamento 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 consultazione, dove 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": {
                  "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, usa il metodo ServingConfig.addControl:

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'API ServingConfig.addControl.
Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Creare un controllo per sinonimi bidirezionale

Per ulteriori informazioni su questo tipo di controllo, consulta Controlli per i sinonimi bidirezionale.

Console

Vai alla pagina Controlli nella console di Search for Retail.

Vai alla pagina Controlli
Nella scheda Controlli di 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 dei sinonimi bidirezionale 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 il 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 esempio shirt e top) che devono essere sinonimi.

Quando uno qualsiasi di questi termini viene incluso in una query, la ricerca 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.

Sono necessari alcuni minuti perché i controlli appena creati o aggiornati siano pronti per pubblicare il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nell'elenco della scheda Controlli di pubblicazione della pagina Controlli.

arricciatura

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 dell'API Controls e il riferimento dell'API di 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 il metodo ServingConfig.addControl. Consulta la sezione Aggiungere controlli alle configurazioni di pubblicazione incorporati.

Creare un controllo per i sinonimi unidirezionale

Per ulteriori informazioni su questo tipo di controllo, consulta Controlli per i sinonimi unidirezionali.

Console

Vai alla pagina Controlli nella console di Search for Retail.

Vai alla pagina Controlli
Nella scheda Controlli di 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 il controllo.
Fai clic su Continua per passare alla sezione Azioni.

Nella sezione Azioni:

Nel campo Termini di query, inserisci i termini (ad esempio, shoes) a cui sono associati sinonimi quando uno di essi è incluso in una query.
Nel campo Sinonimi, inserisci i termini da utilizzare come sinonimi dei 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.

Sono necessari alcuni minuti perché i controlli appena creati o aggiornati siano pronti per pubblicare il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nell'elenco della scheda Controlli di pubblicazione della pagina Controlli.

arricciatura

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 dell'API Controls e il riferimento dell'API di 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, usa il metodo ServingConfig.addControl:

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'API ServingConfig.addControl.
Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Crea un controllo da non associare

Per ulteriori informazioni su questo tipo di controllo, consulta Non associare i controlli.

Console

Vai alla pagina Controlli nella console di Search for Retail.

Vai alla pagina Controlli
Nella scheda Controlli di 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 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 il controllo.
Fai clic su Continua per passare alla sezione Azioni.

Nella sezione Azioni:

Nel campo Termini di query, inserisci i termini (ad esempio, gShoe) che vuoi distinguere esplicitamente dagli altri.
Nel campo Termini dissociati, 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.

Sono necessari alcuni minuti perché i controlli appena creati o aggiornati siano pronti per pubblicare il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nell'elenco della scheda Controlli di pubblicazione della pagina Controlli.

arricciatura

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 dell'API Controls e il riferimento dell'API di 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, usa il metodo ServingConfig.addControl:

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'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 di 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 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 il 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.

Sono necessari alcuni minuti perché i controlli appena creati o aggiornati siano pronti per pubblicare il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nell'elenco della scheda Controlli di pubblicazione della pagina Controlli.

arricciatura

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 dell'API Controls e il riferimento dell'API di 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, usa il metodo ServingConfig.addControl:

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'API ServingConfig.addControl.
Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.

Creare un controllo sostitutivo

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

Console

Vai alla pagina Controlli nella console di Search for Retail.

Vai alla pagina Controlli
Nella scheda Controlli di 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 il controllo.
Fai clic su Continua per passare alla sezione Azioni.

Nella sezione Azioni:

Nel campo Termini di 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 i termini di query specificati.

Ad esempio, puoi sostituire il termine di query gShoe con il termine sostitutivo 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.

Sono necessari alcuni minuti perché i controlli appena creati o aggiornati siano pronti per pubblicare il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.

Puoi trovare il nuovo controllo nell'elenco della scheda Controlli di pubblicazione della pagina Controlli.

arricciatura

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 dell'API Controls e il riferimento dell'API di 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, usa il metodo ServingConfig.addControl:

Per ulteriori informazioni su questo metodo, consulta la documentazione di riferimento dell'API ServingConfig.addControl.
Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.