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

Criar controles de veiculação

Nesta página, descrevemos como criar controles de veiculação.

Os controles de exibição são regras que você define e aplica a configurações de veiculação individuais. Para mais informações sobre configurações de exibição, consulte Sobre configurações de exibição.

Com os controles de disponibilização, você pode criar regras que personalizam a forma como as configurações de exibição exibem resultados.

É possível criar um controle de veiculação no console da Pesquisa para varejo com uma condição que aciona o controle e uma ação que ocorre quando a condição é acionada. Em seguida, anexe o novo controle de veiculaçã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 veiculação, e um único controle pode ser associado a várias configurações desse tipo.

Ao criar controles e configurações de veiculação, você seleciona um produto (recomendações ou pesquisa) para o qual ele pode ser usado. Os controles de veiculação podem ser associados apenas às configurações de veiculação do mesmo tipo de produto. Por exemplo, um controle de veiculaçã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 solicitação de pesquisa ou previsão. Somente os controles na configuração de veiculação ativa para uma solicitação são considerados no momento da veiculação. Por exemplo, suponha que você tenha criado dois controles: um controle chamado "Promoção de gShoe", que melhora os resultados para a marca gShoe quando a palavra "calçados" é pesquisada, e um controle chamado "Mais calçados", que expande as consultas usando o termo "tênis de corrida" para incluir "calçados esportivos". Se você anexar apenas o controle "Promoção do gShoe" a uma configuração de veiculação, as solicitações de pesquisa que usam essa configuração de exibição otimizarão os resultados do gShoe para consultas que usam o termo "sapatos", mas o controle "Mais sapatos" não terá efeito porque não está associado à configuração de veiculação que você está usando.

É possível criar controles e depois adicionar ou trocá-los em uma configuração de exibição ativa.

Crie ou modifique controles de veiculação a qualquer momento na página Controles ou inline usando o método Controls.create. No console, é possível criar controles durante o processo de criação da configuração de exibição.

É possível criar até 100 controles de veiculação. Se você precisar de mais controles de veiculação, solicite uma cota adicional. Para saber como solicitar mais cotas, consulte Aumentar suas cotas. Uma configuração de veiculação pode ter até 100 controles de veiculação de qualquer tipo, além dos controles de redirecionamento, com um limite de 1.000 por configuração 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. 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. Vários tipos de controles linguísticos 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 ver exemplos desses controles, consulte Sobre os controles de veiculação.

Tutorial de controle de redirecionamento

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:

Orientações

Criar um novo controle de exibição

Crie um novo controle de veiculação na página "Controles" do Console do Google Cloud ou in-line 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 otimização/ocultação
Criar um controle de filtros
Criar um controle de redirecionamento
Criar um controle de sinônimos bidirecional
Criar um controle de sinônimos unidirecionais
Criar um controle "Não associe"
Criar um controle "ignorar"
Criar um controle de substituição

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 otimização/ocultação da pesquisa
Criar um controle de otimização/ocultação de recomendações

Criar um controle de otimização/ocultação da pesquisa

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

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, digite um nome para o novo controle.
Opcional: para alterar o ID de controle criado automaticamente, clique em Editar e insira um novo ID de controle.
Na seção Seleção de produtos, escolha Pesquisar.
Escolha Boost/bury controls como tipo de controle.
Clique em "Continuar" para acessar a seção Gatilhos.

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 por categorias no seu site (search.request.query está 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 etapa a seguir. Para que esse controle seja acionado quando qualquer categoria for procurada ou qualquer consulta for pesquisada, pule a etapa a seguir.
Opcional: defina uma condição de controle que aciona a regra com base na busca por uma categoria específica ou quando uma determinada consulta é pesquisada.

Para definir que esse controle seja acionado em qualquer categoria ou consulta, pule esta etapa.

A opção disponível depende da opção escolhida: Procurar por categorias ou Pesquisar:
- Se você escolheu Procurar categorias: no campo Categorias, insira as categorias que acionarão esse controle na navegação.
- Se você escolheu Pesquisar: clique no botão Adicionar consulta para incluir termos de consulta (por exemplo, running shoes) a serem filtrados e selecionar 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 de consulta.
  - Correspondência total: esse controle se aplica apenas quando uma consulta contém uma correspondência total para esse termo de consulta.
  Quando um desses termos é incluído em uma consulta, o controle é aplicado.
Se você especificar as condições de período além desse tipo de condição, o controle será aplicado somente se as duas condições forem atendidas.
Opcional: clique no botão Adicionar período para incluir um ou mais períodos em que o controle pode ser aplicado.

Se você especificar uma condição de termo de consulta ou categoria, além de condições de período, o controle será aplicado somente quando as duas 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 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 acessar a seção Configurações de veiculação.

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

Selecione as configurações de veiculação para 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 no corpo da solicitação.

Para detalhes do campo, 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 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"
                    }
                  ]
                },
                "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 exibiçã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 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, digite um nome para o novo controle.
