O Retail está sendo renomeado para Vertex AI para Pesquisa para Retail. Estamos atualizando o conteúdo para refletir o novo branding.

Esta página foi traduzida pela API Cloud Translation.

Criar controles de veiculação

Esta página descreve como 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. Para mais informações sobre as configurações de exibição, consulte Sobre as configurações de exibição.

Com os controles de veiculação, é possível criar regras que personalizam o modo como para exibir os resultados.

Você pode criar um controle de veiculação no console do Search for Retail consistindo em uma condição, que aciona o controle, e uma ação que realiza quando a condição é acionada. Depois, é possível anexar o novo controle de exibição a uma configuração de exibição.

As configurações de exibição têm uma relação de vários para vários com os 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.

Ao criar controles e configurações de exibição, você seleciona um produto (recomendações ou pesquisa) que 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 veiculação criado para recomendações não podem ser associadas a uma configuração de veiculação que foi criado para pesquisa.

As configurações de exibição gerenciam quais controles são aplicados durante uma pesquisa ou solicitação de previsão. Somente os controles na configuração de veiculação ativa para um solicitação são considerados no momento da disponibilização. Por exemplo, suponha que você tenha criado dois controles: um chamado "gShoe Sale", que aumenta os resultados da marca gShoe quando "shoes" é pesquisado, e um controle chamado "More Shoes", que expande as consultas usando o termo "running shoes" para incluir "sport shoes". Se você anexar apenas a "Promoção do gShoe" para uma configuração de veiculação e, em seguida, pesquisar solicitações o uso dessa configuração de veiculação impulsiona os resultados do gShoe para consultas que usam o termo "sapatos", mas a opção "Mais sapatos" controle não tem efeito porque não é anexada à configuração de veiculação usada.

É possível criar controles e, em seguida, adicioná-los ou trocá-los em uma veiculação ativa configuração do Terraform.

Crie ou modifique controles de veiculação a qualquer momento no Controles ou inline usando o método Controls.create. No console, você pode criar controles durante o processo de criação da configuração de disponibilização.

É possível criar até cem controles de veiculação. Se você precisar de mais controles de veiculação, solicite uma cota extra. Para saber como solicitar mais cota, consulte Aumentar suas cotas. Uma configuração de exibição pode ter até 100 controles de veiculação de qualquer tipo, exceto controles de redirecionamento, cujo limite é de 1.000 por configuração de exibiçã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. 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.
Linguística: personaliza a linguística da consulta de pesquisa. Disponível apenas para pesquisa. Há vários tipos de controles linguísticos 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 ver exemplos desses controles, consulte Sobre os controles de veiculação.

Tutorial de controle de redirecionamento

Este tutorial mostra como usar o controle de redirecionamento.

Para seguir as instruções da tarefa diretamente no editor do Cloud Shell, clique em Orientação:

Orientações

Criar um novo controle de exibição

Crie um controle de veiculação na Controles de segurança na Console do Google Cloud ou inline usando o método Controls.create.

Os controles têm requisitos diferentes dependendo do tipo. Acesse o procedimento de criação do tipo de controle que você planeja criar:

Criar um controle de boost/bury
Criar um controle de filtro
Criar um controle de redirecionamento
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

Consulte Controles de otimização/ocultação para saber mais sobre esse tipo de controle.

Esse tipo de controle está disponível para pesquisa e recomendações.

Criar um controle de aumento/ocultamento de pesquisa
Criar um controle de otimização/ocultação de recomendações

Criar um controle de aumento/ocultamento de pesquisa

Para criar um controle de otimização/ocultação de pesquisa:

Console

Acesse a página Controles no console da Pesquisa para varejo.

Acessar a página "Controles"
Na guia Controles de veiculação, clique em Criar 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 aumento/início como o tipo de controle.
Clique em "Continuar" para acessar a seção Acionadores.

Na seção Acionadores, defina as condições que acionam o controle:

Selecione o tipo de comportamento do usuário que aciona esse controle:
- Procurar categorias: a regra é acionada quando um usuário navega categorias em seu site (search.request.query é vazio).
- Pesquisa: a regra é acionada quando um usuário pesquisa no seu site (search.request.query não está vazio).
É possível definir categorias ou consultas específicas que podem acionar esse controle na próxima etapa. Para definir que esse controle seja acionado quando qualquer categoria for navegado ou pesquisar uma consulta, pule a etapa seguinte.
Opcional: defina uma condição de controle que aciona a regra com base em se uma categoria específica é navegada ou se uma consulta específica é pesquisada.

Para definir esse controle para acionar em qualquer categoria ou consulta, pule esta etapa.

