Esta é a documentação do Recommendations AI, da Pesquisa de varejo e do novo Console do Retail.

Controles de veiculação

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

É possível criar um controle de exibição no Console do Cloud 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 de varejo que você criou. Somente os controles em uma configuração de exibiçã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 do Cloud, consulte Como criar e gerenciar controles.

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.
  • Filtro: remove os resultados que não passam no filtro da lista de resultados retornados.
  • Redirecionamento: redireciona os usuários para uma página específica, dependendo da consulta de pesquisa.
  • Linguística: personaliza a linguística da consulta de 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 exibição será executado.

Os campos de condição de controle podem ser termos de consulta, períodos ou ambos. Dependendo do tipo de controle, é possível especificar vários campos de condição.

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 qual comportamento será aplicado pelo controle de exibição se as condições forem atendidas durante uma pesquisa.

O tipo de ação que pode ser especificado depende do tipo de controle de veiculação criado. Por exemplo, a ação de um controle de otimização/oculta é aplicar um valor de otimização/oculta aos produtos especificados pelo filtro, enquanto a ação de um controle de sinônimos unidirecional é aplicar um termo associado especificado por você.

Controles de otimização/aumento

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

Ao criar um controle de otimização/ocultação, você pode usar expressões de filtro para especificar as condições com base nos campos Product. Consulte Filtrar e ordenar resultados para ver a sintaxe da expressão de filtro. Em seguida, é possível aplicar um valor boost entre -1,0 e 1,0 para indicar o aumento ou a ocultação dos resultados do produto correspondentes a essas condições. Um valor positivo aumenta os resultados, e um valor negativo os oculta.

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.

Você pode definir termos de consulta e períodos aplicáveis como condições de controle. Como ação de controle, especifique um filtro para produtos que serão otimizados ou ocultados e defina o valor.

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

Para criar um controle de otimização/ocultar no Console do Cloud, consulte Criar um novo controle de exibição.

Para saber mais sobre as configurações de controle de otimização/buryagem, consulte a referência da API Controls.BoostAction.

Controles de filtros

Com os controles de filtros, é possível 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 termos de consulta e períodos aplicáveis como condições de controle. Como ação de controle, especifique um filtro a ser aplicado no momento da consulta.

Por exemplo, considerando a consulta "sapatos azuis"", você pode usar um controle de filtros 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 filtros no Console do Cloud, consulte Criar um novo controle de exibição.

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

Controles de redirecionamento

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

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

Por exemplo, você pode criar um controle de redirecionamento para que, durante uma promoção de um produto "quoque" e calçados, as consultas com "tênis de corrida" ou "tênis esportivos" redirecionem para a página do gShoe.

Para criar um controle de redirecionamento no Console do Cloud, 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 linguísticos

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

Por exemplo, se você for um varejista, convém expandir as consultas que têm o termo "tênis de corrida" para incluir "tênis esportivos", para que os resultados da pesquisa incluam as duas palavras-chave. Com os controles linguísticos, é possível criar um controle de sinônimo linguístico em que a condição é que “tênis de corrida” seja inserido como o termo de pesquisa e a ação inclua o sinônimo de "tênis de corrida" nessa pesquisa. Quando um comprador no seu site insere "calçados de corrida" como consulta, a Pesquisa de varejo encontra essa correspondência no controle linguístico que você criou e expande a pesquisa para incluir "tênis de corrida" quando retorna os resultados da pesquisa para o comprador.

Controles de sinônimos bidirecionais

Use os controles de sinônimos bidirecional para vincular vários termos para que a Pesquisa de varejo os trate da mesma maneira durante as pesquisas.

Você pode definir termos de consulta e períodos aplicáveis como condições de controle. Não é necessário definir uma ação de controle separada. Se um termo especificado for usado como uma consulta, a ação 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 jantar" e "toalha de cozinha" como sinônimos. Quando um comprador no seu site insere "toalha de cozinha" como consulta, a Pesquisa de varejo pode expandir a consulta para incluir resultados para "toalha de prato" e vice-versa.

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

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

Controles de sinônimos unidirecionais

Os controles sinônimos unidirecionais vinculam os termos unidirecionalmente.

Você pode definir termos de consulta e 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 "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 no Console do Cloud, consulte Criar um novo controle de exibição.

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

Ignorar controles

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

Um controle de ignorar não garante que a Pesquisa de varejo não forneça resultados. Para evitar que isso aconteça totalmente, use um controle de filtro.

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

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

Para criar um controle de ignorar no Console do Cloud, consulte Criar um novo controle de exibição.

Para mais informações sobre as configurações de controle de ignorados, 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 termos de consulta e períodos aplicáveis como condições de controle. Como ação de controle, especifique os termos que não devem ser associados aos termos da consulta.

Por exemplo, você pode criar um controle que impede que um nome de marca (como "quot gShoe") seja agrupado com o termo "quosa barato" e "qualidade ruim" em uma consulta. Assim, se um comprador pesquisar "gShoe barato e de qualidade ruim", o termo "Pesquisa de varejo" buscará apenas "quot;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 no Console do Cloud, 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 termos de consulta e 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, você pode criar um controle que substitua os apelidos de uma marca pelo nome completo dela que é usado com mais frequência nas descrições do produto.

Para criar um controle de substituição no Console do Cloud, 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.