Crie controlos de publicação

Esta página descreve como criar controlos de publicação.

Os controlos de publicação são regras que define e aplica a configurações de publicação individuais.

Pode criar um controlo de publicação na consola de pesquisa para comércio composto por uma condição, que aciona o controlo, e uma ação que ocorre quando a condição é acionada. Em seguida, pode anexar o novo controlo de publicação a uma configuração de publicação.

Relação entre os controlos e as configurações de publicação

As configurações de publicação têm uma relação de muitos-para-muitos com os controlos. Pode adicionar vários controlos a uma configuração de publicação e um único controlo pode ser associado a várias configurações de publicação.

Quando cria controlos de publicação e configurações de publicação, seleciona um produto (recomendações ou pesquisa) para o qual o controlo pode ser usado.

Os controlos de publicação só podem ser associados a configurações de publicação do mesmo tipo de produto. Por exemplo, um controlo de publicação criado para recomendações não pode ser associado a uma configuração de publicação criada para a pesquisa.

As configurações de publicação gerem os controlos que são aplicados durante uma pesquisa ou um pedido de previsão. Apenas os controlos na configuração de publicação ativa para um pedido são considerados no momento da publicação. Por exemplo, suponhamos que criou dois controlos: um controlo denominado gShoe Sale que aumenta os resultados da marca gShoe quando se pesquisa sapatos e um controlo denominado Mais sapatos que expande as consultas com o termo sapatos de corrida para incluir sapatos desportivos. Se anexar apenas o controlo gShoe Sale a uma configuração de publicação, os pedidos de pesquisa que usam essa configuração de publicação aumentam os resultados do gShoe para consultas que usam o termo sapatos,mas o controlo Mais sapatos não tem efeito porque não está anexado à configuração de publicação que está a usar.

Para mais informações, consulte o artigo Acerca das configurações de publicação.

Vídeos e guias de início rápido

• Introdução aos controlos de publicação: os controlos de publicação permitem-lhe criar regras que personalizam a forma como as suas configurações de publicação devolvem resultados da pesquisa.
• Realçar/ocultar: afeta a classificação e a ordem dos resultados na lista de resultados devolvidos. Disponível para pesquisa e recomendações.
• Filter: remove os resultados que não passam o filtro da lista de resultados devolvida. Disponível apenas para pesquisa.
• Redirecionamento: redireciona os utilizadores para uma página específica consoante a consulta de pesquisa. Disponível apenas para pesquisa.

Este tutorial mostra como usar o controlo de redirecionamento.

---

Para seguir orientações passo a passo para esta tarefa diretamente no editor do Cloud Shell, clique em Orientar-me:

Visita guiada

---

• Linguístico: personaliza a linguística da consulta de pesquisa. Disponível apenas para pesquisa.
  Estão disponíveis vários tipos de controlos linguísticos:
  • 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: impeça a utilização de um grupo de termos na pesquisa quando aparecem termos específicos.
  • Ignorar: impede que um termo seja usado em pesquisas.
  • Substituição: substitui termos na consulta de pesquisa.
• Fixação: afeta a ordenação dos resultados, colocando um resultado numa posição específica, por exemplo, na posição 4. Disponível para pesquisa e navegação.

Para ver exemplos destes controlos, consulte o artigo Acerca dos controlos de publicação.

Nota: não recomendamos a criação de encadeamentos nem controlos em conflito. O Vertex AI Search for commerce não suporta a execução de controlos numa ordem predeterminada.

Opções de configuração do controlo da publicação

Pode criar controlos e, em seguida, adicioná-los ou trocá-los numa configuração de publicação em direto.

Pode criar até 100 controlos de publicação. Se precisar de mais controlos de publicação, peça uma quota adicional. Para saber como pedir quota adicional, consulte o artigo Aumente as suas quotas. Uma configuração de publicação pode ter até 100 controlos de publicação de qualquer tipo, exceto controlos de redirecionamento, cujo limite é de 1000 por configuração de publicação.

Nota: existe um atraso de cinco minutos entre o momento em que um controlo é anexado e o momento em que fica pronto para utilização na publicação. A página de pré-visualização e os pedidos de pesquisa vão refletir este atraso.

Pode criar um controlo de publicação das seguintes formas:

• Na página Controlos naGoogle Cloud consola: aqui, pode criar opcionalmente controlos durante o processo de criação da configuração de publicação.

• Pode usar a consola de merchandising.

• Pode criar um controlo de publicação inline através do método Controls.create.

Use a Google Cloud consola

Para usar a Google Cloud consola para criar controlos de publicação:

1. Aceda à página Controlos na consola de pesquisa para comércio.
   
   Aceda à página Controlos

2. Siga os Google Cloud passos da consola em cada secção de controlo da publicação.

Use a consola de merchandising

A consola de merchandising é uma ferramenta concebida para os comerciantes criarem e administrarem controlos. Oferece um fluxo de aprovação para que todos os comerciantes possam propor todos os controlos e os aprovadores de comerciantes possam revê-los.

A consola de merchandising ajuda a criar controlos de publicação, como fixação, realce/ocultação, sinónimos e facetas. A consola de merchandising apresenta uma interface intuitiva que permite aos comerciantes criar e gerir controlos de forma eficiente. Esta ferramenta também facilita um processo de aprovação, permitindo que qualquer comerciante proponha controlos e que os aprovadores de comerciantes os revejam.

Em Google Cloud, para aceder ao separador da consola de merchandising, tem de ter, no mínimo, as seguintes autorizações:

• Leitor do projeto (leitor): para aceder ao projeto.
• Editor de retalho: para editar e guardar as definições da consola de merchandising.

Use a consola como administrador

Antes de começar, tem de ser um Google Cloud administrador para integrar utilizadores na consola de merchandising.

Em seguida, inicialize a consola de merchandising acedendo ao separador da consola de merchandising na Google Cloud consola:

Separador da consola de merchandising

Precisa destas funções de IAM para aceder, editar e atribuir funções de criador ou aprovador a um utilizador da consola de merchandising:

• Para editar a consola de merchandising, é necessária, pelo menos, a função de Editor de retalho.
• Para atribuir funções de criador ou aprovador a um utilizador, é necessária uma função de administrador do IAM ao nível do projeto.

Nota: um editor de retalho com essa função de administrador de IAM não pode promover-se a um privilégio de acesso superior.