A opção disponível depende se você escolheu Procurar categorias ou Pesquisar:
- Se você escolher Procurar categorias: no campo Categorias, insira quais categorias acionarão esse controle quando navegado.
- Se você tiver escolhido Pesquisa: clique no botão Adicionar consulta para adicionar termos de consulta (por exemplo, running shoes) a serem filtrados e selecione uma das seguintes opções para cada termo:
  - Correspondência parcial: esse controle se aplica quando uma consulta contém uma correspondência parcial para esse termo.
  - Correspondência completa: esse controle se aplica somente quando uma consulta contém uma correspondência completa a esse termo.
  Quando um desses termos é incluído em uma consulta, o controle é aplicado.
Se você especificar as condições do período além desse tipo de o controle será aplicado somente se ambas as condições forem atendidas.
Opcional: clique no botão Adicionar período para incluir um ou mais os intervalos de tempo durante os quais esse controle pode ser aplicado.

Se você especificar uma categoria ou condição de termo de consulta, além de um horário do intervalo de tempo, o controle é aplicado somente quando ambas as condições são atendidas.
Clique em Continuar para acessar a seção Ações.

Na seção Ações:

Adicione filtros para atributos de produtos no campo Boost/bury product.

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 para prosseguir para a seção Configurações de veiculação.

Na seção Configurações de veiculação:

Selecione as configurações de exibição a que 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. Você pode testar se as alterações foram aplicadas na página Avaliar do console.

Encontre 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 um Instância de Control contida no corpo da solicitação.

Para detalhes sobre os campos, consulte a referência da API Controls e a referência da API Controls.create.

Um controle de otimização/ocultação pode ser acionado quando um usuário navega por categorias no seu site (search.request.query está vazio) ou quando um usuário pesquisas no seu site (search.request.query não está em branco).

O exemplo a seguir mostra campos para um controle acionado pela 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"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

O exemplo a seguir mostra campos para um controle acionado por pesquisa, em que searchSolutionUseCase é definido como SEARCH_SOLUTION_USE_CASE_SEARCH.

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_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

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 se as mudanças foram aplicadas na página Avaliar do console.

Para adicionar um controle a uma configuração de veiculação, use o método ServingConfig.addControl:

Para saber mais sobre esse método, consulte a referência da API ServingConfig.addControl.
Para conferir um exemplo desse método, consulte Gerenciar configurações de veiculação.

Criar um controle de otimização/ocultação de recomendações

Para criar um controle de otimização/ocultação de recomendações:

Console

Acesse a página Controles no console da Pesquisa para varejo.

Acessar a página "Controles"
Na guia Controles de veiculação, clique em Criar controle.

O painel Criar controle é aberto.

Na seção Preferências:

No campo Nome do controle, digite 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 Recomendação.
Escolha Controles de aumento/início como o tipo de controle.
Clique em Continuar para acessar a seção Ações.

Na seção Ações:

Adicione filtros para atributos de produtos no campo Boost/bury product.

Use a sintaxe da expressão de filtro documentada em Filtrar recomendações.

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 para prosseguir para a seção Configurações de veiculação.

Na seção Configurações de veiculação:

Selecione as configurações de exibição a que 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. Você pode testar se as alterações foram aplicadas na página Avaliar do console.

Encontre 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 mais detalhes sobre os campos, consulte a Referência da API Controls e Referência da API Controls.create.

Para criar uma expressão de filtro, use a sintaxe documentada da expressão de filtro em Filtrar recomendações.

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_RECOMMENDATION" ],
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Para adicionar um controle a uma configuração de veiculação, use o método ServingConfig.addControl:

Para saber mais sobre esse método, consulte a referência da API ServingConfig.addControl.
Para conferir um exemplo desse método, consulte Gerenciar configurações de veiculação.

Criar um controle de filtro

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

Console

Acesse a página Controles no console do Search for Retail.

Acessar a página "Controles"
Na guia Controles de veiculação, clique em Criar 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 do controle criado automaticamente, clique em Editar e insira um novo ID de controle.
Escolha Controles de filtro como o tipo.
Clique em "Continuar" para acessar a seção Gatilhos.

Na seção Acionadores:

