Faça a gestão das configurações de publicação

Esta página descreve como eliminar, editar e listar configurações de publicação, bem como rever estatísticas sobre cada configuração.

Para obter ajuda na criação de uma nova configuração de publicação, consulte o artigo Crie configurações de publicação.

Não é necessário configurar uma configuração de publicação para que a pesquisa funcione. Qualquer serving_config_id pode ser colocado como parte do pedido de pesquisa. Nesse caso, é predefinido para um controlo de publicação vazio ou não configurado. Em seguida, o catálogo é pesquisado com a capacidade de pesquisa predefinida do Vertex AI Search for commerce.

Se tiver posicionamentos existentes ou criar novos posicionamentos, o Vertex AI Search for commerce cria automaticamente uma configuração de publicação associada a cada posicionamento. A criação de uma configuração de publicação não cria um posicionamento correspondente. A eliminação de uma configuração de publicação elimina o respetivo posicionamento correspondente e a eliminação de um posicionamento elimina a respetiva configuração de publicação correspondente.

Edite as configurações de publicação

Pode editar as configurações de publicação através da consola de pesquisa para comércio ou da API.

Nota: se estiver a fazer alterações significativas a uma configuração de publicação que contenha um modelo de otimização ao nível da página, o modelo de otimização ao nível da página pode devolver resultados abaixo do ideal enquanto está a ser novamente preparado. Uma vez que pode demorar muito tempo a voltar a formar o modelo de otimização ao nível da página, considere recriar o modelo de otimização ao nível da página e a respetiva configuração de publicação associada.

Edite as configurações de publicação na consola

Pode ver e editar os controlos de cada configuração de publicação na página Configurações de publicação. Clique numa configuração de publicação para ver a respetiva página Detalhes, que apresenta todos os controlos de publicação e ao nível do site para essa configuração.

Nesta página, pode editar controlos, criar novos controlos ou aplicar controlos existentes à configuração.

As configurações de publicação recém-criadas ou atualizadas demoram alguns minutos a ficar prontas para publicar tráfego em direto. Pode testar as alterações imediatamente na página Avaliar.

Edite configurações de publicação inline

Pode atualizar os campos de configuração de publicação, adicionar controlos de publicação e remover controlos de publicação inline através de métodos da API.

Aplique patches às configurações de publicação inline

Para atualizar campos numa configuração de publicação, use ServingConfig.patch e inclua uma instância de ServingConfig no corpo do pedido. Especifique os campos a atualizar com o parâmetro updateMask ou deixe-o não definido para atualizar todos os campos suportados.

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

Adicione controlos às configurações de publicação inline

Para adicionar um controlo a uma configuração de publicação, use ServingConfig.addControl. O controlo é adicionado na última posição da lista de controlos à qual pertence. Por exemplo, um controlo facetSpec é aplicado na última posição de servingConfig.facetSpecIds.

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

Remova os controlos das configurações de publicação incorporadas

Para remover um controlo de uma configuração de publicação, use ServingConfig.removeControl.

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

Veja as configurações de publicação

Pode ver as configurações de publicação através da consola de pesquisa de comércio ou da API.

Veja as configurações de publicação na consola

Pode ver todas as suas configurações de publicação na página de configurações de publicação.

Veja as configurações de publicação inline

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

Para mais informações sobre este 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 apresentar todas as configurações de publicação inline, use ServingConfig.list.

Opcionalmente, pode usar o parâmetro pageSize para definir um número máximo de resultados a devolver. Se estiverem disponíveis mais resultados, a resposta list inclui um token de página. Pode transmitir um token de página no parâmetro pageToken de um pedido para obter a página seguinte de resultados.list

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

Elimine uma configuração de publicação

Pode eliminar as configurações de publicação através da consola de pesquisa para comércio ou da API.

Nota: se eliminar uma configuração de publicação que esteja a ser usada por um modelo de otimização ao nível da página, também deve eliminar e voltar a criar o modelo de otimização ao nível da página. Caso contrário, o modelo de otimização ao nível da página devolve a configuração de publicação eliminada.

Elimine configurações de publicação na consola

Para eliminar uma configuração de publicação na consola:

1. Aceda à página Configurações de publicação na consola do Search for commerce.
   
   Aceda à página Configurações de publicação

2. Clique na configuração de publicação que quer eliminar para abrir a respetiva página de detalhes.

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

4. Se a configuração de publicação for considerada ativa, tem de voltar a escrever o respetivo ID e clicar em Confirmar para concluir a eliminação.

Elimine uma configuração de publicação inline

Para eliminar uma única configuração de publicação inline, use ServingConfig.delete.

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

Rever as estatísticas de configuração da publicação

Pode ver detalhes de cada configuração de publicação na página Configurações de publicação. Para qualquer configuração na tabela, clique em Ver estatísticas para ver as respetivas estatísticas.

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

Nota: 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, hora do Pacífico, até hoje à meia-noite, hora do Pacífico.