Para ver um esquema completo das autorizações do IAM ao nível do projeto e do Vertex AI Search para comércio, consulte a secção [Funções de administrador predefinidas](/retail/docs/iam#roles) nesta documentação do [produto Vertex AI Search para comércio](/retail/docs/iam).

Integre utilizadores da consola de merchandising

Se for um Google Cloud administrador da consola, para dar aos comerciantes do site acesso à consola de merchandising e atribuir-lhes a função de criador ou aprovador:

1. Aceda à página Controlos na consola de pesquisa para comércio.
   
   Aceda à página Controlos
2. Navegue para o separador Consola de merchandising.
3. Pode ver o URL exclusivo da consola de merchandising associada ao Google Cloud projeto atual. Copie o link ou abra-o diretamente na Google Cloud consola.
4. Selecione a configuração de publicação predefinida que os comerciantes vão usar para pré-visualizar e anexar controlos aprovados.
5. Atribua aos utilizadores as funções de Aprovador ou Criador.
6. Pode ver o URL exclusivo da consola de merchandising associada ao projeto Google Cloud atual. Copie o link ou abra-o diretamente na Google Cloud consola.
7. Selecione a configuração de publicação predefinida para a Pré-visualização na consola de Merchandising.
8. (Opcional) Edite o acesso à consola de merchandising através destas funções:
• Adicione utilizadores: conceda aos utilizadores acesso de Aprovador ou Criador à consola de merchandising.
• Eliminar utilizadores: revogue o acesso à consola de merchandising eliminando aprovadores ou criadores.
9. Adicione emails de aprovadores. Para cada controlo enviado pelos comerciantes, a lista de emails dos aprovadores recebe um email para rever e aprovar este controlo.

Aceda à consola como utilizador

Se lhe foi concedido acesso com o URL, tem a opção de usar a consola de merchandising em vez da consola Google Cloud padrão. Para criar controlos através da consola de merchandising:

1. Inicie sessão com as credenciais que o seu administrador lhe fornece.
2. Siga os passos da documentação da consola de merchandising em cada secção de controlo de publicação.
3. Após o envio, recebe um email de notificação com o assunto [Merchant Console] Proposed control awaiting review.
4. Enquanto aprovador, pode aceitar, recusar ou alterar o pedido de controlo.

Use a consola como comerciante do site

Siga estes passos para começar a usar a consola de merchandising como merchandiser do site.

1. Defina o fluxo de aprovação para perguntas.
1. Navegue para a parte Definições do menu principal.
2. Por predefinição, é definida uma lista predefinida de perguntas no ecrã Definir o objetivo.



Perguntas sobre a consola de merchandising

3. Adicione uma pergunta clicando em Adicionar pergunta para ajudar os aprovadores a compreender a finalidade dos novos controlos.
4. Clique em Guardar para guardar as perguntas.
2. Crie um controlo.
1. Aceda à secção Controlos.
2. Clique em Criar controlo.
3. Defina o objetivo: tem de responder a todas as perguntas definidas anteriormente. Se ainda não tiver definido nenhuma pergunta, este ecrã não é apresentado.
4. Selecione um controlo. Especifique o tipo de controlo e atribua um nome ao controlo.
5. Definir regras: para cada regra, pode definir acionadores e ações.
6. Defina Acionadores: o objetivo é estabelecer quando aplicar este controlo.
• Termos de consulta: esta regra pode ser acionada quando a sua consulta de pesquisa contém ou corresponde exatamente a termos específicos. Pode definir estes termos de consulta.
• Intervalos de tempo aplicáveis: podem ser aplicadas restrições de tempo para confinar a ativação desta regra a períodos específicos.



Definir acionadores

7. Defina ações: consoante o tipo de controlo, pode definir ações, como o ID do artigo e a posição para um controlo de fixação.
8. Pré-visualizar uma regra: pode ver uma pré-visualização dinâmica da regra no ecrã.
9. Enviar uma regra: depois de clicar em Enviar para enviar o conjunto de regras definido pelo comerciante, pode ver o controlo como Pendente na lista de controlos.
3. Aprove um controlo
1. Para conceder aprovação a um controlo, clique no ícone Mais junto ao controlo na lista de controlos. Selecione Rever.
2. É apresentado um ecrã para o controlo em questão,onde pode Aprovar,Recusar ou Aprovar com edições.
3. Após a aprovação, é feito o redirecionamento para a página da lista de controlos que apresenta o controlo como Aprovado.

   

   Fases de merchandising da consola

Tipos de controlos

Os controlos têm requisitos diferentes consoante o respetivo tipo. Aceda ao procedimento de criação do tipo de controlo que planeia criar:

• Crie um controlo de realce/ocultação
• Crie um controlo de filtros
• Crie um controlo de redirecionamento
• Crie um controlo de fixação
• Crie um controlo de sinónimos bidirecional
• Crie um controlo de sinónimos unidirecional
• Crie um controlo de não associação
• Crie um controlo de ignorar
• Crie um controlo de substituição

Crie um controlo de realce/ocultação

Este tipo de controlo está disponível para a pesquisa e as recomendações.

• Crie um controlo de aumento/diminuição da pesquisa
• Crie um controlo de aumento/ocultação de recomendações

Consulte a secção Controlos de realce/ocultação para saber mais sobre este tipo de controlo.

Crie um controlo de aumento/ocultação de pesquisas

Para criar um controlo de aumento/ocultação de pesquisas:

Consola de merchandising

1. Clique no URL fornecido pelo administrador. Inicie sessão.

   Esta ação direciona para a página Controlos na consola de merchandising.

2. Clique em Criar controlo.

3. Defina os objetivos para os utilizadores finais e o tempo necessário. Tem de responder a todas as perguntas. Clicar em Seguinte.

4. Selecione um controlo. Introduza o nome do controlo, selecione o produto Pesquisa e, de seguida, escolha o tipo de controlo Realçar/Ocultar.

5. Configure o controlo Aumentar/Ocultar:

   1. Em Acionadores, defina o que aciona este controlo atribuindo critérios a uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se não tiver sido configurado nenhum atributo do catálogo, este controlo é sempre aplicado.

   2. Defina um Intervalo de tempo aplicável introduzindo um Intervalo de datas. Se algum dos intervalos de tempo especificados for cumprido, o atributo do catálogo vai ser correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um intervalo de tempo com Adicionar intervalo de tempo.

   3. Defina as ações de realce/ocultação que quer acionar com este controlo. Estas ações são definidas por um atributo do catálogo, como cores, um critério, como contém, e um valor, como vermelho.

   4. Clique em Adicionar atributo para adicionar mais atributos.

6. Use o controlo de deslize para definir o valor de realce/ocultação. Os números negativos são bury e os números positivos são boost.

7. Clique em Enviar para enviar o seu pedido de controlo a um aprovador. Pode ver o estado dos pedidos enviados na consola de merchandising. Se mudar de ideias, pode eliminar o pedido de controlo.

Passos do aprovador

1. Em Configurações de publicação,atribua o controlo à configuração de publicação existente.
2. Aprove o pedido de um controlo de realce/ocultação.

Cloud Console

1. Aceda à página Controlos na consola de pesquisa para comércio.
   
   Aceda à página Controlos

2. No separador Controlos de publicação, clique em Criar controlo.

   É aberto o painel Criar controlo.

3. Na secção Preferências, no campo Nome do controlo, introduza um nome para o novo controlo.

4. Opcional: para alterar o ID do controlo criado automaticamente, clique em Editar e introduza um novo ID do controlo.

5. Na secção Seleção de produtos, selecione Pesquisar.

6. Escolha Controlos de realce/ocultação como o tipo de controlo. Clique em Continuar.

7. Na secção Acionadores, selecione o tipo de comportamento do utilizador que aciona este controlo.

   • Procurar categorias: a regra é acionada quando um utilizador procura categorias no seu site (search.request.query está vazio).

   • Pesquisa: a regra é acionada quando um utilizador pesquisa no seu site (search.request.query não está vazio). Para definir este controlo para ser acionado quando qualquer categoria é procurada ou qualquer consulta é pesquisada, ignore o passo seguinte.

8. Opcional: defina categorias ou consultas específicas que podem acionar este controlo consoante uma categoria específica seja explorada ou uma consulta específica seja pesquisada.

   • Se escolheu Procurar categorias: no campo Categorias, introduza as categorias que vão acionar este controlo quando forem procuradas.

   • Se escolheu Pesquisa: clique no botão Adicionar consulta para adicionar termos de consulta (por exemplo, running shoes) a filtrar. Para cada termo, escolha Correspondência parcial ou Correspondência total.

   Nota: se especificar uma condição de categoria ou termo de consulta, além de condições de intervalo de tempo, o controlo só é aplicado quando ambas as condições são cumpridas.

9. Opcional: clique no botão Adicionar intervalo de tempo para adicionar um ou mais intervalos de tempo durante os quais este controlo pode ser aplicado.

   Nota: se especificar condições de intervalo de tempo além deste tipo de condição, o controlo só é aplicado se ambas as condições forem cumpridas.

10. Clique em Continuar para avançar para a secção Ações.

11. Adicione filtros para atributos de produtos no campo Realçar/ocultar produto.

    Use a sintaxe de expressão de filtro documentada em Filtragem e ordenação. Por exemplo, para especificar as versões vermelha e azul de "product1" e "product2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

12. Para o Valor de amplificação/ocultação, use o controlo de deslize para definir a intensidade da amplificação. Os valores positivos melhoram os resultados e os valores negativos ocultam-nos. Clique em Continuar.

13. Na secção Configurações de publicação, selecione a que configurações de publicação quer aplicar o controlo.

14. Envie as definições de controlo.

    Demora alguns minutos até que os controlos criados ou atualizados recentemente estejam prontos para publicar tráfego em direto. Pode testar se as alterações foram aplicadas na página Avaliar da consola.

Agora, pode encontrar o novo controlo indicado no separador Controlos de publicação da página Controlos.

curl

Faça um pedido Control.create com um ID de controlo e uma instância de Control contida no corpo do pedido.

Para ver detalhes dos campos, consulte a Controls referência da API e a Controls.create referência da API.

Um controlo de realce/ocultação pode ser acionado quando um utilizador procura categorias no seu site (search.request.query está vazio) ou quando um utilizador pesquisa no seu site (search.request.query não está vazio).

O exemplo seguinte mostra os campos de um controlo acionado pela navegação, em que searchSolutionUseCase está 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 seguinte mostra os campos de um controlo acionado pela pesquisa, em que searchSolutionUseCase está 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"
  

Demora alguns minutos até que os controlos criados ou atualizados recentemente estejam prontos para publicar tráfego em direto. Pode testar se as alterações foram aplicadas na página Avaliar da consola.

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

• Para mais informações sobre este método, consulte a ServingConfig.addControl referência da API.

• Para ver um exemplo deste método, consulte o artigo Gerir configurações de publicação.

Crie um controlo de impulso/ocultação de recomendações

Pré-visualização

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Para criar um controlo de aumento/ocultação de recomendações:

Consola de merchandising

1. Clique no URL fornecido pelo administrador. Inicie sessão.

   Esta ação direciona para a página Controlos na consola de merchandising.

2. Clique em Criar controlo.

3. Defina os objetivos para os utilizadores finais e o tempo necessário. Tem de responder a todas as perguntas. Clicar em Seguinte.

4. Selecione um controlo. Introduza o nome do controlo, selecione o produto Procurar e, de seguida, escolha o tipo de controlo Aumentar/Diminuir.

5. Configure o controlo Aumentar/Ocultar:

   1. Em Acionadores, introduza as categorias de páginas que devem acionar o controlo. Se não estiverem configurados atributos do catálogo, este controlo está sempre em vigor.

   2. Defina um Intervalo de tempo aplicável introduzindo um Intervalo de datas. Se algum dos intervalos de tempo especificados for cumprido, o atributo do catálogo vai ser correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um intervalo de tempo com Adicionar intervalo de tempo.

   3. Defina as ações de realce/ocultação que quer acionar com este controlo. Estas ações são definidas por um atributo do catálogo, como cores, um critério, como contém, e um valor, como vermelho.

   4. Clique em Adicionar atributo para adicionar mais atributos.

6. Use o controlo de deslize para definir o valor de realce/ocultação. Os números negativos são bury, os números positivos são boost.

7. Clique em Enviar para enviar o seu pedido de controlo a um aprovador. Pode ver o estado dos pedidos enviados na consola de merchandising. Se mudar de ideias, pode eliminar o pedido de controlo.

Passos do aprovador

1. Em Configurações de publicação,atribua o controlo à configuração de publicação existente.
2. Aprove o pedido de um controlo de realce/ocultação.

Cloud Console

1. Aceda à página Controlos na consola de pesquisa para comércio.
   
   Aceda à página Controlos

2. No separador Controlos de publicação, clique em Criar controlo.

   É aberto o painel Criar controlo.

3. Na secção Preferências, no campo Nome do controlo, introduza um nome para o novo controlo.

4. (Opcional) Para alterar o ID do controlo criado automaticamente, clique em Editar e introduza um novo ID do controlo.

5. Na secção Seleção de produtos, selecione Recomendação.

6. Escolha Controlos de realce/ocultação como o tipo de controlo.

7. Clique em Continuar para avançar para a secção Ações.

8. Adicione filtros para atributos de produtos no campo Realçar/ocultar produto.

   Use a sintaxe de expressão de filtro documentada no artigo Filtre recomendações.

   Por exemplo, para especificar as versões vermelha e azul do "product1" e do "product2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

9. Para o Valor de amplificação/ocultação, use o controlo de deslize para definir a intensidade da amplificação. Os valores positivos melhoram os resultados e os valores negativos ocultam-nos.

10. Clique em Continuar para aceder à secção Configurações de publicação.

11. Selecione as configurações de publicação às quais aplicar o controlo.

12. Envie as definições de controlo.

    Demora alguns minutos até que os controlos criados ou atualizados recentemente estejam prontos para publicar tráfego em direto. Pode testar se as alterações foram aplicadas na página Avaliar da consola.

Pode encontrar o novo controlo indicado no separador Controlos de publicação da página Controlos.

curl

Faça um pedido Control.create com um ID de controlo e uma instância de Control contida no corpo do pedido.

Para ver detalhes dos campos, consulte a Controls referência da API e a Controls.create referência da API.

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

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"
   

Demora alguns minutos até que os controlos criados ou atualizados recentemente estejam prontos para publicar tráfego em direto. Pode testar se as alterações foram aplicadas na página Avaliar da consola.

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

• Para mais informações sobre este método, consulte a ServingConfig.addControl referência da API.

• Para ver um exemplo deste método, consulte o artigo Gerir configurações de publicação.

Crie um controlo de filtro

Consulte a secção Controlos de filtros para saber mais sobre este tipo de controlo.

Consola de merchandising

1. Clique no URL fornecido pelo administrador. Inicie sessão.

   Esta ação direciona para a página Controlos na consola de merchandising.

2. Clique em Criar controlo.

3. Defina os objetivos para os utilizadores finais e o tempo necessário. Tem de responder a todas as perguntas. Clicar em Seguinte.

4. Selecione um controlo. Introduza o nome do controlo, selecione o produto Pesquisar ou Procurar e, de seguida, escolha o tipo de controlo Filtro.

5. Configure o controlo de filtros:

   1. Em Acionadores, defina que atributo do catálogo aciona este controlo atribuindo critérios a uma consulta de pesquisa relacionada ou a uma categoria de página, como contém ou não está no intervalo. Se não tiver sido configurado nenhum atributo do catálogo, este controlo é sempre aplicado.

   2. Defina um Intervalo de tempo aplicável introduzindo um Intervalo de datas. Se algum dos intervalos de tempo especificados for cumprido, o atributo do catálogo vai ser correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um intervalo de tempo com Adicionar intervalo de tempo.

   3. Defina as ações de filtro que quer acionar com este controlo. Estas ações são definidas por um atributo do catálogo, como cores, um critério, como contém, e um valor, como vermelho.

   4. Clique em Adicionar atributo para adicionar mais atributos.

6. Clique em Enviar para enviar o seu pedido de controlo a um aprovador. Pode ver o estado dos pedidos enviados na consola de merchandising. Se mudar de ideias, pode eliminar o pedido de controlo.

Passos do aprovador

1. Em Configurações de publicação,atribua o controlo à configuração de publicação existente.
2. Aprove o pedido de um controlo de Filtro.

Cloud Console

1. Aceda à página Controlos na consola de pesquisa para comércio.
   
   Aceda à página Controlos

2. No separador Controlos de publicação, clique em Criar controlo.

   É aberto o painel Criar controlo.

3. Na secção Preferências, no campo Nome do controlo, introduza um nome para o novo controlo.

4. Opcional: para alterar o ID do controlo criado automaticamente, clique em Editar e introduza um novo ID do controlo.

5. Escolha Controlos de filtros como o tipo de controlo.

6. Clique em Continuar para avançar para a secção Acionadores.

7. Selecione o tipo de comportamento do utilizador que aciona este controlo:

   • Procurar categorias: a regra é acionada quando um utilizador procura categorias no seu site (search.request.query está vazio).

   • Pesquisa: a regra é acionada quando um utilizador pesquisa no seu site (search.request.query não está vazio).

8. Opcional: defina uma condição de controlo que aciona a regra com base na categoria explorada ou na consulta pesquisada. A opção disponível depende de ter escolhido Procurar categorias ou Pesquisar:

   • Se escolheu Procurar categorias: no campo Categorias, introduza as categorias que vão acionar este controlo quando forem procuradas.

   • Se escolheu Pesquisa: clique no botão Adicionar consulta para adicionar termos de consulta (por exemplo, running shoes) a filtrar e selecione uma das seguintes opções para cada termo:

     • Correspondência parcial: este controlo aplica-se quando uma consulta contém uma correspondência parcial com este termo de consulta.
     • Correspondência total: este controlo aplica-se apenas quando uma consulta contém uma correspondência total com este termo de consulta.

     Quando um destes termos é incluído numa consulta, o controlo é aplicado.

   Nota: se especificar uma condição de intervalo de tempo além desta condição, o controlo é aplicado apenas se ambas as condições forem cumpridas.

9. Opcional: clique no botão Adicionar intervalo de tempo para adicionar um ou mais intervalos de tempo durante os quais este controlo pode ser aplicado.

   Nota: se especificar uma condição de categoria ou termo de consulta além desta condição de intervalo de tempo, o controlo é aplicado apenas quando ambas as condições são cumpridas.

10. Clique em Continuar para avançar para a secção Ações.

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

    Use a sintaxe de expressão de filtro documentada em Filtragem e ordenação.

    Por exemplo, para especificar as versões vermelha e azul do "product1" e do "product2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

12. Clique em Continuar para aceder à secção Configurações de publicação.

13. Selecione as configurações de publicação às quais aplicar o controlo.

14. Envie as definições de controlo.

    Demora alguns minutos até que os controlos criados ou atualizados recentemente estejam prontos para publicar tráfego em direto. Pode testar se as alterações foram aplicadas na página Avaliar da consola.

Pode encontrar o novo controlo indicado no separador Controlos de publicação da página Controlos.

curl

Faça um pedido Control.create com um ID de controlo e uma instância de Control contida no corpo do pedido.

Para ver detalhes dos campos, consulte a Controls referência da API e a Controls.create referência da API.

Um controlo de filtro pode ser acionado quando um utilizador procura categorias no seu site (search.request.query está vazio) ou quando um utilizador pesquisa no seu site (search.request.query não está vazio).

O exemplo seguinte mostra os campos de um controlo acionado pela navegação, em que searchSolutionUseCase está 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 seguinte mostra os campos de um controlo acionado pela pesquisa, em que searchSolutionUseCase está 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 controlo a uma configuração de publicação, use o método ServingConfig.addControl:

• Para mais informações sobre este método, consulte a ServingConfig.addControl referência da API.

• Para ver um exemplo deste método, consulte o artigo Gerir configurações de publicação.

Crie um controlo de redirecionamento

Consulte a secção Controlos de redirecionamento para saber mais sobre este tipo de controlo.

Consola de merchandising

1. Clique no URL fornecido pelo administrador. Inicie sessão.

   Esta ação direciona para a página Controlos na consola de merchandising.

2. Clique em Criar controlo.

3. Defina os objetivos para os utilizadores finais e o tempo necessário. Tem de responder a todas as perguntas. Clicar em Seguinte.

4. Selecione um controlo. Introduza o nome do controlo, selecione o produto Pesquisa e, de seguida, escolha o tipo de controlo Redirecionar.

5. Configure o controlo Redirecionar:

   1. Em Acionadores, defina o que aciona este controlo atribuindo critérios a uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se não tiver sido configurado nenhum atributo do catálogo, este controlo é sempre aplicado.

   2. Defina um Intervalo de tempo aplicável introduzindo um Intervalo de datas. Se algum dos intervalos de tempo especificados for cumprido, o atributo do catálogo vai ser correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um intervalo de tempo com Adicionar intervalo de tempo.

   3. Defina as ações de redirecionamento que quer acionar com este controlo introduzindo o URL de redirecionamento.

6. Clique em Enviar para enviar o seu pedido de controlo a um aprovador. Pode ver o estado dos pedidos enviados na consola de merchandising. Se mudar de ideias, pode eliminar o pedido de controlo.

Passos do aprovador

1. Em Configurações de publicação,atribua o controlo à configuração de publicação existente.
2. Aprovar o pedido de um controlo de redirecionamento.

Cloud Console

1. Aceda à página Controlos na consola de pesquisa para comércio.
   
   Aceda à página Controlos

2. No separador Controlos de publicação, clique em Criar controlo.

   É aberto o painel Criar controlo.

3. Na secção Preferências, no campo Nome do controlo, introduza um nome para o novo controlo.

4. Opcional: para alterar o ID do controlo criado automaticamente, clique em Editar e introduza um novo ID do controlo.

5. Escolha Controlos de redirecionamento como o tipo de controlo.

6. Clique em Continuar para avançar para a secção Acionadores.

7. Crie, pelo menos, um termo de consulta ou um intervalo de tempo desencadeador. Os controlos de redirecionamento requerem, pelo menos, um acionador:

8. Selecione o tipo de comportamento do utilizador que aciona este controlo:

   • Procurar categorias: a regra é acionada quando um utilizador procura categorias no seu site (search.request.query está vazio).

   • Pesquisa: a regra é acionada quando um utilizador pesquisa no seu site (search.request.query não está vazio).

9. Defina uma condição de controlo que aciona a regra com base na categoria que é explorada ou na consulta que é pesquisada. A opção disponível depende de ter escolhido Procurar categorias ou Pesquisar:

   • Se escolheu Procurar categorias: no campo Categorias, introduza as categorias que vão acionar este controlo quando forem procuradas.

   • Se escolheu Pesquisa: clique no botão Adicionar consulta para adicionar termos de consulta (por exemplo, running shoes) a filtrar e selecione uma das seguintes opções para cada termo:

     • Correspondência parcial: este controlo aplica-se quando uma consulta contém uma correspondência parcial com este termo de consulta.
     • Correspondência total: este controlo aplica-se apenas quando uma consulta contém uma correspondência total com este termo de consulta.

     Quando um destes termos é incluído numa consulta, o controlo é aplicado.

   Nota: se especificar uma condição de intervalo de tempo além desta condição, o controlo é aplicado apenas se ambas as condições forem cumpridas.

10. Clique no botão Adicionar intervalo de tempo para adicionar um ou mais intervalos de tempo durante os quais este controlo pode ser aplicado.

    Nota: se especificar uma condição de categoria ou termo de consulta além desta condição de intervalo de tempo, o controlo é aplicado apenas quando ambas as condições são cumpridas.

11. Clique em Continuar para avançar para a secção Ações.

12. Introduza o URI para o qual redirecionar quando este controlo for acionado.

13. Clique em Continuar para aceder à secção Configurações de publicação.

14. Selecione as configurações de publicação às quais aplicar o controlo.

15. Envie as definições de controlo.

    Demora alguns minutos até que os controlos criados ou atualizados recentemente estejam prontos para publicar tráfego em direto. Pode testar se as alterações foram aplicadas na página Avaliar da consola.

Pode encontrar o novo controlo indicado no separador Controlos de publicação da página Controlos.

curl

Faça um pedido Control.create com um ID de controlo e uma instância de Control contida no corpo do pedido.

Para ver detalhes dos campos, consulte a Controls referência da API e a Controls.create referência da API.

Um controlo de redirecionamento pode ser acionado quando um utilizador navega pelas categorias no seu site (search.request.query está vazio) ou quando um utilizador pesquisa no seu site (search.request.query não está vazio).

O exemplo seguinte mostra os campos de um controlo acionado pela navegação, em que searchSolutionUseCase está 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 seguinte mostra os campos de um controlo acionado pela pesquisa, em que searchSolutionUseCase está 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 controlo a uma configuração de publicação, use o método ServingConfig.addControl:

• Para mais informações sobre este método, consulte a ServingConfig.addControl referência da API.

• Para ver um exemplo deste método, consulte o artigo Gerir configurações de publicação.

Crie um controlo de sinónimos bidirecional

Consulte Controlos de sinónimos bidirecionais para saber mais sobre este tipo de controlo.

Consola de merchandising

1. Clique no URL fornecido pelo administrador. Inicie sessão.

   Esta ação direciona para a página Controlos na consola de merchandising.

2. Clique em Criar controlo.

3. Defina os objetivos para os utilizadores finais e o tempo necessário. Tem de responder a todas as perguntas. Clicar em Seguinte.

4. Selecione um controlo. Introduza o nome do controlo, selecione o produto Pesquisa e, de seguida, escolha o tipo de controlo Sinónimos.

5. Configure o controlo de sinónimos bidirecionais:

   1. Em Acionadores, defina o que aciona este controlo atribuindo critérios a uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se não tiver sido configurado nenhum atributo do catálogo, este controlo é sempre aplicado.

   2. Defina um Intervalo de tempo aplicável introduzindo um Intervalo de datas. Se algum dos intervalos de tempo especificados for cumprido, o atributo do catálogo vai ser correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um intervalo de tempo com Adicionar intervalo de tempo.

   3. Defina o Tipo de sinónimo que quer acionar com este controlo. Selecione Bidirecional. Consulte a secção sobre Sinónimos para mais informações sobre os tipos de sinónimos.

6. Clique em Enviar. Isto permite aceder a um ecrã de configuração detalhado de Sinónimo bidirecional.

7. Introduza os sinónimos no campo em Ações de sinónimos bidirecionais. Esta ação associa termos bidirecionalmente para serem tratados da mesma forma nos resultados da pesquisa, de modo que uma consulta de sofá vermelho resulte num sofá vermelho-castanho, mas as consultas de sofá castanho são expandidas para incluir todos os tipos de sofás vermelhos, como carmesim ou rosa.

8. Envie novamente para enviar o seu pedido de controlo a um aprovador. Pode ver o estado dos pedidos enviados na consola de merchandising. Se mudar de ideias, pode eliminar o pedido de controlo.

Passos do aprovador

1. Em Configurações de publicação,atribua o controlo à configuração de publicação existente.
2. Aprovar o pedido de controlo de sinónimo bidirecional.

Cloud Console

1. Aceda à página Controlos na consola de pesquisa para comércio.
   
   Aceda à página Controlos

2. No separador Controlos de publicação, clique em Criar controlo.

3. No campo Nome do controlo, introduza um nome para o novo controlo.

   É aberto o painel Criar controlo.

4. Vai aceder à secção Preferências.

5. Opcional: para alterar o ID do controlo criado automaticamente, clique em Editar e introduza um novo ID do controlo.

6. Escolha Controlo de sinónimos bidirecional como o tipo de controlo.

7. Clique em Continuar para avançar para a secção Acionadores.

8. Opcional: clique no botão Adicionar intervalo de tempo para adicionar um ou mais intervalos de tempo durante os quais este controlo pode ser aplicado.

9. Clique em Continuar para avançar para a secção Ações.

10. No campo Sinónimos, introduza entre 2 e 100 termos de consulta (por exemplo, shirt e top) que devem ser sinónimos entre si.

    Quando qualquer um destes termos é incluído numa consulta, a pesquisa considera os outros termos da consulta como sinónimos do termo incluído.

11. Clique em Continuar para aceder à secção Configurações de publicação.

12. Selecione as configurações de publicação às quais aplicar o controlo.

13. Envie as definições de controlo.

    Demora alguns minutos até que os controlos criados ou atualizados recentemente estejam prontos para publicar tráfego em direto. Pode testar se as alterações foram aplicadas na página Avaliar da consola.

Pode encontrar o novo controlo indicado no separador Controlos de publicação da página Controlos.

curl

Faça um pedido Control.create com um ID de controlo e uma instância de Control contida no corpo do pedido.

Para ver detalhes dos campos, consulte a Controls referência da API e a Controls.create referência da API.

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 controlo a uma configuração de publicação, use o método ServingConfig.addControl. Consulte o artigo Adicione controlos às configurações de publicação inline.

Crie um controlo de sinónimos unidirecional

Consulte a secção Controlos de sinónimos unidirecionais para saber mais sobre este tipo de controlo.

Consola de merchandising

1. Clique no URL fornecido pelo administrador. Inicie sessão.

   Esta ação direciona para a página Controlos na consola de merchandising.

2. Clique em Criar controlo.

3. Defina os objetivos para os utilizadores finais e o tempo necessário. Tem de responder a todas as perguntas. Clicar em Seguinte.

4. Selecione um controlo. Introduza o nome do controlo, selecione o produto Pesquisa e, de seguida, escolha o tipo de controlo Sinónimos.

5. Configure o controlo de sinónimo unidirecional:

   1. Em Acionadores, defina o que aciona este controlo atribuindo critérios a uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se não tiver sido configurado nenhum atributo do catálogo, este controlo é sempre aplicado.

   2. Defina um Intervalo de tempo aplicável introduzindo um Intervalo de datas. Se algum dos intervalos de tempo especificados for cumprido, o atributo do catálogo vai ser correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um intervalo de tempo com Adicionar intervalo de tempo.

   3. Defina o Tipo de sinónimo que quer acionar com este controlo. Selecione Só ida. Consulte a secção sobre Sinónimos para mais informações sobre os tipos de sinónimos.

6. Clique em Enviar. Isto permite aceder a um ecrã de configuração detalhado de sinónimos unidirecionais.

7. Introduza os sinónimos no campo em Ações de sinónimos unidirecionais. Esta ação associa termos de forma unidirecional para serem tratados da mesma forma nos resultados da pesquisa. Assim, uma consulta de sofás vermelhos inclui sofás castanhos, mas uma consulta de sofás castanhos não devolve outros tipos de sofás vermelhos, restringindo os resultados apenas a sofás castanhos.

8. Clique novamente em Enviar para enviar o seu pedido de controlo a um aprovador. Pode ver o estado dos pedidos enviados na consola de merchandising. Se mudar de ideias, pode eliminar o pedido de controlo.

Passos do aprovador

1. Em Configurações de publicação,atribua o controlo à configuração de publicação existente.
2. Aprovar o pedido de um controlo de sinónimo unidirecional.

Cloud Console

1. Aceda à página Controlos na consola de pesquisa para comércio.
   
   Aceda à página Controlos

2. No separador Controlos de publicação, clique em Criar controlo.

   É aberto o painel Criar controlo.

3. Na secção Preferências, no campo Nome do controlo, introduza um nome para o novo controlo.

4. Opcional: para alterar o ID do controlo criado automaticamente, clique em Editar e introduza um novo ID do controlo.

5. Escolha Controlo de sinónimos unidirecional como o tipo de controlo.

6. Clique em Continuar para avançar para a secção Acionadores.

7. Opcional: clique no botão Adicionar intervalo de tempo para adicionar um ou mais intervalos de tempo durante os quais este controlo pode ser aplicado.

8. Clique em Continuar para avançar para a secção Ações.

9. No campo Termos de consulta, introduza termos (por exemplo, shoes) que devem ter sinónimos associados quando qualquer um deles estiver incluído numa consulta.

10. No campo Sinónimos, introduza 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).

