Esta página foi traduzida pela API Cloud Translation.

Criar controles de veiculação

Esta página descreve como criar controles de veiculação.

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

Os controles de veiculação permitem criar regras que personalizam como as configurações de exibição exibem os resultados.

É possível criar um controle de veiculação no Console do Google Cloud que consiste em uma condição, que aciona o controle, e uma ação que ocorre quando a condição é acionada. Em seguida, é possível anexar o novo controle de exibição a uma configuração de exibição.

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

Ao criar controles e configurações de exibição, você seleciona um produto (Recommendations AI ou Retail Search) para o qual ele pode ser usado. Os controles de veiculação só podem ser associados a configurações de exibição do mesmo tipo de produto. Por exemplo, um controle de veiculação criado para o Recommendations AI não pode ser associado a uma configuração de veiculação criada para a Retail Search.

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 de 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 no gShoe" que impulsiona os resultados para a marca "gShoe" quando "pesquisa" "tênis" e um controle chamado "Mais tênis" que expande as consultas usando o termo "tênis para corrida" para incluir "tênis esportivos". Se você anexar apenas o controle "Promoção do gShoe" a uma configuração de exibição, as solicitações de pesquisa que usam essa configuração aumentarã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á anexado à configuração de exibição que você está usando.

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

Crie ou modifique os controles de veiculação a qualquer momento na página Controles ou in-line 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 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 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 Retail Search e Recommendations AI.
Filtro: remove os resultados que não passam no filtro da lista de resultados retornados. Disponível apenas para a Retail Search.
Redirecionar: redireciona seus usuários para uma página específica, dependendo da consulta de pesquisa. Disponível apenas para a Retail Search.
Linguística: personaliza a linguística da consulta de pesquisa. Disponível apenas para a pesquisa de varejo. 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 exemplos desses controles, consulte Sobre 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 novo controle de veiculação na página "Controles" no 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 para o 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ônimo de duas vias
Criar um controle de sinônimo unidirecional
Criar um controle de não associação
Criar um controle de 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 a Retail Search e Recommendations AI.

Criar um controle de otimização/ocultação da Pesquisa de varejo
Criar um controle de otimização/ocultação do Recommendations AI

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

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

Console

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

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, selecione Pesquisar.
Escolha Controles de otimização/ocultação 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 por categorias no seu site (search.request.query está vazio).
- Pesquisa: a regra é acionada quando um usuário pesquisa no site (search.request.query não está vazio).
Você pode definir categorias ou consultas específicas que podem acionar esse controle na etapa a seguir. Para definir que esse controle seja acionado quando qualquer categoria ou consulta for pesquisada, ignore a etapa a seguir.
Opcional: defina uma condição de controle que acionará a regra com base no fato de uma categoria específica ser procurada ou uma consulta específica ser pesquisada.

Para definir esse controle de disparo em qualquer categoria ou consulta, pule esta etapa.

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

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

Na seção Ações:

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

Na seção Configurações de exibiçã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 contida 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 em categorias no site (search.request.query está vazio) ou quando ele pesquisa (search.request.query não).

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 exibição, use o método ServingConfig.addControl:

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

Criar um controle de otimização/ocultação do Recommendations AI

Para criar um controle de otimização/ocultação do Recommendations AI:

Console

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

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, selecione Recomendação.
Escolha Controles de otimização/ocultação como o tipo de controle.
Clique em Continuar para acessar a seção Ações.

Na seção Ações:

Adicione filtros aos atributos do produto no campo Otimizar/ocultar produto.

Use a sintaxe de 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 exibiçã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 contida 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 de expressão de filtro 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 exibição, use o método ServingConfig.addControl:

Para mais informações sobre esse método, consulte a referência da API ServingConfig.addControl.
Para ver 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 de varejo no Console do Google Cloud.

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 Acionadores.

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 por categorias no seu site (search.request.query está vazio).
- Pesquisa: a regra é acionada quando um usuário pesquisa no site (search.request.query não está vazio).
Opcional: defina uma condição de controle que acione a regra com base na categoria pesquisada ou na consulta pesquisada. A opção disponível dependerá de você ter escolhido Procurar categorias ou Pesquisar:
- Se você escolheu Procurar categorias: no campo Categorias, insira quais categorias acionarão esse controle quando você navegar.
- Se você escolheu Pesquisar: clique no botão Adicionar consulta para adicionar os termos de consulta (por exemplo, running shoes) a serem filtrados e selecione uma das seguintes opções para cada termo:
  - Correspondência parcial: aplica-se quando uma consulta contém uma correspondência parcial com o termo da consulta.
  - Correspondência completa: esse controle se aplica somente quando uma consulta contém uma correspondência completa com esse termo.
  Quando um desses termos é incluído em uma consulta, o controle é aplicado.
Se você especificar uma condição de intervalo de tempo além dela, o controle será aplicado somente se ambas as condições forem atendidas.
Opcional: clique no botão Adicionar período para adicionar um ou mais períodos em que 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 será aplicado somente quando ambas as condições forem atendidas.
Clique em Continuar para acessar a seção Ações.

