Informazioni sui controlli di pubblicazione

Puoi applicare i controlli di pubblicazione alle configurazioni di pubblicazione per personalizzare il modo in cui la Ricerca tratta le query di ricerca e restituisce i risultati. Un controllo di pubblicazione è una regola costituita da una coppia condizione-azione, in cui la condizione determina quando verrà eseguito il controllo di pubblicazione e l'azione specifica il comportamento che verrà messo in atto dal controllo di pubblicazione.

Puoi creare un controllo di pubblicazione utilizzando il metodo API Control.create.

Se non vuoi utilizzare l'API, puoi scegliere la console per creare controlli di pubblicazione in Vertex AI Search for Commerce.

Controlli di pubblicazione disponibili

Sono disponibili i seguenti controlli di pubblicazione:

  • Promuovi/seppellisci: influisce sul ranking e sull'ordine dei risultati nell'elenco dei risultati restituiti. Disponibile per la ricerca e i consigli.
  • Filtro: rimuove i risultati che non superano il filtro dall'elenco dei risultati restituiti. Disponibile solo per la ricerca.
  • Reindirizzamento: reindirizza gli utenti a una pagina specifica a seconda della query di ricerca. Disponibile solo per la ricerca.
  • Blocco: la posizione esatta nei risultati è specificata per un determinato prodotto.
  • Linguistica: personalizza la linguistica delle query di ricerca. Disponibile solo per la ricerca. Sono disponibili diversi tipi di controlli linguistici:
    • Sinonimo: espande i sinonimi considerati per una query di ricerca.
    • Sinonimo unidirezionale: espande i sinonimi considerati unidirezionalmente per termini specifici.
    • Ignora: impedisce l'utilizzo di un termine nelle ricerche.
    • Non associare: impedisci l'utilizzo dei termini nelle ricerche quando vengono visualizzati termini specifici.
    • Sostituzione: sostituisce i termini nella query di ricerca.

Condizioni di controllo

Le condizioni di controllo determinano quando verrà eseguito un controllo della pubblicazione.

I campi della condizione di controllo possono essere termini di query, intervalli di tempo o entrambi. Alcuni tipi di controllo consentono più campi condizione o non ne consentono nessuno.

I campi delle condizioni disponibili:

  • Termini della query: attivati quando il termine viene visualizzato nella query di ricerca.
    • Una corrispondenza completa richiede che l'intera query di ricerca corrisponda al termine della query.
    • È possibile specificare più termini di query. Viene attivato se uno dei termini della query viene visualizzato nella query di ricerca.
  • Intervallo di tempo attivo: attivato quando la data della query di ricerca rientra nell'intervallo di tempo.
    • È possibile specificare più intervalli di tempo. Viene attivato se la data della query è compresa nell'intervallo di tempo (incluso).

I campi della condizione che specifichi determinano se il controllo verrà applicato.

  • I campi con più condizioni vengono combinati utilizzando l'operatore AND. Ciò significa che se specifichi sia l'intervallo di tempo sia i termini di ricerca, entrambi i campi delle condizioni devono essere attivati affinché il controllo venga applicato.
  • I sottocampi con più condizioni vengono combinati utilizzando l'operatore OR. Ciò significa che se hai più termini di ricerca, questi verranno attivati se uno qualsiasi di essi corrisponde. Se hai più intervalli di tempo, qualsiasi intervallo di tempo corrispondente attiverà il controllo.
  • Se non sono specificati campi di condizione, il controllo viene sempre applicato. Tuttavia, alcuni controlli richiedono la definizione di un campo.

Per saperne di più sulle impostazioni delle condizioni, consulta la documentazione di riferimento dell'API Controls.condition.

Azioni di controllo

Un'azione di controllo specifica il comportamento che il controllo di pubblicazione adotterà se le condizioni vengono soddisfatte durante una ricerca.