11. Clique em Continuar para aceder à secção Configurações de publicação.

12. Selecione as configurações de publicação às quais aplicar o controlo.

13. Envie as definições de controlo.

    Demora alguns minutos até que os controlos criados ou atualizados recentemente estejam prontos para publicar tráfego em direto. Pode testar se as alterações foram aplicadas na página Avaliar da consola.

Pode encontrar o novo controlo indicado no separador Controlos de publicação da página Controlos.

curl

Faça um pedido Control.create com um ID de controlo e uma instância de Control contida no corpo do pedido.

Para ver detalhes dos campos, consulte a Controls referência da API e a Controls.create referência da API.

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 controlo a uma configuração de publicação, use o método ServingConfig.addControl:

• Para mais informações sobre este método, consulte a ServingConfig.addControl referência da API.

• Para ver um exemplo deste método, consulte o artigo Gerir configurações de publicação.

Crie um controlo de não associação

Consulte a secção Controlos de não associação para saber mais sobre este tipo de controlo.

Consola de merchandising

1. Clique no URL fornecido pelo administrador. Inicie sessão.

   Esta ação direciona para a página Controlos na consola de merchandising.

2. Clique em Criar controlo.

3. Defina os objetivos para os utilizadores finais e o tempo necessário. Tem de responder a todas as perguntas. Clicar em Seguinte.

