Tokens de atribuição

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.