Esta é a documentação do Recommendations AI, da Pesquisa de varejo e do novo Console do Retail.

Criar e gerenciar controles

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

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

Controles de veiculação

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

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

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

As configurações de exibição gerenciam quais controles podem ser aplicados. Somente os controles na configuração de exibição ativa para uma solicitação são considerados no momento da veiculação.

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

Crie ou modifique os controles de exibição a qualquer momento na página Controles 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é mil controles de veiculação. Uma configuração de exibição pode ter até 100 controles de exibição de qualquer tipo, além dos controles de redirecionamento, cujo limite é 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.
  • Filtro: remove os resultados que não passam no filtro da lista de resultados retornados.
  • Redirecionar: redireciona seus usuários para uma página específica, dependendo da consulta de pesquisa.
  • Linguística: personaliza a linguística da consulta de pesquisa. Vários tipos de controle linguístico estão disponíveis:
    • Sinônimo: expande os sinônimos considerados para uma consulta de pesquisa.
    • Sinônimo unidirecional: expande os sinônimos considerados unidirecionalmente para termos específicos.
    • Não associar: impede que um grupo de termos seja usado na pesquisa quando termos específicos aparecem.
    • Ignorar: impede que um termo seja usado em pesquisas.
    • Substituição: substitui termos na consulta de pesquisa.

Para ver exemplos desses controles, consulte Controles de exibição.

Tutorial de controle de redirecionamento

Neste tutorial, mostramos como usar o controle de redirecionamento.


Para orientações passo a passo sobre esta tarefa diretamente no editor do Cloud Shell, clique em Orientações:

Orientação


As seções a seguir guiam você pelas mesmas etapas que você encontra clicando em Orientações.

Criar um novo controle de exibição

Crie um novo controle de exibiçã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 escolher o tipo de controle que você pretende criar:

Criar um controle de otimização

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

Console

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

    Acessar a página "Controles"

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

    O painel Criar controle é aberto.

Na seção Preferências:

  1. No campo Nome de controle, insira um nome para seu novo controle.

  2. (Opcional) Para alterar o ID de controle criado automaticamente, clique em Editar no campo Nome de controle e insira um novo ID de controle.

  3. Escolha Boost/bury controls como tipo de controle.

  4. Clique em "Continuar" para avançar para a seção Acionadores.

Na seção Gatilhos:

  1. (Opcional) Clique no botão Adicionar consulta para incluir termos de consulta (por exemplo, running shoes) que serão otimizados ou ocultados e selecione uma das seguintes opções para cada termo:

    • Correspondência parcial: este controle se aplica quando uma consulta contém uma correspondência parcial com esse termo.
    • Correspondência completa: este controle só se aplica quando uma consulta contém uma correspondência completa para esse termo.

      Quando um desses termos for incluído em uma consulta, o controle será aplicado.

    Se você especificar uma condição de período além dela, o controle será aplicado somente se as duas condições forem atendidas.

  2. (Opcional) 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 termo de consulta além desta do período, o controle será aplicado somente quando as duas condições forem atendidas.

  3. Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

  1. Adicione filtros para atributos de 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"))

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

  3. Clique em Continuar para prosseguir para a seção Configurações de exibição.

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

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

  2. 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 sobre 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": {
                  "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. Consulte Adicionar controles às configurações de exibição in-line.

Criar um controle de filtros

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

Console

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

    Acessar a página "Controles"

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

    O painel Criar controle é aberto.

Na seção Preferências:

  1. No campo Nome de controle, insira um nome para seu novo controle.

  2. (Opcional) Para alterar o ID de controle criado automaticamente, clique em Editar no campo Nome de controle e insira um novo ID de controle.

  3. Escolha Controles de filtros como o tipo de controle.

  4. Clique em "Continuar" para avançar para a seção Acionadores.