Il tipo di azione che puoi specificare dipende dal tipo di controllo della pubblicazione che crei. Ad esempio, l'azione per un controllo di aumento/sepoltura consiste nell'applicare un valore di aumento/sepoltura ai prodotti che il filtro specificato, mentre l'azione per un controllo di sinonimo unidirezionale consiste nell'applicare un termine associato specificato.

Controlli boost/bury

I controlli di aumento/sepoltura ti consentono di mostrare determinati risultati di ricerca con un ranking superiore o inferiore.

Puoi creare un controllo di aumento/riduzione per la ricerca o i consigli. La funzionalità di promozione/sepoltura per i consigli è in Anteprima pubblica.

Quando crei un controllo di aumento/riduzione, puoi utilizzare le espressioni di filtro per specificare le condizioni in base ai campi Product.

Puoi quindi applicare un valore boost compreso tra -1,0 e 1,0 per indicare in che misura aumentare o diminuire i risultati dei prodotti che corrispondono a queste condizioni. Un valore positivo aumenta i risultati, mentre un valore negativo li nasconde.

Se imposti un livello di boosting elevato, l'articolo viene promosso maggiormente, ma non significa necessariamente che l'articolo con boosting sarà sempre il risultato in cima alla prima pagina. I risultati molto più pertinenti alla query di ricerca possono comunque superare gli articoli nettamente preferiti, ma non pertinenti. Allo stesso modo, se il boosting viene impostato su -1.0, l'articolo viene declassato in modo significativo, ma i risultati molto pertinenti potrebbero comunque essere mostrati.

Ad esempio, potresti dare la priorità ai prodotti più economici e ridurre la priorità di quelli costosi.

Le condizioni di controllo differiscono tra i controlli boost/bury per la ricerca e per i consigli:

  • Ricerca: puoi impostare i termini di query e gli intervalli di tempo applicabili come condizioni di controllo.
  • Consigli: le condizioni di controllo non sono disponibili. Il controllo si applica sempre.

Come azione di controllo, specifica un filtro per i prodotti da mettere in evidenza o nascondere e imposta il valore di evidenziazione/nascondimento.

Per creare un controllo di aumento/riduzione, consulta Crea un nuovo controllo di pubblicazione.

Per saperne di più sulle impostazioni di controllo di boost/bury, consulta la guida di riferimento dell'API Controls.BoostAction.

Controlli filtro

Con i controlli dei filtri, puoi aggiungere dinamicamente filtri predefiniti in base a una richiesta di ricerca specifica.

Puoi utilizzare espressioni di filtro basate sui campi Product. Consulta Filtrare e ordinare i risultati per la sintassi dell'espressione di filtro.

Puoi impostare i termini di query e gli intervalli di tempo applicabili come condizioni di controllo. Come azione di controllo, specifica un filtro da applicare al momento della query.

Ad esempio, data la query scarpe blu, puoi utilizzare un controllo filtro per filtrare automaticamente i risultati di ricerca in base al colore blu. Puoi anche utilizzare i controlli filtro per impedire che determinati risultati vengano restituiti agli acquirenti.

Per creare un controllo dei filtri, consulta Crea un nuovo controllo della pubblicazione.

Per saperne di più sulle impostazioni di controllo dei filtri, consulta il Riferimento API Controls.FilterAction.

Controlli reindirizzamento

Puoi utilizzare un controllo di reindirizzamento per reindirizzare gli acquirenti a pagine diverse in base alle loro intenzioni, anziché mostrare loro solo i risultati di ricerca.

Puoi impostare i termini di query e gli intervalli di tempo applicabili come condizioni di controllo. Come azione di controllo, specifica un URI di reindirizzamento a cui reindirizzare se le condizioni corrispondono.

Ad esempio, potresti creare un controllo di reindirizzamento in modo che durante una promozione per il prodotto gScarpa, le query con scarpe da corsa o scarpe sportive reindirizzino alla pagina di prodotto gScarpa. Un altro caso in cui utilizzare i controlli di reindirizzamento è quello di reindirizzare gli acquirenti a una pagina specifica se cercano un termine non pertinente al tuo sito, ad esempio una ricerca di Domande frequenti che reindirizza l'utente alla pagina effettiva delle domande frequenti sul tuo sito anziché mostrare i risultati di ricerca.

