Gerenciar configurações de exibiçã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 receber ajuda com a criação de uma nova configuração de veiculação, consulte Crie configurações de veiculação.

Se você já tiver ou criar novas posições, a Vertex AI para Pesquisa para Retail cria automaticamente uma configuração de veiculação associada a cada veiculação. Criar uma configuração de veiculação não cria um a 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 veiculaçã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 alterações significativas em uma configuração de veiculação que contenha um modelo de otimização no nível da página, esse modelo poderá retornar resultados abaixo do ideal, embora seja o retreinamento. 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 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 de veiculação para ver a página Detalhes, que lista todas as configurações controles 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 veiculação, adicionar controles de veiculação e remover de exibição in-line usando métodos da API.

Patch das configurações de veiculaçã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 o campos para atualizar com o parâmetro updateMask ou deixá-lo indefinido para atualizar todos os campos aceitos.

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 do 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 ver as configurações de exibição usando o console do Search for Retail. ou a API.

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

Confira todas as configurações de veiculação na Página "Configurações de exibição".

Conferir 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 exibiçã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 incluirá um token de página. É possível transmitir um token de página no parâmetro pageToken de um 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 retornará a configuração de veiculação excluída.

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

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

1. Acesse a página Configurações de exibição no console do Search 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, insira novamente o ID e clique em Confirmar para concluir a exclusão.

Excluir uma configuração de veiculação in-line

Para excluir uma única configuração de veiculação in-line, 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 estatísticas de configuração de veiculação

Você pode ver detalhes de cada configuração de veiculaçã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.

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.