Na seção Ações:

Adicione filtros para atributos de produtos no campo Filtrar ação.

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 exibiçã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 contida 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 filtros pode ser acionado quando um usuário navega por categorias no seu site (search.request.query está vazio) ou quando um usuário pesquisa nele (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 exibição, use o método ServingConfig.addControl:

Para mais informações sobre esse método, consulte a referência da API ServingConfig.addControl.
Para ver 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 de varejo no Console do Google Cloud.

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 Acionadores.

Na seção Acionadores, crie pelo menos um termo de consulta ou um acionador de intervalo de tempo. 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 site (search.request.query não está vazio).
Defina uma condição de controle que acione a regra com base na categoria procurada ou na consulta que for pesquisada. A opção disponível dependerá de você ter escolhido Procurar categorias ou Pesquisar:
- Se você escolheu Procurar categorias: no campo Categorias, insira quais categorias acionarão esse controle quando você navegar.
- Se você escolheu Pesquisar: clique no botão Adicionar consulta para adicionar os termos de consulta (por exemplo, running shoes) a serem filtrados e selecione uma das seguintes opções para cada termo:
  - Correspondência parcial: aplica-se quando uma consulta contém uma correspondência parcial com o termo da consulta.
  - Correspondência completa: esse controle se aplica somente quando uma consulta contém uma correspondência completa com esse termo.
  Quando um desses termos é incluído em uma consulta, o controle é aplicado.
Se você especificar uma condição de intervalo de tempo além dela, o controle será aplicado somente se ambas as condições forem atendidas.
Clique no botão Adicionar período para incluir um ou mais períodos em que 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 será aplicado somente quando ambas as condições forem atendidas.
Clique em Continuar para acessar 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 exibiçã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 contida 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 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 exibição, use o método ServingConfig.addControl:

Para mais informações sobre esse método, consulte a referência da API ServingConfig.addControl.
Para ver 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 de varejo no Console do Google Cloud.

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 Acionadores.

Na seção Acionadores:

Opcional: clique no botão Adicionar período para adicionar um ou mais períodos em que esse controle pode ser aplicado.
Clique em Continuar para acessar 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 algum desses termos é incluído em uma consulta, a pesquisa considera os outros termos como sinônimos.
Clique em Continuar para acessar a seção Configurações de veiculação.

Na seção Configurações de exibiçã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 contida 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 exibição, use o método ServingConfig.addControl. Consulte Adicionar controles para exibir configurações in-line.

Criar um controle de sinônimos unidirecional

Consulte Controles de sinônimos unidirecionais para saber mais sobre esse tipo de controle.

Console

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

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 Acionadores.

Na seção Acionadores:

Opcional: clique no botão Adicionar período para adicionar um ou mais períodos em que esse controle pode ser aplicado.
Clique em Continuar para acessar a seção Ações.

Na seção Ações:

No campo Termos de consulta, insira termos (por exemplo, shoes) que precisam ter sinônimos associados quando algum deles é 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 exibiçã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 contida 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 exibição, use o método ServingConfig.addControl:

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

Criar um controle de não associação

Consulte Controles de não associar para saber mais sobre esse tipo de controle.

Console

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

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 o controle como o tipo de controle.
Clique em "Continuar" para acessar a seção Acionadores.

Na seção Acionadores:

Opcional: clique no botão Adicionar período para adicionar um ou mais períodos em que esse controle pode ser aplicado.
Clique em Continuar para acessar 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 claramente dos outros.
No campo Termos dissociados, digite termos que não devem ser associados nos resultados da pesquisa com os termos da consulta que você especificou.

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 exibiçã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 contida 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 exibição, use o método ServingConfig.addControl:

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

Criar um controle de ignorar

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

Console

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

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 o controle como o tipo de controle.
Clique em "Continuar" para acessar a seção Acionadores.

Na seção Acionadores:

Opcional: clique no botão Adicionar período para adicionar um ou mais períodos em que esse controle pode ser aplicado.
Clique em Continuar para acessar a seção Ações.

Na seção Ações:

No campo Ignorar termos, insira termos (por exemplo, shoddy) que você quer que uma 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 exibiçã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 contida 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 exibição, use o método ServingConfig.addControl:

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

Criar um controle de substituição

Consulte Controles de substituição para saber mais sobre esse tipo de controle.

Console

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

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 Acionadores.

Na seção Acionadores:

Opcional: clique no botão Adicionar período para adicionar um ou mais períodos em que esse controle pode ser aplicado.
Clique em Continuar para acessar 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 de substituição.
No campo Termo de substituição, insira o termo que deve substituir os termos de consulta que você especificou.

Por exemplo, é possível substituir o termo de consulta gShoe pelo termo de substituição Google Shoe.
Clique em Continuar para acessar a seção Configurações de veiculação.

Na seção Configurações de exibiçã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 contida 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 exibição, use o método ServingConfig.addControl:

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