Jetons d'attribution

Les jetons d'attribution sont des identifiants uniques générés par Vertex AI Search pour le commerce et renvoyés avec chaque requête de recherche. Ils permettent à Vertex AI Search pour le commerce d'associer une requête de recherche à l'événement de recherche correspondant, ce qui permet aux modèles de reclassement d'améliorer la qualité des réponses de recherche. Les jetons d'attribution sont également requis dans les événements de recherche Vertex AI Search pour le commerce pour générer des rapports précis.

Fonctionnement des jetons d'attribution

Vous collectez le attributionToken à partir de la réponse de l'API à la recherche d'un utilisateur. Un nouveau jeton d'attribution est généré pour chaque recherche. Les jetons d'attribution ne sont pas répétés.

Lorsque Vertex AI Search pour le commerce traite une requête de recherche ou de recommandation, il renvoie un attributionToken unique dans sa réponse.

Une réponse placements.search doit être renvoyée dans un événement utilisateur de recherche ou de navigation, et immédiatement si un utilisateur interagit avec un produit. Cela inclut les parcours utilisateur suivants :

search (OUI) → add-to-cart (OUI)
search (OUI) → detail-page-view (OUI)
search (OUI) → purchase (NON) (L'utilisateur n'interagit pas directement avec un produit au moment de l'achat de la même manière qu'avec un clic ou un add-to-cart, bien que l'achat soit toujours attribué à la recherche d'origine.)

Comportement des jetons d'attribution

Les jetons d'attribution sont les suivants :

Spécifiques aux visiteurs : le attributionToken est associé à une réponse de recherche spécifique fournie à un `visitorId. Seul l'événement de recherche lui-même doit être associé au jeton. Tous les événements ultérieurs qui ne sont pas des événements de recherche ne doivent pas être associés à un jeton.
Associés aux événements qui suivent directement la recherche : le attributionToken est particulièrement important pour les événements utilisateur qui représentent une interaction directe avec les résultats de recherche de cette recherche spécifique. Cela inclut les événements de finalisation de l'achat : l'achat est toujours associé via les ID de produit et le visitorId.

Remarque : Si un même utilisateur effectue plusieurs recherches, chaque nouvelle requête de recherche génère un jeton d'attribution, et l'événement de recherche suivant doit comporter ce nouveau jeton. Un jeton d'attribution provenant d'un événement de recherche précédent n'est pas réutilisé pour un événement de recherche ultérieur, car chaque recherche lance un nouveau jeton.

Jetons d'attribution dans l'API Search

Chaque réponse renvoyée par la méthode Vertex AI Search pour le commerce inclut un attributionToken unique à la fin du corps de la réponse de recherche. Exemple :

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

Ce jeton doit être inclus dans l'événement de recherche suivant :

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

Vertex AI Search pour le commerce utilise les données d'événement pour entraîner ses modèles. Le jeton d'attribution permet d'associer l'événement à la requête, en encodant la requête et la réponse de recherche complètes avec les filtres, les attributs et les ID de produit de réponse demandés. Si aucun jeton n'est présent dans les événements de recherche, ces événements sont traités comme s'ils ne provenaient pas de Google Vertex AI Search, et ils peuvent être utilisés de manière incorrecte comme s'ils provenaient d'un autre fournisseur de recherche.

Il est normal (et attendu) d'avoir des événements de recherche sans jetons s'ils proviennent d'un autre fournisseur de recherche, par exemple lors d'une expérience A/B. Toutefois, il existe généralement un mappage 1:1 pour les requêtes de l'API Search vers les événements de recherche avec des jetons.

Effet négatif de l'absence de jetons

Si le attributionToken n'est pas présent dans les événements utilisateur ultérieurs pertinents du même visiteur, Vertex AI Search pour le commerce traite ces événements comme s'ils ne provenaient pas de son service de recherche.

Cela peut entraîner :

Un entraînement de modèle inexact.
Des métriques et une analyse des performances incorrectes.
Des problèmes potentiels pour atteindre des niveaux de performances plus élevés (comme le niveau 3) qui nécessitent suffisamment d'événements attribuables.
Des erreurs signalées dans le tableau de bord de la qualité des données dans Search pour le commerce si le pourcentage d'événements avec des jetons d'attribution est inférieur à 95 %.

Pour tirer des enseignements du comportement des utilisateurs et optimiser les résultats de recherche, Vertex AI Search pour le commerce nécessite une attribution précise uniquement pour l'événement de recherche initial.

Qualité des données des jetons d'attribution

Le tableau de bord de la qualité des données dans la console Search pour le commerce affiche un état d'erreur de non-conformité critique ou bloquant si le pourcentage d'événements avec des jetons d'attribution est inférieur à 95 %. Sinon, l'état est conforme :

Texte alternatif

La qualité des données au niveau 3, qui correspond au modèle optimisé pour les revenus, ne s'entraînera généralement pas sans suffisamment d'événements attribuables. Il est fortement déconseillé de déployer Vertex AI Search pour le commerce en production, sauf s'il fournit des résultats au niveau 3 ou 4. Pour en savoir plus, consultez la section Qualité des données sur la façon de débloquer les niveaux de performances sur la page Qualité des données de cette documentation.

Jetons d'attribution pour les recommandations

Les recommandations de Vertex AI Search créent automatiquement des jetons synthétiques pour les événements attribuables aux requêtes predict.

Pour les prédictions de recommandations, si un utilisateur clique sur un produit recommandé, le PredictResponse.attribution_token doit être transmis en tant que paramètre d'URL à la page produit, puis consigné dans l'événement detail-page-view.

Consignez les recommandations affichées dans panelInfo et définissez les éléments suivants :

panelInfo.attributionToken=PredictResponse.attributionToken