Jetons d'attribution

Les jetons d'attribution sont des identifiants uniques générés par AI Commerce Search et renvoyés avec chaque requête de recherche. Ils permettent à la recherche e-commerce basée sur l'IA 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. Des jetons d'attribution sont également requis dans les événements de recherche AI Commerce Search pour que les rapports soient 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 la recherche AI Commerce traite une demande de recherche ou de recommandation, elle 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 une add-to-cart, mais l'achat est toujours attribué à la recherche d'origine).

Comportement des jetons d'attribution

Les jetons d'attribution sont les suivants :

  • Spécifique au visiteur : le attributionToken est associé à une réponse de recherche spécifique diffusée à un visitorId particulier. Seul l'événement de recherche lui-même doit être tagué avec le jeton. Tous les événements non liés à la recherche ultérieurs ne doivent pas être associés à un jeton.

  • Associé 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 purchase-complete : l'achat est toujours associé aux ID de produits et à visitorId.

    Remarque : Si un même utilisateur effectue plusieurs recherches, chaque nouvelle requête de recherche génère un jeton d'attribution. 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 génère un nouveau jeton.

Jetons d'attribution dans l'API Search

Chaque réponse renvoyée par la méthode AI Commerce Search 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"
}

La recherche e-commerce par IA 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 facettes et les ID de produits de réponse demandés. En l'absence de jeton dans les événements de recherche, ces événements sont traités comme s'ils ne provenaient pas de Google AI Commerce Search. Ils peuvent alors ê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 sont diffusés par un autre fournisseur de recherche, par exemple lors d'un test A/B. Toutefois, il existe généralement un mappage un-à-un entre les requêtes de l'API Search et les événements de recherche avec jetons.

Effet indésirable des jetons manquants

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

Cela peut entraîner :

  • Entraînement de modèle inexact.
  • Métriques et analyses des performances incorrectes.
  • Problèmes potentiels liés à l'atteinte des niveaux de performances supérieurs (comme le niveau 3) qui nécessitent un nombre suffisant d'événements attribuables.
  • Des erreurs sont signalées dans le tableau de bord "Qualité des données" de la recherche AI Commerce dans Gemini Enterprise for Customer Experience si le pourcentage d'événements comportant des jetons d'attribution est inférieur à 95%.

Pour apprendre du comportement des utilisateurs et optimiser les résultats de recherche, AI Commerce Search 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 "Qualité des données" de la console AI Commerce Search dans Gemini Enterprise for Customer Experience affiche un état d'erreur de non-conformité critique ou bloquante si le pourcentage d'événements avec des jetons d'attribution est inférieur à 95%. Sinon, l'état sera défini sur "Conforme" :

Texte alternatif

La qualité des données au niveau 3 (modèle optimisé pour les revenus) ne permet généralement pas d'entraîner le modèle sans un nombre suffisant d'événements attribuables. Nous vous déconseillons vivement de déployer la recherche AI Commerce en production, sauf si elle fournit des résultats de niveau 3 ou 4. Pour en savoir plus sur la façon de débloquer les niveaux de performances, consultez la page Qualité des données de cette documentation.

Jetons d'attribution pour les recommandations

Les recommandations d'AI Commerce 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 enregistré dans l'événement detail-page-view.

Enregistrez les recommandations affichées dans panelInfo et définissez :

panelInfo.attributionToken=PredictResponse.attributionToken