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.
Puoi creare un controllo di pubblicazione nella console Ricerca per il commercio 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: un controllo denominato Sconto gShoe che migliora i risultati per il brand gShoe quando viene cercata la parola scarpe e un controllo denominato Altre scarpe che espande le query che utilizzano il termine scarpe da corsa in modo da includere 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.
Video e guide rapide
- Introduzione ai controlli di pubblicazione: i controlli di pubblicazione ti consentono di creare regole che personalizzino il modo in cui le configurazioni di pubblicazione restituiscono i risultati di ricerca.
- 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.
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:
- Linguistica: personalizza la linguistica delle query di ricerca. Disponibile solo per la ricerca.
- 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.
Opzioni della console per la creazione di controlli
Puoi scegliere uno dei seguenti percorsi della console per creare tutti i controlli di pubblicazione in Vertex AI Search for Commerce.
Utilizzare la console Google Cloud
Segui i passaggi della console Merchandising nella sezione di controllo della pubblicazione.
Utilizzare la console Merchandising
Se sei un amministratore della Console Google Cloud, puoi concedere ai merchandiser del sito l'accesso alla Console di merchandising e assegnare loro il ruolo di autore o approvatore.
Accedere alla console Merchandising come utente
Se ti è stato concesso l'accesso con l'URL, puoi utilizzare la console Merchandising anziché la console Google Cloud standard. Per creare controlli utilizzando la console Merchandising:
Accedi tramite l'accesso esterno fornito dall'amministratore.
Segui i passaggi descritti nella documentazione della console di merchandising nella sezione di controllo della pubblicazione.
Eseguire l'onboarding degli utenti della console Merchandising
Se sei un amministratore della console Google Cloud, puoi fornire ai commercianti l'accesso alla console Merchandising:
Vai alla pagina Controlli nella console Ricerca per il commercio.
Vai alla pagina ControlliVai alla scheda Console di merchandising.
Configura le impostazioni di identità.
Assegna agli utenti i ruoli Approvatore o Autore.
Puoi vedere l'URL univoco della console di merchandising associato al Google Cloud progetto corrente. Copia il link o aprilo direttamente nella console Google Cloud.
Seleziona la configurazione di pubblicazione predefinita per Anteprima nella console Merchandising.
(Facoltativo) Modifica l'accesso alla console Merchandising utilizzando queste funzioni:
Aggiungi utenti: concedi agli utenti l'accesso come Approvatore o Autore alla Console di merchandising.
Elimina utenti: revoca l'accesso alla console Merchandising eliminando gli Approvatori o i Creator.
Vai alla pagina Amministrazione IAM nella console Ricerca per il commercio.
Vai alla pagina Amministrazione IAM
Passaggi aggiuntivi per gli approvatori
Modifica le impostazioni della console di merchandising facendo clic su add_boxCrea controllo.
Aggiungi domande alla regola iniziale o eliminale nella schermata Definizione degli obiettivi.
(Facoltativo) Dopo aver ricevuto le richieste di controllo inviate via email, modifica lo stato, approva o rifiuta le richieste nella dashboard, dove sono elencate.
Gestisci l'approvazione di ogni controllo nella sezione Esamina e approva facendo clic su Approva, Rifiuta o Modifica.
L'ultima opzione ti reindirizza alla schermata successiva, dove puoi apportare le modifiche e fare clic su Approva con modifiche.
Tutti i controlli aggiunti come approvatore vengono approvati automaticamente.
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 di boost/bury
Questo tipo di controllo è disponibile per la ricerca e per i consigli.
- Creare un controllo di soppressione/miglioramento nella ricerca
- Creare un controllo per mettere in evidenza/nascondere i consigli
Per scoprire di più su questo tipo di controllo, consulta Controlli di messa in evidenza/nascondimento.
Creare un controllo boost/bury per la rete di ricerca
Per creare un controllo di evidenza/seppellimento nella rete di ricerca:
Console Merchandising
Fai clic sull'URL fornito dall'amministratore. Accedi.
Verrà visualizzata la pagina Controlli nella console di merchandising.
Fai clic su add_boxCrea controllo.
Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.
Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Metti in evidenza/Nascondi.
Configura il controllo Boost/Bury:
In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.
Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.
Definisci le azioni di promozione/seppellimento che vuoi attivare con questo controllo. Queste azioni sono definite da un attributo del catalogo, ad esempio colors, un criterio, ad esempio contains, e un valore, ad esempio red.
Fai clic su add_boxAggiungi attributo per aggiungere altri attributi.
Utilizza il cursore per impostare il valore di boost/bury. I numeri negativi sono bury e i numeri positivi sono boost.
Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.
console Cloud
Vai alla pagina Controlli nella console Ricerca per il commercio.
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 naviga tra le categorie sul tuo sito (
search.request.query
è vuoto).Ricerca: la regola viene attivata quando un utente esegue una ricerca sul tuo sito (
search.request.query
non è vuoto). Per impostare questo controllo in modo che si attivi quando viene visualizzata una categoria o viene cercata una query, salta il passaggio successivo.
(Facoltativo) Imposta categorie o query specifiche che possono attivare questo controllo a seconda che venga visualizzata una categoria specifica o venga cercata 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 del prodotto nel campo Metti in evidenza/Nascondi prodotto.
Utilizza la sintassi dell'espressione di filtro descritta in Filtro e ordine. 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 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 Merchandising
Fai clic sull'URL fornito dall'amministratore. Accedi.
Verrà visualizzata la pagina Controlli nella console di merchandising.
Fai clic su add_boxCrea controllo.
Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.
Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Sfoglia e poi scegli il tipo di controllo Metti in evidenza/Nascondi.
Configura il controllo Boost/Bury:
In Trigger, inserisci le categorie di pagine che devono attivare il controllo. Se non sono configurati attributi del catalogo, questo controllo è sempre attivo.
Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.
Definisci le azioni di promozione/seppellimento che vuoi attivare con questo controllo. Queste azioni sono definite da un attributo del catalogo, ad esempio colors, un criterio, ad esempio contains, e un valore, ad esempio red.
Fai clic su add_boxAggiungi attributo per aggiungere altri attributi.
Utilizza il cursore per impostare il valore di boost/bury. I numeri negativi sono inibitori, i numeri positivi sono stimolanti.
Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.
console Cloud
Vai alla pagina Controlli nella console Ricerca per il commercio.
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 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 Merchandising
Fai clic sull'URL fornito dall'amministratore. Accedi.
Verrà visualizzata la pagina Controlli nella console di merchandising.
Fai clic su add_boxCrea controllo.
Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.
Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca o Sfoglia e poi scegli il tipo di controllo Filtra.
Configura il controllo Filtro:
In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca o una categoria di pagina correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.
Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.
Definisci le azioni di filtro che vuoi attivare con questo controllo. Queste azioni sono definite da un attributo del catalogo, ad esempio colors, un criterio, ad esempio contains, e un valore, ad esempio red.
Fai clic su add_boxAggiungi attributo per aggiungere altri attributi.
Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.
console Cloud
Vai alla pagina Controlli nella console Ricerca per il commercio.
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 naviga tra le categorie sul tuo sito (
search.request.query
è vuoto).Ricerca: la regola viene attivata quando un utente esegue una ricerca sul tuo sito (
search.request.query
non è vuoto).
(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 richiedono 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 Merchandising
Fai clic sull'URL fornito dall'amministratore. Accedi.
Verrà visualizzata la pagina Controlli nella console di merchandising.
Fai clic su add_boxCrea controllo.
Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.
Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Reindirizzamento.
Configura il controllo Reindirizza:
In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.
Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.
Definisci le azioni di reindirizzamento che vuoi attivare con questo controllo inserendo l'URL di reindirizzamento.
Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.
console Cloud
Vai alla pagina Controlli nella console Ricerca per il commercio.
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 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 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 Merchandising
Fai clic sull'URL fornito dall'amministratore. Accedi.
Verrà visualizzata la pagina Controlli nella console di merchandising.
Fai clic su add_boxCrea controllo.
Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.
Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Sinonimi.
Configura il controllo dei sinonimi bidirezionali:
In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.
Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.
Definisci il tipo di sinonimo che vuoi attivare con questo controllo. Seleziona Bidirezionale. Per ulteriori informazioni sui tipi di sinonimi, consulta la sezione Sinonimi.
Fai clic su Invia. Viene visualizzata una schermata di configurazione dettagliata dei sinonimi bidirezionali.
Inserisci i sinonimi nel campo Azioni di sinonimi bidirezionali. Questa azione collega i termini in modo bidirezionale in modo che vengano trattati allo stesso modo nei risultati di ricerca, in modo che una query su divano rosso restituisca divano rosso bordeaux, ma le query su divano bordeaux vengano espanse per includere tutti i tipi di divani rossi, come cremisi o rosa.
Fai clic di nuovo su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.
console Cloud
Vai alla pagina Controlli nella console Ricerca per il commercio.
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 Merchandising
Fai clic sull'URL fornito dall'amministratore. Accedi.
Verrà visualizzata la pagina Controlli nella console di merchandising.
Fai clic su add_boxCrea controllo.
Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.
Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Sinonimi.
Configura il controllo dei sinonimi unidirezionali:
In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.
Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.
Definisci il tipo di sinonimo che vuoi attivare con questo controllo. Seleziona Solo andata. Per ulteriori informazioni sui tipi di sinonimi, consulta la sezione Sinonimi.
Fai clic su Invia. Viene visualizzata una schermata di configurazione dettagliata dei sinonimi unidirezionali.
Inserisci i sinonimi nel campo sotto Azioni di sinonimi unidirezionali. Questa azione collega i termini in modo unidirezionale in modo che vengano trattati allo stesso modo nei risultati di ricerca, in modo che una query su divani rossi includa i divani marrone, ma una query su divani marrone non restituisca altri tipi di divani rossi, limitando i risultati solo ai divani marrone.
Fai di nuovo clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.
console Cloud
Vai alla pagina Controlli nella console Ricerca per il commercio.
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 richiedono 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" } ] }, "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 Merchandising
Fai clic sull'URL fornito dall'amministratore. Accedi.
Verrà visualizzata la pagina Controlli nella console di merchandising.
Fai clic su add_boxCrea controllo.
Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.
Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Non associa.
Configura il controllo Non associa:
In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.
Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.
In Non associare azioni,specifica i termini che non devono essere associati ai termini di query inseriti nella sezione Scaglioni precedente. Inseriscili rispettivamente nei campi Termini di query e Termini disaggiunti.
Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.
console Cloud
Vai alla pagina Controlli nella console Ricerca per il commercio.
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 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 Merchandising
Fai clic sull'URL fornito dall'amministratore. Accedi.
Verrà visualizzata la pagina Controlli nella console di merchandising.
Fai clic su add_boxCrea controllo.
Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.
Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Ignora.
Configura il controllo Ignora:
In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.
Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.
Inserisci i termini che vuoi ignorare in Azioni di ignoramento.
Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.
console Cloud
Vai alla pagina Controlli nella console Ricerca per il commercio.
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 es.
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 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 Merchandising
Fai clic sull'URL fornito dall'amministratore. Accedi.
Verrà visualizzata la pagina Controlli nella console di merchandising.
Fai clic su add_boxCrea controllo.
Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.
Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Sostituto.
Configura il controllo Sostituisci:
In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.
Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.
In Azioni di sostituzione, definisci i termini di query da sostituire nel primo campo e i relativi sostituti nel secondo campo.
Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.
console Cloud
Vai alla pagina Controlli nella console Ricerca per il commercio.
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 Merchandising
Fai clic sull'URL fornito dall'amministratore. Accedi.
Verrà visualizzata la pagina Controlli nella console di merchandising.
Fai clic su add_boxCrea controllo.
Definisci gli obiettivi per gli utenti finali e le tempistiche richieste. È obbligatorio rispondere a tutte le domande. Fai clic su Avanti.
Seleziona un controllo. Inserisci il nome del controllo, seleziona il prodotto Ricerca e poi scegli il tipo di controllo Fissaggio.
Configura il controllo Fissa:
In Attivatori, definisci l'attributo del catalogo che attiva questo controllo specificando i criteri per una query di ricerca correlata, ad esempio contiene o non compreso nell'intervallo. Se non è stato configurato alcun attributo del catalogo, questo controllo verrà sempre applicato.
Definisci un intervallo di tempo applicabile inserendo un intervallo di date. Se uno o più degli intervalli di tempo specificati è soddisfatto, l'attributo del catalogo verrà associato alla query durante uno degli intervalli di tempo specificati. Aggiungi un intervallo di tempo con add_boxAggiungi intervallo di tempo.
Definisci le azioni di blocco che vuoi attivare con questo controllo. Queste azioni sono definite dall'ID prodotto e dalla posizione del pin, preferibilmente un numero inferiore a 120 (le dimensioni tipiche di una pagina). Puoi fare clic su add_boxAggiungi prodotto e aggiungerne fino a 10.
Fai clic su Invia per inviare la richiesta di controllo a un approvatore. Puoi visualizzare lo stato delle richieste inviate nella Console merchandising. Se cambi idea, puoi eliminare la richiesta di controllo.
console Cloud
Vai alla pagina Controlli nella console Ricerca per il commercio.
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 il commercio consente 10 elementi nella mappa di elementi 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 Cloud
Vai alla pagina Valuta nella console Ricerca per il commercio.
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.