(Opcional) Para alterar o ID de controle criado automaticamente, clique em Editar e insira um novo ID de controle.
Na seção Seleção de produtos, escolha Recomendação.
Escolha Boost/bury controls como tipo de controle.
Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

Adicione filtros para atributos do produto no campo Boost/bury product.

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

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

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

Selecione as configurações de veiculação para 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 no corpo da solicitação.

Para detalhes do campo, consulte a Referência da API Controls e a Referência da API Controls.create.

Para criar uma expressão de filtro, use a sintaxe dela documentada em Recomendações de filtro.

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 exibição.

Criar um controle de filtros

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, digite um nome para o novo controle.
Opcional: para alterar o ID de controle criado automaticamente, clique em Editar e insira um novo ID de controle.
Escolha Controles de filtro como o tipo de controle.
Clique em "Continuar" para acessar a seção Gatilhos.

Na seção Gatilhos:

Selecione o tipo de comportamento do usuário que aciona esse controle:
- Procurar categorias: a regra é acionada quando um usuário navega por categorias no seu site (search.request.query está vazio).
- Pesquisa: a regra é acionada quando um usuário pesquisa no seu site (search.request.query não está vazio).
Opcional: defina uma condição de controle que acione a regra com base em qual categoria é procurada ou em qual consulta é pesquisada. A opção disponível depende da opção Procurar categorias ou Pesquisar:
- Se você escolheu Procurar categorias: no campo Categorias, insira as categorias que acionarão esse controle na navegação.
- Se você escolheu Pesquisar: clique no botão Adicionar consulta para incluir termos de consulta (por exemplo, running shoes) a serem filtrados e selecionar 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 de consulta.
  - Correspondência total: esse controle se aplica apenas quando uma consulta contém uma correspondência total para esse termo de consulta.
  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 será aplicado somente se as duas condições forem atendidas.
Opcional: clique no botão Adicionar período para incluir um ou mais períodos em que o controle pode ser aplicado.

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

Na seção Ações:

Adicione filtros dos atributos do produto no campo Ação do 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 acessar a seção Configurações de veiculação.

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

Selecione as configurações de veiculação para 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 no corpo da solicitação.

Para detalhes do campo, consulte a Referência da API Controls e a Referência da API Controls.create.

Um controle de filtro pode ser acionado quando um usuário navega por categorias no site (search.request.query está vazio) ou quando um usuário pesquisa no 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"
                    }
                  ]
                },
                "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, digite um nome para o novo controle.
Opcional: para alterar o ID de controle criado automaticamente, clique em Editar e insira um novo ID de controle.
Escolha Controles de redirecionamento como o tipo de controle.
Clique em "Continuar" para acessar a seção Gatilhos.

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

