Tokens de atribuição

Os tokens de atribuição são IDs exclusivos gerados pela Vertex AI para Pesquisa de comércio e retornados com cada solicitação de pesquisa. Eles permitem que a Vertex AI para Pesquisa no comércio associe uma solicitação de pesquisa ao evento de pesquisa correspondente, o que permite que os modelos de reclassificação melhorem a qualidade das respostas de pesquisa. Os tokens de atribuição também são necessários nos eventos de pesquisa da Vertex AI para Pesquisa no comércio para gerar relatórios precisos.

Como os tokens de atribuição funcionam

Você coleta o attributionToken da resposta da API de uma pesquisa do usuário. Há um novo token de atribuição para cada pesquisa, e eles não são repetidos.

Quando a Vertex AI para Pesquisa no comércio atende a uma solicitação de pesquisa ou recomendação, ela retorna um attributionToken exclusivo na resposta:

• Esse token é essencial para vincular ações subsequentes do usuário (como cliques, adição ao carrinho e compras) à pesquisa ou recomendação específica que as gerou.
• É importante vincular o token de pesquisa correto aos Eventos de pesquisa para que os Eventos de visualização de página detalhada, Eventos de adição ao carrinho e Eventos de compra possam ser conectados corretamente.

Uma resposta placements.search precisa ser enviada em um evento de usuário de pesquisa ou navegação e imediatamente quando um usuário interage com um produto. Isso inclui jornadas do usuário como:

• search (SIM) → add-to-cart (SIM)
• search (SIM) → detail-page-view (SIM)
• search (SIM) → purchase (NÃO). O usuário não está interagindo diretamente com um produto no momento da compra da mesma forma que com um clique ou add-to-cart, mas a compra ainda é atribuída à pesquisa original.

Comportamento do token de atribuição

Os tokens de atribuição são:

• Específico do visitante: o attributionToken está associado a uma resposta de pesquisa específica veiculada a um visitorId específico. Somente o evento de pesquisa precisa ser marcado com o token. Todos os eventos não relacionados à pesquisa subsequentes não devem ser marcados com um token.

• Associado a eventos que seguem diretamente a pesquisa: o attributionToken é particularmente importante para eventos do usuário que representam uma interação direta com os resultados da pesquisa específica. Isso inclui eventos de conclusão da compra: a compra ainda está vinculada pelos IDs de produtos e visitorId.

  Observação: se um único usuário fizer várias pesquisas, cada nova solicitação vai gerar um token de atribuição, e o evento de pesquisa subsequente vai incluir esse novo token. Um token de atribuição de um evento de pesquisa anterior não é reutilizado em um evento de pesquisa subsequente, porque cada pesquisa inicia um novo token.

Tokens de atribuição na API Search

Cada resposta retornada pelo método da Pesquisa da Vertex AI para e-commerce inclui um attributionToken exclusivo no final do corpo da resposta da pesquisa. Exemplo:

{
  "results": [
    {
      "id": "727121",
      "product": {
…
     }
  ],
  "totalSize": 19600,
  "attributionToken": "dfB0CgwIgKrltAYQ8afX4AIQARokNjZjMGEwYjEtMDAwMC0yNjAyLTk0Y2UtNTgyNDI5Y2JkMzUwKgUxMjM0NTIkxcvzF6OAlyLo5KotmNa3LY6-nRW3t4wtwvCeFdSynRWb1rctOg5kZWZhdWx0X3NlYXJjaGgB",
  "nextPageToken": "AM1MDZiNWOyQjM4UTLlNGN50iMwYjMtADMwATLwIGMhBzY2YDJaIw-bCbxQYAt1PJgIwgExEgC"
…

Esse token precisa ser incluído no evento de pesquisa subsequente:

{
"eventType": "search",
"searchQuery":"red t-shirt", 
"productDetails":[
  {"product":{"id":"727121"}}, {"product":{"id":  …
  }
] ,
"visitorId":"GA1.1.1383176924.1721324981",
"attributionToken":"dfB0CgwIgKrltAYQ8afX4AIQARokNjZjMGEwYjEtMDAwMC0yNjAyLTk0Y2UtNTgyNDI5Y2JkMzUwKgUxMjM0NTIkxcvzF6OAlyLo5KotmNa3LY6-nRW3t4wtwvCeFdSynRWb1rctOg5kZWZhdWx0X3NlYXJjaGgB"
}

A Vertex AI para Pesquisa para e-commerce usa os dados de eventos para treinar os modelos. O token de atribuição oferece uma maneira de vincular o evento à solicitação, codificando toda a solicitação e resposta de pesquisa com os filtros, facetas e IDs de produtos de resposta solicitados. Sem um token presente nos eventos de pesquisa, eles são tratados como se não fossem da Vertex AI para Pesquisa do Google, e podem ser usados incorretamente como se fossem de outro provedor de pesquisa.

É normal (e esperado) ter eventos de pesquisa sem tokens se eles forem veiculados por outro provedor de pesquisa, durante um experimento A/B, por exemplo. No entanto, geralmente há um mapeamento de 1:1 para solicitações da API Search para eventos de pesquisa com tokens.

Efeito negativo da falta de tokens

Se o attributionToken não estiver nos eventos subsequentes relevantes do mesmo visitante, a Vertex AI para Pesquisa de e-commerce vai tratar esses eventos como se não tivessem sido originados do serviço de pesquisa dela.

Isso pode gerar:

• Treinamento impreciso do modelo.
• Métricas e análises de performance incorretas.
• Possíveis problemas para alcançar níveis de performance mais altos (como o nível 3) que exigem eventos atribuíveis suficientes.
• Erros informados no painel de qualidade de dados na Pesquisa para e-commerce se a porcentagem de eventos com tokens de atribuição for inferior a 95%.

Para aprender com o comportamento do usuário e otimizar os resultados da pesquisa, a Vertex AI para Pesquisa no comércio exige atribuição precisa apenas para o evento de pesquisa inicial.

Qualidade dos dados do token de atribuição

O painel de qualidade dos dados no console da Pesquisa para e-commerce mostra um Status de erro crítico ou de bloqueio de não conformidade se a porcentagem de eventos com tokens de atribuição for inferior a 95%. Caso contrário, o Status vai aparecer como "Em conformidade":

A qualidade dos dados no nível 3, que é o modelo otimizado para receita, geralmente não é treinada sem eventos atribuíveis suficientes. Não é recomendável implantar a Vertex AI para Pesquisa para Commerce em produção, a menos que ela esteja veiculando resultados no nível 3 ou 4. Para mais informações, consulte a seção "Qualidade de dados" sobre como desbloquear níveis de performance na página Qualidade de dados desta documentação.

Tokens de atribuição para recomendações

As recomendações da Vertex AI para Pesquisa criam automaticamente tokens sintéticos para eventos atribuíveis a solicitações predict.

Para previsões de recomendações, se um usuário clicar em um produto recomendado, o PredictResponse.attribution_token será transmitido como um parâmetro de URL para a página do produto e registrado no evento detail-page-view.

Registre as recomendações exibidas como parte de panelInfo e defina:

panelInfo.attributionToken=PredictResponse.attributionToken