A Vertex AI para Pesquisa no varejo está sendo renomeada como Vertex AI para Pesquisa no comércio. Estamos atualizando o conteúdo para refletir o novo branding.

Esta página foi traduzida pela API Cloud Translation.

Gerenciar configurações de exibiçã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 veiculação para que a pesquisa funcione. Qualquer serving_config_id pode ser colocado como parte da solicitação de pesquisa. Nesse caso, o padrão é um controle de exibição vazio ou não configurado. Em seguida, o catálogo é pesquisado com o recurso de pesquisa padrão da Vertex AI para Pesquisa no comércio.

Se você tiver posições existentes ou criar novas posições, a Vertex AI Search para e-commerce vai 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 remove o posicionamento correspondente, e a exclusão de um posicionamento remove 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 e-commerce ou a API.

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 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 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 de exibição, adicionar e remover controles de exibição inline usando métodos da API.

Fazer patch inline nas configurações de veiculação

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 sem definição para atualizar todos os campos compatíveis.

Para mais informações 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 inline às configurações de veiculação

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 pertence. Por exemplo, um controle facetSpec é aplicado na última posição de servingConfig.facetSpecIds.

Para mais informações 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 mais informações 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'

Ver configurações de exibição

É possível conferir as configurações de exibição usando o console de pesquisa para comércio ou a API.

Ver configurações de veiculaçã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 veiculaçã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 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 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 mais informações 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 configurações de exibição usando o console da Pesquisa para e-commerce ou a API.

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

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

Acesse a página Configurações de exibição no console da Pesquisa para e-commerce.

Acessar a página "Configurações de exibição"
Clique na configuração de veiculação que você quer excluir para abrir a página de detalhes.
Clique em Excluir na barra de botões na parte superior da página.
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 veiculação inline

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

Para mais informações 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 as estatísticas de 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.