Selecione o tipo de comportamento do usuário que aciona esse controle:
- Procurar categorias: a regra é acionada quando um usuário navega por categorias no seu site (search.request.query está 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 acione a regra com base em qual categoria é procurada ou em qual consulta é pesquisada. A opção disponível depende da opção Procurar categorias ou Pesquisar:
- Se você escolheu Procurar categorias: no campo Categorias, insira as categorias que acionarão esse controle na navegação.
- Se você escolheu Pesquisar: clique no botão Adicionar consulta para incluir termos de consulta (por exemplo, running shoes) a serem filtrados e selecionar 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 de consulta.
  - Correspondência total: esse controle se aplica apenas quando uma consulta contém uma correspondência total para esse termo de consulta.
  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 será aplicado somente se as duas condições forem atendidas.
Clique no botão Adicionar período para incluir um ou mais períodos em que o controle pode ser aplicado.

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

Na seção Ações:

Insira o URI de redirecionamento 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 veiculação para 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 no corpo da solicitação.

Para detalhes do campo, consulte a Referência da API Controls e a Referência da API Controls.create.

Um controle de redirecionamento pode ser acionado quando um usuário navega por categorias no seu site (search.request.query está vazio) ou quando um usuário 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": {
                  "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 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 sinônimos bidirecional

Consulte Controles de sinônimos bidirecionais 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.
No campo Nome do controle, digite um nome para o novo controle.

O painel Criar controle é aberto.

Na seção Preferências:

Opcional: para alterar o ID de controle criado automaticamente, clique em Editar e insira um novo ID de controle.
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 períodos em que o controle pode ser aplicado.
Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

No campo Sinônimos, insira de 2 a 100 termos de consulta (por exemplo, shirt e top) que precisam ser sinônimos.

Quando qualquer um desses termos é incluído em uma consulta, a pesquisa considera os outros termos de consulta 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 veiculação para 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 no corpo da solicitação.

Para detalhes do campo, 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 unidirecionais

Consulte Controles de sinônimos unidirecionais 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, digite um nome para o novo controle.
Opcional: para alterar o ID de controle criado automaticamente, clique em Editar e insira um novo ID de controle.
Escolha Controle de sinônimos unidirecionais 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 períodos em que o 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, insira os termos (por exemplo, shoes) que precisam ter sinônimos associados quando algum deles for incluído em uma consulta.
No campo Sinônimos, insira termos que devem ser usados como sinônimos para os termos de consulta especificados (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 veiculação para 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 no corpo da solicitação.

Para detalhes do campo, 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"
                    }
                  ]
                },
                "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 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, digite um nome para o novo controle.
Opcional: para alterar o ID de controle criado automaticamente, clique em Editar e insira um novo ID de controle.
Escolha Não associar controle 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 períodos em que o 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, insira os termos (por exemplo, gShoe) que você quer diferenciar explicitamente de outros.
No campo Termos dissociados, insira os termos que não devem ser associados aos resultados da pesquisa aos termos de consulta especificados.

Por exemplo, é possível dissociar o termo de consulta gShoe do termo cheap.
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 veiculação para 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 no corpo da solicitação.

Para detalhes do campo, 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"
                    }
                  ]
                },
                "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 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 "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, digite um nome para o novo controle.
Opcional: para alterar o ID de controle criado automaticamente, clique em Editar e insira um novo ID de controle.
Escolha Não associar controle 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 períodos em que o controle pode ser aplicado.
Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

No campo Ignorar termos, insira os termos (por exemplo, shoddy) que você quer que a pesquisa ignore quando 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 veiculação para 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 no corpo da solicitação.

Para detalhes do campo, 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 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 substituição

Consulte Controles de substituição 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.

O painel Criar controle é aberto.

Na seção Preferências:

No campo Nome do controle, digite um nome para o novo controle.
Opcional: para alterar o ID de controle criado automaticamente, clique em Editar e insira um novo ID de controle.
Escolha Controle de substituição 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 períodos em que o 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, insira os termos de consulta (por exemplo, gShoe) que você quer substituir pelo termo substituto.
No campo Termo substituto, insira o termo que vai substituir os termos de consulta especificados.

Por exemplo, é possível substituir o termo de consulta gShoe pelo termo substituto Google Shoe.
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 veiculação para 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 no corpo da solicitação.

Para detalhes do campo, 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"
                    }
                  ]
                },
                "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 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.