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 della pubblicazione è una regola costituita da una coppia di condizione-azione, in cui la condizione indica quando verrà eseguito il controllo della pubblicazione e l'azione specifica il comportamento che verrà applicato.

Puoi creare un controllo della pubblicazione utilizzando il metodo dell'API Control.create.

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

Controlli di pubblicazione disponibili

Sono disponibili i seguenti controlli di pubblicazione:

  • Metti in evidenza/Nascondi: influisce sul ranking e sull'ordine dei risultati nell'elenco dei risultati restituiti. Disponibile per la ricerca e per i consigli.
  • Filtra: rimuove dall'elenco dei risultati restituiti i risultati che non superano il filtro. Disponibile solo per la ricerca.
  • Reindirizza: reindirizza gli utenti a una pagina specifica in base alla query di ricerca. Disponibile solo per la ricerca.
  • Fissaggio: 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:
    • Sinonimi: espande i sinonimi considerati per una query di ricerca.
    • Sinonimi unidirezionali: espande i sinonimi considerati in modo unidirezionale per termini specifici.
    • Ignora: impedisce l'utilizzo di un termine nelle ricerche.
    • Non associa: impedisce l'utilizzo di termini nelle ricerche quando vengono visualizzati termini specifici.
    • Sostituisci: 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 condizione disponibili:

  • Termini di query: attivata quando il termine viene visualizzato nella query di ricerca.
    • Una corrispondenza completa richiede che l'intera query di ricerca corrisponda al termine di query.
    • È possibile specificare più termini di query. Si attiva se uno dei termini della query compare 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. Si attiva se la data della query rientra nell'intervallo di tempo (incluso).

I campi delle condizioni specificati determinano se il controllo verrà applicato.

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

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

Azioni di controllo

Un'azione di controllo specifica il comportamento che verrà applicato dal controllo di pubblicazione 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 evidenza/seppellimento consiste nell'applicare un valore di evidenza/seppellimento ai prodotti del filtro specificato, mentre l'azione per un controllo di sinonimi unidirezionali consiste nell'applicare un termine associato specificato.

Controlli boost/bury

I controlli di miglioramento/seppellimento ti consentono di mostrare determinati risultati di ricerca con un ranking più alto o più basso.

Puoi creare un controllo di boost/seppellimento per la ricerca o per i consigli. La funzionalità di messa in evidenza/seppellimento per i consigli è in Anteprima pubblica.

Quando crei un controllo di messa in evidenza/nascondimento, 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 quanto incrementare o nascondere i risultati dei prodotti corrispondenti a queste condizioni. Un valore positivo migliora i risultati, mentre un valore negativo li nasconde.

L'impostazione di un'intensità di boosting elevata offre all'articolo una promozione importante, 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 avere la precedenza rispetto agli articoli nettamente preferiti, ma non pertinenti. Analogamente, se imposti l'intensità del boost su -1,0, l'articolo verrà retrocesso notevolmente, ma potrebbero essere comunque mostrati risultati molto pertinenti.

Ad esempio, puoi dare la priorità ai prodotti più economici e rimuovere quella ai prodotti costosi.

Le condizioni di controllo sono diverse tra i controlli di 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 viene sempre applicato.

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

Per creare un controllo di aumento/seppellimento, consulta Creare 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 filtro, puoi aggiungere dinamicamente filtri predefiniti in base a una richiesta di ricerca specifica.

Puoi utilizzare espressioni di filtro basate su campi Product. Per la sintassi delle espressioni di filtro, consulta Filtrare e ordinare i risultati.

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 filtro, consulta Creare un nuovo controllo di pubblicazione.

Per saperne di più sulle impostazioni di controllo filtro, consulta la guida di riferimento dell'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 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 vengono soddisfatte.

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

Per creare un controllo di reindirizzamento, consulta Creare un nuovo controllo di 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 fissaggio 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 ricerca o alla visualizzazione Condition che sarà il campo dell'azione pin_action.

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

  • Condizione regola: deve essere specificato [Condition.query_terms][] (solo per la ricerca) o [Condition.page_categories][] (solo per la visualizzazione) non vuoto, ma non entrambi.
  • Input azione: vengono mappate 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 pin.
  • Risultato dell'azione: blocca i prodotti con ID corrispondenti nella posizione specificata nell'ordine dei risultati finali. Ad esempio, supponiamo che la query sia scarpe, [Condition.query_terms][] sia "shoes" e pin_map abbia {1, pid1}. Il prodotto con pid1 è bloccato nella posizione più alta nei risultati finali.

Attivazione dei perni e delle regole applicate

Quando è attivato un controllo di blocco:

  • I prodotti con ID prodotto corrispondenti a un segnaposto vengono visualizzati nella risposta finale nella posizione esatta specificata dal controllo.
  • I pin alla seconda pagina o successive (numero di pagina superiore) 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 unico controllo.
  • product_id deve essere l'ID di un prodotto esistente nel catalogo.

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

  • I filtri e l'ordinamento vengono applicati. In questo modo, i segnalini non vengono visualizzati.
  • L'ordinamento (ad esempio, i risultati di ricerca ordinati per prezzo) non è predefinito.

