Criar controles de exibição

Console de merchandising

1. Clique no URL fornecido pelo administrador. Sign in.

   Isso leva você à página Controles no console de merchandising.

2. Clique em add_boxCriar controle.

3. Defina as metas para os usuários finais e o tempo necessário. Todas as perguntas precisam ser respondidas. Clique em Próxima.

4. Selecione um controle. Insira o nome do controle, selecione o produto Pesquisa e escolha o tipo de controle Aumentar/Ocultar.

5. Configure o controle Otimizar/Ocultar:

   1. Em Gatilhos, defina qual atributo do catálogo aciona esse controle fornecendo critérios para uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se nenhum atributo de catálogo tiver sido configurado, esse controle sempre será aplicado.

   2. Defina um período aplicável inserindo um período. Se algum dos intervalos de tempo especificados for atendido, o atributo do catálogo será correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um período com add_boxAdicionar período.

   3. Defina as ações de aumentar/ocultar que você quer acionar com esse controle. Essas 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 add_boxAdicionar atributo para incluir mais atributos.

6. Use o controle deslizante para definir o Valor de otimização/aumento. Números negativos são "bury", e números positivos são "boost".

7. Clique em Enviar para enviar sua solicitação de controle a um aprovador. Você poderá conferir o status das solicitações enviadas no console do Merchandising. Se você mudar de ideia, poderá excluir o pedido de controle.

Console do Cloud

1. Acesse a página Controles no console da Pesquisa para e-commerce.
   
   Acessar a página "Controles"

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

   O painel Criar controle é aberto.

3. Na seção Preferências, no campo Nome do controle, insira um nome para o novo controle.

4. Opcional: para mudar o ID de controle criado automaticamente, clique em Editar e insira um novo ID.

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

6. Escolha Controles de aumento/início como o tipo de controle. Clique em Continuar.

7. Na seção Acionadores, selecione o tipo de comportamento do usuário que aciona esse controle.

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

   • Pesquisa: a regra é acionada quando um usuário pesquisa no seu site (search.request.query não está vazio). Para definir esse controle de forma que ele seja acionado quando qualquer categoria for pesquisada ou qualquer consulta for feita, pule a próxima etapa.

8. Opcional: defina categorias ou consultas específicas que podem acionar esse controle, dependendo se uma categoria específica é pesquisada ou uma consulta específica é feita.

   • Se você escolheu Procurar categorias: no campo Categorias, insira quais categorias vão acionar esse controle quando forem pesquisadas.

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

9. Opcional: clique no botão Adicionar período para incluir um ou mais períodos em que esse controle pode ser aplicado.

10. Clique em Continuar para acessar a seção Ações.

11. Adicione filtros para atributos de produto no campo Aumentar/ocultar produto.

    Use a sintaxe da expressão de filtro documentada em Como filtrar e ordenar. Por exemplo, para especificar as versões em vermelho e azul de "produto1" e "produto2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

12. Em Valor de otimização/aumento, use o controle deslizante para definir a força do aumento. Valores positivos impulsionam os resultados, e valores negativos os ocultam. Clique em Continuar.

13. Na seção Configurações de exibição, selecione as configurações a que aplicar o controle.

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

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

curl

Faça uma solicitação Control.create com um ID de controle e uma instância de Control contida no corpo da solicitação.

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

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

O exemplo a seguir mostra campos para um controle acionado por navegação, em que searchSolutionUseCase 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 a seguir mostra campos para um controle acionado por 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"
  

Leva alguns minutos para que os controles recém-criados ou atualizados estejam prontos para exibir o tráfego em tempo real. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

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

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

• Para um exemplo desse método, consulte Gerenciar configurações de exibição.

Console de merchandising

1. Clique no URL fornecido pelo administrador. Sign in.

   Isso leva você à página Controles no console de merchandising.

2. Clique em add_boxCriar controle.

3. Defina as metas para os usuários finais e o tempo necessário. Todas as perguntas precisam ser respondidas. Clique em Próxima.

4. Selecione um controle. Insira o nome do controle, selecione o produto Navegar e escolha o tipo de controle Aumentar/Ocultar.

