Tokens de atribuição

Os tokens de atribuição são IDs exclusivos gerados pela Pesquisa em E-commerce com IA e retornados com cada solicitação de pesquisa. Eles permitem que a Pesquisa de comércio com IA 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 da pesquisa. Os tokens de atribuição também são necessários em eventos de pesquisa da Pesquisa de e-commerce com IA para 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 Pesquisa de e-commerce com IA atende a uma solicitação de pesquisa ou recomendação, ela retorna um attributionToken exclusivo na resposta.

Uma resposta placements.search precisa ser enviada de volta 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 em si precisa ser marcado com o token. Todos os eventos subsequentes que não são de pesquisa não devem ser marcados com um token.

  • Associado a eventos que seguem diretamente a pesquisa: o attributionToken é especialmente importante para eventos de usuário que representam uma interação direta com os resultados da pesquisa específica. Isso inclui eventos purchase-complete: a compra ainda está vinculada pelos IDs de produto 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 carregar 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 de pesquisa de comércio com IA inclui um attributionToken exclusivo no final do corpo da resposta de 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 Pesquisa de comércio eletrônico com IA 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 Pesquisa de e-commerce com IA 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 de usuário subsequentes relevantes do mesmo visitante, a Pesquisa de comércio com IA vai tratar esses eventos como se não tivessem sido originados do serviço de pesquisa dela.

Isso pode gerar:

  • Treinamento de modelo impreciso.
  • Métricas e análise 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 da Pesquisa de comércio com IA no Gemini Enterprise for Customer Experience 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 Pesquisa de comércio com IA exige uma atribuição precisa apenas para o evento de pesquisa inicial.

Qualidade de dados do token de atribuição

O painel de qualidade de dados na Pesquisa de comércio com IA no console do Gemini Enterprise for Customer Experience mostra um Status de erro crítico ou de não conformidade de bloqueio se a porcentagem de eventos com tokens de atribuição for inferior a 95%. Caso contrário, o Status vai aparecer como "Em conformidade":

Texto alternativo

A qualidade de 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 Pesquisa de comércio com IA 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 Pesquisa de e-commerce com IA 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 vai 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