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 il controllo di pubblicazione esegue un'azione. L'azione specifica il comportamento che il controllo della pubblicazione mette in atto.

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.

Best practice per l'integrazione e la configurazione

Questa sezione descrive le best practice per l'integrazione e la configurazione utilizzando i controlli di pubblicazione.

Inizia senza controlli

Inizia a utilizzare Vertex AI Search for Commerce con controlli di pubblicazione minimi o nulli. I controlli di pubblicazione come il boost e l'interramento interferiscono con l'ottimizzazione del ranking originariamente eseguita per migliorare le entrate e la pertinenza del risultato di ricerca.

I controlli della pubblicazione devono essere aggiunti se esiste una necessità aziendale molto forte di farlo. Ad esempio, ABC.com è un marketplace di moda online. Ha marchi interni pqr e xyz, oltre ad altri brand. Ora, ABC.com potrebbe scegliere di promuovere i brand interni pqr e xyz, portandoli in cima ai risultati di ricerca per alcune query di ricerca specifiche, ad esempio top da donna. Il caso d'uso aziendale potrebbe essere che ABC.com ha margini migliori con i prodotti dei brand pqr e xyz, il che fornisce la giustificazione per interferire con il ranking predefinito, ovvero per non utilizzare un boost.

Un altro motivo per iniziare con controlli minimi è che il modello di AI di backend apprende e si adatta continuamente in base ai comportamenti e alle tendenze di acquisto degli utenti (il backend viene addestrato su un periodo di eventi compreso tra 30 e 90 giorni). Un buon numero di casi d'uso relativi ai sinonimi sarebbe già gestito.

In sintesi, la decisione di aggiungere controlli della pubblicazione deve essere supportata da un indicatore di entrate o da un caso d'uso aziendale solido.

Configurazione degli attributi

Consulta i prerequisiti per la configurazione degli attributi qui. Lo scopo degli attributi è estendere la struttura delle informazioni sul prodotto e aggiungere attributi del prodotto definiti dall'utente. Gli attributi non devono essere utilizzati come archivio di informazioni. Inoltre, imposta i flag vero/falso per gli attributi che lo rendono ricercabile e indicizzabile. Imposta almeno uno dei flag di configurazione su true per gli attributi.

Configurazione dell'attributo di corrispondenza esatta

Il flag di configurazione della corrispondenza esatta viene utilizzato per attributi come model_name o part_number, che tendono a essere caratteri alfanumerici univoci. Ad esempio, il numero di modello di una lavatrice potrebbe essere "WA2300AH3000". In questo caso, imposta l'attributo come model_name e la configurazione per la corrispondenza esatta su true in modo che, quando la query di ricerca corrisponde alla stringa dell'attributo model_name, venga restituito solo questo prodotto nel risultato di ricerca.

Ti consigliamo di non utilizzare parole o brand di uso comune negli attributi e di impostare la corrispondenza esatta su true. Ciò limita notevolmente il risultato di ricerca quando queste parole di uso comune sono nella query di ricerca, con conseguente basso richiamo del prodotto per le query di ricerca di uso comune, oltre a influire negativamente sulle metriche CTR / CVR.

Vertex AI Search for commerce è solo un servizio di ranking

La proposta di valore del servizio Vertex AI Search for commerce è che viene utilizzato per scoprire i prodotti del tuo catalogo in base alla pertinenza della query e classificarli in modo ottimizzato per le entrate (insieme a funzionalità ausiliarie come Boost/Bury/Filter e così via).

In sostanza, il servizio Vertex AI Search for commerce restituisce un elenco classificato di prodotti ottimizzati per le entrate e la pertinenza da mostrare all'utente finale. Vertex AI Search for commerce non sostituisce il database del catalogo.

Se necessario, le API GET e LIST del prodotto possono essere utilizzate per ottenere le informazioni complete sul prodotto nell'ambito del livello di arricchimento.

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 un controllo della pubblicazione esegue un'azione.

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

I campi delle condizioni disponibili:

  • Termini della query: attivato 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 finché la data della query è compresa nell'intervallo di tempo (incluso).

I campi della condizione che specifichi determinano se il controllo viene 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 vengono attivati se uno qualsiasi di essi corrisponde. Se hai più intervalli di tempo, qualsiasi intervallo di tempo che corrisponde attiva 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 guida di riferimento dell'API Controls.condition.

Azioni di controllo

Un'azione di controllo specifica il comportamento che il controllo della pubblicazione mette in atto 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 per aumentare/diminuire il ranking 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 visualizzati.

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 della ricerca e dei 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/occultamento.

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 all'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 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 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 dei risultati finali. 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.

La regola di blocco accetta qualsiasi ID prodotto (principale, variante o raccolta), ma l'effetto di blocco viene disattivato per qualsiasi articolo con un ID prodotto non principale.

Ciò significa che, se vuoi che una variante esatta o una raccolta sia visibilmente bloccata nella parte superiore dell'interfaccia utente:

  1. Crea la regola di blocco in base all'ID prodotto principale dell'articolo.

  2. Dopodiché, devi eseguire una delle seguenti operazioni:

    • Aggiungi un'altra regola di incremento e incrementa gli ID variante (utilizzando una condizione di incremento, ad esempio id:ANY(123, 234)).
    • Aggiungi un'altra regola di filtro per escludere i varianti dei prodotti esatte che ti interessano.

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 segnaposto.
  • L'ordinamento (ad esempio, i risultati di ricerca ordinati per prezzo) non è quello predefinito.

Comportamento di blocco

  • Se un prodotto è bloccato, ignora 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, ha la precedenza la coppia [pin_pos, p_id] del controllo aggiornato più di recente.

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 dipende 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 della pubblicazione.

Controlli sinonimi bidirezionali

Utilizza i controlli bidirezionali dei sinonimi 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 i risultati per strofinaccio e canovaccio.

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

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

  • Risultati della query A restituiti: set A (senza regole per i sinonimi 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 della pubblicazione.

Tieni presente che, 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 for commerce 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 viene trasmessa come pitture e potrebbero esserci molte pitture a olio corrispondenti, ma il set di risultati è più grande perché la ricerca è per pitture. Questo tipo di controllo potrebbe essere utile se le pitture a olio sono 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 di ignoranza, consulta la guida di riferimento all'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 è possibile.

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 "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 Creare un nuovo controllo di pubblicazione.

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