> ## Documentation Index > Fetch the complete documentation index at: https://docs.xbox.com/llms.txt > Use this file to discover all available pages before exploring further. # Capacités des événements PlayStream > Explorez les capacités du pipeline d'événements PlayStream, notamment le moteur de règles en temps réel, la segmentation en direct, le débogueur d'événements, les webhooks et les API WriteEvent personnalisées. PlayStream offre aux développeurs de jeux une gamme de fonctionnalités qui leur permettent d'analyser les données collectées à partir des événements en jeu, d'obtenir des informations précieuses et d'améliorer l'engagement des joueurs; ces fonctionnalités peuvent aussi être utilisées pour les LiveOps. Ce document présente un examen détaillé de chacune de ces fonctionnalités. ## Fonctionnalités de PlayStream * **Un pipeline d'événements** - Unifie l'ensemble du flux de données de votre jeu en un seul flux de données. Les services de jeu PlayFab insèrent automatiquement des événements dans PlayStream, et vous pouvez ajouter des événements personnalisés à l'aide des méthodes client et serveur de notre API WriteEvent. Nos modules complémentaires du Marketplace génèrent également des événements automatiquement. Les événements sont gérés sous forme de données JSON. * **Un moteur de règles en temps réel** - Évalue des règles complexes en réponse aux événements entrants dans PlayStream et déclenche diverses actions, notamment CloudScript. * **Un système de segmentation en temps réel** - Regroupe les joueurs en segments en fonction de diverses propriétés des joueurs. Les segments sont calculés en temps réel et sont toujours à jour. Des actions peuvent être déclenchées automatiquement lorsque des joueurs entrent dans des segments ou en sortent. * **Une visualisation en temps réel des données d'événements** - Comprend un débogueur d'événements en temps réel. * La possibilité d'envoyer une partie ou la totalité des événements à des **services Web externes au moyen de webhooks** - Ceux-ci peuvent être configurés automatiquement en installant des modules complémentaires du Marketplace, ou configurés manuellement pour envoyer des événements à vos propres serveurs. * **Une archive d'événements** - Où vous pouvez filtrer, rechercher et afficher les événements historiques, y compris l'historique de livraison des événements. > [!NOTE] > > PlayStream offre maintenant la prise en charge des **événements d'entité** ainsi que des événements PlayStream classiques. Pour en savoir plus, consultez l'article [PlayStream avec les événements d'entité](https://docs.xbox.com/fr-CA/services/playfab/data-analytics/ingest-data/playstream-with-entity-events.md) après avoir terminé celui-ci. Examinons plus en détail les fonctionnalités de PlayStream. ### Pipeline d'événements et moniteur PlayStream La façon la plus simple de voir le pipeline d'événements en action est d'utiliser le débogueur PlayStream. Vous remarquerez le moniteur dès que vous sélectionnez la section **Title Overview**, puis l'onglet **PlayStream Monitor** de votre jeu. Le moniteur PlayStream est un flux en temps réel de tous les événements de votre jeu, y compris les événements personnalisés que vous choisissez d'envoyer à l'aide des méthodes de notre API WriteEvent. Cela est extrêmement utile pendant le développement, car vous pouvez voir immédiatement ce qui se passe sur le serveur principal pendant que vous testez votre code côté client et côté serveur. Le moniteur vous mène aussi directement aux comptes des joueurs, afin que vous puissiez les vérifier par rapport à la logique de jeu sur laquelle vous travaillez. Chaque événement comporte plusieurs champs sélectionnables. Si vous sélectionnez le cercle d'information « (i) », vous verrez les données JSON brutes de l'événement. ![Données JSON brutes de l'événement](https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/ingest-data/playstream-event-rawjson.png?fit=max\&auto=format\&n=MjJ0-cTsb1bpaMcX\&q=85\&s=c20729a81bd459f0542c972904380b21) Vous pouvez aussi sélectionner l'ID du joueur pour accéder directement au profil du joueur. Certains autres événements comportent également des champs sélectionnables. Lorsque vous êtes dans la vue d'un joueur précis, vous pouvez sélectionner l'onglet **PlayStream**, qui devrait vous montrer la vue du moniteur en temps réel filtrée pour ce joueur. ### Segmentation des joueurs et actions À l'aide de ces événements, vous pouvez configurer des segments, qui définissent des joueurs parmi vos utilisateurs en fonction de la plupart des propriétés des joueurs. Tout cela se produit en temps réel; il ne devrait donc y avoir aucun délai perceptible, même à grande échelle. Si vous pouvez associer un événement à l'élément que vous souhaitez utiliser comme facteur de différenciation, vous pouvez créer un segment pour celui-ci. Et les segments s'appliquent rétroactivement à *tous* les joueurs, en fonction des données de leur profil. Ainsi, si vous définissez un segment de joueurs dont l'XP > 3 000, chaque joueur ayant une XP > 3 000 fera désormais partie de ce segment. ![Définition du segment XP élevée](https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/ingest-data/playstream-segment-highxp.png?fit=max\&auto=format\&n=MjJ0-cTsb1bpaMcX\&q=85\&s=58f1580ce5630fbbc419c04d383679d3) Ce segment particulier sera évalué chaque fois que la statistique appelée « Total\_XPGained » change. Si la condition (> 3000) est évaluée à **TRUE**, le joueur entrera dans le segment « High XP Players », et les actions correspondantes seront déclenchées. Dans ce cas, une notification Push sera envoyée et de l'or sera accordé au joueur. Vous pouvez aussi déclencher différentes actions personnalisées lorsque le joueur quitte un segment, ce qui vous permet d'apporter en conséquence toute autre modification nécessaire. Diverses actions de base sont offertes, notamment accorder un objet au joueur, accorder de la monnaie virtuelle, modifier des statistiques, bannir un joueur, envoyer un courriel à un joueur ou envoyer une notification Push. Vous pouvez aussi déclencher plutôt l'exécution d'un CloudScript personnalisé. ### Règles et actions Le même système d'actions présenté ci-dessus peut également être utilisé pour répondre à des événements précis provenant de votre jeu. Par exemple, la règle ci-dessous montre comment, lorsqu'un événement personnalisé (**Client\_StoreVisit**) est détecté, le joueur reçoit de la monnaie virtuelle ainsi qu'une notification Push le remerciant de sa visite. ![Règle répondant à un événement personnalisé](https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/ingest-data/playstream-rule.png?fit=max\&auto=format\&n=MjJ0-cTsb1bpaMcX\&q=85\&s=8e7f773af37397737f70311745d847d8) À l'aide des règles et des actions, vous pouvez modifier les comportements LiveOps de votre jeu sans apporter de changement au client du jeu. ### Webhooks Vous pouvez aussi configurer des webhooks, de sorte qu'une partie ou la totalité des événements transitant par PlayStream soient envoyés à un service externe. Par exemple, vous pourriez utiliser la fonctionnalité illustrée ci-dessous pour appeler votre propre serveur principal à chaque connexion d'un joueur. ![Configuration d'un webhook](https://mintcdn.com/microsoft-4404708b/MjJ0-cTsb1bpaMcX/images/playfab/data-analytics/ingest-data/playstream-webhook.png?fit=max\&auto=format\&n=MjJ0-cTsb1bpaMcX\&q=85\&s=4794b4ccca63f0f8640442fbc147c7f1) Les webhooks PlayStream sont des appels POST vers le point de terminaison que vous fournissez, qui transmettent toutes les données de l'événement dans le corps de l'appel. Grâce à ce mécanisme, vous pourriez ensuite activer des actions personnalisées supplémentaires sur vos données en temps réel, à l'aide de vos propres services personnalisés. ### Data Explorer Par défaut, les événements sont conservés pendant une certaine période qui dépend de votre niveau de service. Vous pouvez consulter tout l'historique des événements à deux endroits : vous pouvez afficher tous les événements de votre titre dans l'onglet **Data Explorer Basic** ou dans l'onglet **Data Explorer Advanced**. Les deux se trouvent dans la section **Data** de **Game Manager**. ### Balises personnalisées La fonctionnalité [Custom Tags](https://docs.xbox.com/fr-CA/services/playfab/data-analytics/ingest-data/playstream-custom-tags.md) permet aux développeurs de jeux d'enrichir davantage leurs événements PlayStream standard avec des métadonnées propres à leur entreprise. Il s'agit d'une fonctionnalité de confort conçue pour faciliter le développement sur PlayFab et le rendre plus extensible. ### Propriétés personnalisées Cette fonctionnalité vous permet de stocker des points de données clés supplémentaires sur vos joueurs et d'y accéder. Par exemple, vous pouvez utiliser des propriétés personnalisées pour enregistrer et récupérer des données liées aux préférences des joueurs, comme leurs modes de jeu ou types de personnages favoris. Vous pouvez ainsi créer une segmentation plus ciblée qui permet d'offrir des expériences adaptées à vos joueurs, au sein des segments, des actions associées comme CloudScript ou avec les expériences. ## Événements V1 et V2 PlayStream offre des événements V1 et V2, et le tableau ci-dessous présente une comparaison des fonctionnalités de chaque type d'événement : | Fonctionnalité | V1 (joueur/titre/personnage) | V2 (basé sur les entités) | | - | - | - | | Event Explorer | Oui | Oui | | Data Connections | Oui | Oui | | Débogueur PlayStream | Oui | Oui | | Actions | Execute Function Send Email Push Notification CloudScript Player Ban Action GrantVC Delete Player Increment Statistic | Execute Function Send Email Inventory/AddVC Inventory/GrantItem | | Segments | Oui | Non | | Règles déclenchées par événement | Oui | Oui | | Webhooks | Oui | Non | | Propriétés personnalisées | Oui | Oui | | Archiveur S3 (hérité) | Oui | Non | ## Comment PlayStream peut vous aider à propulser votre jeu Voici quelques exemples de la façon dont vous pouvez utiliser PlayStream pour propulser votre jeu et libérer tout son potentiel : * Déclenchez des actions comme l'octroi d'objets et de monnaie virtuelle lorsque les joueurs se connectent, terminent des niveaux du tutoriel ou atteignent des jalons précis, et utilisez ces données pour adapter l'expérience du joueur. * Signalez ou bannissez automatiquement les joueurs qui adoptent un comportement de tricherie. * Collectez des données sur la progression des joueurs, les mécaniques de jeu et la difficulté des niveaux. Utilisez ces données pour prendre des décisions éclairées sur l'équilibrage et le réglage du jeu afin d'offrir aux joueurs une expérience stimulante, mais agréable. * Encouragez et récompensez les interactions sociales positives dans le jeu. * Envoyez des notifications Push ou des courriels automatiques lorsque les joueurs atteignent des jalons, effectuent des achats ou terminent des niveaux. ## Related topics - [Classements avec PlayStream et Telemetry](https://docs.xbox.com/fr-CA/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry.md) - [Utiliser des balises personnalisées pour personnaliser vos événements](https://docs.xbox.com/fr-CA/services/playfab/data-analytics/ingest-data/playstream-custom-tags.md) - [Événements PlayStream](https://docs.xbox.com/fr-CA/services/playfab/data-analytics/ingest-data/playstream-events.md) - [Événements PlayStream de Game Saves](https://docs.xbox.com/fr-CA/services/playfab/player-progression/game-saves/playstream-events.md) - [PlayStream avec les événements d'entité](https://docs.xbox.com/fr-CA/services/playfab/data-analytics/ingest-data/playstream-with-entity-events.md)