Tokens de atribuição

Os tokens de atribuição são IDs exclusivos gerados pela Vertex AI Search for commerce e devolvidos com cada pedido de pesquisa. Permitem que o Vertex AI Search for commerce associe um pedido de pesquisa ao respetivo 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 do Vertex AI Search for commerce para relatórios precisos.

Como funcionam os tokens de atribuição

Recolhe o attributionToken da resposta da API de uma pesquisa do utilizador. Existe um token de atribuição novo para cada pesquisa; os tokens de atribuição não se repetem.

Quando o Vertex AI Search for commerce publica um pedido de pesquisa ou recomendação, devolve um attributionToken exclusivo na respetiva resposta:

  • Este token é fundamental para associar ações subsequentes do utilizador (como cliques, adições ao carrinho e compras) à pesquisa ou recomendação específica que as originou.
  • É importante associar o token de pesquisa correto aos Eventos de pesquisa para que os Eventos de visualização de página detalhada, os Eventos de adição ao carrinho e os Eventos de compra possam ser associados corretamente.

Deve ser enviada uma resposta placements.search num evento de utilizador de pesquisa ou navegação e imediatamente no evento em que um utilizador interage com um produto. Isto inclui percursos do utilizador, como:

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

Comportamento do token de atribuição

Os tokens de atribuição:

  • Específico do visitante: o attributionToken está associado a uma resposta de pesquisa específica publicada para um determinado visitorId. Apenas o evento de pesquisa em si tem de ser etiquetado com o token. Todos os eventos não relacionados com a pesquisa subsequentes não devem ser etiquetados com um token.

  • Associado a eventos que ocorrem imediatamente após a pesquisa: o elemento attributionToken é particularmente importante para eventos de utilizador que representam uma interação direta com os resultados da pesquisa dessa pesquisa específica. Isto inclui eventos purchase-complete: a compra continua associada através dos IDs dos produtos e do visitorId.

    Nota: se um único utilizador realizar várias pesquisas, cada novo pedido de pesquisa gera um token de atribuição, e o evento de pesquisa subsequente deve conter esse novo token. Um token de atribuição de um evento de pesquisa anterior não é reutilizado para um evento de pesquisa subsequente, porque cada pesquisa inicia um novo token.

Tokens de atribuição na API Search

Cada resposta devolvida pelo método Vertex AI Search for commerce inclui um attributionToken único no final do corpo da resposta de pesquisa. Por exemplo:

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

Este token tem de 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"
}

O Vertex AI Search para comércio usa os dados de eventos para preparar os respetivos modelos. O token de atribuição oferece uma forma de associar o evento ao pedido, codificando o pedido de pesquisa completo e a resposta com os filtros, as facetas e os IDs dos produtos de resposta pedidos. Sem um token presente nos eventos de pesquisa, esses eventos são tratados como se não fossem da Pesquisa da Google Vertex AI, e os eventos de pesquisa podem ser usados incorretamente como se fossem de outro fornecedor de pesquisa.

Não há problema (e é esperado) ter eventos de pesquisa sem tokens se forem publicados a partir de outro fornecedor de pesquisas, por exemplo, durante uma experiência A/B. No entanto, normalmente, existe um mapeamento de 1:1 para pedidos da API Google Search para eventos de pesquisa com tokens.

Efeito adverso da falta de tokens

Se o attributionToken não estiver nos eventos de utilizador subsequentes relevantes do mesmo visitante, o Vertex AI Search for commerce trata esses eventos como se não tivessem origem no respetivo serviço de pesquisa.

Isto pode provocar:

  • Preparação do modelo imprecisa.
  • Métricas incorretas e análise de desempenho.
  • Potenciais problemas com a obtenção de níveis de desempenho mais elevados (como o Nível 3) que requerem eventos atribuíveis suficientes.
  • Erros comunicados no Painel de controlo de qualidade dos dados na Pesquisa para comércio se a percentagem de eventos com tokens de atribuição for inferior a 95%.

Para aprender com o comportamento do utilizador e otimizar os resultados da pesquisa, o Vertex AI Search para comércio requer uma atribuição precisa apenas para o evento de pesquisa inicial.

Qualidade dos dados do token de atribuição

O Painel de controlo da qualidade de dados na consola do Search for commerce mostra um Estado de erro de não conformidade crítico ou de bloqueio se a percentagem de eventos com tokens de atribuição for inferior a 95%. Caso contrário, o estado é apresentado como Em conformidade:

Texto alternativo

Normalmente, a qualidade dos dados no Nível 3, que é o modelo otimizado em função da receita, não é preparada sem eventos atribuíveis suficientes. Não recomendamos vivamente a implementação do Vertex AI Search for commerce em produção, a menos que esteja a publicar resultados no nível 3 ou 4. Para mais informações, consulte a secção Qualidade de dados sobre como desbloquear níveis de desempenho na página Qualidade de dados desta documentação.

Tokens de atribuição para recomendações

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

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

Registe as recomendações apresentadas como parte de panelInfo e defina:

panelInfo.attributionToken=PredictResponse.attributionToken