Esta é a documentação apenas do Recommendations AI. Para testar a pesquisa de varejo e o console unificado de varejo na fase restrita do GA, entre em contato com a equipe de vendas do Cloud. Se você não quiser usar a pesquisa de varejo, permaneça no console de recomendações até novo aviso.

Se você estiver usando a versão v1beta do Recommendations AI, migre para a versão da API Retail.

Como usar recomendações em e-mails

Embora os resultados de previsão do Recommendations AI sejam mais usados em canais de site de varejo, também é possível usar recomendações em mensagens de e-mail. As recomendações no e-mail geralmente são incluídas como parte de explosões de e-mail de campanhas de marketing, e-mails pós-encomenda ou e-mails abandonados no carrinho.

Como escolher o tipo de modelo

O modelo "Recomendado para você" pode ser útil para e-mails, porque foi projetado para fornecer recomendações em casos de uso em que um usuário não indicou interesse em um item específico. Ele funciona melhor com usuários conectados que têm algum histórico de navegação ou compras.

O modelo "Outros como você pode gostar" é normalmente usado como um canal de página de detalhes do produto, e não para campanhas de e-mail. No entanto, você pode usá-lo para e-mails a fim de recomendar itens semelhantes ou complementares ao que um cliente visualizou recentemente.

O modelo de compras frequentes geralmente é usado na página "Adicionar ao carrinho" ou "Carrinho de compras", mas também pode ser usado para e-mail.

Requisitos de solicitação

Para recuperar as recomendações relevantes, o campo userId precisa corresponder ao ID do usuário associado a um usuário conectado no seu site ou app.

O ideal é que o campo visitorId corresponda ao último ID da sessão do usuário do site. Como o ID da última sessão nem sempre é registrado, um identificador exclusivo aleatório também pode ser enviado como o campo visitorId.

Os modelos "Comprados juntos com frequência" e "Outros" também podem exigir IDs do produto na seção productDetails da chamada de previsão. Para modelos juntos juntos, os IDs podem ser itens da compra mais recente de um usuário.

Incluir previsões estáticas no e-mail

Você pode enviar previsões estáticas inserindo dados em um modelo de e-mail.

O método predict pode ser chamado em tempo real à medida que os e-mails são enviados, ou as recomendações podem ser recuperadas individualmente e salvas como parte de um modelo de e-mail ou em um banco de dados para ser consultada posteriormente. Para ter as recomendações mais atualizadas, chame o método predict o mais próximo possível do horário de envio do e-mail.

Chamada do método predict para e-mail

O método predict do Recommendations AI usa alguns campos como entrada e retorna uma lista de recomendações de produtos. visitorId, userId e id são usados como entrada para a maioria dos modelos de Recommendations AI.

Cada solicitação de previsão para um usuário precisa ser feita individualmente, usando scripts de código ou shell.

Veja a seguir um pseudocódigo para uma solicitação de previsão:

for user in userlist:
  emailTemplate.recommendations = predict(user.visitorid,user.userid,user.lastorder.id,...)
...
format email template as required

Incluir previsões dinâmicas no e-mail

Embora as previsões estáticas sejam simples de implementar, elas podem ficar desatualizadas mais rapidamente do que as previsões dinâmicas. Talvez um usuário não abra o e-mail por algum tempo, e recomendações melhores podem estar disponíveis. Sistemas de e-mail em massa mais sofisticados podem adicionar conteúdo dinâmico com a inclusão de uma referência a uma imagem em um e-mail em HTML.

Veja abaixo um exemplo de HTML de uma imagem que inclui uma referência de canal:

<img src="https://example.com/recs/email?userid=47832&campaign=2020FALL&placement=fbt>

É possível recuperar as recomendações com uma Função do Google Cloud ou qualquer app do lado do servidor que possa fazer a solicitação de previsão. Os resultados da previsão precisam ser transformados em uma imagem. Isso pode ser feito com uma biblioteca, como a ImageMagick.

As previsões são baseadas apenas em e-mails abertos e visualizados. Também é possível armazenar os resultados em cache em vez de criar uma nova imagem se o usuário abrir o e-mail novamente. Isso reduz o custo do uso do Recommendations AI para e-mails.

Como o destino do link geralmente é codificado no e-mail, você não precisa saber quais produtos serão exibidos. Redirecionar cliques para páginas de produtos individuais requer configuração adicional. Geralmente, você usa uma única imagem para todas as recomendações. Portanto, o uso de um mapa de imagem pode ajudar a determinar qual produto foi clicado.

Cotas

Se você planeja executar um grande lote de solicitações de previsão em um curto período de tempo, verifique suas cotas. Na página Cotas do projeto, marque Solicitações de previsão de recomendação por projeto por minuto. É possível solicitar um aumento clicando em Editar cotas na página de detalhes da cota.

Recomendamos a implementação da espera exponencial (em inglês) para repetir solicitações após um atraso. O serviço retornará respostas HTTP 429 se a cota for excedida.

Como avaliar resultados

Com a inclusão de tags de URL, você pode acompanhar e avaliar a eficácia das campanhas. Use o Google Analytics ou outra plataforma de análise para adicionar parâmetros de acompanhamento a links em e-mails e incluir esses dados em relatórios. Cliques em recomendações de tags por e-mail para filtrá-los e avaliar as métricas.

Se você fizer testes A/B de várias recomendações, recomendamos fazer isso em uma única campanha. Todas as diretrizes padrão de testes A/B para sites ainda se aplicam.

A seguir