Sobre os controles de veiculação

É possível aplicar controles de exibição a configurações de exibição para personalizar como a pesquisa trata consultas e retorna resultados. Um controle de exibição é uma regra que consiste em um par de condição e ação. A condição determina quando o controle de exibição será executado, e a ação especifica o comportamento que ele vai adotar.

É possível criar um controle de exibição usando o método Control.create da API.

Se você não quiser usar a API, escolha console para criar controles de exibição na Vertex AI Search para e-commerce.

Controles de veiculação disponíveis

Os seguintes controles de exibição estão disponíveis:

  • Boost/bury: afeta a classificação e a ordem do resultado na lista de resultados retornada. Disponível para pesquisa e recomendações.
  • Filtro: remove os resultados que não passam no filtro da lista de resultados retornados. Disponível apenas para pesquisa.
  • Redirecionamento: redireciona os usuários para uma página específica, dependendo da consulta de pesquisa. Disponível apenas para pesquisa.
  • Fixação: a posição exata nos resultados é especificada para um determinado produto.
  • Linguística: personaliza a linguística da consulta de pesquisa. Disponível apenas para pesquisa. Vários tipos de controle linguístico estão disponíveis:
    • Sinônimo: expande os sinônimos considerados para uma consulta de pesquisa.
    • Sinônimo unidirecional: expande os sinônimos considerados unidirecionalmente para termos específicos.
    • Ignorar: impede que um termo seja usado em pesquisas.
    • Não associar: impede que termos sejam usados em pesquisas que aparecem em termos específicos.
    • Substituição: substitui termos na consulta de pesquisa.

Condições de controle

As condições de controle determinam quando um controle de veiculação será executado.

Os campos de condição de controle podem ser termos de consulta, períodos ou ambos. Alguns tipos de controle permitem vários campos de condição ou não permitem nenhum.

Os campos de condição disponíveis:

  • Termos de consulta: acionado quando o termo aparece na consulta de pesquisa.
    • Uma correspondência total requer que toda a consulta de pesquisa corresponda ao termo.
    • Vários termos de consulta podem ser especificados. É acionada enquanto um dos termos da consulta aparece na consulta de pesquisa.
  • Intervalo de tempo ativo: acionado quando a data da consulta de pesquisa está no intervalo de tempo.
    • Vários períodos podem ser especificados. Gatilhos, desde que a data da consulta esteja dentro do intervalo de tempo (inclusivo).

Os campos de condição especificados determinam se o controle será aplicado.

  • Vários campos de condição são combinados usando AND. Isso significa que, se você especificar o período e os termos da consulta, ambos os campos de condição precisarão ser acionados para que o controle seja aplicado.
  • Vários subcampos de condição são combinados usando OR. Isso significa que, se você tiver vários termos de consulta, eles serão acionados caso algum deles corresponda. Se você tiver vários períodos, qualquer um deles que corresponder vai acionar o controle.
  • Nenhum campo de condição especificado significa que o controle sempre será aplicado. No entanto, alguns controles exigem a definição de um campo.

Para mais informações sobre as configurações de condição, consulte a referência da API Controls.condition.

Ações de controle

Uma ação de controle especifica o comportamento que o controle de disponibilização vai adotar se as condições forem atendidas durante uma pesquisa.

O tipo de ação que você pode especificar depende do tipo de controle de veiculação que você criar. Por exemplo, a ação para um controle boost/bury é aplicar um valor boost/bury aos produtos que o filtro especificar, enquanto a ação para um controle sinônimo unidirecional é aplicar um termo associado que você especificar.

Controles de otimização/ocultação

Os controles de otimização ou "aumento" permitem exibir determinados resultados de pesquisa como maiores ou menores de classificação.

É possível criar um controle de aumentar/ocultar para pesquisa ou recomendações. O recurso de aumentar/ocultar para recomendações está em pré-lançamento público.

Ao criar um controle de otimização/envio, é possível usar expressões de filtro para especificar as condições com base nos campos Product.

Em seguida, é possível aplicar um valor de boost entre -1,0 e 1,0 para indicar o quanto de otimização ou exibição de resultados de produtos correspondentes a essas condições. Um valor positivo aumenta os resultados, e um valor negativo os esconde.

Definir uma força máxima de reforço dará ao item uma grande promoção, mas não necessariamente significa que ele será o resultado sempre. Os resultados mais relevantes para a consulta de pesquisa ainda podem superar os itens altamente favorecidos, mas irrelevantes. Da mesma forma, definir a força de reforço como -1,0 daria ao item um grande rebaixamento, mas os resultados altamente relevantes ainda poderão ser exibidos.

