Receber recomendações

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

Depois de fazer upload dos produtos e registrar eventos do usuário, é possível solicitar recomendações de produtos para usuários específicos com base nos eventos registrados e na atividade atual deles. Pode levar até 48 horas para que novos produtos e eventos de usuários sejam refletidas no modelo de recomendação.

A Vertex AI para Pesquisa para varejo retorna uma lista de identificadores de produto classificados. Você está responsável por renderizar os resultados no seu site com imagens e texto.

Nunca armazenar em cache resultados personalizados de um usuário final, nunca retornar resultados personalizados para um usuário final diferente.

Antes de começar

Você precisa criar um Google Cloud projeto e configurar a autenticação usando as etapas em Antes de começar.

Além disso, antes de solicitar previsões recomendações, você precisa recomendação treinada e ajustada (modelo) e um ou mais configurações de veiculação.

Avaliar as recomendações

Antes de atualizar o código do seu site para solicitar recomendações, você pode usar visualizar os resultados da previsão para confirmar que o modelo e a configuração de exibição funcionando conforme o esperado.

Para mais informações sobre configurações de exibição, consulte Sobre as configurações de exibição.

É possível visualizar os resultados da configuração de veiculação na página Avaliar ou acessar a página Detalhes de uma configuração de exibição no console e clicar na Guia Avaliar. As etapas a seguir mostram como visualizar a partir do Avaliar.

Para visualizar as recomendações retornadas pela configuração de veiculação, faça o seguinte:

  1. Acesse a página Avaliar no console do Search for Retail.

    Acessar a página "Avaliar"

  2. Clique na guia Recomendações se ela ainda não estiver selecionada.

  3. Selecione a configuração de veiculação que você quer visualizar.

  4. Opcional: insira um ID de visitante para visualizar as recomendações desse usuário.

  5. Se a seção Itens associados for mostrada, clique em Adicionar item e insira um ID do produto para receber recomendações associadas a esse item. Você pode adicionar vários itens associados.

    A adição de itens só está disponível se o tipo de modelo da configuração de veiculação selecionada exige produtos como entrada para as recomendações. Os modelos Recomendado para você não exigem a inserção de itens associados.

  6. Clique em Visualização da previsão para conferir os resultados.

Para acessar a página Detalhes da configuração de veiculação que você está visualizando, clique em Veja a configuração de veiculação no campo Selecionar configuração de veiculação.

Receba uma recomendação

Para detalhes sobre custos de previsão, consulte Preços.

curl

Para receber uma recomendação, faça uma solicitação POST para o método REST predict e forneça o corpo da solicitação apropriado:

  • A conta de serviço usada precisa ter a função "Visualizador de varejo" ou superior.

  • Substitua SERVING_CONFIG_ID pela configuração de veiculação. você vai usar as previsões. Saiba mais

  • Se você importou os eventos do usuário do Google Analytics 360 usando o BigQuery, defina visitorId como o ID do cliente do Google Analytics. Consulte a documentação do Google Analytics para saber como conseguir o ID do cliente.

  • Se você estiver executando um experimento A/B, defina experimentIds como o ID desse grupo. Saiba mais

  • Forneça um objeto de evento do usuário para as ações do usuário iniciadas com a solicitação de recomendação.

    Saiba que esse evento de usuário não é registrado, ele é usado apenas para fornecer contexto sobre a solicitação de recomendação. Você também deve registrar o usuário do mesmo modo que você registra eventos de outros usuários.

  • Como opção, forneça um filtro para restringir os produtos em potencial retornados. Saiba mais.

curl -X POST \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    --data '{
              "filter": "FILTER_STRING",
              "validateOnly": false,
              "userEvent": {
                  "eventType": "detail-page-view",
                  "visitorId": "VISITOR_ID",
                  "userInfo": {
                      "userId": "USER_ID",
                      "ipAddress": "IP_ADDRESS",
                      "userAgent": "USER_AGENT"
                  },
                  "experimentIds": "EXPERIMENT_GROUP",
                  "productDetails": [{
                      "product": {
                        "id": "PRODUCT_ID"
                     }
                  }]
              }
            }' \
https://retail.googleapis.com/v2/projects/PROJECT_ID/locations/global/catalogs/default_catalog/servingConfigs/SERVING_CONFIG_ID:predict

