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
Cada resposta retornada pelo método de pesquisa da Vertex AI 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 seguinte:
{ "eventType": "search", "searchQuery":"red t-shirt", "productDetails":[ {"product":{"id":"727121"}}, {"product":{"id": … } ] , "visitorId":"GA1.1.1383176924.1721324981", "attributionToken":"dfB0CgwIgKrltAYQ8afX4AIQARokNjZjMGEwYjEtMDAwMC0yNjAyLTk0Y2UtNTgyNDI5Y2JkMzUwKgUxMjM0NTIkxcvzF6OAlyLo5KotmNa3LY6-nRW3t4wtwvCeFdSynRWb1rctOg5kZWZhdWx0X3NlYXJjaGgB" }
A Vertex AI Search for 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 a solicitação e a resposta de pesquisa completa 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 da Vertex AI 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, normalmente há um mapeamento 1:1 para as solicitações da API de pesquisa para pesquisar eventos com tokens.
Qualidade dos dados do token de atribuição
O painel "Qualidade dos dados" na seção "Pesquisa para comércio" vai mostrar 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":
A qualidade dos dados no NÍVEL 3, que é o modelo otimizado para receita, geralmente não é treinado sem eventos atribuíveis suficientes. Não é recomendável implantar a Vertex AI para Pesquisa para Commerce na produção, a menos que ela esteja exibindo 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.
Tokens de atribuição para recomendações
Como não há um evento para recomendações, não é necessário incluir tokens de atribuição de respostas predict em nenhum evento.
O token de atribuição da resposta de previsão pode ser enviado em eventos subsequentes (geralmente um detail-page-view ou add-to-cart), mas não é obrigatório. A implementação exigiria a transmissão do token de atribuição do produto recomendado em um parâmetro de URL para o URL da página do produto e, em seguida, o uso desse parâmetro para preencher o campo attributionToken do evento detail-page-view.
As recomendações da Vertex AI para Pesquisa criam automaticamente tokens sintéticos para eventos atribuíveis a solicitações predict. Adicionar os tokens explicitamente pode melhorar um pouco a precisão dos relatórios de análise. No entanto, isso não é estritamente necessário e terá pouco impacto nos modelos de recomendações.