Como exemplo de uso de boost/bury, você pode priorizar produtos mais baratos e remover prioridades dos caros.

As condições de controle são diferentes entre os controles de otimização/ocultação de pesquisa e recomendações:

  • Pesquisa: você pode definir os termos da consulta e os períodos aplicáveis como condições de controle.
  • Recomendações: as condições de controle não estão disponíveis. O controle sempre é aplicado.

Como uma ação de controle, especifique um filtro para produtos que serão aprimorados ou definidos e defina o valor de boost/bury.

Para criar um controle de otimização/inserção, consulte Criar um novo controle de exibição.

Para mais informações sobre as configurações de controle de aumento/início, consulte a referência da API Controls.BoostAction.

Controles de filtros

Com os controles de filtro, você pode adicionar dinamicamente filtros predefinidos com base em uma solicitação de pesquisa específica.

É possível usar expressões de filtro baseadas em campos Product. Consulte Filtrar e ordenar resultados para ver a sintaxe da expressão de filtro.

Você pode definir os termos da consulta e os períodos aplicáveis como condições de controle. Como uma ação de controle, especifique um filtro para aplicar no momento da consulta.

Por exemplo, com a consulta sapatos azuis, você pode usar um controle de filtro para filtrar automaticamente os resultados da pesquisa na cor azul. Também é possível usar controles de filtro para impedir que determinados resultados sejam retornados aos compradores.

Para criar um controle de filtro, consulte Criar um novo controle de exibição.

Para mais informações sobre as configurações de controle de filtro, consulte a referência da API Controls.FilterAction.

Controles de redirecionamento

É possível usar um controle de redirecionamento para redirecionar seus compradores a páginas diferentes com base na intenção deles, em vez de exibir apenas os resultados da pesquisa.

Você pode definir os termos da consulta e os períodos aplicáveis como condições de controle. Como uma ação de controle, especifique um URI de redirecionamento para redirecionar se as condições forem correspondidas.

Por exemplo, é possível criar um controle de redirecionamento para que, durante uma promoção de um produto gShoe, as consultas com tênis de corrida ou esportivos sejam redirecionadas para a página do produto gShoe. Outro caso de uso dos controles de redirecionamento é redirecionar os compradores para uma página específica se eles pesquisarem um termo que não é relevante para seu site, como uma pesquisa por Perguntas frequentes, que redireciona o usuário para a página de perguntas frequentes do site em vez de mostrar resultados da pesquisa.

Para criar um controle de redirecionamento, consulte Criar um novo controle de exibição.

Para mais informações sobre as configurações de controle de redirecionamento, consulte a referência da API Controls.RedirectAction.

Controles de fixação

Com os controles de fixação, você pode especificar uma posição exata nos resultados em que quer que um determinado produto apareça.

Você pode criar um controle de fixação para pesquisa ou navegação. Não há suporte para recomendações.

Ao criar um controle de fixação, é possível usar expressões de filtro para especificar as condições com base nos campos Product.

Como uma ação de controle, adicione um Rule à sua pesquisa ou navegue Condition, que será o campo de ação pin_action..

Em seguida, é possível aplicar um valor de pin entre [1,120] para indicar a posição fixa em que os resultados correspondentes a essas condições serão fixados.

  • Condição da regra: é necessário especificar [Condition.query_terms][] (somente para pesquisa) ou [Condition.page_categories][] (somente para navegação) não vazios, mas não ambos.
  • Entrada de ação: os pares [pin_position, product_id] são mapeados (a posição de entrada pode ser um valor de 1 a 120). O tamanho máximo é o tamanho máximo da página de solicitação. 10 é o número de pares permitidos no mapa de fixação.
  • Resultado da ação: fixa os produtos com IDs correspondentes na posição especificada na ordem do resultado final. Por exemplo, suponha que a consulta seja sapatos, o [Condition.query_terms][] seja "shoes" e o pin_map tenha {1, pid1}. O produto com pid1 é fixado na posição superior dos resultados finais.

Ativar fixações e regras aplicadas

Quando um controle de fixação está ativado:

  • Os produtos com IDs que correspondem a um pin aparecem na resposta final na posição exata especificada pelo controle.
  • Não é permitido fixar na segunda página ou em uma página posterior (número de página maior). Ou seja, qualquer fixação definida para uma posição maior que a solicitação page_size é ignorada.
  • É possível fixar até 10 produtos com um controle.
  • O product_id precisa ser o ID de um produto existente no catálogo.

