Esta documentação do Recommendations AI faz referência ao console do Recommendations. Recomendamos migrar para o console de varejo e usar a documentação de varejo, que documenta o Recommendations AI, o console de varejo e a pesquisa de varejo.

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

Tokens de atribuição

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