Faça a gestão de modelos

Esta página descreve como otimizar, pausar, retomar, eliminar e listar modelos de recomendações. Para obter ajuda na criação de um novo modelo de recomendações, consulte o artigo Crie modelos de recomendações.

Recomendações gerais para a qualidade do modelo

Geralmente, os eventos devem ser carregados, pelo menos, diariamente para manter uma boa qualidade de dados.

  • Limites de antiguidade dos dados: os eventos de utilizador anteriores a 2015 não são aceites. Para sugestões de aprendizagem automática, o sistema usa eventos de utilizadores dos últimos 180 dias. Da mesma forma, as métricas de eventos de utilizadores com mais de 180 dias ou geradas há mais de 180 dias não são exportáveis.

  • IDs de visitantes únicos: o número total de IDs de visitantes únicos para cada tipo de evento deve ser, pelo menos, 100 para garantir dados suficientes para resultados de qualidade.

A maioria dos modelos tem o melhor desempenho com, pelo menos, três meses de visualizações de páginas de produtos, visualizações de páginas iniciais e eventos add-to-cart.

Para o modelo Frequentemente comprados em conjunto, recomenda-se um a dois anos de histórico de compras. Este modelo requer especificamente uma das seguintes opções:

  • Em média, 10 ocorrências por artigo do catálogo (com um período de 1 ano de eventos de conclusão de compra).

  • Ambos: 90 dias de eventos de conclusão de compras no último ano e 1000 eventos de conclusão de compras nesse mesmo ano.

Uma a duas semanas de visualizações de páginas de detalhes podem ser suficientes para começar a formar os modelos Outros produtos de que pode gostar e Recomendados para si.

Ajuste um modelo

A Vertex AI Search for commerce usa os dados de entrada que fornece ao seu modelo para ajustar os hiperparâmetros para a preparação.

A otimização demora 2 a 4 dias, durante os quais o modelo continua a funcionar como habitualmente. Para ver detalhes dos custos de otimização, consulte a secção Preços.

Defina a frequência de otimização de um modelo

Recomendamos que ajuste periodicamente o seu modelo. Isto mantém a preparação do modelo ideal à medida que os dados mudam e o comportamento dos clientes difere ao longo do ano. Além disso, algumas atualizações importantes do modelo interno só podem ser aplicadas depois de o modelo ter sido otimizado.

Quando cria o modelo, pode defini-lo para ser ajustado automaticamente a cada três meses ou optar por ajustá-lo apenas manualmente. Independentemente da definição que escolher, o modelo é ajustado automaticamente uma vez após a criação.

Pode alterar a definição do estado de sincronização em qualquer altura. A alteração desta definição não afeta os processos de otimização em execução.

Para editar a definição do estado de otimização de um modelo:

Consola

  1. Aceda à página Modelos na consola de pesquisa para comércio.

    Aceda à página Modelos

    Pode ver o estado da otimização de cada modelo em Estado da otimização.

  2. Clique no nome de um modelo para ver a respetiva página de detalhes.

  3. Clique em Editar junto a Estado da sintonia.

  4. Na lista pendente, selecione uma definição:

    • De três em três meses. Ajusta-se automaticamente quando o último ajuste foi há 90 dias.
    • Apenas ajuste manual. Ajusta apenas quando ajusta manualmente.

  5. Clique em Concluído para guardar a definição.

curl

Faça um pedido Models.patch através da API. Consulte a referência da API Models.patch.

Para ver detalhes sobre todos os campos Models, consulte a Models 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/models/MODEL_ID",
  "PeriodicTuningState": "NEW_TUNING_STATE_VALUE"
}' \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID?updateMask=PeriodicTuningState'

Ajuste manualmente um modelo

A otimização manual aciona uma otimização única do seu modelo. Pode ajustar manualmente o modelo quando houver uma alteração significativa no catálogo (como um aumento do tamanho ou uma alteração na hierarquia do catálogo) ou nos eventos (como o preenchimento de eventos do histórico ou uma alteração na distribuição de dados após a promoção de determinados grupos de artigos).