5. Configure o controle Otimizar/Ocultar:

   1. Em Gatilhos, insira as categorias de página para acionar o controle. Se nenhum atributo de catálogo for configurado, esse controle estará sempre em vigor.

   2. Defina um período aplicável inserindo um período. Se algum dos intervalos de tempo especificados for atendido, o atributo do catálogo será correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um período com add_boxAdicionar período.

   3. Defina as ações de aumentar/ocultar que você quer acionar com esse controle. Essas 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 add_boxAdicionar atributo para incluir mais atributos.

6. Use o controle deslizante para definir o Valor de otimização/aumento. Números negativos são "bury", e números positivos são "boost".

7. Clique em Enviar para enviar sua solicitação de controle a um aprovador. Você poderá conferir o status das solicitações enviadas no console do Merchandising. Se você mudar de ideia, poderá excluir o pedido de controle.

Console do Cloud

1. Acesse a página Controles no console da Pesquisa para e-commerce.
   
   Acessar a página "Controles"

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

   O painel Criar controle é aberto.

3. Na seção Preferências, no campo Nome do controle, insira um nome para o novo controle.

4. (Opcional) Para mudar o ID de controle criado automaticamente, clique em Editar e insira um novo ID.

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

6. Escolha Controles de aumento/início como o tipo de controle.

7. Clique em Continuar para acessar a seção Ações.

8. Adicione filtros para atributos de produto no campo Aumentar/ocultar produto.

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

   Por exemplo, para especificar as versões em vermelho e azul de "produto1" e "produto2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

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

10. Clique em Continuar para acessar a seção Configurações de veiculação.

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

12. Envie suas configurações de controle.

    Leva alguns minutos para que os controles recém-criados ou atualizados estejam prontos para exibir o tráfego em tempo real. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

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

curl

Faça uma solicitação Control.create com um ID de controle e uma instância de Control contida no corpo da solicitação.

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

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

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ],
                "boostAction": {
                  "boost": BOOST_NUMBER,
                  "productsFilter": "FILTER_EXPRESSION"
                }
              }
    }' \
    "https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?controlId=CONTROL_ID"
   

Leva alguns minutos para que os controles recém-criados ou atualizados estejam prontos para exibir o tráfego em tempo real. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

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

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

• Para um exemplo desse método, consulte Gerenciar configurações de exibição.

Console de merchandising

1. Clique no URL fornecido pelo administrador. Sign in.

   Isso leva você à página Controles no console de merchandising.

2. Clique em add_boxCriar controle.

3. Defina as metas para os usuários finais e o tempo necessário. Todas as perguntas precisam ser respondidas. Clique em Próxima.

4. Selecione um controle. Insira o nome do controle, selecione o produto Pesquisa ou Navegar e escolha o tipo de controle Filtro.

5. Configure o controle Filtro:

   1. Em Acionadores, defina qual atributo do catálogo aciona esse controle. Para isso, forneça critérios a uma consulta de pesquisa ou categoria de página relacionada, como contém ou não está no intervalo. Se nenhum atributo de catálogo tiver sido configurado, esse controle sempre será aplicado.

   2. Defina um período aplicável inserindo um período. Se algum dos intervalos de tempo especificados for atendido, o atributo do catálogo será correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um período com add_boxAdicionar período.

   3. Defina as ações de filtro que você quer acionar com esse controle. Essas 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 add_boxAdicionar atributo para incluir mais atributos.

6. Clique em Enviar para enviar sua solicitação de controle a um aprovador. Você poderá conferir o status das solicitações enviadas no console do Merchandising. Se você mudar de ideia, poderá excluir o pedido de controle.

Console do Cloud

1. Acesse a página Controles no console da Pesquisa para e-commerce.
   
   Acessar a página "Controles"

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

   O painel Criar controle é aberto.

3. Na seção Preferências, no campo Nome do controle, insira um nome para o novo controle.

4. Opcional: para mudar o ID de controle criado automaticamente, clique em Editar e insira um novo ID.

5. Escolha Controles de filtro como o tipo de controle.

6. Clique em "Continuar" para acessar a seção Acionadores.

7. Selecione o tipo de comportamento do usuário que aciona esse controle:

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

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

8. Opcional: defina uma condição de controle que acione a regra com base na categoria pesquisada ou na consulta feita. A opção disponível depende se você escolheu Procurar categorias ou Pesquisar:

   • Se você escolheu Procurar categorias: no campo Categorias, insira quais categorias vão acionar esse controle quando forem pesquisadas.

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

     • Correspondência parcial: esse controle se aplica quando uma consulta contém uma correspondência parcial para esse termo.
     • Correspondência completa: esse controle se aplica somente quando uma consulta contém uma correspondência completa a esse termo.

     Quando um desses termos é incluído em uma consulta, o controle é aplicado.

