Gerenciar configurações de veiculação

Esta página descreve como excluir, editar e listar configurações de exibição, além de analisar estatísticas sobre cada configuração.

Para saber como criar uma nova configuração de exibição, consulte Criar configurações de exibição.

Se você tiver posições existentes ou criar novas, a Vertex AI Search for Retail cria automaticamente uma configuração de exibição associada a cada posição. Criar uma configuração de exibição não cria uma posição correspondente. A exclusão de uma configuração de exibição exclui o posicionamento correspondente, e a exclusão de um posicionamento exclui a configuração de exibição correspondente.

Editar configurações de exibição

É possível editar as configurações de exibição usando o console da Pesquisa para varejo ou a API.

Observação: se você estiver fazendo mudanças significativas em uma configuração de veiculação que contém um modelo de otimização no nível da página, ele poderá retornar resultados subótimos durante o reensino. Como pode levar muito tempo para treinar novamente o modelo de otimização no nível da página, recomendemos recriar o modelo de otimização no nível da página e a configuração de veiculação associada.

Editar as configurações de exibição no console

É possível conferir e editar os controles de cada configuração de exibição 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 e em todo o site para essa configuração.

Nesta página, é possível editar controles, criar novos ou aplicar controles existentes à configuração.

Leva alguns minutos para que as configurações de exibição recém-criadas ou atualizadas estejam prontas para exibir o tráfego em tempo real. É possível testar as mudanças imediatamente na página Avaliar.

Editar configurações de exibição inline

É possível atualizar campos de configuração de exibição, adicionar controles de exibição e remover controles de exibição inline usando métodos de API.

Patch de configurações de exibição inline

Para atualizar campos em uma configuração de veiculação, use ServingConfig.patch e inclua uma instância de ServingConfig no corpo da solicitação. Especifique os campos a serem atualizados com o parâmetro updateMask ou deixe-o indefinido para atualizar todos os campos com suporte.

Para saber mais sobre esse método, consulte a referência da API ServingConfig.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/servingConfigs/SERVING_CONFIG_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/servingConfigs/SERVING_CONFIG_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

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

Para adicionar um controle a uma configuração de exibição, use ServingConfig.addControl. O controle é adicionado na última posição da lista de controles a que pertence. Por exemplo, um controle facetSpec é aplicado na última posição de servingConfig.facetSpecIds.

Para saber mais sobre esse método, consulte a referência da API ServingConfig.addControl.

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

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

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

Para saber mais sobre esse método, consulte a referência da API ServingConfig.removeControl.

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

Conferir as configurações de exibição

É possível conferir as configurações de exibição usando o console da Pesquisa para varejo ou a API.

Conferir as configurações de veiculação no console

É possível conferir todas as configurações de exibição na página Configurações de exibição.

Visualizar configurações de exibição inline

Para ver uma única configuração de exibição inline, use ServingConfig.get.

Para saber mais sobre esse método, consulte a referência da API ServingConfig.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/servingConfigs/SERVING_CONFIG_ID'

Para listar todas as configurações de veiculação inline, use ServingConfig.list.

Também é possível usar o parâmetro pageSize para definir um número máximo de resultados a serem retornados. Se mais resultados estiverem 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 saber mais sobre esse método, consulte a referência da API ServingConfig.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/servingConfigs?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

Excluir uma configuração de veiculação

É possível excluir as configurações de veiculação usando o console da Pesquisa para varejo ou a API.

Observação: se você excluir uma configuração de veiculação que está sendo usada por um modelo de otimização no nível da página, também exclua e recrie o modelo de otimização no nível da página. Caso contrário, o modelo de otimização no nível da página vai retornar a configuração de exibição excluída.

Excluir configurações de veiculação no console

Para excluir uma configuração de veiculação no console:

1. Acesse a página Configurações de exibição no console da Pesquisa para varejo.
   
   Acessar a página "Configurações de exibição"

2. Clique na configuração de veiculação que você quer excluir para abrir a página de detalhes.

3. Clique em Excluir na barra de botões na parte superior da página.

4. Se a configuração de veiculação for considerada ativa, digite novamente o ID e clique em Confirmar para concluir a exclusão.

Excluir uma configuração de veiculação inline

Para excluir uma única configuração de veiculação inline, use ServingConfig.delete.

Para saber mais sobre esse método, consulte a referência da API ServingConfig.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/servingConfigs/SERVING_CONFIG_ID'

Como analisar as estatísticas da configuração de veiculação

Confira os detalhes de cada configuração de exibição na página Configurações de exibição. Para qualquer configuração na tabela, clique em Visualizar análise para ver suas estatísticas.

A taxa de cliques mostra os cliques por pesquisa para a configuração de veiculação. Taxa de conversão indica as compras por pesquisa para a configuração.

Observação: os períodos das estatísticas estão no fuso horário do Pacífico. Por exemplo, as estatísticas diárias representam os dados de ontem à meia-noite do horário do Pacífico até hoje à meia-noite do horário do Pacífico.