Événements personnalisés

Les événements personnalisés vous permettent de suivre des mesures spécifiques à votre jeu que d'autres événements ne capturent pas entièrement. Cela inclut :

• Adoption — Combien d'utilisateurs cliquent sur un composant d'interface utilisateur spécifique ?
• Comportement des utilisateurs — Quelle est la capacité la plus fréquemment utilisée sur chaque carte ?
• Boucle centrale — Comment les ratios de kills/morts se comparent-ils entre différentes armes ?

Une fois que votre jeu commence à suivre les événements personnalisés, vous débloquerez la page Explorer du tableau de bord Analytics sur le Creator Hub. Vous pouvez ajouter jusqu'à 100 événements personnalisés à votre jeu.

Suivre les événements personnalisés

Pour débloquer la page Explorer, vous devez d'abord suivre des événements personnalisés dans votre jeu. Commencez par identifier quelles mesures sont les plus importantes pour surveiller et améliorer votre jeu. Les événements sont agrégés quotidiennement, il peut donc falloir jusqu'à 24 heures pour que les graphiques apparaissent sur la page.

Compteurs

Les compteurs sont des événements ponctuels capturés sans valeur. Vous pouvez utiliser des compteurs pour suivre le nombre de fois qu'un événement spécifique s'est produit. Utilisez des compteurs pour des actions uniques telles que cliquer sur un bouton, commencer une quête ou utiliser un outil.

Les événements suivront automatiquement à la fois le nombre d'événements et le nombre d'utilisateurs uniques. Pour les agrégations de valeur, les événements de compteur sont traités comme des événements avec une valeur par défaut de 1. Cela signifie que les agrégations comme max/min/moyenne seront toujours égales à 1, et la somme sera égale au nombre total d'événements.

local AnalyticsService = game:GetService("AnalyticsService")

AnalyticsService:LogCustomEvent(
    player,
    "MissionStarted" -- Nom de l'événement
)

Événements avec valeurs

Vous pouvez également suivre des événements avec des valeurs pour des mesures qui nécessitent des données plus quantitatives dans votre jeu, telles que les ratios de kills/morts ou la durée pendant laquelle un utilisateur passe sur une mission. Cela peut également être utilisé comme moyen d'envoyer des événements en lot afin de rester sous les limites de taux, c'est-à-dire envoyer 10 zombies tués au lieu de 1 zombie tué dix fois.

local AnalyticsService = game:GetService("AnalyticsService")

AnalyticsService:LogCustomEvent(
    player,
    "MissionCompletedDuration", -- Nom de l'événement
    120 -- Valeur de l'événement
)

Agrégations d'événements

Tous les metrics d'événements incluent les agrégations suivantes et prennent en charge le découpage :

• Compter
• Compter les utilisateurs uniques
• Valeur moyenne
• Somme des valeurs
• Valeur min
• Valeur max
• Valeur moyenne par utilisateur

Affichez vos agrégations d'événements sur la page Explorer en sélectionnant le type d'agrégation.

Utiliser des champs personnalisés

Les événements personnalisés permettent également de segmenter par des champs personnalisés pour faciliter la comparaison entre les segments. Par exemple, vous pouvez fournir des noms de quête à chaque événement pour voir lesquels les utilisateurs préfèrent le plus, ou attacher la classe de joueur pour voir si une classe a un ratio de kills/morts significativement plus élevé.

Vous pouvez segmenter par des champs personnalisés en utilisant le sélecteur de découpage.

Vous devriez utiliser des champs personnalisés chaque fois que cela est possible au lieu des noms d'événements, car il y a une limite de cardinalité beaucoup plus stricte sur les noms d'événements que sur les champs personnalisés. L'utilisation de champs personnalisés vous permet également de voir des visualisations des événements en fonction des valeurs de champs.

Par exemple, au lieu de PlantCabbage, PlantTurnip, PlantPepper comme trois événements distincts, vous pourriez avoir un seul événement avec le nom PlantSeed et des valeurs de champ personnalisées Plant - Cabbage, Plant - Turnip, et Plant - Pepper. De cette façon, vous pouvez visualiser à la fois le nombre total de graines plantées ainsi que comparer chaque plante dans la même visualisation. Cela réduit également la cardinalité de vos noms d'événements.

Pour plus d'informations, voir Champs personnalisés.

Utiliser des événements personnalisés pour développer votre jeu

Les événements personnalisés vous permettent de suivre les mesures les plus importantes, fournissant des éclairages sur la manière dont les joueurs interagissent avec des fonctionnalités et du contenu spécifiques. Utilisez ces événements pour découvrir des tendances dans le comportement des joueurs et optimiser votre boucle de jeu centrale.

Dans le jeu de référence Plant, la boucle centrale avec un événement HarvestPlant est déclenchée chaque fois qu'un joueur récolte une plante mûre. En utilisant des événements personnalisés, vous pouvez suivre le nombre moyen de plantes récoltées par joueur chaque jour, ventilé par le type de plante en tant que champ personnalisé :

• Essayez d'améliorer la diversité du contenu dans votre jeu et encouragez les joueurs à explorer d'autres options dans le cadre de la boucle centrale pour éviter la répétitivité.
• Explorez pourquoi les utilisateurs préfèrent nettement les navets à d'autres plantes, et s'il y a des déséquilibres causés par les navets (comme avec les événements économiques).
• Ajoutez plus de suivi d'événements dans votre boucle, comme planter des graines, arroser des plantes, et aller au magasin, pour mieux suivre le comportement des joueurs et d'autres domaines d'amélioration.