9. Opcional: clique no botão Adicionar período para incluir um ou mais períodos em que esse controle pode ser aplicado.

10. Clique em Continuar para acessar a seção Ações.

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

    Use a sintaxe da expressão de filtro documentada em Como filtrar e ordenar.

    Por exemplo, para especificar as versões em vermelho e azul de "produto1" e "produto2": (id: ANY("product1","product2")) AND (colorFamily: ANY("Red","Blue"))

12. Clique em Continuar para acessar a seção Configurações de veiculação.

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

14. Envie suas configurações de controle.

    Leva alguns minutos para que os controles recém-criados ou atualizados estejam prontos para exibir o tráfego em tempo real. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

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

curl

Faça uma solicitação Control.create com um ID de controle e uma instância de Control contida no corpo da solicitação.

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

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

O exemplo a seguir mostra campos para um controle acionado por navegação, em que searchSolutionUseCase 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 a seguir mostra campos para um controle acionado por 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 controle a uma configuração de exibição, use o método ServingConfig.addControl:

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

• Para um exemplo desse método, consulte Gerenciar configurações de exibição.

Console de merchandising

1. Clique no URL fornecido pelo administrador. Sign in.

   Isso leva você à página Controles no console de merchandising.

2. Clique em add_boxCriar controle.

3. Defina as metas para os usuários finais e o tempo necessário. Todas as perguntas precisam ser respondidas. Clique em Próxima.

4. Selecione um controle. Insira o nome do controle, selecione o produto Pesquisa e escolha o tipo de controle Redirecionar.

5. Configure o controle de Redirecionamento:

   1. Em Gatilhos, defina qual atributo do catálogo aciona esse controle fornecendo critérios para uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se nenhum atributo de catálogo tiver sido configurado, esse controle sempre será aplicado.

   2. Defina um período aplicável inserindo um período. Se algum dos intervalos de tempo especificados for atendido, o atributo do catálogo será correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um período com add_boxAdicionar período.

   3. Defina as ações de redirecionamento que você quer acionar com esse controle inserindo o URL de redirecionamento.

6. Clique em Enviar para enviar sua solicitação de controle a um aprovador. Você poderá conferir o status das solicitações enviadas no console do Merchandising. Se você mudar de ideia, poderá excluir o pedido de controle.

Console do Cloud

1. Acesse a página Controles no console da Pesquisa para e-commerce.
   
   Acessar a página "Controles"

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

   O painel Criar controle é aberto.

3. Na seção Preferências, no campo Nome do controle, insira um nome para o novo controle.

4. Opcional: para mudar o ID de controle criado automaticamente, clique em Editar e insira um novo ID.

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

6. Clique em "Continuar" para acessar a seção Acionadores.

7. Crie pelo menos um termo de consulta ou um gatilho de período. Os controles de redirecionamento exigem pelo menos um acionador:

8. Selecione o tipo de comportamento do usuário que aciona esse controle:

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

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

9. Defina uma condição de controle que acione a regra com base na categoria pesquisada ou na consulta pesquisada. A opção disponível depende se você escolheu Procurar categorias ou Pesquisar:

   • Se você escolheu Procurar categorias: no campo Categorias, insira quais categorias vão acionar esse controle quando forem pesquisadas.

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

     • Correspondência parcial: esse controle se aplica quando uma consulta contém uma correspondência parcial para esse termo.
     • Correspondência completa: esse controle se aplica somente quando uma consulta contém uma correspondência completa a esse termo.

     Quando um desses termos é incluído em uma consulta, o controle é aplicado.

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

11. Clique em Continuar para acessar a seção Ações.

12. Insira o URI para redirecionar quando esse controle for acionado.

13. Clique em Continuar para acessar a seção Configurações de veiculação.

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

15. Envie suas configurações de controle.

    Leva alguns minutos para que os controles recém-criados ou atualizados estejam prontos para exibir o tráfego em tempo real. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

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

curl

Faça uma solicitação Control.create com um ID de controle e uma instância de Control contida no corpo da solicitação.

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

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

O exemplo a seguir mostra campos para um controle acionado por navegação, em que searchSolutionUseCase 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 a seguir mostra campos para um controle acionado por 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 controle a uma configuração de exibição, use o método ServingConfig.addControl:

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