Os resultados serão semelhantes aos exibidos abaixo:

{
  "results": [{"id": "sample-id-1"}, {"id": "sample-id-2"}],
  "attribution_token": "sample-atr-token"
}

Você precisa associar o valor attribution_token a qualquer URL exibido como resultado dessa previsão e retorná-lo aos eventos do usuário para esses URLs. Saiba mais.

Java

public static PredictResponse predictWithNextPageToken(UserEvent userEvent, int pageSize,
    String nextPageToken)
    throws IOException, InterruptedException {
  PredictionServiceClient predictionClient = getPredictionServiceClient();

  PredictRequest request = PredictRequest.newBuilder()
      .setPlacement(HOME_PAGE_PLACEMENT_NAME)
      .setUserEvent(userEvent)
      .setPageSize(pageSize)
      .setPageToken(nextPageToken)
      .setValidateOnly(true)
      .build();

  PredictResponse response = predictionClient.predict(request);

  predictionClient.shutdownNow();
  predictionClient.awaitTermination(2, TimeUnit.SECONDS);

  return response;
}

Reclassificação de preços

A reclassificação de preços organiza, por ordem decrescente de preço, os itens recomendados do catálogo que têm probabilidade similar de serem pedidos. A relevância ainda é usada para solicitar itens. Portanto, ativar a reclassificação de preços não é o mesmo que classificar por preço.

A reclassificação de preços pode ser definida no nível de configuração de veiculação ou por previsão solicitação.

Ao escolher a configuração de reclassificação de preços, como criar uma configuração de veiculação na Pesquisa para varejo essa configuração será aplicada a todas as recomendações sem precisar de outras ações.

Se você precisar controlar a reclassificação de preços de uma recomendação específica, pode fazer isso usando o PredictRequest.params. Isso substitui qualquer configuração de reclassificação no nível da configuração que se aplicaria a essa recomendação.

Diversidade de recomendações

A diversificação afeta se os resultados retornados de uma única solicitação de previsão são de categorias diferentes do seu catálogo de produtos.

A diversificação pode ser definida no nível da configuração de disponibilização ou por previsão solicitação.

Ao escolher essa configuração, como criar uma configuração de veiculação na Pesquisa para varejo essa configuração será aplicada, por padrão, a todas as recomendações exibidas pelo sem precisar de outras ações.

Se você precisar controlar a diversidade de uma recomendação específica, faça Portanto, usando o PredictRequest.params. Isso substitui qualquer configuração de diversificação no nível da configuração que se aplicaria a essa recomendação. Veja os valores aceitos.

Usar filtros de recomendação

É possível filtrar as recomendações retornadas usando o campo filter no método predict. Para mais informações, consulte Filtrar recomendações.

Chamadas Prediction com modelos de otimização no nível da página

Fornecer recomendações usando a otimização no nível da página requer uma chamada de previsão extra etapa.

Faça uma chamada de previsão inicial usando uma configuração de exibição que contenha a otimização no nível da página um modelo de machine learning. A resposta de previsão retorna uma lista classificada de elementos IDs de configuração que representam o modelo a ser usado em cada painel.

Em seguida, faça uma chamada de previsão para cada painel usando o ID de configuração de veiculação Modelo de otimização no nível da página recomendado para isso. A resposta de previsão contém o modelo nome (como Recomendado para você) e uma lista de itens recomendados para exibição no painel.

A reclassificação de preços, a diversidade de recomendações e os filtros de recomendação não são disponível para configurações de veiculação usando o modelo de otimização no nível da página.

Monitorar e resolver problemas de recomendações

Depois de configurar seu site para receber recomendações, recomendamos que você defina configurar alertas. Consulte Configurar um alerta para erros de previsão.

Para resolver erros, consulte Monitoramento e solução de problemas.