Esta é a documentação do Recommendations AI, da Pesquisa de varejo e do novo Console do Varejo. Para usar a pesquisa de varejo na fase GA restrita, entre em contato com a equipe de vendas do Cloud.

Se você estiver usando apenas o Recommendations AI, permaneça no Console do Recommendations e consulte a documentação do Recommendations AI.

Como criar e gerenciar controles

Esta página descreve como adicionar, visualizar, editar e excluir controles.

  • Os controles de veiculação são regras que você define e aplica a configurações específicas de veiculação de pesquisa de varejo.
  • Os controles de todo o site se aplicam a todos os resultados da pesquisa de varejo.

Controles de veiculação

Os controles de exibição permitem criar regras que personalizam como as configurações de exibição veiculam resultados da pesquisa.

É possível criar um controle de exibição com base em regras no Console do Cloud que consiste em uma condição, que aciona a regra, e uma ação que ocorre quando a condição é acionada. Depois, é possível anexar o novo controle de exibição a qualquer configuração de exibição da pesquisa de varejo que você criou.

As configurações de veiculação de pesquisa de varejo têm diversos relacionamentos com controles. É possível adicionar vários controles a uma configuração de exibição, e um único controle pode ser associado a várias configurações de exibição.

É possível criar controles e, em seguida, adicioná-los ou trocá-los em uma configuração de exibição ativa da Pesquisa de varejo.

Crie ou modifique os controles de exibição a qualquer momento na página Controles. Ao criar uma configuração de exibição da pesquisa de varejo, o Console do Cloud de varejo solicita que você também crie controles.

É possível criar até mil controles de veiculação.

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

  • Boost/bury: afeta a classificação e a ordem dos resultados na lista de resultados retornada.
  • Filtro: remove os resultados que não passam no filtro da lista de resultados retornados.
  • Redirecionar: redireciona seus 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.
    • Não associar: impede que um grupo de termos seja usado na pesquisa quando termos específicos aparecem.
    • Ignorar: impede que um termo seja usado em pesquisas.
    • Substituição: substitui termos na consulta de pesquisa.

Para exemplos desses controles, consulte Regras de controle de exibição.

Criar um novo controle de exibição

