Construisez des systèmes de recommandation personnalisés dans votre jeu pour mettre en avant du contenu sélectionné tel que des actifs 2D et 3D, des mini-jeux, d'autres jeux, et plus encore. L'API Class.RecommendationService|Service de recommandation vous permet d'enregistrer l'activité des utilisateurs, de capturer des impressions et de fournir des résultats personnalisés pour pratiquement tout type d'engagement.
Quelques cas d'utilisation courants pour les systèmes de recommandation incluent la présentation aux utilisateurs d'une interface de suggestion à la fin d'une manche, un menu superposé présentant des actions personnalisées, ou d'autres mises en œuvre qui présentent un ensemble unique de choix, d'actifs, de lieux ou de jeux à l'utilisateur.
Utilisez les étapes universelles suivantes et les meilleures pratiques pour configurer votre système de recommandation :
Ce guide couvre le processus de mise en œuvre de RecommendationService dans votre jeu. Ce contenu ne couvre pas le processus de création de l'UI, d'ajout d'actifs ou de téléportation des utilisateurs. Consultez la documentation supplémentaire pour ces sujets.
Enregistrer votre contenu
Il existe de nombreuses façons d'implémenter des recommandations dans votre jeu. Les paramètres d'exemple de ce guide sont destinés à recommander aux utilisateurs divers mini-jeux au sein d'un jeu, en priorisant les recommandations les plus susceptibles de maximiser les sessions de jeu de qualité.
Ce type de système de recommandation est souvent incorporé dans un menu UI de carrousel, permettant aux utilisateurs de faire défiler, sélectionner et trouver plus de détails sur l'activité dans laquelle ils s'apprêtent à s'engager. Les considérations pour ce type d'interface sont incluses dans les paramètres ci-dessous.
Si vous créez votre propre système, vous devrez peut-être utiliser des paramètres et des configurations légèrement différents, mais suivez les mêmes étapes de base.
Pour remplir le contenu que votre système de recommandation peut servir aux utilisateurs, utilisez RegisterItemAsync. Lorsque vous enregistrez un élément, fournissez un referenceId, une chaîne définie par le développeur qui identifie de manière unique l'élément dans votre propre base de données. Ce referenceId est généralement utilisé pour rechercher les métadonnées d'un élément, telles que le nom, la description ou l'ID d'actif, dans votre magasin de données à afficher dans l'UI.
En tant que meilleure pratique, enregistrez les éléments dès qu'ils sont créés pour garantir que le pool de recommandations est toujours frais.
Enregistrer les impressions des utilisateurs
Une fois que le service connaît vos éléments et commence à les suggérer, informez le service lorsqu'un utilisateur consulte réellement les recommandations avec LogImpressionEvent.
Quand enregistrer
Une interface de type carrousel est une interface courante pour afficher plusieurs options jouables à un utilisateur. Utilisez les meilleures pratiques suivantes pour garantir que votre journalisation fournit des données exploitables propres :
- Journalisation unique : Enregistrez l'impression une seule fois par session pour un élément spécifique.
- Ne journalisez pas chaque fois que l'élément apparaît, car cela crée des informations bruyantes qui peuvent interférer avec votre journalisation.
- Déclencheur : Vous pouvez choisir d'enregistrer lorsque l'élément devient entièrement visible dans le menu ou lorsque l'utilisateur interagit avec l'élément, comme en ouvrant une page de détail.
Soyez extrêmement prudent quant à l'ID que vous passez à RecommendationService.LogImpressionEvent. Le service doit lier l'événement strictement à l'instance de recommandation spécifique qu'il a générée.
- Ne pas utiliser une chaîne brute ou un ID de référence.
Durée
La durée suit le temps de l'impression. Vous pouvez penser à cela comme à combien de temps un utilisateur a regardé l'image ou la recommandation.
Si vous n'utilisez pas de vidéo, vous pouvez définir la valeur de Durée sur 1. Cela garantit que vous obtenez des données propres et cohérentes indiquant que "l'utilisateur a vu cet élément", qui est généralement la seule journalisation dont vous avez besoin pour une carte statique.
Enregistrer les actions de qualité
Lorsque qu'un utilisateur décide d'interagir avec une recommandation, utilisez LogActionEvent. Dans cet exemple, il ne suffit pas de cliquer simplement sur "Jouer" sur la recommandation pour envoyer un signal à un système de recommandation de haute qualité. Il est important de faire la distinction entre un clic accidentel et une session réelle.
Type d'action requis
Lorsque vous appelez LogActionEvent, vous devez spécifier le type d'action qui se produit. Pour suivre les événements d'action qui entraînent des sessions de jeu, utilisez Enum.RecommendationActionType.Play. Il est important d'utiliser l'énumération correcte pour indiquer au backend qu'un type d'action spécifique est activé. Pour les recommandations liées au temps de jeu, Enum.RecommendationActionType.Play est strictement requis pour correspondre au modèle de configuration MaximizePlays utilisé à l'étape suivante pour récupérer des recommandations. Si vous utilisez une énumération différente, le modèle ne registrera pas l'événement correctement pour les actions liées au jeu.
La stratégie "jeu de qualité"
En fonction de votre jeu, vous pouvez avoir différentes définitions de ce qui constitue un "jeu de qualité". Utilisez les étapes suivantes pour aider à affiner ce qui différencie le jeu de qualité dans votre situation.
- Suivre en interne : Lorsque qu'un utilisateur entre dans le mini-jeu, suivez son temps de session localement dans votre script.
- Filtrer : Définissez un seuil de satisfaction, comme jouer plus de 60 secondes.
- Journaux : Ne déclenchez LogActionEvent que si l'utilisateur dépasse ce seuil.
Enregistrez uniquement les actions pour les éléments qui ont réellement été servis par le RecommendationService.
- Ne journalisez pas les jeux qui proviennent de recherches, de sélections aléatoires ou de jeux passés.
- N'utilisez pas des "IDs de traçage factices" pour forcer ces données dans le système.
Le modèle s'attend à un ratio réaliste. Si vous servez 1 impression mais que vous enregistrez 10 jeux provenant de trafic externe, vous confondez les données d'entraînement et ruinez la précision de vos métriques.
Récupérer des recommandations
Pour récupérer des recommandations, utilisez GenerateItemListAsync. GenerateItemListAsync accepte un dictionnaire qui inclut diverses options pour la requête de liste de recommandations. Bien que beaucoup de ces paramètres soient simples, il est important de comprendre les paramètres ConfigName pris en charge pour garantir que vous fournissez des recommandations réussies.
ConfigName
Vous avez plusieurs configurations à votre disposition lors de la récupération des recommandations. Dans l'exemple actuel conçu pour maximiser les recommandations en fonction du nombre de jeux de qualité, utilisez la configuration MaximizePlays. Selon le cas d'utilisation, la configuration MaximizePlays est préférable à MaximizeTimeSpent car elle indexe également la satisfaction de l'utilisateur, plutôt que le temps passé. Cela indique au système de retourner des éléments qui seront probablement à l'origine de jeux de qualité.
Pour plus d'informations sur chaque config supportée, consultez GenerateItemListAsync.
Surveiller les analyses
Une fois que vous avez intégré le service, vous pouvez surveiller ses performances directement dans le Creator Hub. Pour accéder à vos analyses de recommandation :
- Dans le Creator Hub, allez sur la page de votre jeu.
- Dans la barre latérale, naviguez vers Engagement > Service de recommandation.
Principaux indicateurs à surveiller :
- Total des actions au fil du temps : Les utilisateurs interagissent-ils réellement avec les recommandations ?
- Total des utilisateurs uniques : Combien de personnes utilisent la fonctionnalité de découverte ?
- Moyenne des éléments impressionnés par utilisateur : Les utilisateurs font-ils défiler le carrousel ?
- Temps moyen passé par utilisateur : La qualité des recommandations les maintient-elle dans le jeu plus longtemps ?
- Dans l'exemple fourni, la Durée est fixée à 1, de sorte que ce métrique spécifique n'est pas particulièrement précieux dans ce cas. Cependant, dans d'autres applications, comme les vidéos, cela peut être un indicateur fort de vos impressions.
Gardez à l'esprit les paramètres et les processus utilisés dans ce système de recommandation conçus pour maximiser les jeux de qualité, en particulier en utilisant 1 seconde de durée pour les miniatures, en enregistrant uniquement les jeux de qualité, et en gérant strictement vos ID. En maintenant vos données de journalisation et d'impression propres, vous pouvez recommander et affiner le contenu qui correspond le mieux aux expériences uniques de vos utilisateurs.
Bien que ce flux couvre le processus pour un système de recommandation qui maximise le temps de jeu, vous pouvez utiliser un ordre d'opérations similaire et des concepts fondamentaux pour développer un service de recommandation qui s'adapte aux besoins de votre jeu.