Para ajustar manualmente um modelo:

Consola

  1. Aceda à página Modelos na consola de pesquisa para comércio.

    Aceda à página Modelos

  2. Clique no nome de um modelo para ver a respetiva página de detalhes.

  3. Clique em Ajuste manual na barra de botões.

    A otimização demora 2 a 4 dias, durante os quais o modelo continua a funcionar como habitualmente.

curl

Faça um pedido Models.tune através da API. Consulte a referência da API Models.tune.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:tune'

Pause e retome a preparação de um modelo

Se o modelo estiver ativo (não em pausa), é novamente preparado, pelo menos, uma vez por semana, mas não mais do que uma vez por dia. Para uma reciclagem consistente, certifique-se de que carrega dados de eventos do utilizador no prazo de 24 horas após a ocorrência do evento.

Pode pausar o modelo para parar a preparação. Pode querer fazê-lo se tiver importado dados incorretos ou para permanecer abaixo do limite de 10 modelos ativos por projeto. Se tiver menos de 10 modelos ativos, pode reiniciar um modelo pausado em qualquer altura.

Para ver detalhes dos custos de preparação, consulte a secção Preços.

Pode iniciar até cinco operações de modelos por minuto. As operações de modelos limitadas incluem a criação, a eliminação, a pausa e a retoma.

Para pausar ou reiniciar um modelo:

Consola

  1. Aceda à página Modelos na consola de pesquisa para comércio.

    Aceda à página Modelos

    Pode ver o estado da preparação de todos os modelos em Estado da preparação.

  2. Para pausar um modelo ativo (Estado de preparação de PREPARAÇÃO), clique em Pausar .

  3. Para iniciar um modelo em pausa (Estado da preparação de PAUSADO), clique em Retomar .

curl

Para pausar um modelo ativo, faça um pedido Models.pause através da API. Consulte a referência da API Models.pause.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:pause'

Para iniciar um modelo em pausa, faça um pedido Models.resume através da API.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID:resume'

Ver detalhes do modelo

Veja os detalhes de um modelo na consola ou através do método da API Models.get.

Para ver as configurações de publicação associadas a um modelo específico, use este procedimento. Todos os outros detalhes do modelo estão disponíveis na consola e na resposta da API.

Consola

  1. Aceda à página Modelos na consola de pesquisa para comércio.

    Aceda à página Modelos

  2. A página Modelos apresenta todos os seus modelos e os respetivos estados de preparação e consulta.

  3. Clique no nome de um modelo para ver a respetiva página de Detalhes.

curl

Para obter as informações de um único modelo, faça um pedido Models.get através da API. Consulte a referência da API Models.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/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'

Apresente uma lista dos seus modelos

Veja uma lista dos seus modelos na consola ou através do método da API Models.list.

Consola

  1. Aceda à página Modelos na consola de pesquisa para comércio.

    Aceda à página Modelos

  2. A página Modelos apresenta todos os seus modelos e os respetivos estados de preparação e consulta.

curl

Para listar todos os modelos e os respetivos detalhes inline, faça um pedido Models.list usando a API. Consulte a referência da API Models.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 list resposta inclui um token de página. Pode transmitir um token de página no parâmetro pageToken de um pedido list para obter a página seguinte de resultados. Este exemplo usa ambos os parâmetros.

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/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

Elimine um modelo

Pode iniciar até cinco operações de modelos por minuto. As operações de modelos limitadas incluem a criação, a eliminação, a pausa e a retoma.

Elimine um modelo na consola ou através do método da API Models.delete.

Consola

  1. Aceda à página Modelos na consola de pesquisa para comércio.

    Aceda à página Modelos

  2. Clique no nome do modelo que quer eliminar para abrir a respetiva página de detalhes.

  3. Clique em Eliminar na barra de botões.

  4. Introduza novamente o nome do modelo e clique em Confirmar.

curl

Faça um pedido Models.delete através da API. Consulte a referência da API Models.delete.

Para ver detalhes sobre todos os campos Models, consulte a Models 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/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'