Per creare un controllo del reindirizzamento, consulta Creare un nuovo controllo della pubblicazione.

Per saperne di più sulle impostazioni di controllo dei reindirizzamenti, consulta la guida di riferimento dell'API Controls.RedirectAction.

Controlli di blocco

I controlli di blocco ti consentono di specificare una posizione esatta nei risultati in cui vuoi che venga visualizzato un determinato prodotto.

Puoi creare un controllo di blocco per la ricerca o la navigazione. Non è supportato per i consigli.

Quando crei un controllo di blocco, puoi utilizzare le espressioni di filtro per specificare le condizioni in base ai campi Product.

Come azione di controllo, aggiungi un Rule alla tua ricerca o alla tua navigazione Condition, che sarà il campo di azione pin_action.

Puoi quindi applicare un valore pin compreso tra [1,120] per indicare la posizione fissa a cui bloccare i risultati che corrispondono alle condizioni specificate.

  • Condizione della regola: è necessario specificare [Condition.query_terms][] (solo per la ricerca) o [Condition.page_categories][] (solo per la navigazione), ma non entrambi.
  • Input azione: vengono mappate le coppie [pin_position, product_id] (la posizione di input può essere un valore compreso tra 1 e 120). La dimensione massima è la dimensione massima della pagina della richiesta. 10 è il numero di coppie consentite nella mappa dei segnaposto.
  • Risultato azione: blocca i prodotti con ID corrispondenti nella posizione specificata nell'ordine del risultato finale. Per fare un esempio, supponiamo che la query sia scarpe, che [Condition.query_terms][] sia "shoes" e che pin_map abbia {1, pid1}. Il prodotto con pid1 è bloccato nella prima posizione dei risultati finali.

Attivazione dei pin e delle regole applicate

Quando un controllo di blocco è attivato:

  • I prodotti con ID prodotto che corrispondono a un segnaposto vengono visualizzati nella risposta finale nella posizione esatta specificata dal controllo.
  • I pin alla seconda pagina o alle pagine successive (numero di pagina più alto) non sono consentiti, ovvero qualsiasi pin impostato su una posizione superiore alla richiesta page_size viene ignorato.
  • È possibile bloccare un massimo di 10 prodotti con un controllo.
  • product_id deve essere l'ID di un prodotto esistente nel catalogo.

Il prodotto viene sempre richiamato in ogni ricerca e viene visualizzato nella pagina, a meno che:

  • Sono stati applicati filtri e ordinamento. Questi impediscono la visualizzazione dei pin.
  • L'ordine di ordinamento (ad esempio, i risultati di ricerca ordinati per prezzo) non è quello predefinito.

Comportamento dei pin

  • Se un prodotto è bloccato, ignorerà eventuali incrementi o seppellimenti della richiesta o di altri controlli.
  • Se un prodotto è bloccato in più posizioni, ha la precedenza il controllo aggiornato più di recente.
  • Due prodotti non possono essere bloccati nella stessa posizione all'interno dello stesso controllo di blocco (mappa dei segnaposto).
    • Se più controlli corrispondono alla stessa query e ognuno di questi ha un pin diverso per lo stesso ID prodotto, la coppia [pin_pos, p_id] del controllo aggiornato più di recente ha la precedenza.

Controlli linguistici

Puoi creare aggiunte o override al modo in cui le parole vengono trattate per determinate query.

Controlli sinonimi

L'impostazione di due parole come sinonimi è un controllo linguistico che associa due parole.

I controlli dei sinonimi aggiungono ulteriore contesto a una query di ricerca. Non forzano l'inclusione di un risultato nei risultati di ricerca, ma possono aiutare il sistema a includere prodotti aggiuntivi nei risultati di ricerca, aumentando la probabilità che un determinato risultato venga incluso. In altre parole, i controlli dei sinonimi possono incoraggiare il risultato di ricerca a prendere in considerazione più opzioni, ma in definitiva il risultato di ricerca dipenderà dal punteggio.

