Nesta página, descrevemos como usar tokens de atribuição para melhorar o desempenho da recomendação ao longo do tempo.
Os tokens de atribuição são IDs exclusivos, gerados pelo Recommendations AI e retornados em cada solicitação de previsão, que permitem que o Recommendations AI associe as ações do usuário e as recomendações uns aos outros, para fornecer métricas de receita e da taxa de conversão.
A inclusão de tokens de atribuição nos eventos do usuário é opcional. Se você não fornecer tokens de atribuição, o Recommendations AI aproximará esses tokens, alinhando-os na resposta de previsão e nos eventos do usuário ingeridos com base no código do visitante e nos carimbos de data/hora. Saiba mais.
Como os tokens de recomendação funcionam
Cada recomendação retornada pelo método predict inclui um attributionToken
exclusivo no corpo da resposta.
Exemplo:
{ "results": [{"id": "352"}, {"id": "456"}], "attribution_token": "abc123" }
Quando seu site mostra um produto com base em uma recomendação do Recommendations AI, é preciso retornar o token de atribuição dessa recomendação quando o usuário interage com um produto recomendado (por exemplo, uma visualização ou um clique para adicionar ao carrinho). Esse loop de feedback permite que o Recommendations AI forneça informações sobre como as recomendações estão afetando seus negócios. Para mais informações, consulte Como avaliar o desempenho do recomendador.
Como você retorna o token de atribuição
Para retornar o token de atribuição, basta incluí-lo no evento de usuário registrado para qualquer ação que o usuário execute com o produto recomendado. As ações que um usuário pode realizar com um produto recomendado dependem do design do site. ações comuns incluem adicionar um produto a uma lista de favoritos, solicitar uma visualização detalhada, adicioná-lo a um carrinho de compras ou uma compra de um clique.
Para retornar o token de atribuição, primeiro é preciso associá-lo ao produto como ele é exibido em um painel de recomendações no seu site. Uma maneira comum de fazer isso é anexá-lo a todos os URLs associados a ações que podem ser realizadas no painel de recomendações. Exemplo:
https://www.example.com/54321/?rtoken=abc123
Depois, quando o usuário interage com esse produto no painel de recomendações (que gera um evento de usuário), o token de atribuição pode ser analisado a partir do link do URL e inserido no evento do usuário que você enviar para as recomendações. IA para essa interação.
Por exemplo, suponha que você solicite uma previsão associada à exibição de um produto a um usuário. O Recommendations AI retorna um conjunto de IDs de catálogo recomendados com um token de atribuição associado.
{ "results": [{"id": "352"}, {"id": "456"}], "attribution_token": "abc123" }
Seu site exibe os itens recomendados em um painel de recomendações e inclui o token de atribuição retornado para essa previsão com cada URL no painel de recomendações. Quando o usuário clicar em um dos produtos recomendados
para ter uma visualização mais detalhada desse produto, inclua o
token de atribuição com o evento do usuário detail-page-view
registrado nesse
clique. O evento de usuário seria semelhante ao exemplo a seguir:
{ "eventType" : "detail-page-view", "visitorId": "visitor1", "userInfo": { "userId": "user1" }, "attributionToken": "abc123", "productDetails": [{ "product": { "id": "123" "priceInfo": { "originalPrice": 49.00, "price": 44.00, "currencyCode": "USD" } } }] }
Quando o usuário interage com um produto exibido devido a uma recomendação e você inclui o token de atribuição com o evento do usuário para essa interação, o Recommendations AI usa essas informações para avaliação.
Por exemplo, suponha que o usuário veja um produto em um painel de recomendações e use esse painel para adicioná-lo à lista de desejos e também ter uma visualização detalhada do produto. É necessário incluir o token de atribuição dos dois eventos de usuário gerados no painel de recomendações (adicionar à lista e visualização de página de detalhes).
Agora, suponha que o mesmo usuário adicione esse produto ao carrinho a partir da visualização detalhada. Não é necessário incluir o token de atribuição com essa ação, porque ela foi tirada da visualização detalhada, não do painel de recomendação. Da mesma forma, se esse usuário comprar o produto, mas não diretamente do painel de recomendações, não haverá vantagem em retornar o token de atribuição com o evento de compra.
A seguir
- Avalie o desempenho da recomendação.
- Saiba como gravar eventos de usuário.