Gerenciar controles de disponibilização

Esta página descreve como visualizar, editar, excluir, exportar e importar controles de veiculação.

Para informações gerais sobre controles de exibição e instruções sobre como criar controles de exibição, consulte Sobre os controles de exibição e Criar controles de exibição.

Ver e editar controles de exibição

É possível conferir os controles de veiculação da Vertex AI para Pesquisa para e-commerce usando o console e a API.

Ver e editar controles de exibição no console

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

Também é possível ver e editar os controles de uma configuração de exibição específica na página Configurações de exibição. Clique em uma configuração de exibição para acessar a página Detalhes, que lista todos os controles de exibição dessa configuração. Clique no ícone editEditar controle para mudar as configurações de um controle no painel Editar controle. Clique no ícone do_not_disturb_onRemover controle para dissociar o controle da configuração de exibição. Isso não exclui o controle.

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

Ver controles de veiculação inline

Para ver um controle de veiculação única inline, use Control.get.

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

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

Para listar vários controles de exibição inline, use Controls.list.

Também é possível usar o parâmetro pageSize para definir um número máximo de resultados a serem retornados. Se houver mais resultados disponíveis, a resposta list vai incluir um token de página. É possível transmitir um token de página no parâmetro pageToken de uma solicitação list para recuperar a próxima página de resultados.

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

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

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

Correção inline dos controles de veiculação

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

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

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

Adicionar controles inline às configurações de veiculação

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

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

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

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

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

Excluir um controle de exibição

É possível excluir um controle de exibição do console ou inline usando o método Controls.delete.

Excluir um controle de exibição no console

Exclua um controle de exibição para remover esse controle de todas as configurações de exibição que o usam.

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

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

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

Excluir um controle de exibição inline

Para excluir controles de exibição inline, use Controls.delete.

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

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

Exportar controles de veiculação

É possível exportar os controles de veiculação para um arquivo em um bucket do Cloud Storage.

Há dois motivos para exportar e importar controles de veiculação:

• Mover controles de veiculação de um projeto para outro.

• Para fazer uma edição em massa em todos ou em alguns controles de exibição. Exporte os controles de veiculação, edite o arquivo exportado e importe-o para mudar ou adicionar controles de veiculação.

É possível exportar e importar pelo console da Pesquisa para e-commerce. Ao exportar controles de veiculação, você exporta todos os controles do projeto.

Para exportar controles de veiculação, faça o seguinte:

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 Exportar controles.

3. Na janela Exportar controles de veiculação, selecione o bucket do Cloud Storage para onde você quer exportar o arquivo de controles.

4. Clique em Exportar.

   Os controles exportados são salvos em um arquivo NDJSON no bucket selecionado com um nome no seguinte formato:

   projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

5. Depois que a operação de exportação for concluída, você poderá conferir o status dela na lista Importação, exportação e exclusão de atividades em massa na janela Exportar atividade. Abra a janela Exportar atividade clicando em Mostrar na janela de mensagem ou seguindo as instruções em Ver o status de uma operação de integração específica.

Importar controles de veiculação

Para adicionar ou modificar controles de exibição em massa, faça as mudanças em um arquivo de controles exportado. Em seguida, importe para o projeto original ou para outro.

O que saber sobre a importação de controles de veiculação:

• Não é possível importar um arquivo de controle de veiculação se ele tiver controles de veiculação de pesquisa e de recomendações.

• Quando você importa controles de veiculação, todos os controles no arquivo são associados à configuração de veiculação especificada na importação. Se um controle de veiculação já estiver associado a outra configuração de veiculação no projeto, essa associação também será mantida.

Para importar controles de exibição, faça o seguinte:

1. Edite e revise um arquivo de controle de veiculação exportado e coloque-o em um bucket do Cloud Storage. Para exportar controles de veiculação, consulte a tarefa anterior Exportar controles de veiculação.

   Verifique se o arquivo contém apenas controles de veiculação de pesquisa ou de recomendações. Não é possível importar um arquivo que contenha os dois tipos.

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

3. Na guia Controles de veiculação, clique em Importar controles.

4. Na janela Importar controles de veiculação:

   1. Procure e selecione o bucket do Cloud Storage e o arquivo NDJSON que contém os controles que você quer importar.

   2. Selecione a configuração de veiculação que você quer associar aos controles de veiculação importados.

   3. Analise o plano de prévia da importação. Os controles que serão criados são mostrados na guia Novo, e os que serão modificados aparecem na guia Modificado.

5. Clique em Importar.

   Uma operação de longa duração é iniciada para importar os controles novos e modificados.

6. Depois que a operação de importação for concluída, você poderá conferir o status dela na guia Controles da janela Status da atividade. Abra a janela Status da atividade clicando em Mostrar na janela de mensagem ou seguindo as instruções em Ver o status de uma operação de integração específica.