Nesta página, você vai aprender a criar controles de exibição.
Os controles de veiculação são regras que você define e aplica a configurações de veiculação individuais.
É possível criar um controle de exibição no console da Pesquisa de comércio com IA no Gemini Enterprise for Customer Experience que consiste em uma condição, que aciona o controle, e uma ação que ocorre quando a condição é acionada. Depois, é possível anexar o novo controle de exibição a uma configuração de exibição.
Relação entre controles e configurações de exibição
As configurações de veiculação têm uma relação de muitos para muitos com os controles. É possível adicionar vários controles a uma configuração de veiculação, e um único controle pode ser associado a várias configurações de veiculação.
Ao criar controles e configurações de veiculação, você seleciona um produto (recomendações ou pesquisa) para o qual o controle pode ser usado.
Os controles de veiculação só podem ser associados a configurações de veiculação do mesmo tipo de produto. Por exemplo, um controle de exibição criado para recomendações não pode ser associado a uma configuração de exibição criada para pesquisa.

As configurações de exibição gerenciam quais controles são aplicados durante uma pesquisa ou uma solicitação de previsão. Somente os controles na configuração de exibição ativa de uma solicitação são considerados no momento da exibição. Por exemplo, suponha que você tenha criado dois controles: um chamado Promoção de gShoe, que aumenta os resultados da marca gShoe quando tênis é pesquisado, e outro chamado Mais tênis, que expande as consultas usando o termo tênis de corrida para incluir tênis esportivos. Se você anexar apenas o controle gShoe Sale a uma configuração de exibição, as solicitações de pesquisa que usam essa configuração vão aumentar os resultados do gShoe para consultas com o termo sapatos,mas o controle Mais sapatos não terá efeito porque não está anexado à configuração de exibição que você está usando.
Para mais informações, consulte Sobre as configurações de exibição.
Vídeos e guias de início rápido
- Introdução aos controles de veiculação: com eles, você pode criar regras que personalizam como as configurações de veiculação retornam resultados da pesquisa.
- Boost/bury: afeta a classificação e a ordem dos resultados 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.
- Redirecionar: redireciona seus usuários para uma página específica, dependendo da
consulta de pesquisa. Disponível apenas para pesquisa.
Neste tutorial, mostramos como usar o controle de redirecionamento.
Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientação:
- 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.
- 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.
- Fixação: afeta a ordenação dos resultados, colocando um resultado em uma posição específica, por exemplo, na posição 4. Disponível para pesquisa e navegação.
Para exemplos desses controles, consulte Sobre os controles de veiculação.
Opções de configuração de controle de veiculação
É possível criar controles e, em seguida, adicioná-los ou trocá-los em uma configuração de exibição ativa.
É possível criar até 100 controles de veiculação na Pesquisa de e-commerce com IA. Se você precisar de mais controles de veiculação, solicite uma cota adicional. Para isso, siga as etapas em Aumentar suas cotas.
Uma configuração de exibição pode ter até 100 controles de exibição de qualquer tipo, exceto os controles de redirecionamento de pesquisa, cujo limite pode ser de até 1.000 por configuração de exibição. A cota de controles em uma configuração de exibição pode ser diferente da cota geral permitida para um tipo de controle na API AI Commerce Search.
É possível criar um controle de veiculação das seguintes maneiras:
Na página "Controles" do console doGoogle Cloud : aqui, é possível criar controles durante o processo de criação da configuração de exibição.
Use o console de merchandising.
É possível criar um controle de veiculação inline usando o método
Controls.create.
Para usar o console Google Cloud e criar controles de veiculação:
Acesse a página Controles no console da Pesquisa de comércio com IA no Gemini Enterprise for Customer Experience.
Acessar a página "Controles"Siga as etapas do console do Google Cloud em cada seção de controle de veiculação.
Tipos de controle
Os controles têm requisitos diferentes dependendo do tipo. Acesse o procedimento de criação do tipo de controle que você quer criar:
- Criar um controle de otimização/ocultação
- Criar um controle de filtro
- Criar um controle de redirecionamento
- Criar um controle de fixação
- Criar um controle de sinônimos bidirecional
- Criar um controle de sinônimos unidirecional
- Criar um controle de não associação
- Criar um controle de ignorar
- Criar um controle substituto
Criar um controle de otimização/ocultação
Esse tipo de controle está disponível para pesquisa e recomendações.
- Criar um controle de aumento/diminuição da pesquisa
- Criar um controle de otimização/ocultação de recomendações
Consulte Controles de aumento/início para mais informações sobre esse tipo de controle.
Criar um controle de aumento/diminuição da pesquisa
Para criar um controle de otimização/aumento de pesquisa:
Console do Cloud
Acesse a página Controles no console da Pesquisa de comércio com IA no Gemini Enterprise for Customer Experience.
Acessar a página "Controles"Na guia Controles de veiculação, clique em add_boxCriar controle.
O painel Criar controle é aberto.
Na seção Preferências, no campo Nome do controle, insira um nome para o novo controle.
Opcional: para mudar o ID de controle criado automaticamente, clique em Editar e insira um novo ID.
Na seção Seleção de produtos, selecione Pesquisar.
Escolha Controles de destaque/ocultação como o tipo de controle. Clique em Continuar.
Na seção Gatilhos, selecione o tipo de comportamento do usuário que aciona esse controle.
Navegar pelas categorias: a regra é acionada quando um usuário navega pelas categorias no seu site (
search.request.queryestá vazio).Pesquisa: a regra é acionada quando um usuário pesquisa no seu site (
search.request.querynão está vazio). Para definir esse controle de forma que ele seja acionado quando qualquer categoria for pesquisada ou qualquer consulta for feita, pule a próxima etapa.
Opcional: defina categorias ou consultas específicas que podem acionar esse controle, dependendo se uma categoria específica é navegada ou se uma consulta específica é pesquisada.
Se você escolheu Procurar categorias: no campo Categorias, insira quais categorias vão acionar esse controle quando forem pesquisadas.
Se você escolheu Pesquisar: clique no botão Adicionar consulta para adicionar termos de consulta (por exemplo,
running shoes) a serem filtrados. Para cada termo, escolha Correspondência parcial ou Correspondência exata.
Opcional: clique no botão Adicionar período para incluir um ou mais períodos em que esse controle pode ser aplicado.
Clique em Continuar para acessar a seção Ações.
Adicione filtros para atributos de produto no campo Aumentar/ocultar produto.
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"))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. Clique em Continuar.
Na seção Configurações de exibição, selecione a que você quer aplicar o controle.
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. Para testar se as mudanças foram aplicadas, acesse a página Avaliar do console.
Agora você pode encontrar o novo controle listado na guia Controles de exibição da página Controles.
curl
Faça uma solicitação Control.create com um ID de controle e uma
instância de Control contida no corpo da solicitação.
Para detalhes dos campos, consulte a
referência da API Controls e a
referência da API Controls.create.
Um controle de aumentar/ocultar pode ser acionado quando um usuário navega pelas categorias no seu site (search.request.query está vazio) ou quando ele faz uma pesquisa no seu site (search.request.query não está vazio).
O exemplo a seguir mostra campos para um controle acionado por navegação, em que
searchSolutionUseCase é definido como SEARCH_SOLUTION_USE_CASE_BROWSE.
curl -X POST \ -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \ -H "Content-Type: application/json; charset=utf-8" \ --data '{ "displayName": "DISPLAY_NAME", "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ], "searchSolutionUseCase": [ "SEARCH_SOLUTION_USE_CASE_BROWSE" ], "rule": { "condition": { "pageCategories": [ "CATEGORY_ABC", "CATEGORY_XYZ" ], "activeTimeRange": [ { "startTime": "START_TIMESTAMP_1", "endTime": "END_TIMESTAMP_1" }, { "startTime": "START_TIMESTAMP_2", "endTime": "END_TIMESTAMP_2"