Gerenciar configurações de veiculação

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

Para ajuda na criação de uma nova configuração de exibição, consulte Criar configurações de exibição.

Não é necessário configurar uma configuração de exibição para que a pesquisa funcione. Qualquer serving_config_id pode ser colocado como parte da solicitação de pesquisa. Nesse caso, ele é definido como um controle de exibição vazio ou não configurado. Em seguida, o catálogo é pesquisado com a capacidade de pesquisa padrão da Pesquisa de comércio com IA.

Se você tiver posições atuais ou criar novas, a Pesquisa de comércio com IA criará automaticamente uma configuração de exibição associada a cada posição. A criação de uma configuração de exibição não cria uma posição correspondente. A exclusão de uma configuração de exibição exclui a posição correspondente, e a exclusão de uma posição exclui a configuração de exibição correspondente.

Editar configurações de exibição

É possível editar configurações de exibição usando a Pesquisa de comércio com IA no console do Gemini Enterprise for Customer Experience ou na API.

Observação: se você estiver fazendo mudanças significativas em uma configuração de exibição que contém um modelo de otimização no nível da página, o modelo de otimização no nível da página poderá retornar resultados abaixo do ideal enquanto estiver sendo treinado novamente. Como pode levar muito tempo para treinar novamente o modelo de otimização no nível da página, considere recriar o modelo de otimização no nível da página e a configuração de exibição associada a ele.

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

É possível ver 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 ver a respectiva 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ânsito 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.

Aplicar patch em configurações de exibição inline

Para atualizar campos em uma configuração de exibiçã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 não definido para atualizar todos os campos compatíveis.

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

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 a 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 mais informações sobre esse método, consulte a ServingConfig.addControl 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" \
-d '{
      "controlID": "CONTROL_ID"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:addControl'

Remover controles de 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 ServingConfig.removeControl 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" \
-d '{
      "controlID": "CONTROL_ID"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:removeControl'

Ver configurações de exibição

É possível ver configurações de exibição usando a Pesquisa de comércio com IA no console do Gemini Enterprise for Customer Experience ou na API.

Ver configurações de disponibilização no console

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

Ver configurações de exibição inline

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

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

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 exibição inline, use ServingConfig.list.

Opcionalmente, é 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 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 mais informações sobre esse método, consulte a ServingConfig.list referência da API.

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 exibição

É possível excluir configurações de exibição usando a Pesquisa de comércio com IA no console do Gemini Enterprise for Customer Experience ou na API.

Observação: se você excluir uma configuração de exibiçã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 exibição no console

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

1. Acesse a página Configurações de exibição na Pesquisa de comércio com IA no console do Gemini Enterprise for Customer Experience.
   
   Acessar a página "Configurações de exibição"

2. Clique na configuração de exibiçã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 exibição for considerada ativa, insira novamente o ID e clique em Confirmar para concluir a exclusão.

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

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

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

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 revisar as estatísticas de configuração do serviço

Veja 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 exibiçã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.