Ad esempio, se vuoi che i risultati di ricerca per scarpe da corsa includano anche scarpe sportive, crea un controllo dei sinonimi linguistici. La condizione è che scarpe da corsa venga inserito come termine di ricerca. L'azione consiste nell'includere il sinonimo scarpe sportive nella ricerca. Pertanto, quando un acquirente sul tuo sito cerca scarpe da corsa, la ricerca trova corrispondenze nel controllo linguistico che hai creato, espandendolo per includere scarpe sportive quando restituisce i risultati di ricerca all'acquirente.

Per creare un controllo dei sinonimi, consulta Crea un nuovo controllo di pubblicazione.

Controlli sinonimi bidirezionali

Utilizza i controlli dei sinonimi bidirezionali per collegare più termini in modo che la ricerca li tratti allo stesso modo durante le ricerche.

Puoi impostare i termini di query e gli intervalli di tempo applicabili come condizioni di controllo. Non è necessario impostare un'azione di controllo separata. Se un termine specificato viene utilizzato come query, l'azione di controllo consiste nell'utilizzare altri termini specificati come sinonimi.

Ad esempio, puoi impostare un controllo sinonimi bidirezionale che associa i termini strofinaccio e canovaccio come sinonimi. Quando un acquirente sul tuo sito inserisce canovaccio come query, la ricerca può espandere la query per includere risultati per strofinaccio e canovaccio.

Per creare un controllo dei sinonimi, consulta Crea un nuovo controllo di pubblicazione.

I sinonimi non modificano la query originale. Ad esempio, se le query A e B sono un sinonimo bidirezionale, prevedi il seguente effetto:

  • Risultati della query A restituiti: set A (senza regole di sinonimia applicate) e alcuni elementi del set B. Tuttavia, i risultati potrebbero essere inferiori alla combinazione di A e B.

  • Risultati della query B restituiti: il set B e alcuni risultati del set A, ma probabilmente meno della somma dei set di risultati A e B.

Per saperne di più sulle impostazioni di controllo dei sinonimi bidirezionali, consulta il riferimento API Controls.TwowaySynonymsAction.

Controlli sinonimi unidirezionali

I controlli sinonimi unidirezionali espandono i termini di query per collegare i termini in modo unidirezionale.

Puoi impostare i termini di query e gli intervalli di tempo applicabili come condizioni di controllo. Come azione di controllo, specifica i termini da utilizzare come sinonimi unidirezionali.

Ad esempio, potresti impostare un controllo dei sinonimi unidirezionale che espande le ricerche del termine rosa in modo da includere il termine rosa. Poiché si tratta di un sinonimo unidirezionale, le ricerche del termine rosa non vengono ampliate per includere il termine pink.

Per creare un controllo dei sinonimi unidirezionale, consulta Crea un nuovo controllo di pubblicazione.

Tieni presente che, proprio come per i sinonimi bidirezionali, viene eseguita la query originale e i sinonimi vengono forniti come suggerimenti per la query. I sinonimi di parole completamente diverse potrebbero comportare l'inclusione nei risultati solo di un numero ridotto di termini sinonimi. L'esempio precedente restituisce articoli rosa con particolare attenzione alle rose rosa, ma una regola di sinonimia che espande le ricerche del termine cane per includere gatto restituisce principalmente articoli con cani, oltre ad alcuni con gatti.

Per saperne di più sulle impostazioni di controllo dei sinonimi unidirezionali, consulta il riferimento API Controls.OnewaySynonymsAction.

I sinonimi non forniscono risultati identici

I risultati di ricerca per due sinonimi non sono sempre identici.

Ad esempio, se imposti borse per laptop e valigie come sinonimi bidirezionali, il sistema potrebbe già associare valigia a valigie. Pertanto, quando un utente cerca bagagli, Vertex AI Search for Commerce restituisce risultati relativi a bagagli, valigie e borse per laptop. Tuttavia, quando cerchi borse per laptop, Vertex AI Search per il commercio aggiunge solo valigie ai sinonimi. Pertanto, i risultati potrebbero non contenere valigia.