Adicione um novo controle de exibição na página "Controles" no Console do Google Cloud.

  1. Acesse a página "Controles de varejo" no Console do Google Cloud.

    Acessar a página "Controles"

  2. Na guia Controles de veiculação, clique em Criar controle.

  3. Insira um nome para o novo controle.

  4. Insira um ID de controle.

  5. Escolha o tipo de controle:

    Otimizar/ocultar

    Consulte Controles de aumento/início para mais informações sobre esse tipo de controle.

    1. (Opcional) Digite os termos da consulta (por exemplo, running shoes) para aumentar ou ocultar e selecionar uma das seguintes opções para cada termo:

      • Correspondência parcial: essa regra se aplica quando uma consulta contém uma correspondência parcial para esse termo.
      • Correspondência completa: essa regra se aplica somente quando uma consulta contém uma correspondência completa a esse termo.

      Esta é uma condição de controle. Quando um desses termos é incluído em uma consulta, a regra de reforço/início pode entrar em vigor. Se você especificar um intervalo de tempo, a regra será aplicada apenas se os critérios de período também forem atendidos.

    2. (Opcional) Clique no botão Adicionar período para incluir um ou mais períodos em que essa regra deve ser aplicada.

      Esta é uma condição de controle. Se você especificar os termos da consulta, a regra será aplicada apenas se um desses termos for usado em uma consulta durante esse período.

    3. No campo Boost/bury product, especifique os atributos do produto para aumentar ou ocultar. Use a sintaxe da expressão de filtro documentada em Como filtrar e ordenar.

      Por exemplo, para especificar as versões em vermelho e azul de "produto1" e "produto2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

    4. Em Valor de otimização/aumento, use o controle deslizante para definir a força do aumento. Valores positivos impulsionam os resultados, e valores negativos os ocultam.

      Esta é uma ação de controle que especifica qual comportamento a regra terá se as condições de controle forem atendidas.

    Filtro

    Consulte Controles de filtro para saber mais sobre esse tipo de controle.

    1. Insira os termos da consulta (por exemplo, running shoes) e filtre e selecione uma das seguintes opções para cada termo:

      • Correspondência parcial: essa regra se aplica quando uma consulta contém uma correspondência parcial para esse termo.
      • Correspondência completa: essa regra se aplica somente quando uma consulta contém uma correspondência completa a esse termo.

      Esta é uma condição de controle. Quando um desses termos é incluído em uma consulta, a regra de filtro entra em vigor. Se você especificar um intervalo de tempo, a regra será aplicada apenas se os critérios de período também forem atendidos.

    2. (Opcional) Clique no botão Adicionar período para incluir um ou mais períodos em que essa regra deve ser aplicada.

      Esta é uma condição de controle. A regra só será aplicada se um dos termos de consulta especificados for usado em uma consulta durante esse período.

    3. No campo Ação de filtro, especifique um filtro a ser aplicado quando a regra for acionada.

      Use a sintaxe da expressão de filtro documentada em Como filtrar e ordenar.

      Por exemplo, para filtrar versões vermelhas e azuis de "produto1" e "produto2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

      Esta é uma ação de controle que especifica qual comportamento a regra terá se as condições de controle forem atendidas.

    Redirecionar

    Consulte Controles de redirecionamento para mais informações sobre esse tipo de controle.

    1. Insira os termos da consulta (por exemplo, running shoes), que deve acionar a regra de redirecionamento, e selecionar uma das seguintes opções para cada termo:

      • Correspondência parcial: essa regra se aplica quando uma consulta contém uma correspondência parcial para esse termo.
      • Correspondência completa: essa regra se aplica somente quando uma consulta contém uma correspondência completa a esse termo.

      Esta é uma condição de controle. Quando um desses termos é incluído em uma consulta, a regra de redirecionamento entra em vigor. Se você especificar um intervalo de tempo, a regra será aplicada apenas se os critérios de período também forem atendidos.

    2. (Opcional) Clique no botão Adicionar período para incluir um ou mais períodos em que essa regra deve ser aplicada.

      Esta é uma condição de controle. A regra só será aplicada se um dos termos de consulta especificados for usado em uma consulta durante esse período.

    3. No campo URI de redirecionamento, especifique a página a ser redirecionada quando a regra for acionada.

      Esta é uma ação de controle que especifica qual comportamento a regra terá se as condições de controle forem atendidas.

    Sinônimo

    Consulte Controles de sinônimos para mais informações sobre esse tipo de controle.

    1. Digite pelo menos dois termos de consulta (por exemplo, running shoes), que precisam ser sinônimos um do outro, e selecione uma das seguintes opções para cada termo:

      • Correspondência parcial: essa regra se aplica quando uma consulta contém uma correspondência parcial para esse termo.
      • Correspondência completa: essa regra se aplica somente quando uma consulta contém uma correspondência completa a esse termo.

      Quando qualquer um desses termos for incluído em uma consulta, a pesquisa considerará os outros termos como sinônimos.

      Esta é uma condição de controle. Quando um desses termos é incluído em uma consulta, a regra de sinônimo pode entrar em vigor. Se você especificar um intervalo de tempo, a regra será aplicada apenas se os critérios de período também forem atendidos. Esse campo também fornece a ação de controle, que consiste em usar os outros termos especificados como sinônimos.

    2. (Opcional) Clique no botão Adicionar período para incluir um ou mais períodos em que essa regra deve ser aplicada.

      Esta é uma condição de controle. A regra só será aplicada se um dos termos de consulta especificados for usado em uma consulta durante esse período.

    Sinônimo unidirecional

    Para mais informações sobre esse tipo de controle, consulte Controles de sinônimos unidirecionais.

    1. Insira os termos da consulta (por exemplo, running shoes) que precisa ter sinônimos associados a eles e selecione uma das seguintes opções para cada termo:

      • Correspondência parcial: essa regra se aplica quando uma consulta contém uma correspondência parcial para esse termo.
      • Correspondência completa: essa regra se aplica somente quando uma consulta contém uma correspondência completa a esse termo.

      Esta é uma condição de controle. Quando qualquer um desses termos for incluído em uma consulta, a pesquisa considerará os outros termos como consulta do termo incluído, que você especificará na seção Termos associados. de dados. Se você especificar um intervalo de tempo, a regra será aplicada apenas se os critérios de período também forem atendidos.

    2. (Opcional) Clique no botão Adicionar período para incluir um ou mais períodos em que essa regra deve ser aplicada.

      Esta é uma condição de controle. A regra só será aplicada se um dos termos de consulta especificados for usado em uma consulta durante esse período.

    3. Na seção Termos associados, insira termos que devem ser usados como sinônimos para os termos de consulta especificados anteriormente.

      Esta é uma ação de controle que especifica qual comportamento a regra terá se as condições de controle forem atendidas.

    Não associar

    Consulte Não associar controles para mais informações sobre esse tipo de controle.

    1. Insira os termos da consulta (por exemplo, running shoes) que você quer diferenciar explicitamente de outras pessoas e selecione uma das seguintes opções para cada termo:

      • Correspondência parcial: essa regra se aplica quando uma consulta contém uma correspondência parcial para esse termo.
      • Correspondência completa: essa regra se aplica somente quando uma consulta contém uma correspondência completa a esse termo.

      Esta é uma condição de controle. Quando qualquer um desses termos é incluído em uma consulta, a regra impede que ele seja associado aos termos especificados no campo Termos associados. Se você especificar um período, a regra será aplicada apenas se os critérios de período também forem atendidos.

    2. (Opcional) Clique no botão Adicionar período para incluir um ou mais períodos em que essa regra deve ser aplicada.

      Esta é uma condição de controle. A regra só será aplicada se um dos termos de consulta especificados for usado em uma consulta durante esse período.

    3. Em Termos associados, insira termos que não podem ser associados nos resultados da pesquisa com os termos de consulta especificados anteriormente.

      Esta é uma ação de controle que especifica qual comportamento a regra terá se as condições de controle forem atendidas.

    Ignorar

    Consulte Ignorar controles para saber mais sobre esse tipo de controle.

    1. Insira os termos da consulta (por exemplo, running shoes) que você quer evitar que sejam usados em uma pesquisa e selecione uma das seguintes opções para cada termo:

      • Correspondência parcial: essa regra se aplica quando uma consulta contém uma correspondência parcial para esse termo.
      • Correspondência completa: essa regra se aplica somente quando uma consulta contém uma correspondência completa a esse termo.

      Esta é uma condição de controle. Quando um desses termos é incluído em uma consulta, a regra "ignorar" pode ser aplicada. Isso também fornece a ação de controle, que é ignorar os termos especificados. Se você especificar um período, a regra será aplicada apenas se os critérios de período também forem atendidos.

    2. (Opcional) Clique no botão Adicionar período para incluir um ou mais períodos em que essa regra deve ser aplicada.

      A regra só será aplicada se um dos termos de consulta especificados for usado em uma consulta durante esse período.

    Substituição

    Consulte Controles de substituição para mais informações sobre esse tipo de controle.

    1. Insira os termos da consulta (por exemplo, running shoes) que você quer substituir e selecione uma das seguintes opções para cada termo:

      • Correspondência parcial: essa regra se aplica quando uma consulta contém uma correspondência parcial para esse termo.
      • Correspondência completa: essa regra se aplica somente quando uma consulta contém uma correspondência completa a esse termo.

      Esta é uma condição de controle. Quando qualquer um desses termos é incluído em uma consulta, ele é substituído pelo termo fornecido em Termo de substituição. Se você especificar um período, a regra será aplicada apenas se os critérios de período também forem atendidos.

    2. (Opcional) Clique no botão Adicionar período para incluir um ou mais períodos em que essa regra deve ser aplicada.

      Esta é uma condição de controle. A regra só será aplicada se um dos termos de consulta especificados for usado em uma consulta durante esse período.

    3. Em Termo de substituição, insira o termo que precisa substituir os termos de consulta especificados anteriormente.

      Esta é uma ação de controle que especifica qual comportamento a regra terá se as condições de controle forem atendidas.

  6. Selecione as configurações de exibição a que aplicar o controle.

  7. Envie suas configurações de controle.

    Leva alguns minutos para que os controles recém-criados ou atualizados estejam prontos para exibir o tráfego em tempo real. É possível testar as mudanças imediatamente na página Avaliar.

