Gerenciar configurações de exibição

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

Se precisar de ajuda para criar uma nova configuração de exibição, consulte Criar configurações de exibição.

Se você já tiver posições ou criar novas, a Vertex AI para Pesquisa para varejo vai criar automaticamente uma configuração de veiculação associada a cada uma. Criar uma configuração de veiculaçã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 também remove a configuração de veiculação correspondente.

Editar configurações de veiculação

É possível editar as configurações de exibição usando o console da Pesquisa for Retail ou a 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, esse modelo poderá retornar resultados abaixo do ideal durante o retreinamento. Como pode levar muito tempo para treinar novamente o modelo de otimização no nível da página, considere recriá-lo e a configuração de veiculação associada.

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

É possível ver e editar os controles de cada configuração de veiculação na página Configurações de exibição. Clique em uma configuração de veiculação para ver a página Detalhes dela, que lista todos os controles de exibição e de todo o site referentes a essa configuração.

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

Pode levar alguns minutos para que as configurações de veiculação recém-criadas ou atualizadas fiquem prontas para exibir o tráfego ativo. É 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 e adicionar controles de veiculação e remover esses controles inline usando métodos de API.

Configurações de exibição de patch inline

Para atualizar os 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 sem definição 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 veiculação, use ServingConfig.addControl. O controle é adicionado na última posição da lista a que ele 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 veiculaçã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 configurações de veiculação

É possível visualizar as configurações de exibição usando o console do Search for Retail ou a API.

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

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

Visualizar configurações de exibição inline

Para conferir uma única configuração de veiculaçã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 exibição inline, use ServingConfig.list.

Se preferir, use 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 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 exibição usando o console da Pesquisa for Retail 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, exclua e recrie o modelo. Caso contrário, o modelo de otimização no nível da página retornará a configuração de veiculação excluída.

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

Para excluir uma configuração de veiculação no console, faça o seguinte:

1. Acesse a página Configurações de veiculação no console da Pesquisa for Retail.
   
   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 dela 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 revisar estatísticas de configuração de veiculação

É possível conferir os detalhes de cada configuração de veiculação na página Configurações de veiculaçã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.