Utilisation de 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 éventuellement inclure dans chaque requête d’API. Elles sont utiles pour enrichir les événements PlayStream standard avec des métadonnées plus spécifiques au studio (par exemple, numéro de build, identifiants de trace externes, etc.). Les balises personnalisées étendent 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 spécifiques. Les balises personnalisées offrent un moyen d’étendre le schéma pour plus de flexibilité et de fonctionnalités.Que pouvez-vous faire avec les balises personnalisées ?
Les balises personnalisées vous permettent d’accomplir de nombreuses choses. Voici quelques suggestions, mais n’hésitez pas à faire preuve de créativité lorsque vous les utilisez.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 une automatisation. Les actions et règles CloudScript vous permettent de déclencher des événements automatiquement en fonction de certains critères. Par exemple, si votre studio de jeux investit dans le marketing à la performance pour votre jeu et que vous menez diverses campagnes marketing pour acquérir de nouveaux joueurs, vous pouvez désormais 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 « new player » et utilisez la campagne marketing pour décider de la récompense à accorder au joueur. Par exemple : « 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 depuis des services non PlayFab et en assurer le suivi à mesure qu’elles transitent par les pipelines de données. Si vous disposez déjà de votre propre système d’analytique (par exemple, basé sur un identifiant), vous pouvez facilement intégrer et fusionner de nouvelles données en transmettant cet identifiant dans les balises personnalisées de vos événements PlayStream. Vous pouvez inclure des ID de campagne ou d’autres identifiants analytiques pour analyser les revenus et déterminer quelle campagne a généré la meilleure acquisition de nouveaux joueurs, le meilleur flux de revenus ou la meilleure 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 transite ensuite par les pipelines PlayStream pour être stocké dans Kusto, l’entrepôt de données back-end de PlayFab.Limitations
- Les balises personnalisées présentent les 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’est-à-dire 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 accompagnent les événements PlayStream correspondants à mesure qu’ils transitent par les pipelines de données, et vous pouvez accéder ultérieurement à ces données à des fins opérationnelles 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.