O produto é sempre recuperado em todas as pesquisas e aparece na página, a menos que:

  • Os filtros e a classificação são aplicados. Isso impede que os pins apareçam.
  • A ordem de classificação (como classificar os resultados da pesquisa por preço) não é a padrão.

Comportamento de fixação

  • Se um produto estiver fixado, ele vai ignorar todos os aumentos ou ocultações da solicitação ou de outros controles.
  • Se um produto for fixado em várias posições, o controle atualizado mais recentemente terá precedência.
  • Dois produtos não podem ser fixados na mesma posição dentro do mesmo controle de fixação (mapa de fixação).
    • Se vários controles corresponderem à mesma consulta e cada um deles tiver um fixador diferente para o mesmo ID de produto, o par [pin_pos, p_id] do controle atualizado mais recentemente terá precedência.

Controles linguísticos

É possível criar adições ou substituições para o modo como as palavras são tratadas em determinadas consultas.

Controles de sinônimos

Definir duas palavras como sinônimos é um controle linguístico que associa duas palavras.

Os controles de sinônimos adicionam mais contexto a uma consulta de pesquisa. Elas não forçam a inclusão de um resultado nos resultados da pesquisa, mas podem ajudar o sistema a incluir mais produtos, aumentando a probabilidade de um resultado específico ser incluído. Em outras palavras, os controles de sinônimos podem incentivar o resultado da pesquisa a considerar mais opções, mas, em última análise, o resultado da pesquisa vai depender da pontuação.

Por exemplo, se você quiser que os resultados da pesquisa por tênis de corrida também incluam tênis esportivos, crie um controle de sinônimos linguísticos. A condição é que tênis de corrida seja inserido como termo de pesquisa. A ação é incluir o sinônimo tênis esportivos com essa pesquisa. Assim, quando um comprador no seu site pesquisa tênis de corrida, a pesquisa encontra essa correspondência no controle linguístico que você criou, expandindo-a para incluir tênis esportivos quando retorna os resultados da pesquisa para o comprador.

Para criar um controle de sinônimos, consulte Criar um novo controle de exibição.

Controles de sinônimos bidirecionais

Use controles de sinônimos bidirecionais para vincular vários termos de modo que a pesquisa os trate da mesma forma durante as pesquisas.

Você pode definir os termos da consulta e os períodos aplicáveis como condições de controle. Você não precisa definir uma ação de controle separada. Se um termo especificado for usado como uma consulta, a ação de controle será usar outros termos especificados como sinônimos.

Por exemplo, é possível definir um controle de sinônimos bidirecional que associe os termos toalha de prato e toalha de cozinha como sinônimos. Quando um comprador no seu site insere toalha de cozinha como consulta, a pesquisa pode expandir a consulta para incluir resultados para toalha de prato e toalha de cozinha.

Para criar um controle de sinônimos, consulte Criar um novo controle de exibição.

Os sinônimos não mudam a consulta original. Por exemplo, se as consultas A e B forem sinônimos bidirecionais, espere o seguinte efeito:

  • Resultados da consulta A: conjunto A (sem regra de sinônimos aplicada) e parte do conjunto B. No entanto, os resultados podem ser menores do que a combinação de A e B.

  • Resultados da consulta B retornados: conjunto B e parte do A, mas possivelmente menos que a soma dos conjuntos de resultados A e B.

Para mais informações sobre as configurações de controle de sinônimos bidirecionais, consulte a referência da API Controls.TwowaySynonymsAction.

Controles de sinônimos unidirecionais

Os controles de sinônimos unidirecionais expandem os termos de consulta para vincular os termos unidirecionalmente.

Você pode definir os termos da consulta e os períodos aplicáveis como condições de controle. Como ação de controle, especifique os termos a serem usados como sinônimos unidirecionais.

Por exemplo, é possível definir um controle de sinônimos unidirecional que amplia as pesquisas pelo termo rose para incluir o termo pink. Como se trata de um sinônimo unidirecional, as pesquisas pelo termo rosa não se expandem para incluir o termo rose.

Para criar um controle de sinônimos unidirecional, consulte Criar um novo controle de exibição.