Ignora controlli

I controlli di ignoranza impediscono alla ricerca di utilizzare determinati termini di query durante le ricerche. Contrassegnano i termini ignorati in una query come non importanti, ma non li escludono completamente dalla query.

Per rimuovere completamente un termine di ricerca da una query, utilizza un controllo di sostituzione. Mentre un controllo del filtro influisce sui risultati visualizzati, un controllo di sostituzione è un modo più efficace per impedire a Vertex AI Search for commerce di restituire risultati per un termine specifico.

Un controllo di ignoranza non garantisce che i risultati per il termine ignorato non vengano restituiti nei risultati di Vertex AI Search per il commercio. Ad esempio, un controllo di ignoranza per la parola olio potrebbe comunque restituire pitture a olio per una query di pitture a olio. La query verrà trasmessa come paints e potrebbero essere trovate molte pitture a olio, ma il set di risultati sarà più grande perché la ricerca è per paints. Questo tipo di controllo potrebbe essere utile se pitture a olio è una query popolare sul tuo sito e vendi molti tipi diversi di pitture, ma non molte pitture a base di olio.

Puoi impostare i termini di query e gli intervalli di tempo applicabili come condizioni di controllo. Non devi impostare un'azione di controllo separata. Se un termine specificato viene utilizzato come query, l'azione di controllo consiste nell'ignorare il termine.

Ad esempio, potresti creare un controllo che ignori i termini di ricerca che utilizzano un linguaggio offensivo.

Per creare un controllo di ignoranza, vedi Creare un nuovo controllo di pubblicazione.

Per saperne di più sulle impostazioni di controllo dell'ignoranza, consulta la guida di riferimento dell'API Controls.IgnoreAction.

Controlli di non associazione

I controlli di non associazione impediscono l'associazione di determinati termini di ricerca ad altri specificati. Ciò non influirà necessariamente sui risultati di ricerca, ma potrebbe farlo.

Utilizza un termine di query specifico e intervalli di tempo applicabili per le condizioni di controllo. Come azione di controllo, specifica i termini che non devono essere associati ai termini di ricerca.

Esempio: crei un controllo che impedisce a un nome brand (ad esempio gScarpe) di raggrupparsi con economico e scarsa qualità in una query. Un acquirente cerca scarpe gShoe economiche di scarsa qualità. La ricerca rimuove i termini di query economici e di scarsa qualità dalla query iniziale, con il termine di query risultante gScarpe. Tuttavia, ciò non garantisce che venga rimosso completamente dai risultati di ricerca.

Se un termine di query pertinente contiene anche un termine specificato come da non associare, il risultato pertinente potrebbe comunque essere restituito. Per evitare completamente questo problema, utilizza un controllo filtro.

Per creare un controllo di non associazione, consulta Crea un nuovo controllo di pubblicazione.

Per saperne di più sulle impostazioni di controllo non associare, consulta la guida di riferimento dell'API Controls.DoNotAssociateAction.

Controlli di sostituzione

I controlli di sostituzione sostituiscono uno o più termini di query specificati con un termine diverso che specifichi. Puoi specificare più termini che possono essere mappati a un singolo termine (ma non viceversa).

Puoi impostare i termini di query e gli intervalli di tempo applicabili come condizioni di controllo. Come azione di controllo, specifica il termine da utilizzare come sostituzione.

Ad esempio, puoi creare un controllo che sostituisca i soprannomi di un brand con il nome completo del brand più comunemente utilizzato nelle descrizioni dei prodotti.

Per creare un controllo sostitutivo nella console Search for commerce, consulta Crea un nuovo controllo di pubblicazione.

Per saperne di più sulle impostazioni di controllo della sostituzione, consulta la guida di riferimento dell'API Controls.ReplacementAction.