4. Selecione um controlo. Introduza o nome do controlo, selecione o produto Pesquisa e, de seguida, escolha o tipo de controlo Não associar.

5. Configure o controlo Não associar:

   1. Em Acionadores, defina o que aciona este controlo atribuindo critérios a uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se não tiver sido configurado nenhum atributo do catálogo, este controlo é sempre aplicado.

   2. Defina um Intervalo de tempo aplicável introduzindo um Intervalo de datas. Se algum dos intervalos de tempo especificados for cumprido, o atributo do catálogo vai ser correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um intervalo de tempo com Adicionar intervalo de tempo.

   3. Em Não associar ações,especifique os termos que não devem ser associados aos termos de consulta que introduziu na secção Acionadores anterior. Introduza-os nos campos de termos de consulta e termos desassociados, respetivamente.

6. Clique em Enviar para enviar o seu pedido de controlo a um aprovador. Pode ver o estado dos pedidos enviados na consola de merchandising. Se mudar de ideias, pode eliminar o pedido de controlo.

Passos do aprovador

1. Em Configurações de publicação,atribua o controlo à configuração de publicação existente.
2. Aprovar o pedido de um controlo Do-not-associate.

Cloud Console

1. Aceda à página Controlos na consola de pesquisa para comércio.
   
   Aceda à página Controlos