• Para um exemplo desse método, consulte Gerenciar configurações de exibição.

Console de merchandising

1. Clique no URL fornecido pelo administrador. Sign in.

   Isso leva você à página Controles no console de merchandising.

2. Clique em add_boxCriar controle.

3. Defina as metas para os usuários finais e o tempo necessário. Todas as perguntas precisam ser respondidas. Clique em Próxima.

4. Selecione um controle. Insira o nome do controle, selecione o produto Pesquisa e escolha o tipo de controle Sinônimos.

5. Configure o controle de sinônimos bidirecionais:

   1. Em Gatilhos, defina qual atributo do catálogo aciona esse controle fornecendo critérios para uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se nenhum atributo de catálogo tiver sido configurado, esse controle sempre será aplicado.

   2. Defina um período aplicável inserindo um período. Se algum dos intervalos de tempo especificados for atendido, o atributo do catálogo será correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um período com add_boxAdicionar período.

   3. Defina o Tipo de sinônimo que você quer acionar com esse controle. Selecione Bidirecional. Consulte a seção Sinônimos para mais informações sobre os tipos de sinônimos.

6. Clique em Enviar. Isso leva você a uma tela detalhada de configuração de sinônimo bidirecional.

7. Insira os sinônimos no campo em Ações de sinônimos bidirecionais. Essa ação vincula termos bidirecionalmente para serem tratados da mesma forma nos resultados da pesquisa. Assim, uma consulta "sofá vermelho" resulta em "sofá vermelho-marrom", mas as consultas "sofá marrom" são expandidas para incluir todos os tipos de sofás vermelhos, como carmesim ou rosa.

8. Clique em Enviar novamente para enviar sua solicitação de controle a um aprovador. Você poderá conferir o status das solicitações enviadas no console do Merchandising. Se você mudar de ideia, poderá excluir o pedido de controle.

Console do Cloud

1. Acesse a página Controles no console da Pesquisa para e-commerce.
   
   Acessar a página "Controles"

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

3. No campo Nome do controle, insira um nome para o novo controle.

   O painel Criar controle é aberto.

4. Você vai estar na seção Preferências.

5. Opcional: para mudar o ID de controle criado automaticamente, clique em Editar e insira um novo ID.

6. Escolha Controle de sinônimos bidirecionais como o tipo de controle.

7. Clique em "Continuar" para acessar a seção Acionadores.

8. Opcional: clique no botão Adicionar período para incluir um ou mais períodos em que esse controle pode ser aplicado.

9. Clique em Continuar para acessar a seção Ações.

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

    Quando qualquer um desses termos é incluído em uma consulta, a pesquisa considera os outros termos como sinônimos.

11. Clique em Continuar para acessar a seção Configurações de veiculação.

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

13. Envie suas configurações de controle.

    Leva alguns minutos para que os controles recém-criados ou atualizados estejam prontos para exibir o tráfego em tempo real. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

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

curl

Faça uma solicitação Control.create com um ID de controle e uma instância de Control contida no corpo da solicitação.

Para detalhes dos 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 inline às configurações de veiculação.

Console de merchandising

1. Clique no URL fornecido pelo administrador. Sign in.

   Isso leva você à página Controles no console de merchandising.

2. Clique em add_boxCriar controle.

3. Defina as metas para os usuários finais e o tempo necessário. Todas as perguntas precisam ser respondidas. Clique em Próxima.

4. Selecione um controle. Insira o nome do controle, selecione o produto Pesquisa e escolha o tipo de controle Sinônimos.

5. Configure o controle de sinônimos unidirecionais:

   1. Em Gatilhos, defina qual atributo do catálogo aciona esse controle fornecendo critérios para uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se nenhum atributo de catálogo tiver sido configurado, esse controle sempre será aplicado.

   2. Defina um período aplicável inserindo um período. Se algum dos intervalos de tempo especificados for atendido, o atributo do catálogo será correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um período com add_boxAdicionar período.

   3. Defina o Tipo de sinônimo que você quer acionar com esse controle. Selecione Somente ida. Consulte a seção Sinônimos para mais informações sobre os tipos de sinônimos.

6. Clique em Enviar. Isso leva você a uma tela detalhada de configuração de sinônimo unidirecional.

