Receber recomendações

Esta página descreve como pedir recomendações de produtos para um utilizador específico e um evento do utilizador.

Depois de carregar os seus produtos e registar eventos do utilizador, pode pedir recomendações de produtos para utilizadores específicos com base nos eventos do utilizador registados para esse utilizador e na respetiva atividade atual. Pode demorar até 48 horas para que os novos produtos e eventos do utilizador se reflitam no modelo de recomendação.

O Vertex AI Search for commerce devolve uma lista de identificadores de produtos classificados. É responsável por renderizar os resultados no seu Website com imagens e texto.

Nunca colocar em cache resultados personalizados de um utilizador final e nunca devolver resultados personalizados a um utilizador final diferente.

Antes de começar

Tem de criar um Google Cloud projeto e configurar a autenticação através dos passos descritos em Antes de começar.

Antes de poder pedir previsões a partir de recomendações, precisa de:

Avalie as recomendações

Antes de atualizar o código do Website para pedir recomendações, pode usar os resultados da previsão de pré-visualização para confirmar que o modelo e a configuração de publicação estão a funcionar como esperado.

Para mais informações sobre as configurações de publicação, consulte o artigo Acerca das configurações de publicação.

Pré-visualize os resultados da configuração de publicação na página Avaliar ou acedendo à página Detalhes de uma configuração de publicação na consola e clicando no separador Avaliar.

Para pré-visualizar as recomendações devolvidas pela configuração de publicação:

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

    Aceda à página Avaliar

  2. Clique no separador Recomendações, se ainda não estiver selecionado.

  3. Selecione a configuração de publicação que quer pré-visualizar.

  4. Opcional: introduza um ID do visitante para pré-visualizar as recomendações para esse utilizador.

  5. Se a secção Itens associados for apresentada, clique em Adicionar item e introduza um ID do produto para receber recomendações associadas a esse item. Pode adicionar vários itens associados.

    A adição de itens só está disponível se o tipo de modelo da configuração de publicação selecionada exigir produtos como entrada para recomendações. Os modelos Recomendado para si não requerem a introdução de itens associados.

  6. Clique em Pré-visualização da previsão para ver os resultados da previsão.

Para ver a página Detalhes da configuração de publicação em pré-visualização, clique em Ver configuração de publicação no campo Selecionar configuração de publicação.

Receba uma recomendação

A API Recommendations tem limites no número de itens devolvidos. No entanto, existem soluções alternativas para aumentar o número de itens devolvidos.

Maximize o valor da ficha de navegação

Esta secção descreve como tirar o máximo partido das suas fichas de navegação na Vertex AI Search for commerce através do processamento eficaz de categorias, garantindo o modelo de nível de dados mais elevado e desbloqueando a personalização.

Processamento eficaz de categorias

  • Use nomes de categorias de páginas únicos e descritivos para garantir um acompanhamento preciso do comportamento do utilizador e da aprendizagem do modelo.
  • Estruture as categorias de geral para específico, permitindo que os utilizadores refinem progressivamente a respetiva experiência de navegação.
  • Evite categorias demasiado específicas com interação limitada dos utilizadores.

Garantir o modelo de nível mais elevado

Aceda à página Qualidade de dados

Em seguida, para configurar o modelo de nível mais elevado:

  1. Implemente o acompanhamento de eventos do utilizador para captar interações do utilizador (cliques, compras, adicionar ao carrinho) para a pesquisa e a navegação.

  2. Monitorize o carregamento de dados e a disponibilidade do modelo através do painel de controlo Qualidade dos dados da Vertex AI Search for commerce.

Consulte a secção Qualidade de dados para ver mais informações sobre os níveis de dados para pesquisa e navegação.

Melhore o desempenho com a personalização

Uma vez que é um modelo de classificação que aprende com o comportamento do utilizador, uma grande parte do desempenho do modelo de navegação provém das respetivas capacidades de personalização.

  • Ative a personalização quando avaliar o desempenho do modelo.
  • A desativação da personalização afeta o desempenho e minimiza o potencial impacto do modelo.
  • A personalização deve estar ativa antes de expor os resultados da navegação ao tráfego de produção em direto ou aos testes A/B.

Aumente os limites

  • O limite para os resultados do Vertex AI Search for commerce é de 120.

  • A API Recommendations suporta a reclassificação de até 2000 itens.

  • Embora a latência aumente, é possível aumentar o tamanho da página até 500 ou 1000.

Soluções alternativas

Para as páginas de categorias, pode personalizá-las e reclassificá-las através de recomendações pessoais. Para contornar o limite de 120 resultados, faça várias chamadas simultâneas para o primeiro número de páginas indicado e, em seguida, junte os resultados para parecerem uma página grande.

Para restringir manualmente o conjunto de recomendações devolvidas aos utilizadores finais, pode adicionar critérios de filtro em consultas PredictRequest.params.

Marque os atributos selecionados como filtráveis através da API e, em seguida, consulte-os diretamente nos respetivos pedidos de previsão.

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

curl

Para receber uma recomendação, faça um pedido POST ao método REST predict e forneça o corpo do pedido adequado:

  • A conta de serviço que usa tem de ter a função "Visualizador de retalho" ou superior.

  • Substitua SERVING_CONFIG_ID pela configuração de publicação onde vai usar as previsões. Saiba mais.

  • Se importou eventos de utilizadores do Google Analytics 360 através do BigQuery, defina visitorId como o ID de cliente do Google Analytics. Consulte a documentação do Google Analytics para saber como obter o ID do cliente.

  • Se estiver a executar uma experiência A/B, defina experimentIds como o ID deste grupo de experiência. Saiba mais.

  • Forneça um objeto de evento do utilizador para a ação do utilizador que iniciou o pedido de recomendação.

    Tenha em atenção que este evento do utilizador não é registado. É usado apenas para fornecer contexto para este pedido de recomendação. Também deve registar o evento do utilizador da mesma forma que regista outros eventos do utilizador.

  • Opcionalmente, forneça um filtro para restringir os potenciais produtos devolvidos. Saiba mais.

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth application-default