2. No separador Controlos de publicação, clique em Criar controlo.

   É aberto o painel Criar controlo.

3. Na secção Preferências, no campo Nome do controlo, introduza um nome para o novo controlo.

4. Opcional: para alterar o ID do controlo criado automaticamente, clique em Editar e introduza um novo ID do controlo.

5. Escolha Não associar controlo como o tipo de controlo.

6. Clique em Continuar para avançar para a secção Acionadores.

7. Opcional: clique no botão Adicionar intervalo de tempo para adicionar um ou mais intervalos de tempo durante os quais este controlo pode ser aplicado.

8. Clique em Continuar para avançar para a secção Ações.

9. No campo Termos de consulta, introduza termos (por exemplo, gShoe) que quer desambiguar explicitamente de outros.

10. No campo Termos dissociados, introduza os termos a dissociar dos resultados da pesquisa com os termos de consulta que especificou.

    Por exemplo, pode dissociar o termo de consulta gShoe do termo cheap.

11. Clique em Continuar para aceder à secção Configurações de publicação.

12. Selecione as configurações de publicação às quais aplicar o controlo.

13. Envie as definições de controlo.

    Demora alguns minutos até que os controlos criados ou atualizados recentemente estejam prontos para publicar tráfego em direto. Pode testar se as alterações foram aplicadas na página Avaliar da consola.