Na seção Gatilhos:

  1. (Opcional) Clique no botão Adicionar consulta para incluir os termos da consulta (por exemplo, running shoes) a serem filtrados e selecione uma das seguintes opções para cada termo:

    • Correspondência parcial: este controle se aplica quando uma consulta contém uma correspondência parcial com esse termo.
    • Correspondência completa: este controle só se aplica quando uma consulta contém uma correspondência completa para esse termo.

    Quando um desses termos for incluído em uma consulta, o controle será aplicado.

    Se você especificar uma condição de período além dela, o controle será aplicado somente se as duas condições forem atendidas.

  2. (Opcional) 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 termo de consulta além desta do período, o controle será aplicado somente quando as duas condições forem atendidas.

  3. Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

  1. Adicione filtros para os atributos do produto no campo Filtro de 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"))

  2. Clique em Continuar para prosseguir para a seção Configurações de exibição.

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

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

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

Este exemplo mostra campos de um

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": {
                  "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"
                    }
                  ]
                },
                "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. Consulte Adicionar controles às configurações de exibição in-line.

Criar um controle de redirecionamento

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

Console

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

    Acessar a página "Controles"

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

    O painel Criar controle é aberto.

Na seção Preferências:

  1. No campo Nome de controle, insira um nome para seu novo controle.

  2. (Opcional) Para alterar o ID de controle criado automaticamente, clique em Editar no campo Nome de controle e insira um novo ID de controle.

  3. Escolha Controles de redirecionamento como o tipo de controle.

  4. Clique em "Continuar" para avançar para a seção Acionadores.

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

  1. Clique no botão Adicionar consulta para incluir os termos da consulta (por exemplo, running shoes) a serem filtrados e selecione uma das seguintes opções para cada termo:

    • Correspondência parcial: este controle se aplica quando uma consulta contém uma correspondência parcial com esse termo.
    • Correspondência completa: este controle só se aplica quando uma consulta contém uma correspondência completa para esse termo.

    Quando um desses termos for incluído em uma consulta, o controle será aplicado.

    Se você especificar uma condição de período além dela, o controle será aplicado somente se as duas condições forem atendidas.

  2. 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 termo de consulta além desta do período, o controle será aplicado somente quando as duas condições forem atendidas.

  3. Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

  1. Insira o URI para redirecionar quando o controle for acionado.

  2. Clique em Continuar para prosseguir para a seção Configurações de exibição.

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

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

  2. 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 sobre 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": {
                  "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. Consulte Adicionar controles às configurações de exibição in-line.

Criar um controle de sinônimo bidirecional

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

Console

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

    Acessar a página "Controles"

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

  3. No campo Nome de controle, insira um nome para seu novo controle.

    O painel Criar controle é aberto.

Na seção Preferências:

  1. (Opcional) Para alterar o ID de controle criado automaticamente, clique em Editar no campo Nome de controle e insira um novo ID de controle.

  2. Escolha Controle de sinônimo bidirecional como o tipo de controle.

  3. Clique em "Continuar" para avançar para a seção Acionadores.

Na seção Gatilhos:

  1. (Opcional) Clique no botão Adicionar período para incluir um ou mais períodos em que esse controle pode ser aplicado.

  2. Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

  1. 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 for incluído em uma consulta, a pesquisa considerará os outros termos como sinônimos.

  2. Clique em Continuar para prosseguir para a seção Configurações de exibição.

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

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

  2. 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 sobre 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 exibição, use o método ServingConfig.addControl. Consulte Adicionar controles às configurações de exibição in-line.

Criar um controle de sinônimos unidirecional

Consulte Controles de sinônimo unidirecional para saber mais sobre esse tipo de controle.

Console

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

    Acessar a página "Controles"

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

    O painel Criar controle é aberto.

Na seção Preferências:

  1. No campo Nome de controle, insira um nome para seu novo controle.

  2. (Opcional) Para alterar o ID de controle criado automaticamente, clique em Editar no campo Nome de controle e insira um novo ID de controle.

  3. Escolha Controle de sinônimo unidirecional como o tipo de controle.

  4. Clique em "Continuar" para avançar para a seção Acionadores.

