O Retail está sendo renomeado para Vertex AI para Pesquisa para Retail. 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, conforme além de analisar as estatísticas de cada configuração.

Para saber como criar uma nova configuração de exibição, consulte Criar configurações de exibiçã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. Ao excluir uma configuração de veiculação, o canal correspondente e excluir um canal exclui seu configuração de veiculação.

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.

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 um 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 veiculação recém-criadas ou atualizadas sejam para veicular o tráfego em tempo real. É possível testar as mudanças imediatamente na página Avaliar.

Editar configurações de veiculaçã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.

Configurações de veiculação de patch 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 veiculaçã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'

Ver configurações de veiculação

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

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

É possível conferir 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 veiculação in-line, 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.

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

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

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

Acesse a página Configurações de exibição no console do Search for Retail.

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 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

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.

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.