Encontre o novo controle listado na guia Controles de exibição da página "Controles".

Ver ou editar um controle de exibição

A guia Controles de exibição da página "Controles" lista todos os seus controles de exibição e as configurações associadas. Clique em Editar para alterar as configurações de um controle, incluindo se é necessário aplicá-lo a uma configuração de exibição extra.

Também é possível ver e editar os controles de cada configuração de exibição na página Configurações de exibição. Clique em uma configuração de exibição para ver a respectiva página "Detalhes", que lista todos os controles de exibição e em todo o site para essa configuração.

Leva alguns minutos para que os controles recém-criados ou atualizados estejam prontos para exibir o tráfego em tempo real. É possível testar as mudanças imediatamente na página Avaliar.

Excluir um controle de exibição

Exclua um controle de servidor para remover essa regra de todas as configurações de exibição que a usam.

  1. Acesse a página "Controles de varejo" no Console do Google Cloud.

    Acessar a página "Controles"

  2. Na linha da tabela do controle que você pretende remover, clique em Excluir.

  3. Na janela de confirmação, clique em Excluir para concluir o processo.

Controles para todo o site

Os controles laterais permitem que você gerencie as configurações globalmente em todas as configurações de exibição.

Controles de atributos

Os controles de atributos de todo o site estão disponíveis no Console do Cloud para os atributos de produtos do seu catálogo.