Na seção Gatilhos:

  1. (Opcional) Clique no botão Adicionar período para incluir um ou mais períodos em que esse controle pode ser aplicado.

  2. Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

  1. No campo Termos de consulta, insira termos (por exemplo, shoes) que precisam ter sinônimos associados a eles quando qualquer um deles for incluído em uma consulta.

  2. No campo Sinônimos, insira termos que precisam ser usados como sinônimos para os termos de consulta especificados (por exemplo, sneakers e sandals como sinônimos unilaterais para o termo de consulta shoes).

  3. Clique em Continuar para prosseguir para a seção Configurações de exibição.

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

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

  2. 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 sobre 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"
                    }
                  ]
                },
                "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. Consulte Adicionar controles às configurações de exibição in-line.

Criar um controle de não associação

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

Console

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

    Acessar a página "Controles"

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

    O painel Criar controle é aberto.

Na seção Preferências:

  1. No campo Nome de controle, insira um nome para seu novo controle.

  2. (Opcional) Para alterar o ID de controle criado automaticamente, clique em Editar no campo Nome de controle e insira um novo ID de controle.

  3. Escolha Não associar o controle como o tipo de controle.

  4. Clique em "Continuar" para avançar para a seção Acionadores.

Na seção Gatilhos:

  1. (Opcional) Clique no botão Adicionar período para incluir um ou mais períodos em que esse controle pode ser aplicado.

  2. Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

  1. No campo Termos de consulta, insira termos (por exemplo, gShoe) que você quer diferenciar explicitamente de outras pessoas.

  2. No campo Termos removidos, insira termos que não devem ser associados a resultados de pesquisa com os termos especificados.

    Por exemplo, é possível desassociar o termo de consulta gShoe do termo cheap.

  3. Clique em Continuar para prosseguir para a seção Configurações de exibição.

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

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

  2. 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 sobre 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"
                    }
                  ]
                },
                "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. Consulte Adicionar controles às configurações de exibição in-line.

Criar um controle para ignorar

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

Console

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

    Acessar a página "Controles"

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

    O painel Criar controle é aberto.

Na seção Preferências:

  1. No campo Nome de controle, insira um nome para seu novo controle.

  2. (Opcional) Para alterar o ID de controle criado automaticamente, clique em Editar no campo Nome de controle e insira um novo ID de controle.

  3. Escolha Não associar o controle como o tipo de controle.

  4. Clique em "Continuar" para avançar para a seção Acionadores.

Na seção Gatilhos:

  1. (Opcional) Clique no botão Adicionar período para incluir um ou mais períodos em que esse controle pode ser aplicado.

  2. Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

  1. No campo Ignorar termos, digite termos (por exemplo, shoddy) que você quer que uma pesquisa ignore quando eles forem inseridos como termos de consulta.

  2. Clique em Continuar para prosseguir para a seção Configurações de exibição.

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

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

  2. 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 sobre 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 exibição, use o método ServingConfig.addControl. Consulte Adicionar controles às configurações de exibição in-line.

Criar um controle de substituição

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

Console

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

    Acessar a página "Controles"

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

    O painel Criar controle é aberto.

Na seção Preferências:

  1. No campo Nome de controle, insira um nome para seu novo controle.

  2. (Opcional) Para alterar o ID de controle criado automaticamente, clique em Editar no campo Nome de controle e insira um novo ID de controle.

  3. Escolha Controle de substituição como o tipo de controle.

  4. Clique em "Continuar" para avançar para a seção Acionadores.

Na seção Gatilhos:

  1. (Opcional) Clique no botão Adicionar período para incluir um ou mais períodos em que esse controle pode ser aplicado.

  2. Clique em Continuar para prosseguir para a seção Ações.