Pode encontrar o novo controlo indicado no separador Controlos de publicação da página Controlos.

curl

Faça um pedido Control.create com um ID de controlo e uma instância de Control contida no corpo do pedido.

Para ver detalhes dos campos, consulte a Controls referência da API e a Controls.create referência da API.

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 controlo a uma configuração de publicação, use o método ServingConfig.addControl:

• Para mais informações sobre este método, consulte a ServingConfig.addControl referência da API.

• Para ver um exemplo deste método, consulte o artigo Gerir configurações de publicação.

Crie um controlo de ignorar

Consulte a secção Ignorar controlos para saber mais sobre este tipo de controlo.

Consola de merchandising

1. Clique no URL fornecido pelo administrador. Inicie sessão.

   Esta ação direciona para a página Controlos na consola de merchandising.

2. Clique em Criar controlo.

3. Defina os objetivos para os utilizadores finais e o tempo necessário. Tem de responder a todas as perguntas. Clicar em Seguinte.

4. Selecione um controlo. Introduza o nome do controlo, selecione o produto Pesquisa e, de seguida, escolha o tipo de controlo Ignorar.

5. Configure o controlo Ignorar:

   1. Em Acionadores, defina o que aciona este controlo atribuindo critérios a uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se não tiver sido configurado nenhum atributo do catálogo, este controlo é sempre aplicado.

   2. Defina um Intervalo de tempo aplicável introduzindo um Intervalo de datas. Se algum dos intervalos de tempo especificados for cumprido, o atributo do catálogo vai ser correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um intervalo de tempo com Adicionar intervalo de tempo.

   3. Introduza os termos que quer ignorar em Ignorar ações.