7. Insira seus sinônimos no campo em Ações de sinônimos unidirecionais. Essa ação vincula termos de forma unidirecional para serem tratados da mesma forma nos resultados da pesquisa. Assim, uma consulta de "sofá vermelho" inclui sofás vinho, mas uma consulta de "sofá vinho" não retorna outros tipos de sofás vermelhos, restringindo os resultados apenas a sofás vinho.

8. Clique em Enviar novamente para enviar sua solicitação de controle a um aprovador. Você poderá conferir o status das solicitações enviadas no console do Merchandising. Se você mudar de ideia, poderá excluir o pedido de controle.

Console do Cloud

1. Acesse a página Controles no console da Pesquisa para e-commerce.
   
   Acessar a página "Controles"

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

   O painel Criar controle é aberto.

3. Na seção Preferências, no campo Nome do controle, insira um nome para o novo controle.

4. Opcional: para mudar o ID de controle criado automaticamente, clique em Editar e insira um novo ID.

5. Escolha Controle de sinônimos unidirecional como o tipo de controle.

6. Clique em "Continuar" para acessar a seção Acionadores.

7. Opcional: clique no botão Adicionar período para incluir um ou mais períodos em que esse controle pode ser aplicado.

8. Clique em Continuar para acessar a seção Ações.

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

10. No campo Sinônimos, insira termos que devem ser usados como sinônimos para os termos de consulta especificados. Por exemplo, sneakers e sandals como sinônimos unidirecionais para o termo de consulta shoes.

11. Clique em Continuar para acessar a seção Configurações de veiculação.

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

13. Envie suas configurações de controle.

    Leva alguns minutos para que os controles recém-criados ou atualizados estejam prontos para exibir o tráfego em tempo real. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

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

curl

Faça uma solicitação Control.create com um ID de controle e uma instância de Control contida no corpo da solicitação.

Para detalhes dos 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:

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

• Para um exemplo desse método, consulte Gerenciar configurações de exibição.

Console de merchandising

1. Clique no URL fornecido pelo administrador. Sign in.

   Isso leva você à página Controles no console de merchandising.

2. Clique em add_boxCriar controle.

3. Defina as metas para os usuários finais e o tempo necessário. Todas as perguntas precisam ser respondidas. Clique em Próxima.

4. Selecione um controle. Insira o nome do controle, selecione o produto Pesquisa e escolha o tipo de controle Não associar.

5. Configure o controle Não associar:

   1. Em Gatilhos, defina qual atributo do catálogo aciona esse controle fornecendo critérios para uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se nenhum atributo de catálogo tiver sido configurado, esse controle sempre será aplicado.

   2. Defina um período aplicável inserindo um período. Se algum dos intervalos de tempo especificados for atendido, o atributo do catálogo será correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um período com add_boxAdicionar período.

   3. Em Não associar ações,especifique os termos que não podem ser associados aos termos de consulta inseridos na seção anterior Gatilhos. Insira-os nos campos "Termos da consulta" e "Termos dissociados", respectivamente.

6. Clique em Enviar para enviar sua solicitação de controle a um aprovador. Você poderá conferir o status das solicitações enviadas no console do Merchandising. Se você mudar de ideia, poderá excluir o pedido de controle.

Console do Cloud

1. Acesse a página Controles no console da Pesquisa para e-commerce.
   
   Acessar a página "Controles"

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

   O painel Criar controle é aberto.

3. Na seção Preferências, no campo Nome do controle, insira um nome para o novo controle.

4. Opcional: para mudar o ID de controle criado automaticamente, clique em Editar e insira um novo ID.

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

6. Clique em "Continuar" para acessar a seção Acionadores.

7. Opcional: clique no botão Adicionar período para incluir um ou mais períodos em que esse controle pode ser aplicado.

8. Clique em Continuar para acessar a seção Ações.

9. No campo Termos da consulta, insira termos (por exemplo, gShoe) que você quer diferenciar explicitamente de outros.

10. No campo Termos dissociados, insira termos que precisam ser dissociados dos resultados da pesquisa com os termos de consulta especificados.

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

11. Clique em Continuar para acessar a seção Configurações de veiculação.

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

13. Envie suas configurações de controle.

    Leva alguns minutos para que os controles recém-criados ou atualizados estejam prontos para exibir o tráfego em tempo real. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

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

curl

Faça uma solicitação Control.create com um ID de controle e uma instância de Control contida no corpo da solicitação.

