Nesta página, descrevemos como usar tokens de atribuição para melhorar o desempenho ao longo do tempo.
Os tokens de atribuição são IDs exclusivos gerados pela Vertex AI para Pesquisa para o varejo e retornados a cada solicitação de previsão ou pesquisa. Eles permitem que a Vertex AI para Pesquisa para varejo associe ações e resultados de usuários entre si e treine modelos de reclassificação para melhorar a qualidade dos resultados.
A inclusão de tokens de atribuição nos eventos do usuário é opcional. Se você não fornecer tokens de atribuição, a Vertex AI para Pesquisa para varejo fará uma aproximação dos tokens de atribuição alinhando os resultados na resposta de previsão ou pesquisa e os eventos do usuário ingeridos com base no ID do visitante e nos carimbos de data/hora.
Como os tokens de atribuição funcionam
Cada resposta retornada pelos métodos predict
ou search
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 um resultado da Vertex AI para Pesquisa para varejo,
é necessário retornar o token de atribuição desse resultado quando
o usuário interage com um produto retornado (por exemplo, uma visualização ou
um clique de add-to-cart
). Esse ciclo de feedback permite que a Vertex AI para Pesquisa
para o varejo forneça informações sobre como seus resultados estão afetando seus negócios.
Como você retorna o token de atribuição
Para retornar o token de atribuição, inclua-o no evento do usuário que você registrar para qualquer ação que o usuário execute com o produto em uma recomendação ou resultado da pesquisa. As ações que um usuário pode fazer com esse produto 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 no painel de recomendações ou nos resultados da pesquisa 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 ou nos resultados da pesquisa. Exemplo:
https://www.example.com/54321/?rtoken=abc123
Quando o usuário interage com esse produto no painel de recomendações ou nos resultados da pesquisa (que gera um evento do usuário), o token de atribuição pode ser analisado no link do URL e inserido no evento do usuário enviado à Vertex AI para Pesquisa para varejo para essa interação.
Por exemplo, suponha que você solicite uma previsão associada à exibição de um produto a um usuário. A Vertex AI para Pesquisa para varejo 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. Configure seu site para gravar esse evento e enviá-lo à Vertex AI para Pesquisa no varejo. Para ver um exemplo do objeto de evento do usuário, consulte este artigo. Quando o usuário clica em um dos produtos em um resultado para consultar uma visão mais detalhada, inclua o token de atribuição com o evento do usuário registrado nesse clique. O evento do usuário seria semelhante ao exemplo a seguir:
{ "eventType" : "detail-page-view", "visitorId": "visitor1", "userInfo": { "userId": "user1" }, "attributionToken": "abc123", "productDetails": [{ "product": { "id": "abc" } }] }
Quando o usuário interage com um produto exibido devido a uma recomendação ou um resultado de pesquisa e você inclui o token de atribuição com o evento do usuário para essa interação, a Vertex AI para Pesquisa para varejo usa essas informações para avaliação.
Por exemplo, suponha que o usuário veja um produto em um resultado da pesquisa e use o resultado para adicioná-lo à lista de desejos e também para ter uma visão detalhada do produto. Inclua o token de atribuição para os dois eventos do usuário gerados pelo resultado da pesquisa (add-to-cart
e detail-page-view
).
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 retirada da visualização detalhada, e não do resultado da pesquisa. Da mesma forma, se esse usuário comprar o produto, mas não diretamente do resultado da pesquisa, não haverá vantagem em retornar o token de atribuição com o evento de compra.