Selecione o tipo de comportamento do usuário que aciona esse controle:
- Procurar categorias: a regra é acionada quando um usuário navega categorias em seu site (search.request.query é vazio).
- Pesquisa: a regra é acionada quando um usuário pesquisa no seu site. (search.request.query não está em branco).
Opcional: defina uma condição de controle que acione a regra com base na categoria que é navegada ou na consulta que é pesquisada. A opção disponível depende se você escolheu Procurar categorias ou Pesquisar:
- Se você escolher Procurar categorias: no campo Categorias, insira quais categorias acionarão esse controle quando navegado.
- Se você tiver escolhido Pesquisa: clique no botão Adicionar consulta para adicionar termos de consulta (por exemplo, running shoes) a serem filtrados e selecione uma das seguintes opções para cada termo:
  - Correspondência parcial: esse controle se aplica quando uma consulta contém uma correspondência parcial para esse termo.
  - Correspondência completa: esse controle se aplica somente quando uma consulta contém uma correspondência completa a esse termo.
  Quando um desses termos é incluído em uma consulta, o controle é aplicado.
Se você especificar uma condição de período além dessa, o controle só será aplicado se ambas as condições forem atendidas.
Opcional: clique no botão Adicionar período para incluir um ou mais os intervalos de tempo durante os quais esse controle pode ser aplicado.

Se você especificar uma condição de categoria ou de termo de consulta além dessa condição de período, o controle só será aplicado quando ambas as condições forem atendidas.
Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

Adicione filtros para atributos do produto no campo Ação de filtro.

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"))
Clique em Continuar para prosseguir para a seção Configurações de veiculação.

Na seção Configurações de veiculação:

Selecione as configurações de exibição a que 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. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

Encontre 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 mais detalhes sobre os campos, consulte a Referência da API Controls e Referência da API Controls.create.

Um controle de filtro pode ser acionado quando um usuário navega por categorias no seu site (search.request.query está vazio) ou quando um usuário faz uma pesquisa no seu site (search.request.query não está vazio).

O exemplo a seguir mostra campos para um controle acionado pela 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"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