Para detalhes dos 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:

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

• Para um exemplo desse método, consulte Gerenciar configurações de exibição.

Console de merchandising

1. Clique no URL fornecido pelo administrador. Sign in.

   Isso leva você à página Controles no console de merchandising.

2. Clique em add_boxCriar controle.

3. Defina as metas para os usuários finais e o tempo necessário. Todas as perguntas precisam ser respondidas. Clique em Próxima.

4. Selecione um controle. Insira o nome do controle, selecione o produto Pesquisa e escolha o tipo de controle Ignorar.

5. Configure o controle Ignorar:

   1. Em Gatilhos, defina qual atributo do catálogo aciona esse controle fornecendo critérios para uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se nenhum atributo de catálogo tiver sido configurado, esse controle sempre será aplicado.

   2. Defina um período aplicável inserindo um período. Se algum dos intervalos de tempo especificados for atendido, o atributo do catálogo será correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um período com add_boxAdicionar período.

   3. Insira os termos que você quer ignorar em Ignorar ações.

6. Clique em Enviar para enviar sua solicitação de controle a um aprovador. Você poderá conferir o status das solicitações enviadas no console do Merchandising. Se você mudar de ideia, poderá excluir o pedido de controle.

Console do Cloud

1. Acesse a página Controles no console da Pesquisa para e-commerce.
   
   Acessar a página "Controles"

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

   O painel Criar controle é aberto.

3. Na seção Preferências, no campo Nome do controle, insira um nome para o novo controle.

4. Opcional: para mudar o ID de controle criado automaticamente, clique em Editar e insira um novo ID.

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

6. Clique em "Continuar" para acessar a seção Acionadores.

7. Opcional: clique no botão Adicionar período para incluir um ou mais períodos em que esse controle pode ser aplicado.

8. Clique em Continuar para acessar a seção Ações.

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

10. Clique em Continuar para acessar a seção Configurações de veiculação.

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

12. Envie suas configurações de controle.

    Leva alguns minutos para que os controles recém-criados ou atualizados estejam prontos para exibir o tráfego em tempo real. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

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

curl

Faça uma solicitação Control.create com um ID de controle e uma instância de Control contida no corpo da solicitação.

Para detalhes dos 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:

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

• Para um exemplo desse método, consulte Gerenciar configurações de exibição.

Console de merchandising

1. Clique no URL fornecido pelo administrador. Sign in.

   Isso leva você à página Controles no console de merchandising.

2. Clique em add_boxCriar controle.

3. Defina as metas para os usuários finais e o tempo necessário. Todas as perguntas precisam ser respondidas. Clique em Próxima.

4. Selecione um controle. Insira o nome do controle, selecione o produto Pesquisa e escolha o tipo de controle Substituição.

5. Configure o controle de substituição:

   1. Em Gatilhos, defina qual atributo do catálogo aciona esse controle fornecendo critérios para uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se nenhum atributo de catálogo tiver sido configurado, esse controle sempre será aplicado.

   2. Defina um período aplicável inserindo um período. Se algum dos intervalos de tempo especificados for atendido, o atributo do catálogo será correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um período com add_boxAdicionar período.

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

6. Clique em Enviar para enviar sua solicitação de controle a um aprovador. Você poderá conferir o status das solicitações enviadas no console do Merchandising. Se você mudar de ideia, poderá excluir o pedido de controle.

Console do Cloud

1. Acesse a página Controles no console da Pesquisa para e-commerce.
   
   Acessar a página "Controles"

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

   O painel Criar controle é aberto.

3. Na seção Preferências, no campo Nome do controle, insira um nome para o novo controle.

4. Opcional: para mudar o ID de controle criado automaticamente, clique em Editar e insira um novo ID.

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

6. Clique em "Continuar" para acessar a seção Acionadores.

7. Opcional: clique no botão Adicionar período para incluir um ou mais períodos em que esse controle pode ser aplicado.

8. Clique em Continuar para acessar a seção Ações.

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

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

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

11. Clique em Continuar para acessar a seção Configurações de veiculação.

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

13. Envie suas configurações de controle.

    Leva alguns minutos para que os controles recém-criados ou atualizados estejam prontos para exibir o tráfego em tempo real. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

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

curl

Faça uma solicitação Control.create com um ID de controle e uma instância de Control contida no corpo da solicitação.

Para detalhes dos 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:

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