Comportamento dei segnaposto

  • Se un prodotto è bloccato, vengono ignorati eventuali incrementi o occultamenti della richiesta o di altri controlli.
  • Se un prodotto è bloccato in più posizioni, ha la precedenza il controllo aggiornato più di recente.
  • Non è possibile fissare due prodotti nella stessa posizione all'interno dello stesso controllo di fissaggio (mappa dei segnaposto).
    • Se più controlli corrispondono alla stessa query e ognuno ha un pin diverso per lo stesso ID prodotto, ha la precedenza la coppia [pin_pos, p_id] del controllo aggiornato più di recente.

Controlli linguistici

Puoi creare aggiunte o sostituzioni per il 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 contesto aggiuntivo a una query di ricerca. Non forzano l'inclusione di un risultato nei risultati di ricerca, ma possono aiutare il sistema a includere altri prodotti 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 alla fine 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 sia 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 questa corrispondenza nel controllo linguistico che hai creato, espandendola per includere scarpe sportive quando restituisce i risultati di ricerca all'acquirente.

Per creare un controllo dei sinonimi, consulta Creare un nuovo controllo della 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 associ i termini rivestito e tovagliolo da cucina come sinonimi. Quando un acquirente sul tuo sito inserisce panno da cucina come query, la ricerca può espandere la query per includere risultati per panno da stoviglie e panno da cucina.

Per creare un controllo dei sinonimi, consulta Creare un nuovo controllo della pubblicazione.

I sinonimi non modificano la query originale. Ad esempio, se le query A e B sono sinonimi bidirezionali, si prevede il seguente effetto:

  • Risultati della query A restituiti: set A (senza regole di sinonimi applicati) e parte del set B. Tuttavia, i risultati potrebbero essere inferiori alla combinazione di A e B.

  • Risultati della query B restituiti: insieme B e parte di A, ma possibilmente meno della somma degli insiemi di risultati A e B.

Per saperne di più sulle impostazioni di controllo dei sinonimi bidirezionali, consulta la Guida di riferimento dell'API Controls.TwowaySynonymsAction.

Controlli sinonimi unidirezionali

I controlli sinonimi unidirezionali espandono i termini di query per collegarli 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, puoi impostare un controllo dei sinonimi unidirezionale che espanda le ricerche per il termine rosa in modo da includere il termine rosa. Poiché si tratta di un sinonimo unidirezionale, le ricerche per il termine rosa non vengono espanse per includere il termine rosa.

Per creare un controllo dei sinonimi unidirezionale, consulta Creare un nuovo controllo della pubblicazione.

Tieni presente che, come per i sinonimi bidirezionali, viene eseguita la query originale e i sinonimi vengono forniti come suggerimenti per quella query. I sinonimi di parole completamente diverse possono comportare l'inclusione di solo un numero limitato di termini sinonimi nei risultati. L'esempio precedente restituisce elementi rosa con un'enfasi sulle rose rosa, ma una regola di sinonimi che espande le ricerche per il termine cane in modo da includere gatto restituisce principalmente elementi con cani, oltre ad alcuni con gatti.

Per saperne di più sulle impostazioni di controllo dei sinonimi unidirezionali, consulta la documentazione di riferimento dell'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 bagagli come sinonimi bidirezionali, il sistema potrebbe già associare valigia a bagagli. Pertanto, quando un utente cerca bagagli, Vertex AI Search for Commerce restituisce risultati relativi a bagagli, valigia e borse per laptop. Tuttavia, quando cerchi borse per laptop, Vertex AI Search for Commerce aggiunge ai sinonimi solo bagagli. Pertanto, i risultati potrebbero non contenere valigia.

Ignora controlli

I controlli di ignoramento 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. Sebbene un controllo filtro influisca 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 ignoramento 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 ignora per la parola olio potrebbe comunque restituire colori ad olio per una query su colori ad olio. La query verrà passata come pitture e potrebbero esserci molte corrispondenze per le pitture ad olio, ma il set di risultati sarà più grande perché la ricerca è per pitture. Questo tipo di controllo potrebbe essere utile se le vernici a olio sono una query molto utilizzata sul tuo sito e vendi molti tipi diversi di vernici, ma non molte vernici a olio.

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 è ignorare il termine.

Ad esempio, puoi creare un controllo che ignori i termini di query che utilizzano un linguaggio offensivo.

Per creare un controllo di ignoramento, consulta 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 che i termini di query vengano sottoposti a query insieme durante le ricerche con altri termini specificati.

Puoi impostare i termini di query e gli intervalli di tempo applicabili come condizioni di controllo. Come azione di controllo, specifica i termini che non devono essere associati ai termini di query.

Ad esempio, puoi creare un controllo che impedisca il raggruppamento di un nome di marca (ad es. gShoe) con i termini economico e di scarsa qualità in una query, in modo che se un acquirente cerca gShoe economica di scarsa qualità, la ricerca cerchi solo gShoe.

Se un risultato pertinente per il termine di query contiene anche un termine specificato come non associare, il risultato pertinente potrebbe comunque essere restituito. Per evitare che ciò accada, utilizza un controllo filtro.

Per creare un controllo di mancata associazione, consulta Creare un nuovo controllo di pubblicazione.

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

Controlli sostitutivi

I controlli di sostituzione sostituiscono uno o più termini di query specificati con un termine diverso da te specificato. 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 sostituto.

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

Per creare un controllo sostitutivo nella console Ricerca per il commercio, consulta Creare un nuovo controllo di pubblicazione.

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