O exemplo a seguir mostra campos para um controle acionado por pesquisa, em que searchSolutionUseCase é definido como SEARCH_SOLUTION_USE_CASE_SEARCH.

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_SEARCH"
              ],
              "rule": {
                "condition": {
                  "pageCategories": [
                      "CATEGORY_ABC",
                      "CATEGORY_XYZ"
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "filterAction": {
                  "filter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Para adicionar um controle a uma configuração de veiculação, use o método ServingConfig.addControl:

Para saber mais sobre esse método, consulte a referência da API ServingConfig.addControl.
Para conferir um exemplo desse método, consulte Gerenciar configurações de exibição.

Criar um controle de redirecionamento

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

Console

Acesse a página Controles no console do Search for Retail.

Acessar a página "Controles"
Na guia Controles de veiculação, clique em Criar 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.
Escolha Controles de redirecionamento como o tipo.
Clique em "Continuar" para acessar a seção Gatilhos.

Na seção Gatilhos, crie pelo menos um acionador de termo de consulta ou de período de tempo. Os controles de redirecionamento exigem pelo menos um gatilho:

Selecione o tipo de comportamento do usuário que aciona esse controle:
- Procurar categorias: a regra é acionada quando um usuário navega categorias em seu site (search.request.query é vazio).
- Pesquisa: a regra é acionada quando um usuário pesquisa no seu site (search.request.query não está vazio).
Defina uma condição de controle que aciona a regra com base qual categoria é pesquisada ou qual consulta é pesquisada. A opção disponível depende da opção escolhida: Procurar categorias ou Pesquisar:
- Se você escolher Procurar categorias: no campo Categorias, insira quais categorias acionarão esse controle quando navegado.
- Se você tiver escolhido Pesquisa: clique no botão Adicionar consulta para adicionar termos de consulta (por exemplo, running shoes) a serem filtrados e selecione uma das seguintes opções para cada termo:
  - Correspondência parcial: esse controle se aplica quando uma consulta contém uma correspondência parcial para esse termo.
  - Correspondência completa: esse controle se aplica somente quando uma consulta contém uma correspondência completa a esse termo.
  Quando um desses termos é incluído em uma consulta, o controle é aplicado.
Se você especificar uma condição de período além dessa, o controle só será aplicado se ambas as condições forem atendidas.
Clique no botão Adicionar período para adicionar um ou mais períodos durante nas quais esse controle pode ser aplicado.

Se você especificar uma condição de categoria ou termo de consulta de intervalo de tempo, o controle será aplicado somente quando as duas condições sejam atendidos.
Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

Insira o URI para redirecionar quando esse controle for acionado.
Clique em Continuar para acessar a seção Configurações de veiculação.

Na seção Configurações de veiculação:

Selecione as configurações de exibição a que 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. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

Encontre 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 um Instância de Control contida no corpo da solicitação.

Para mais detalhes sobre os campos, consulte a Referência da API Controls e Referência da API Controls.create.

Um controle de redirecionamento pode ser acionado quando um usuário navega por categorias no site (search.request.query está vazio) ou quando um usuário pesquisas no seu site (search.request.query não está em branco).

O exemplo a seguir mostra campos para um controle acionado pela 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": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

O exemplo a seguir mostra campos para um controle acionado por pesquisa, em que searchSolutionUseCase é definido como SEARCH_SOLUTION_USE_CASE_SEARCH.

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_SEARCH"
              ],
              "rule": {
                "condition": {
                  "queryTerms": [
                    {
                      "value": "VALUE_1",
                      "fullMatch": "FULLMATCH_BOOLEAN_1"
                    },
                    {
                      "value": "VALUE_2",
                      "fullMatch": "FULLMATCH_BOOLEAN_2"
                    }
                  ],
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "redirectAction": {
                  "redirectUri": "REDIRECT_URI",
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Para adicionar um controle a uma configuração de veiculação, use o ServingConfig.addControl :

Para saber mais sobre esse método, consulte a Referência da API ServingConfig.addControl.
Para conferir um exemplo desse método, consulte Gerenciar configurações de veiculação.

Criar um controle de sinônimos bidirecional

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

Console

Acesse a página Controles no console do Search for Retail.

Acessar a página "Controles"
Na guia Controles de veiculação, clique em Criar controle.
No campo Nome do controle, digite um nome para o novo controle.

O painel Criar controle é aberto.

Na seção Preferências:

Opcional: para mudar o ID de controle criado automaticamente, clique em Editar e insira um novo ID.
Escolha Controle de sinônimos bidirecional como o tipo de controle.
Clique em "Continuar" para acessar a seção Gatilhos.

Na seção Gatilhos:

Opcional: clique no botão Adicionar período para incluir um ou mais os intervalos de tempo durante os quais esse controle pode ser aplicado.
Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

No campo Synonyms, insira de 2 a 100 termos de consulta (por exemplo, shirt e top) que sejam sinônimos entre si.

Quando qualquer um desses termos é incluído em uma consulta, a pesquisa considera os outros termos como sinônimos do termo incluído.
Clique em Continuar para acessar a seção Configurações de veiculação.

Na seção Configurações de veiculação:

Selecione as configurações de exibição a que 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. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

Encontre 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 sobre os campos, consulte a referência da API Controls e a referência da API Controls.create.

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" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                    ]
                },
                "twoWaySynonymAction": {
                  "synonyms": [
                    "SYNONYM_1",
                    "SYNONYM_2"
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Para adicionar um controle a uma configuração de veiculação, use o método ServingConfig.addControl. Consulte Adicionar controles às configurações de exibição inline.

Criar um controle de sinônimos unidirecional

Consulte Controles de sinônimos unidirecionais para saber mais sobre esse controle. não é válido.

Console

Acesse a página Controles no console da Pesquisa para varejo.

Acessar a página "Controles"
Na guia Controles de veiculação, clique em Criar 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.
Escolha Controle de sinônimo unidirecional como o tipo de controle.
Clique em "Continuar" para acessar a seção Acionadores.

Na seção Gatilhos:

Opcional: clique no botão Adicionar período para incluir um ou mais os intervalos de tempo durante os quais esse controle pode ser aplicado.
Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

No campo Termos da consulta, insira termos (por exemplo, shoes) que devem ter sinônimos associados quando qualquer um deles for incluído em uma consulta.
No campo Sinônimos, digite os termos que devem ser usados como sinônimos. para os termos de consulta que você especificou (por exemplo, sneakers e sandals) como sinônimos unidirecionais para o termo de consulta shoes).
Clique em Continuar para acessar a seção Configurações de veiculação.

Na seção Configurações de veiculação:

Selecione as configurações de exibição a que 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. Você pode testar se as alterações foram aplicadas na página Avaliar do console.

Encontre 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 mais detalhes sobre os campos, consulte a Referência da API Controls e Referência da API Controls.create.

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" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "oneWaySynonymAction": {
                  "synonyms": [
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "synonyms": [
                      "SYNONYM_1",
                      "SYNONYM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Para adicionar um controle a uma configuração de veiculação, use o método ServingConfig.addControl:

Para saber mais sobre esse método, consulte a Referência da API ServingConfig.addControl.
Para conferir um exemplo desse método, consulte Gerenciar configurações de exibição.

Criar um controle "não associar"

Consulte Controles "Não associar" para mais informações. tipo de controle de acesso.

Console

Acesse a página Controles no console do Search for Retail.

Acessar a página "Controles"
Na guia Controles de veiculação, clique em Criar 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.
Escolha Não associar controle como o tipo.
Clique em "Continuar" para acessar a seção Acionadores.

Na seção Gatilhos:

Opcional: clique no botão Adicionar período para incluir um ou mais os intervalos de tempo durante os quais esse controle pode ser aplicado.
Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

No campo Termos de consulta, digite termos (por exemplo, gShoe). que você queira diferenciar explicitamente dos outros.
No campo Termos dissociados, insira termos que não podem ser associados nos resultados da pesquisa com os termos de consulta especificados.

Por exemplo, é possível separar o termo de consulta gShoe do termo cheap.
Clique em Continuar para prosseguir para a seção Configurações de veiculação.

Na seção Configurações de veiculação:

Selecione as configurações de exibição a que 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. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

Encontre 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 um Instância de Control contida no corpo da solicitação.

Para mais detalhes sobre os campos, consulte a Referência da API Controls e Referência da API Controls.create.

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" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "doNotAssociateAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "doNotAssociateTerms": [
                      "DISSOCIATED_TERM_1",
                      "DISSOCIATED_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Para adicionar um controle a uma configuração de veiculação, use o ServingConfig.addControl :

Para saber mais sobre esse método, consulte a Referência da API ServingConfig.addControl.
Para conferir um exemplo desse método, consulte Gerenciar configurações de veiculação.

Criar um controle de ignorar

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

Console

Acesse a página Controles no console do Search for Retail.

Acessar a página "Controles"
Na guia Controles de veiculação, clique em Criar 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.
Escolha Não associar controle como o tipo.
Clique em "Continuar" para acessar a seção Acionadores.

Na seção Gatilhos:

Opcional: clique no botão Adicionar período para incluir um ou mais os intervalos de tempo durante os quais esse controle pode ser aplicado.
Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

No campo Ignorar termos, digite os termos (por exemplo, shoddy) que: que você quer que a pesquisa ignore quando eles forem inseridos como termos de consulta.
Clique em Continuar para acessar a seção Configurações de veiculação.

Na seção Configurações de veiculação:

Selecione as configurações de exibição a que 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. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

Encontre 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 sobre os campos, consulte a referência da API Controls e a referência da API Controls.create.

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" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "ignoreAction": {
                  "ignoreTerms": [
                      "IGNORE_TERM_1",
                      "IGNORE_TERM_2"
                    ]
                  ]
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Para adicionar um controle a uma configuração de veiculação, use o ServingConfig.addControl :

Para saber mais sobre esse método, consulte a Referência da API ServingConfig.addControl.
Para conferir um exemplo desse método, consulte Gerenciar configurações de veiculação.

Criar um controle substituto

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

Console

Acesse a página Controles no console da Pesquisa para varejo.

Acessar a página "Controles"
Na guia Controles de veiculação, clique em Criar 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 do controle criado automaticamente, clique em Editar e insira um novo ID de controle.
Escolha Controle de substituição como o tipo.
Clique em "Continuar" para acessar a seção Acionadores.

Na seção Gatilhos:

Opcional: clique no botão Adicionar período para incluir um ou mais os intervalos de tempo durante os quais esse controle pode ser aplicado.
Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

No campo Termos de consulta, digite termos de consulta (por exemplo, gShoe) que você quer que seja substituído pelo termo substituto.
No campo Termo de substituição, digite o termo que deve substituir o termos de consulta especificados.

Por exemplo, você pode substituir o termo da consulta gShoe pelo termo de substituição Google Shoe.
Clique em Continuar para prosseguir para a seção Configurações de veiculação.

Na seção Configurações de veiculação:

Selecione as configurações de exibição a que 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. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

Encontre 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 um Instância de Control contida no corpo da solicitação.

Para mais detalhes sobre os campos, consulte a Referência da API Controls e Referência da API Controls.create.

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" ],
              "rule": {
                "condition": {
                  "activeTimeRange": [
                    {
                      "startTime": "START_TIMESTAMP_1",
                      "endTime": "END_TIMESTAMP_1"
                    },
                    {
                      "startTime": "START_TIMESTAMP_2",
                      "endTime": "END_TIMESTAMP_2"
                    }
                  ]
                },
                "replacementAction": {
                    "queryTerms": [
                      "QUERY_TERM_1",
                      "QUERY_TERM_2"
                    ],
                    "replacementTerm": "REPLACEMENT_TERM"
                  }
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"

Para adicionar um controle a uma configuração de veiculação, use o ServingConfig.addControl :

Para saber mais sobre esse método, consulte a referência da API ServingConfig.addControl.
Para conferir um exemplo desse método, consulte Gerenciar configurações de exibição.