Questa pagina descrive come creare i 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 personalizzino il modo in cui le configurazioni di pubblicazione pubblicano i risultati.
Puoi creare un controllo della pubblicazione nella console Ricerca per la vendita al dettaglio costituito da una condizione che attiva il controllo e da un'azione che viene eseguita quando si attiva la condizione. Puoi quindi collegare il nuovo controllo della pubblicazione a una configurazione di pubblicazione.
Le configurazioni di pubblicazione hanno una relazione many-to-many 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 anche "scarpe sportive". Se agganci solo il controllo "Sconto gShoe" a una configurazione di pubblicazione, le richieste di ricerca che utilizzano questa configurazione migliorano 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 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 ulteriori controlli della pubblicazione, richiedi una quota aggiuntiva. Per scoprire come richiedere una quota aggiuntiva, consulta Aumentare le quote. Una configurazione di pubblicazione può avere fino a 100 controlli di pubblicazione di qualsiasi tipo, ad eccezione dei controlli di reindirizzamento, il cui limite è 1000 per 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 dall'elenco dei risultati restituiti i risultati che non superano il filtro. Disponibile solo per la ricerca.
- Reindirizzamento: reindirizza gli utenti a una pagina specifica a seconda della query di ricerca. Disponibile solo per la ricerca.
- Linguistica: personalizza la linguistica delle query di ricerca. Disponibile solo per la ricerca. Sono disponibili diversi tipi di controlli linguistici:
- 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 l'utilizzo di un termine nelle ricerche.
- Sostituisci: sostituisce i termini nella query di ricerca.
- Fissaggio: influisce sull'ordinamento dei risultati, posizionando un risultato in una posizione specifica, ad esempio nella posizione 4. Disponibile per la ricerca e la navigazione.
Per esempi di questi controlli, consulta Informazioni sui controlli di pubblicazione.
Tutorial sul controllo del reindirizzamento
Questo tutorial mostra come utilizzare il controllo di reindirizzamento.
Per seguire le indicazioni dettagliate per questa attività direttamente nell'editor di Cloud Shell, fai clic su 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 di blocco
- Creare un controllo sinonimi bidirezionale
- Creare un controllo sinonimi unidirezionale
- Creare un controllo di mancata associazione
- Creare un controllo di ignoramento
- Creare un controllo sostitutivo
Creare un controllo boost/bury
Per saperne 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 di evidenza/seppellimento nella ricerca
- Creare un controllo per mettere in evidenza/nascondere i consigli
Creare un controllo boost/bury per la rete di ricerca
Per creare un controllo di soppressione/miglioramento della ricerca:
Console
Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.
Vai alla pagina ControlliNella scheda Controlli pubblicazione, fai clic su add_boxCrea controllo.
Viene visualizzato il riquadro Crea controllo.
Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome 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 Cerca.
Scegli Controlli boost/bury come tipo di controllo. Fai clic su Continua.
Nella sezione Attivatori, seleziona il tipo di comportamento dell'utente che attiva questo controllo.
Sfoglia categorie: la regola si attiva quando un utente sfoglia 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). Per impostare questo controllo in modo che si attivi quando viene visualizzata una categoria o viene eseguita una ricerca, salta il passaggio successivo.
(Facoltativo) Imposta categorie o query specifiche che possono attivare questo controllo a seconda che si navighi in una categoria specifica o si cerchi una query specifica.
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. Per ogni termine, scegli Corrispondenza parziale o Corrispondenza completa.
(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.
Aggiungi filtri per gli attributi dei prodotti nel campo Metti in evidenza/Nascondi prodotto.
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 migliorano i risultati, mentre quelli negativi li nascondono. Fai clic su Continua.
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 gestire il traffico in tempo reale. Puoi verificare se le modifiche sono state applicate nella pagina Valuta della console.
Ora 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
.
Un controllo di aumento/seppellimento 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, 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" } ] }, "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"
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 il metodo ServingConfig.addControl
:
Per saperne di più su questo metodo, consulta il riferimento all'API
ServingConfig.addControl
.Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.
Creare un controllo di boost/bury per i consigli
Per creare un controllo boost/bury per i consigli:
Console
Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.
Vai alla pagina ControlliNella scheda Controlli pubblicazione, fai clic su add_boxCrea controllo.
Viene visualizzato il riquadro Crea controllo.
Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome 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.
Aggiungi filtri per gli attributi dei prodotti nel campo Metti in evidenza/Nascondi prodotto.
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 migliorano i risultati, mentre quelli negativi li nascondono.
Fai clic su Continua per passare alla 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
.
Per creare un'espressione di filtro, utilizza la sintassi dell'espressione di filtro descritta 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"
I controlli appena creati o aggiornati possono richiedere alcuni minuti prima di essere pronti per gestire 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 il metodo ServingConfig.addControl
:
Per saperne di più su questo metodo, consulta il riferimento all'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 ControlliNella scheda Controlli pubblicazione, fai clic su add_boxCrea controllo.
Viene visualizzato il riquadro Crea controllo.
Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome 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.
Seleziona il tipo di comportamento utente che attiva questo controllo:
Sfoglia categorie: la regola si attiva quando un utente sfoglia 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).
(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 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 corrispondenza parziale a questo termine di query.
- Corrispondenza completa: questo controllo si applica solo quando una query contiene una corrispondenza completa per questo termine di query.
Quando uno di questi termini è incluso in una query, il controllo viene applicato.
(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.
Aggiungi i filtri per gli attributi del prodotto nel campo Azione filtro.
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"))
Fai clic su Continua per passare alla 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 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
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
.
Un controllo filtro 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, 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 all'API
ServingConfig.addControl
.Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.
Creare un controllo di reindirizzamento
Per saperne di più su questo tipo di controllo, consulta Controlli di reindirizzamento.
Console
Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.
Vai alla pagina ControlliNella scheda Controlli pubblicazione, fai clic su add_boxCrea controllo.
Viene visualizzato il riquadro Crea controllo.
Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome 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.
Crea almeno un attivatore per termine di query o intervallo di tempo. I controlli di reindirizzamento richiedono almeno un attivatore:
Seleziona il tipo di comportamento utente che attiva questo controllo:
Sfoglia categorie: la regola si attiva quando un utente sfoglia 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 corrispondenza parziale a questo termine di query.
- Corrispondenza completa: questo controllo si applica solo quando una query contiene una corrispondenza completa per questo termine di query.
Quando uno di questi termini è incluso in una query, il controllo viene applicato.
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.
Inserisci l'URI a cui reindirizzare quando viene attivato questo controllo.
Fai clic su Continua per passare alla 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
.
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, 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": { "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 all'API
ServingConfig.addControl
.Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.
Creare un controllo 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 ControlliNella scheda Controlli pubblicazione, fai clic su add_boxCrea controllo.
Nel campo Nome controllo, inserisci un nome per il nuovo controllo.
Viene visualizzato il riquadro Crea controllo.
Si aprirà la 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.
(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.
Nel campo Sinonimi, inserisci da 2 a 100 termini di query (ad es.
shirt
etop
) che devono essere sinonimi tra loro.Quando uno di questi termini è incluso in una query, la ricerca considera gli altri termini della query come sinonimi del termine incluso.
Fai clic su Continua per passare alla 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" } ] }, "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
Aggiungere controlli alle configurazioni di pubblicazione in linea.
Creare un controllo sinonimi unidirezionale
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 ControlliNella scheda Controlli pubblicazione, fai clic su add_boxCrea controllo.
Viene visualizzato il riquadro Crea controllo.
Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome 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.
(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.
Nel campo Termini di query, inserisci i termini (ad es.
shoes
) che devono avere sinonimi associati quando uno di questi è incluso in una query.Nel campo Sinonimi, inserisci i termini da utilizzare come sinonimi per i termini di query specificati (ad esempio,
sneakers
esandals
come sinonimi unidirezionali per il termine di queryshoes
).Fai clic su Continua per passare alla 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 il metodo ServingConfig.addControl
:
Per saperne di più su questo metodo, consulta il riferimento all'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 ControlliNella scheda Controlli pubblicazione, fai clic su add_boxCrea controllo.
Viene visualizzato il riquadro Crea controllo.
Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome controllo.
(Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.
Scegli Non associa controllo come tipo di controllo.
Fai clic su Continua per passare alla 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.
Nel campo Termini di query, inserisci i termini (ad es.
gShoe
) che vuoi distinguere esplicitamente da altri.Nel campo Termini disaggiunti, inserisci i termini da disaggregare dai risultati di ricerca con i termini di query che hai specificato.
Ad esempio, puoi disaccoppiare il termine di query
gShoe
dal terminecheap
.Fai clic su Continua per passare alla 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 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
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" } ] }, "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 saperne di più su questo metodo, consulta il riferimento all'API
ServingConfig.addControl
.Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.
Creare un controllo di ignoramento
Per saperne di più su questo tipo di controllo, consulta Ignorare i controlli.
Console
Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.
Vai alla pagina ControlliNella scheda Controlli pubblicazione, fai clic su add_boxCrea controllo.
Viene visualizzato il riquadro Crea controllo.
Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome controllo.
(Facoltativo) Per modificare l'ID controllo creato automaticamente, fai clic su Modifica e inserisci un nuovo ID controllo.
Scegli Non associa controllo come tipo di controllo.
Fai clic su Continua per passare alla 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.
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.
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 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
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" } ] }, "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 il metodo ServingConfig.addControl
:
Per saperne di più su questo metodo, consulta il riferimento all'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 di sostituzione.
Console
Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.
Vai alla pagina ControlliNella scheda Controlli pubblicazione, fai clic su add_boxCrea controllo.
Viene visualizzato il riquadro Crea controllo.
Nella sezione Preferenze, inserisci un nome per il nuovo controllo nel campo Nome 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.
(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.
Nel campo Termini di query, inserisci i termini di query (ad es.
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 di sostituzioneGoogle Shoe
.Fai clic su Continua per passare alla 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" } ] }, "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 saperne di più su questo metodo, consulta il riferimento all'API
ServingConfig.addControl
.Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.
Creare un controllo di blocco
Per creare un controllo di blocco:
Console
Vai alla pagina Controlli nella console Ricerca per la vendita al dettaglio.
Vai alla pagina ControlliNella scheda Controlli pubblicazione, fai clic su add_boxCrea controllo.
Viene visualizzato il riquadro Crea controllo.
Nel campo Nome controllo della sezione Preferenze, 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 Cerca o Sfoglia.
Scegli Controllo di blocco come tipo di controllo. Fai clic su Continua.
Nella sezione Attivatori, scegli il comportamento dell'utente che attiva questo controllo:
Sfoglia categorie: per le richieste di ricerca è necessario che il campo
page_categories
sia compilato e chesearch.request.query
sia vuoto.Ricerca: le richieste di ricerca richiedono solo l'inserimento di
search.request.query
.Per impostazione predefinita, questo controllo viene attivato per tutte le categorie e le query cercate.
(Facoltativo) Imposta una condizione che attivi la regola in base a una determinata categoria visualizzata o alla query cercata:
Sfoglia categorie: nel campo Categorie, inserisci le categorie che attivano il controllo.
Ricerca: per aggiungere termini di query da filtrare (ad es.
running shoes
), fai clic su Aggiungi query. Per ogni termine, scegli Corrispondenza parziale o Corrispondenza completa.
(Facoltativo) Fai clic su Aggiungi intervallo di tempo o Aggiungi intervallo di date per aggiungere uno o più intervalli di tempo durante i quali è possibile applicare questo controllo.
Fai clic su Continua per passare alla sezione Azioni. Per Posizione bloccata, utilizza il cursore per specificare la posizione in cui devono essere bloccati i prodotti. Il dispositivo di scorrimento del valore del blocco non accetta valori pari a 0, numeri negativi o non interi.
Vertex AI Search per la vendita al dettaglio consente 10 indicatori nella mappa degli indicatori di qualsiasi singolo controllo. La posizione può essere qualsiasi valore compreso tra 1 e 120 (la dimensione massima della pagina della richiesta).
Fai clic su Continua per passare alla sezione Configurazioni di pubblicazione. Seleziona le configurazioni di pubblicazione a cui applicare il controllo e 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" \ -H "X-Goog-User-Project: PROJECT_NUMBER" \ --data '{ "displayName": "DisplayName", "solutionTypes": "SOLUTION_TYPE_SEARCH", "searchSolutionUseCase": ["SEARCH_SOLUTION_USE_CASE_SEARCH"], "rule": { "condition": { "queryTerms": [ { "value": "Term1", "fullMatch": "boolean: true / false" }, { "value": "Term2", "fullMatch": "boolean: true / false" }, ], "activeTimeRange": [ { "startTime": timestamp1, "endTime": timestamp2 }, { "startTime": timestamp3, "endTime": timestamp4 } ] }, "pinAction": { "pinMap" : { "pin_position1": "product_id", "pin_position2": "product_id>" } } } }' \ "https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/controls?controlId=CONTROL_ID"
pin_position
deve essere un numero intero compreso tra [1,10] inclusi e product_id
deve esistere nel tuo catalogo. Il numero massimo di elementi consentiti nella mappa dei pin è 10 per ogni controllo.
Quindi, collega il controllo di blocco alla configurazione di pubblicazione:
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ -H "X-Goog-User-Project: PROJECT_NUMBER" \ -d '{ "controlId": "CONTROL_ID" }' \ 'https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'
In questo caso, CONTROL_ID
deve essere il controllo di blocco id
che hai creato in precedenza.
Per aggiungere un controllo a una configurazione di pubblicazione, utilizza il metodo ServingConfig.addControl
:
Per saperne di più su questo metodo, consulta il riferimento all'API
ServingConfig.addControl
.Per un esempio di questo metodo, consulta Gestire le configurazioni di pubblicazione.
Infine, per testare la configurazione, effettua una richiesta di ricerca. Per assicurarti che a una richiesta venga applicato correttamente il controllo di blocco, utilizza termini di query (nella ricerca) o categorie di pagine (nella visualizzazione) corrispondenti ai termini/alle categorie forniti nel controllo creato nei passaggi precedenti.
Console
Vai alla pagina Valuta nella console Ricerca per la vendita al dettaglio.
Vai alla pagina ValutaVai alla scheda Ricerca.
Inserisci una query di test nel campo della query di ricerca.
Fai clic su Anteprima ricerca.
Visualizza i risultati per assicurarti che i prodotti scelti siano bloccati.
curl
curl -s -X POST -H "Authorization: Bearer" -H "Content-Type: application/json" --data "{'query': '','visitorId': ' \ "https://retail.googleapis.com/v2/projects/PROJECT/locations/global/catalogs/CATALOG/placements/default_search:search"'}"
Vincoli per il controllo degli errori
Per il controllo degli errori, tieni presente questi vincoli:
- Non è possibile fissare due prodotti nella stessa posizione, ovvero i prodotti "a" e "b" non possono occupare entrambi la posizione 2.
- Al contrario, un prodotto non può essere fissato in più posizioni, ovvero il prodotto "a" non può essere fissato contemporaneamente alle posizioni 2 e 3 per la stessa query.
product_id
deve esistere come prodotto nel catalogo, supponendo che non vengano applicati filtri o ordinamento.