6. Clique em Enviar para enviar o seu pedido de controlo a um aprovador. Pode ver o estado dos pedidos enviados na consola de merchandising. Se mudar de ideias, pode eliminar o pedido de controlo.

Passos do aprovador

1. Em Configurações de publicação,atribua o controlo à configuração de publicação existente.
2. Aprovar o pedido de um controlo Ignorar.

Cloud Console

1. Aceda à página Controlos na consola de pesquisa para comércio.
   
   Aceda à página Controlos

2. No separador Controlos de publicação, clique em Criar controlo.

   É aberto o painel Criar controlo.

3. Na secção Preferências, no campo Nome do controlo, introduza um nome para o novo controlo.

4. Opcional: para alterar o ID do controlo criado automaticamente, clique em Editar e introduza um novo ID do controlo.

5. Escolha Não associar controlo como o tipo de controlo.

6. Clique em Continuar para avançar para a secção Acionadores.

7. Opcional: clique no botão Adicionar intervalo de tempo para adicionar um ou mais intervalos de tempo durante os quais este controlo pode ser aplicado.

8. Clique em Continuar para avançar para a secção Ações.

9. No campo Ignorar termos, introduza termos (por exemplo, shoddy) que quer que uma pesquisa ignore quando são introduzidos como termos de consulta.

10. Clique em Continuar para aceder à secção Configurações de publicação.

11. Selecione as configurações de publicação às quais aplicar o controlo.

12. Envie as definições de controlo.

    Demora alguns minutos até que os controlos criados ou atualizados recentemente estejam prontos para publicar tráfego em direto. Pode testar se as alterações foram aplicadas na página Avaliar da consola.

Pode encontrar o novo controlo indicado no separador Controlos de publicação da página Controlos.

curl

Faça um pedido Control.create com um ID de controlo e uma instância de Control contida no corpo do pedido.

Para ver detalhes dos campos, consulte a Controls referência da API e a Controls.create referência da API.

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 controlo a uma configuração de publicação, use o método ServingConfig.addControl:

• Para mais informações sobre este método, consulte a ServingConfig.addControl referência da API.

• Para ver um exemplo deste método, consulte o artigo Gerir configurações de publicação.

Crie um grupo de controlo de substituição

Consulte a secção Controlos de substituição para saber mais sobre este tipo de controlo.

Consola de merchandising

1. Clique no URL fornecido pelo administrador. Inicie sessão.

   Esta ação direciona para a página Controlos na consola de merchandising.

2. Clique em Criar controlo.

3. Defina os objetivos para os utilizadores finais e o tempo necessário. Tem de responder a todas as perguntas. Clicar em Seguinte.

4. Selecione um controlo. Introduza o nome do controlo, selecione o produto Pesquisa e, de seguida, escolha o tipo de controlo Substituição.

5. Configure o controlo de substituição:

   1. Em Acionadores, defina o que aciona este controlo atribuindo critérios a uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se não tiver sido configurado nenhum atributo do catálogo, este controlo é sempre aplicado.

   2. Defina um Intervalo de tempo aplicável introduzindo um Intervalo de datas. Se algum dos intervalos de tempo especificados for cumprido, o atributo do catálogo vai ser correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um intervalo de tempo com Adicionar intervalo de tempo.

   3. Em Ações de substituição, defina os termos de consulta que quer substituir no primeiro campo e os respetivos substitutos no segundo campo.

6. Clique em Enviar para enviar o seu pedido de controlo a um aprovador. Pode ver o estado dos pedidos enviados na consola de merchandising. Se mudar de ideias, pode eliminar o pedido de controlo.

Passos do aprovador

1. Em Configurações de publicação,atribua o controlo à configuração de publicação existente.
2. Aprovar o pedido de um controlo de substituição.

Cloud Console

1. Aceda à página Controlos na consola de pesquisa para comércio.
   
   Aceda à página Controlos

2. No separador Controlos de publicação, clique em Criar controlo.

   É aberto o painel Criar controlo.

3. Na secção Preferências, no campo Nome do controlo, introduza um nome para o novo controlo.

4. Opcional: para alterar o ID do controlo criado automaticamente, clique em Editar e introduza um novo ID do controlo.

5. Escolha Controlo de substituição como o tipo de controlo.

6. Clique em Continuar para avançar para a secção Acionadores.

7. Opcional: clique no botão Adicionar intervalo de tempo para adicionar um ou mais intervalos de tempo durante os quais este controlo pode ser aplicado.

8. Clique em Continuar para avançar para a secção Ações.

9. No campo Termos de consulta, introduza termos de consulta (por exemplo, gShoe) que quer substituir pelo termo de substituição.

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

    Por exemplo, pode substituir o termo de consulta gShoe pelo termo de substituição Google Shoe.

11. Clique em Continuar para aceder à secção Configurações de publicação.

12. Selecione as configurações de publicação às quais aplicar o controlo.

13. Envie as definições de controlo.

    Demora alguns minutos até que os controlos criados ou atualizados recentemente estejam prontos para publicar tráfego em direto. Pode testar se as alterações foram aplicadas na página Avaliar da consola.

Pode encontrar o novo controlo indicado no separador Controlos de publicação da página Controlos.

curl

Faça um pedido Control.create com um ID de controlo e uma instância de Control contida no corpo do pedido.

Para ver detalhes dos campos, consulte a Controls referência da API e a Controls.create referência da API.

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 controlo a uma configuração de publicação, use o método ServingConfig.addControl:

• Para mais informações sobre este método, consulte a ServingConfig.addControl referência da API.

• Para ver um exemplo deste método, consulte o artigo Gerir configurações de publicação.

Crie um controlo de fixação

Para criar um controlo de fixação:

Consola de merchandising

1. Clique no URL fornecido pelo administrador. Inicie sessão.

   Esta ação direciona para a página Controlos na consola de merchandising.

2. Clique em Criar controlo.

3. Defina os objetivos para os utilizadores finais e o tempo necessário. Tem de responder a todas as perguntas. Clicar em Seguinte.

4. Selecione um controlo. Introduza o nome do controlo, selecione o produto Pesquisa e, de seguida, escolha o tipo de controlo Fixação.