Na seção Ações:

  1. No campo Termos de consulta, insira termos de consulta (por exemplo, gShoe) que você queira substituir pelo termo de substituição.

  2. No campo Termo de substituição, insira o termo que deve substituir os termos de consulta especificados.

    Por exemplo, é possível substituir o termo de consulta gShoe pelo termo de substituição Google Shoe.

  3. Clique em Continuar para prosseguir para a seção Configurações de exibição.

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

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

  2. 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 sobre 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"
                    }
                  ]
                },
                "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. Consulte Adicionar controles às configurações de exibição in-line.

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

Ver e editar controles de veiculação

É possível visualizar os controles de exibição usando o Retail Console ou a Retail API.

Visualizar e editar controles de exibição no console

A guia Controles de veiculação da página "Controles" lista todos os controles de exibição e as configurações de exibição associadas a eles. Clique no ícone Editar controle para um controle mudar as configurações e as configurações de exibição associadas no painel Editar controle. Clique no ícone Excluir controle para um controle que o excluir, o que também o removerá de todas as configurações de exibição.

Também é possível ver e editar os controles de uma configuração de exibição específica na página Configurações de exibição. Clique em uma configuração de exibição para ver a página Detalhes, que lista todos os controles de exibição dessa configuração. Clique no ícone Editar controle para um controle mudar as configurações no painel Editar controle. Clique no ícone Remover controle para desinserir o controle da configuração de exibição. Isso não exclui o 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.

Ver controles de exibição in-line

Para ver um único controle de veiculação in-line, use Control.get.

Para mais informações sobre esse método, consulte a referência da API Control.get.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID'

Para listar vários controles de veiculação in-line, use Controls.list.

Opcionalmente, use o parâmetro pageSize para definir um número máximo de resultados a serem retornados. Se mais resultados estiverem disponíveis, a resposta de list incluirá um token de página. Você pode transmitir um token de página no parâmetro pageToken de uma solicitação list para recuperar a próxima página de resultados.

Para listar somente os controles associados a uma determinada configuração de exibição, use o parâmetro de consulta filter para especificar o ID de configuração de exibição.

Para mais informações sobre esse método, consulte a referência da API Control.list.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=servingConfig=SERVING_CONFIG_ID

Aplicar patch aos controles de veiculação inline

Para atualizar campos em um controle de exibição, use Controls.patch e inclua uma instância de Control no corpo da solicitação. Especifique os campos a serem atualizados com o parâmetro updateMask ou deixe-os indefinidos para atualizar todos os campos compatíveis.

Para mais informações sobre esse método, consulte a referência da API Controls.patch.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID",
      "FIELD_NAME_1": "NEW_FIELD_VALUE_1"
      "FIELD_NAME_2": "NEW_FIELD_VALUE_2"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

Adicionar controles às configurações de exibição in-line

Para adicionar um controle a uma configuração de exibição, use 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.

Remover controles das configurações de exibição inline

Para remover um controle de uma configuração de exibição, use ServingConfig.removeControl.

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.

Excluir um controle de exibição

Use o método Controls.delete para excluir um controle de exibição do console ou in-line.

Excluir um controle de exibição no console

Exclua um controle de exibição para removê-lo de todas as configurações de exibição que o estão usando.

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

    Acessar a página "Controles"

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

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

Excluir um controle de veiculação in-line

Para excluir controles de exibição in-line, use Controls.delete.

Para mais informações sobre esse método, consulte a referência da API Controls.delete.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/SERVING_CONTROL_ID'

Controles para todo o site

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

Controles de atributos

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

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

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

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

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

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

Para detalhes sobre as configurações de atributos e quais são as configurações padrão e permitidas, consulte o tópico Configurar atributos.

Definir controles de atributos para todo o site

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

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

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

    Acessar a página "Controles"

  2. Acesse a guia Controles em todo o site.

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

  3. Clique em Modificar controles.

  4. Ativar ou desativar um controle.

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

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

  5. Clique em Salvar controles.

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