Cette documentation ne concerne que Recommendations AI. Pour essayer Retail Search et la console Play Store unifiée pendant la phase de disponibilité limitée, contactez le service commercial Cloud. Si vous ne prévoyez pas d'utiliser Retail Search, restez dans la console "Recommandations" jusqu'à nouvel ordre.

Si vous utilisez la version v1beta de Recommendations AI, migrez vers la version Retail API.

Jetons d'attribution

Cette page décrit comment vous pouvez utiliser des jetons d'attribution pour améliorer les performances de recommandation au fil du temps.

Les jetons d'attribution sont des ID uniques, générés par Recommendations AI et renvoyés avec chaque requête de prédiction. Ils permettent à Recommendations AI d'associer des actions utilisateur à des recommandations afin de fournir des métriques de revenus et de taux de conversion.

L'inclusion de jetons d'attribution dans vos événements utilisateur est facultative. Si vous ne fournissez pas de jetons d'attribution, Recommendations AI fait une approximation des jetons d'attribution en alignant les recommandations dans la réponse de prédiction avec les événements utilisateur ingérés en fonction de l'ID de visiteur et des horodatages. En savoir plus

Fonctionnement des jetons de recommandation

Chaque recommandation renvoyée par la méthode predict inclut un attributionToken unique dans le corps de la réponse. Exemple :

{
  "results": [{"id": "352"}, {"id": "456"}],
  "attribution_token": "abc123"
}

Lorsque votre site Web affiche un produit basé sur une recommandation de Recommendations AI, vous devez renvoyer le jeton d'attribution de cette recommandation lorsque l'utilisateur interagit avec un produit recommandé (par exemple, affichage d'une vue ou clic pour l'ajout d'un produit au panier). Cette boucle de rétroaction permet à Recommendations AI de vous fournir des informations sur l'impact qu'ont les recommandations sur votre entreprise. Pour en savoir plus, consultez la page Mesurer les performances de l'outil de recommandation.

Comment renvoyer le jeton d'attribution

Vous renvoyez le jeton d'attribution en l'incluant dans l'événement utilisateur que vous enregistrez pour toute action effectuée par l'utilisateur avec le produit recommandé. Les actions qu'un utilisateur peut effectuer avec un produit recommandé dépendent de la conception de votre site Web. Les actions courantes incluent l'ajout du produit à une liste de favoris, l'accès à une vue détaillée, l'ajout à un panier ou l'achat en un clic.

Pour renvoyer le jeton d'attribution, vous devez d'abord l'associer au produit tel qu'il s'affiche dans un panneau de recommandations de votre site Web. Pour ce faire, une méthode courante consiste à l'ajouter à toutes les URL associées aux actions pouvant être effectuées dans le panneau de recommandations. Exemple :

https://www.example.com/54321/?rtoken=abc123

Lorsque l'utilisateur interagit avec ce produit dans le panneau de recommandations (ce qui génère un événement utilisateur), le jeton d'attribution peut être analysé à partir de l'URL et inséré dans l'événement utilisateur que vous envoyez à Recommendations AI pour cette interaction.

Par exemple, supposons que vous demandiez une prédiction associée à l'affichage d'un produit pour un utilisateur. Recommendations AI affiche un ensemble d'ID de catalogue recommandés avec leurs jetons d'attribution associés.

{
  "results": [{"id": "352"}, {"id": "456"}],
  "attribution_token": "abc123"
}

Votre site Web affiche les articles recommandés dans un panneau de recommandations et inclut le jeton d'attribution renvoyé pour la prédiction avec chaque URL du panneau de recommandations. Lorsque l'utilisateur clique sur l'un des produits recommandés pour afficher une vue plus détaillée de ce produit, incluez le jeton d'attribution avec l'événement utilisateur detail-page-view que vous enregistrez sur ce clic. L'événement utilisateur ressemblerait à l'exemple suivant :

{
  "eventType" : "detail-page-view",
  "userInfo": {
    "visitorId": "visitor1",
    "userId": "user1"
   },
   "eventDetail": {
     "attributionToken": "abc123",
   },
   "productEventDetail": {
      "productDetails": [{
        "catalogItemId": "123",
        "originalPrice": 49.00,
        "displayPrice": 44.00,
        "currencyCode": "USD"
       }
     ]
   }
}

Lorsque l'utilisateur interagit avec un produit affiché en raison d'une recommandation et que vous incluez le jeton d'attribution avec l'événement utilisateur correspondant à cette interaction, Recommendations AI utilise cette information pour l'évaluation.

Par exemple, supposons que l'utilisateur voie un produit dans un panneau de recommandations et qu'il utilise le panneau de recommandations pour ajouter ce produit à sa liste de souhaits et pour afficher une vue détaillée du produit. Vous devez inclure le jeton d'attribution pour les deux événements utilisateur générés à partir du panneau de recommandations (ajout à la liste et affichage de la page).

Supposons maintenant que le même utilisateur ajoute ce produit à son panier depuis la vue détaillée. Vous n'avez pas besoin d'inclure le jeton d'attribution avec cette action, car elle a été obtenue à partir de la vue détaillée, et non du panneau de recommandations. De même, si cet utilisateur achète finalement le produit, mais pas directement depuis le panneau de recommandations, le fait de renvoyer un jeton d'attribution avec l'événement d'achat ne présente aucun avantage.

Étape suivante