Utiliser des balises personnalisées avec les événements PlayStream
Les balises personnalisées (Custom Tags) sont une collection de paires clé-valeur que les studios peuvent inclure de façon facultative dans chaque requête d’API. Elles sont utiles pour enrichir les événements PlayStream standard avec des métadonnées plus propres au studio (p. ex. numéro de build, identificateurs de trace externes, etc.). Les balises personnalisées élargissent les façons dont vous pouvez utiliser les événements PlayStream. Le schéma PlayStream de base est fixe et manque d’extensibilité, mais il nous a permis de créer des métriques et des analyses communes. La nature fixe du schéma limitait la capacité des studios de jeux à personnaliser leurs données de manière efficace et économique, ainsi que leur capacité à collecter des points de données précis. Les balises personnalisées offrent un moyen d’étendre le schéma pour permettre une plus grande flexibilité et davantage de fonctionnalités.Que pouvez-vous faire avec les balises personnalisées?
Vous pouvez accomplir beaucoup de choses à l’aide des balises personnalisées. Voici quelques suggestions, mais n’hésitez pas à faire preuve de plus de créativité en les utilisant.Automatisation
Les métadonnées PlayStream peuvent servir de critères qui déclenchent certains événements. Lorsqu’une tâche doit être accomplie, un client PlayFab peut configurer une règle indiquant « si [Custom Tags] satisfait l’exigence xyz, alors déclencher l’action A ». Vous pouvez intégrer CloudScript aux balises personnalisées pour réaliser de l’automatisation. Les actions et règles CloudScript vous permettent de déclencher automatiquement des événements en fonction de certains critères. Par exemple, si votre studio de jeux investit dans le marketing de performance pour votre jeu et que vous menez différentes campagnes marketing pour acquérir de nouveaux joueurs, vous pouvez maintenant suivre la campagne marketing qui a permis d’acquérir un joueur et ajouter l’ID de cette campagne à tous les événements PlayStream. Vous pouvez ensuite utiliser cet ID de campagne pour automatiser des processus. Par exemple, si votre publicité promettait « 1 000 pièces d’or gratuites à l’inscription », envoyez l’événement « nouveau joueur » et utilisez la campagne marketing pour décider quelle incitation offrir au joueur. P. ex. « si la campagne marketing = ‘FREE_GOLD_COINS’, alors donner 1 000 pièces d’or au joueur ».Télémétrie
Les métadonnées PlayStream peuvent faciliter la collecte et l’analyse des données. Par exemple, vous pouvez envoyer des balises personnalisées dans les données de vos événements PlayStream à partir de services autres que PlayFab et en assurer le suivi à mesure qu’elles circulent dans les pipelines de données. Si vous disposez déjà de votre propre système d’analytique (p. ex. basé sur un certain identificateur), vous pouvez facilement intégrer et fusionner de nouvelles données en transmettant cet identificateur dans les balises personnalisées de vos événements PlayStream. Vous pouvez inclure des ID de campagne ou d’autres identificateurs analytiques pour analyser les revenus, afin de déterminer quelle campagne a généré la plus forte acquisition de nouveaux joueurs, le plus important flux de revenus ou la plus grande valeur client.Flux de données
Une fois les balises personnalisées reçues dans la requête d’API, les données font partie de l’événement PlayStream, qui circule ensuite dans les pipelines PlayStream pour être stocké dans Kusto, l’entrepôt de données principal de PlayFab.Limitations
- Les balises personnalisées sont soumises aux restrictions suivantes :
- Pas plus de 10 paires clé-valeur
- Chaque chaîne de clé ne peut pas dépasser 64 caractères utf8
- Chaque chaîne de valeur ne peut pas dépasser 128 caractères utf8
- Prises en charge uniquement avec les appels d’API (c.-à-d. non prises en charge par l’interface utilisateur de Game Manager)
Prise en main
L’exemple de requête suivant vous montre comment ajouter des balises personnalisées à votre requête JSON. LesCustomTags suivent les événements PlayStream pertinents à mesure qu’ils circulent dans les pipelines de données, et vous pouvez accéder à ces données plus tard à des fins concrètes et analytiques.
Exemple de requête
Exemple de réponse
L’ajout de balises personnalisées ne modifie pas la réponse que vous recevez de l’appel au point de terminaison. La réponse après l’ajout duCustomTag node est identique à celle que vous recevez lorsque le nœud n’est pas présent.