5. Configure o controlo de fixação:

   1. Em Acionadores, defina o que aciona este controlo atribuindo critérios a uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se não tiver sido configurado nenhum atributo do catálogo, este controlo é sempre aplicado.

   2. Defina um Intervalo de tempo aplicável introduzindo um Intervalo de datas. Se algum dos intervalos de tempo especificados for cumprido, o atributo do catálogo vai ser correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um intervalo de tempo com Adicionar intervalo de tempo.

   3. Defina as ações de fixação que quer acionar com este controlo. Estas ações são definidas pelo ID do produto e pela posição do marcador, de preferência um número inferior a 120 (o tamanho típico da página). Pode clicar em Adicionar produto e adicionar até 10.

6. Clique em Enviar para enviar o seu pedido de controlo a um aprovador. Pode ver o estado dos pedidos enviados na consola de merchandising. Se mudar de ideias, pode eliminar o pedido de controlo.

Passos do aprovador

1. Em Configurações de publicação,atribua o controlo à configuração de publicação existente.
2. Aprovar o pedido de um controlo de Fixação.

Cloud Console

1. Aceda à página Controlos na consola de pesquisa para comércio.
   
   Aceda à página Controlos

2. No separador Controlos de publicação, clique em Criar controlo.

   É aberto o painel Criar controlo.

3. No campo Nome do controlo da secção Preferências, introduza um nome para o novo controlo.

4. Opcional: para alterar o ID do controlo criado automaticamente, clique em Editar e introduza um novo ID do controlo.

5. Na secção Seleção de produtos, selecione Pesquisar ou procurar.

6. Escolha Controlo de fixação como o tipo de controlo. Clique em Continuar.

7. Na secção Acionadores, escolha o comportamento do utilizador que aciona este controlo:

   • Procurar categorias: os pedidos de navegação têm de ter o campo page_categories preenchido, além de o campo search.request.query estar vazio.

   • Pesquisa: os pedidos de pesquisa só requerem o preenchimento de search.request.query.

     Por predefinição, todas as categorias exploradas e as consultas pesquisadas acionam este controlo.

8. Opcional: defina uma condição que aciona a regra com base numa categoria específica consultada ou numa consulta pesquisada:

   • Procurar categorias: no campo Categorias, introduza as categorias que acionam o controlo.

   • Pesquisa: para adicionar termos de consulta a filtrar (por exemplo, running shoes), clique em Adicionar consulta. Para cada termo, escolha Correspondência parcial ou Correspondência total.

9. Opcional: clique em Adicionar intervalo de tempo ou Adicionar intervalo de datas para adicionar um ou mais intervalos de tempo durante os quais este controlo pode ser aplicado.

   Nota: se especificar uma categoria ou um termo de consulta, além de condições de intervalo de tempo ou de datas, o controlo só é aplicado se ambos os tipos de condições forem cumpridos.

10. Clique em Continuar para avançar para a secção Ações. Para Afixar localização, use o controlo de deslize para especificar a posição na qual os produtos devem ser afixados. O controlo de deslize do valor do alfinete não aceita valores de 0, números negativos nem números não inteiros.

    O Vertex AI Search for commerce permite 10 marcadores no mapa de marcadores de qualquer controlo único. A posição pode ser qualquer valor entre 1 e 120 (o tamanho máximo da página de pedido).

    Nota: as fixações na segunda página não são respeitadas se a posição for superior ao tamanho da página do pedido. Por exemplo, se uma consulta de pesquisa pedir um tamanho da página de 50, mas tiver definido um pino para a página 75, o item de pesquisa é ignorado nos resultados.

11. Clique em Continuar para aceder à secção Configurações de publicação. Selecione as configurações de publicação às quais quer aplicar o controlo e envie as definições de controlo.

    Demora alguns minutos até que os controlos criados ou atualizados recentemente estejam prontos para publicar tráfego em direto. Pode testar se as alterações foram aplicadas na página Avaliar da consola.

Pode encontrar o novo controlo indicado no separador Controlos de publicação da página Controlos.

curl

Faça um pedido Control.create com um ID de controlo e uma instância de Control contida no corpo do pedido.

Para ver detalhes dos campos, consulte a Controls referência da API e a Controls.create referência da API.

curl -X POST \
 -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
 -H "Content-Type: application/json; charset=utf-8" \
 -H "X-Goog-User-Project: PROJECT_NUMBER" \
 --data '{
          "displayName": "DisplayName",
          "solutionTypes": "SOLUTION_TYPE_SEARCH",
          "searchSolutionUseCase": ["SEARCH_SOLUTION_USE_CASE_SEARCH"],
     "rule": {
            "condition": {
 "queryTerms": [
                {
                  "value": "Term1",
                  "fullMatch": "boolean: true / false"
                },
                {
                  "value": "Term2",
                  "fullMatch": "boolean: true / false"
                },
             ],
             "activeTimeRange": [
               {
                 "startTime": timestamp1,
                 "endTime": timestamp2
               },
               {
                 "startTime": timestamp3,
                 "endTime": timestamp4
               }
             ]
            },
            "pinAction": {
               "pinMap" :  {
                        "pin_position1": "product_id",
                      "pin_position2": "product_id>"
                    }
            }
              }
}' \
"https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/controls?controlId=CONTROL_ID"

O valor pin_position deve ser um número inteiro entre [1,10] inclusive e product_id tem de existir no seu catálogo. O número máximo de elementos permitidos no mapa de pins é 10 para cada controlo.

Em seguida, anexe o controlo de fixação à configuração de publicação:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-H "X-Goog-User-Project: PROJECT_NUMBER" \
-d '{
      "controlId": "CONTROL_ID"
  }' \
'https://retail.googleapis.com/v2alpha/projects/PROJECT_NUMBER/locations/LOCATION/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

Neste caso, CONTROL_ID deve ser o controlo de fixação id que criou anteriormente.

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

• Para mais informações sobre este método, consulte a ServingConfig.addControl referência da API.

• Para ver um exemplo deste método, consulte o artigo Gerir configurações de publicação.

Por fim, para testar a configuração, faça um pedido de pesquisa. Para se certificar de que um pedido tem o controlo de fixação aplicado com êxito, use termos de consulta (na pesquisa) ou categorias de páginas (na navegação) que correspondam aos termos/categorias fornecidos no controlo que criou nos passos anteriores.

Cloud Console

1. Aceda à página Avaliar na consola de pesquisa para comércio.
   
   Aceda à página Avaliar

2. Aceda ao separador Pesquisar.

3. Introduza uma consulta de teste no campo de consulta de pesquisa.

4. Clique em Pré-visualização da pesquisa.

5. Veja os resultados para garantir que os produtos escolhidos estão fixados.

curl

curl -s -X POST -H "Authorization: Bearer " -H "Content-Type: application/json"
--data "{'query': '','visitorId': ''}" \ "https://retail.googleapis.com/v2/projects/PROJECT/locations/global/catalogs/CATALOG/placements/default_search:search"

Restrições para a verificação de erros

Para a verificação de erros, tenha em atenção estas restrições:

• Não é possível fixar dois produtos na mesma posição, ou seja, os produtos "a" e "b" não podem ocupar a posição n.º 2.
• Por outro lado, um produto não pode ser fixado em mais do que uma posição, ou seja, o produto "a" não pode ser fixado nas posições n.º 2 e n.º 3 ao mesmo tempo para a mesma consulta.
• O product_id tem de existir como um produto no catálogo, partindo do princípio de que não são aplicados filtros nem ordenação.