• Para um exemplo desse método, consulte Gerenciar configurações de exibição.

Console de merchandising

1. Clique no URL fornecido pelo administrador. Sign in.

   Isso leva você à página Controles no console de merchandising.

2. Clique em add_boxCriar controle.

3. Defina as metas para os usuários finais e o tempo necessário. Todas as perguntas precisam ser respondidas. Clique em Próxima.

4. Selecione um controle. Insira o nome do controle, selecione o produto Pesquisa e escolha o tipo de controle Fixação.

5. Configure o controle de fixação:

   1. Em Gatilhos, defina qual atributo do catálogo aciona esse controle fornecendo critérios para uma consulta de pesquisa relacionada, como contém ou não está no intervalo. Se nenhum atributo de catálogo tiver sido configurado, esse controle sempre será aplicado.

   2. Defina um período aplicável inserindo um período. Se algum dos intervalos de tempo especificados for atendido, o atributo do catálogo será correspondido à consulta durante qualquer um dos intervalos de tempo especificados. Adicione um período com add_boxAdicionar período.

   3. Defina as ações de fixação que você quer acionar com esse controle. Essas ações são definidas pelo ID do produto e pela posição do alfinete, de preferência um número menor que 120 (o tamanho típico da página). Clique em add_boxAdicionar produto e inclua até 10.

6. Clique em Enviar para enviar sua solicitação de controle a um aprovador. Você poderá conferir o status das solicitações enviadas no console do Merchandising. Se você mudar de ideia, poderá excluir o pedido de controle.

Console do Cloud

1. Acesse a página Controles no console da Pesquisa para e-commerce.
   
   Acessar a página "Controles"

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

   O painel Criar controle é aberto.

3. No campo Nome do controle da seção Preferências, insira um nome para o novo controle.

4. Opcional: para mudar o ID de controle criado automaticamente, clique em Editar e insira um novo ID.

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

6. Escolha Controle de fixação como o tipo de controle. Clique em Continuar.

7. Na seção Acionadores, escolha o comportamento do usuário que aciona esse controle:

   • Procurar categorias: as solicitações de navegação precisam ter o campo page_categories preenchido, além de search.request.query vazio.

   • Pesquisa: as solicitações de pesquisa exigem apenas que o search.request.query seja preenchido.

     Por padrão, todas as categorias navegadas e consultas pesquisadas acionam esse controle.

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

   • Procurar categorias: no campo Categorias, insira quais categorias acionam o controle.

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

9. Opcional: clique em Adicionar período ou Adicionar período para incluir um ou mais períodos em que esse controle pode ser aplicado.

10. Clique em Continuar para acessar a seção Ações. Para Fixar local, use o controle deslizante para especificar em qual posição os produtos serão fixados. O controle deslizante de fixação não aceita valores de 0, números negativos ou não inteiros.

    A Vertex AI para Pesquisa em e-commerce permite 10 fixações no mapa de fixações de um único controle. A posição pode ser qualquer valor entre 1 e 120 (o tamanho máximo da página de solicitação).

11. Clique em Continuar para acessar a seção Configurações de veiculação. Selecione as configurações de veiculação a que aplicar o controle e envie suas configurações de controle.

    Leva alguns minutos para que os controles recém-criados ou atualizados estejam prontos para exibir o tráfego em tempo real. É possível testar se as mudanças foram aplicadas na página Avaliar do console.

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

curl

Faça uma solicitação Control.create com um ID de controle e uma instância de Control contida no corpo da solicitação.

Para detalhes dos 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" \
 -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 pin_position precisa ser um número inteiro entre [1,10], incluindo esses valores, e o product_id precisa estar no seu catálogo. O número máximo de elementos permitidos no mapa de fixação é 10 para cada controle.

Em seguida, anexe o controle de fixação à sua configuração de veiculaçã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'

Nesse caso, CONTROL_ID deve ser o controle de fixação id criado anteriormente.

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

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

• Para um exemplo desse método, consulte Gerenciar configurações de exibição.

Console do Cloud

1. Acesse a página Avaliar no console da Pesquisa para e-commerce.
   
   Acessar a página "Avaliar"

2. Acesse a guia Pesquisar.

3. Insira uma consulta de teste no campo "Consulta de pesquisa".

4. Clique em Visualização da pesquisa.

5. Confira os resultados para garantir que os produtos escolhidos estejam 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"