Os controles de atributos para todo o site disponíveis são:

  • Indexável: a pesquisa de varejo pode filtrar e atributos usando esse atributo.
  • Atributos dinâmicos: a pesquisa de varejo pode usar automaticamente esse atributo como um atributo dinâmico com base no comportamento anterior do usuário, como cliques e visualizações de atributos. Para ativar o atributo dinâmico para um atributo, Indexable precisa ser definido como verdadeiro para esse atributo.
  • Pesquisável: esse atributo pode ser pesquisado pelas consultas de pesquisa de varejo, o que aumenta o recall dele. Esse controle é aplicável apenas a atributos de texto.

É possível ativar ou desativar os controles de atributos gerais para atributos individuais.

O atributo dinâmico está disponível como um controle de atributos para todo o site. Por padrão, o atributo dinâmico é ativado para todos os atributos personalizados.

No modo de configuração de nível de catálogo, os controles de atributo em todo o site estão disponíveis para indexação e pesquisa.

Os atributos predefinidos do sistema, como marca, cor ou tamanho, sempre são indexáveis. Os atributos do sistema textual são sempre pesquisáveis. Indexáveis e pesquisáveis podem ser alternados para atributos personalizados (atributos definidos usando Product.attributes[]). por padrão, eles são definidos como falso para atributos personalizados.

Também é possível definir algumas configurações de atributo por produto usando apenas o método de API Product.

Para saber mais sobre as configurações de atributos e quando elas estão disponíveis, consulte Configurações de atributos.

Definir controles de atributos para todo o site

Defina um controle de atributo para todo o site na página Controles no Console do Google Cloud.

A definição de controles de atributos globalmente está disponível no modo de configuração no nível do catálogo padrão. Anteriormente, a configuração no nível do produto era o modo padrão. Se você ainda estiver no modo de configuração no nível do produto e precisar alternar entre modos, entre em contato com o suporte do varejo.

  1. Acesse a página "Controles de varejo" no Console do Google Cloud.

    Acessar a página "Controles"

  2. Acesse a guia Controles em todo o site.

    Essa guia exibe uma tabela de todos os atributos de produtos que você pode definir em todo o site.

  3. Clique em Modificar controles.

  4. Ativar ou desativar um controle.

    • Verdadeiro: ative um controle para esse atributo. Isso modifica qualquer configuração de atributos no nível do produto na API Retail.
    • Falso: desative um controle desse atributo. Isso modifica qualquer configuração de atributo no nível do produto na API Retail.

      Só é possível definir o atributo dinâmico como verdadeiro para atributos que também estão definidos para indexação.

  5. Clique em Salvar controles.

    As alterações nas configurações de atributos para indexação e pesquisa entram em vigor em até 12 horas ou imediatamente no seu próximo processamento de catálogo. As mudanças na configuração de reconhecimento dinâmico levam até dois dias. É possível testar as mudanças imediatamente na página Avaliar.