Sobre os controles de veiculação

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

É possível criar um controle de veiculação no console da Pesquisa para varejo ou usando o método Control.create da API.

Depois, é possível anexar o novo controle de exibição a qualquer configuração de exibição da Pesquisa que você criou. Somente os controles em uma configuração de veiculação ativa para uma solicitação são considerados no momento da veiculação.

Para saber mais sobre como criar controles de exibição no console da Pesquisa para varejo, consulte Criar controles de exibição.

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, o período será acionado se algum deles corresponder.
  • 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 saber mais 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 veiculaçã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ê criou. 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 de sinônimo unidirecional é aplicar um termo associado que você especificar.

Controles de otimização/ocultação

Os controles de otimização/ocultação permitem mostrar determinados resultados de pesquisa como maiores ou menores na classificação.

É possível criar um controle de aumento/ocultação para pesquisa ou recomendações. O recurso "Boost/bury" para recomendações está no Acesso antecipado.

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 diferem entre os controles de otimização/ocultação de pesquisa e recomendações:

  • Pesquisa: é possível definir termos de consulta e 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 saber mais 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 saber mais 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 mostrar 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 "tênis esportivos" sejam redirecionadas para a página do produto gShoe.

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

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

Como fixar controles

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

É possível 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 à pesquisa ou à navegação 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 para fixar os resultados correspondentes a essas condições.

  • Condição da regra: é necessário especificar [Condition.query_terms][] (somente para pesquisa) ou [Condition.page_categories][] (somente para navegação), 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 alfinetes.
  • Resultado da ação: fixar 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 de destaque nos resultados finais.

Ativar alfinetes e regras aplicadas

Quando um controle de fixação é ativado:

  • Os produtos com IDs que correspondem a um alfinete aparecem na resposta final na posição exata especificada pelo controle.
  • Não é permitido fixar na segunda página ou em uma página mais recente (número de página mais alto). Ou seja, qualquer pino definido em uma posição mais alta do que a solicitação page_size é ignorado.
  • É possível fixar no máximo 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 pinos apareçam.
  • A ordem de classificação (como ordenar os resultados da pesquisa por preço) não é o padrão.

Comportamento de alfinete

  • Se um produto estiver fixado, ele vai ignorar todos os aumentos ou ocultamentos da solicitação ou de outros controles.
  • Se um produto estiver fixado em várias posições, o controle atualizado mais recentemente terá precedência.
  • Não é possível fixar dois produtos na mesma posição dentro do mesmo controle de fixação (mapa de alfinetes).
    • Se vários controles corresponderem à mesma consulta e cada um deles tiver um pino diferente para o mesmo ID do 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ônimas é um controle linguístico que associa duas palavras.

Com os controles de sinônimos, você pode incluir outros produtos nos resultados da pesquisa que não são recuperados pelo nosso sistema por padrã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 o termo de pesquisa. A ação é incluir o sinônimo "tênis esportivos" nessa pesquisa. Assim, quando um comprador no seu site pesquisa "tênis de corrida", a pesquisa encontra a correspondência no controle linguístico que você criou e o expande 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 também para "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, um sinônimo bidirecional de "A<==>B" vai ter o seguinte efeito:

  • Para a consulta "A", os resultados retornados devem ser o conjunto de resultados A (quando nenhuma regra de sinônimo é aplicada) + alguns do conjunto de resultados B, mas ainda podem ser menores que a união do conjunto de resultados A + conjunto de resultados B.

  • Para a consulta "B", os resultados retornados devem ser o conjunto de resultados B + alguns do conjunto de resultados A, mas ainda podem ser menores que o conjunto de resultados A + o conjunto de resultados B.

Para saber mais 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 da consulta para vincular os termos de forma unidirecional.

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 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 "rosa". Como se trata de um sinônimo unidirecional, as pesquisas pelo termo "rosa" não se expandem para incluir o termo "rosa".

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

Assim como nos sinônimos de duas vias, a consulta original é executada e os sinônimos são fornecidos como dicas para essa consulta. Os sinônimos de palavras totalmente diferentes podem resultar apenas em pequenos números dos termos sinônimos incluídos nos resultados. Por exemplo, uma regra de sinônimo para "dog=>cat" ainda vai retornar principalmente cães, além de alguns gatos, enquanto o exemplo "rose=>pink" vai retornar itens cor-de-rosa com ênfase em rosas cor-de-rosa.

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

Os 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 de mão dupla, o sistema já poderá associar "mala" a "bagagem". Assim, quando um usuário procura "bagagem", a Vertex AI Search for Retail retorna resultados sobre "bagagem", "mala" e "bolsas para laptop". No entanto, quando você pesquisa "bolsas para laptop", a Vertex AI para Pesquisa para varejo só adiciona "bagagem" aos sinônimos. Portanto, os resultados podem não conter "mala".

Ignorar controles

Ignorar controles impede que a pesquisa use determinados termos de consulta durante as pesquisas.

Um controle de ignorar não é um operador negativo. Ele não garante que a Pesquisa da Vertex AI para varejo não vai fornecer resultados para esse termo. Para evitar que isso aconteça totalmente, use um controle de filtro. Um controle de ignorar aplicado a uma consulta de palavra única ainda pode retornar resultados, já que pode haver sinônimos definidos pelo Google ou expansão de consulta que correspondem a alguns produtos.

Por exemplo, um controle de ignoração para a palavra "óleo" ainda vai retornar tintas a óleo para uma consulta de "tintas a óleo". A consulta será transmitida como "pinturas", e muitas tintas a óleo podem ser encontradas, mas o conjunto de resultados será maior, já que a pesquisa é por "pinturas". 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.

Um controle de ignorar não garante que a pesquisa não vai fornecer nenhum resultado. Para evitar que isso aconteça totalmente, use um controle de filtro.

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 ignoramento, consulte a referência da API Controls.IgnoreAction.

Controles de não associação

Os controles de não associação impedem que os termos da consulta sejam consultados em conjunto durante pesquisas com outros termos especificados.

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 os termos que não podem ser associados aos termos da consulta.

Por exemplo, é possível criar um controle que impeça que um nome de marca (como "gShoe") seja agrupado com o termo "cheap" e "poor quality" em uma consulta. Assim, se um cliente pesquisar "gShoe barato de baixa qualidade", a pesquisa vai pesquisar apenas "gShoe".

Se um resultado relevante para o termo de consulta também contiver um termo especificado como "não associar", ele 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 saber mais sobre as configurações de controle de não associação, 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 varejo, 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.