Assim como com sinônimos bidirecionais, a consulta original é executada e os sinônimos são fornecidos como dicas para ela. Sinônimos de palavras completamente diferentes podem resultar apenas em um pequeno número de termos sinônimos incluídos nos resultados. O exemplo anterior retorna itens rosa com ênfase em rosas rosa, mas uma regra de sinônimos que amplia as pesquisas pelo termo cachorro para incluir gato retorna principalmente itens com cachorros, além de alguns com gatos.

Para mais informações sobre as configurações de controle de sinônimos unidirecionais, consulte a referência da API Controls.OnewaySynonymsAction.

Sinônimos não fornecem resultados idênticos

Os resultados da pesquisa para dois sinônimos nem sempre são idênticos.

Por exemplo, se você definir bolsas para laptop e bagagem como sinônimos bidirecionais, o sistema poderá associar mala a bagagem. Assim, quando um usuário pesquisa bagagem, a Vertex AI para Pesquisa para Commerce retorna resultados sobre bagagem, mala e bolsas para notebook. No entanto, quando você pesquisa bolsas para laptop, a Vertex AI para Pesquisa no comércio adiciona apenas bagagem aos sinônimos. Portanto, os resultados podem não conter mala.

Ignorar controles

Os controles de ignorar impedem que a pesquisa use determinados termos de consulta durante as pesquisas. Eles marcam os termos ignorados em uma consulta como não importantes, mas não os excluem completamente.

Para remover completamente um termo de pesquisa de uma consulta, use um controle de substituição. Enquanto um controle de filtro afeta quais resultados são mostrados, um controle de substituição é uma maneira mais robusta de impedir que a Vertex AI Search para e-commerce retorne resultados para um termo específico.

Um controle de ignorar não garante que os resultados do termo ignorado não serão retornados em uma pesquisa da Vertex AI para comércio. Por exemplo, um controle de ignorar para a palavra óleo ainda pode retornar tintas a óleo para uma consulta de tintas a óleo. A consulta será transmitida como tintas, e pode haver muitas tintas a óleo correspondentes, mas o conjunto de resultados será maior, já que a pesquisa é por tintas. Esse tipo de controle pode ser útil se tintas a óleo for uma consulta popular no seu site e você vender muitos tipos diferentes de tintas, mas não muitas tintas à base de óleo.

Você pode definir os termos da consulta e os períodos aplicáveis como condições de controle. Você não precisa definir uma ação de controle separada. Se um termo especificado for usado como uma consulta, a ação de controle será ignorar esse termo.

Por exemplo, é possível criar um controle que ignore termos de consulta que usam linguagem ofensiva.

Para criar um controle de ignorar, consulte Criar um novo controle de exibição.

Para saber mais sobre as configurações de controle de ignorar, consulte a Referência da API Controls.IgnoreAction.

Controles de não associação

Os controles de não associação impedem que determinados termos de pesquisa sejam associados a outros especificados. Isso não afeta necessariamente os resultados da pesquisa, mas pode afetar.

Use um determinado termo de consulta e períodos aplicáveis para suas condições de controle. Como uma ação de controle, especifique quais termos não devem ser associados aos termos de consulta.

Exemplo: você cria um controle que impede que um nome de marca (como gShoe) seja agrupado com barato e qualidade ruim em uma consulta. Um comprador pesquisa sapato barato de baixa qualidade. A pesquisa remove os termos de consulta barato e baixa qualidade da consulta inicial, e o termo resultante é gShoe. No entanto, isso não garante que ele seja totalmente removido dos resultados da pesquisa.

Se um termo de consulta relevante também contiver um termo especificado como "não associar", o resultado relevante ainda poderá ser retornado. Para evitar que isso aconteça totalmente, use um controle de filtro.

Para criar um controle de não associação, consulte Criar um novo controle de exibição.

Para mais informações sobre as configurações de controle "não associar", consulte a referência da API Controls.DoNotAssociateAction.

Controles de substituição

Os controles de substituição substituem um ou mais termos de consulta fornecidos por um termo diferente que você especifica. É possível especificar vários termos que podem ser mapeados para um único termo (mas não vice-versa).

Você pode definir os termos da consulta e os períodos aplicáveis como condições de controle. Como ação de controle, especifique o termo que será usado como substituição.

Por exemplo, é possível criar um controle que substitua apelidos de uma marca pelo nome completo dela, que costuma ser mais usado em descrições de produtos.

Para criar um controle de substituição no console da Pesquisa para e-commerce, consulte Criar um novo controle de exibição.

Para saber mais sobre as configurações de controle de substituição, consulte a referência da API Controls.ReplacementAction.