Vertex AI Search pour le commerce est en cours de rebaptisement en Vertex AI Search pour le commerce. Nous mettons à jour le contenu pour refléter le nouveau branding.

Cette page a été traduite par l'API Cloud Translation.

Jetons d'attribution

Les jetons d'attribution sont des ID 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 réorganisation d'améliorer la qualité des réponses de recherche. Les jetons d'attribution sont également requis dans Vertex AI Search pour les événements de recherche commerciale afin d'obtenir 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 demande de recherche ou de recommandation, il renvoie un attributionToken unique dans sa réponse :

Ce jeton est essentiel pour relier les actions ultérieures des utilisateurs (comme les clics, les ajouts au panier et les achats) à la recherche ou à la recommandation spécifique qui les a déclenchées.
Il est important d'associer le jeton de recherche approprié aux événements de recherche afin que les événements de vue de page détaillée, les événements d'ajout au panier et les événements d'achat puissent être correctement associés.

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 qui suivent 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 "Achat terminé" : 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 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 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 Vertex AI 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, Vertex AI Search pour le commerce considère que ces événements ne proviennent pas de son service de recherche.

Cela peut entraîner :

Entraînement inexact du modèle.
Métriques et analyses des performances incorrectes.
Problèmes potentiels liés à l'obtention de niveaux de performances plus élevés (comme le niveau 3) qui nécessitent un nombre suffisant d'événements attribuables.
Les erreurs signalées dans le tableau de bord "Qualité des données" de la recherche pour le commerce si le pourcentage d'événements avec des jetons d'attribution est inférieur à 95 %.

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

Qualité des données des jetons d'attribution

Le tableau de bord "Qualité des données" de la console Search for Commerce affiche un état d'erreur de non-respect 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

Le modèle de qualité des données de niveau 3 (modèle optimisé pour les revenus) ne s'entraînera généralement pas sans un nombre suffisant 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 de niveau 3 ou 4. Pour en savoir plus sur la façon de débloquer les niveaux de performances, consultez la section "Qualité des données" de 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 du produit, puis enregistré dans l'événement detail-page-view.

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

panelInfo.attributionToken=PredictResponse.attributionToken