> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.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 un éventail de fonctionnalités qui leur permettent d’analyser les données collectées à partir des événements en jeu, d’obtenir des insights précieux et d’améliorer l’engagement des joueurs. Il peut également être utilisé pour le LiveOps. Ce document présente en détail 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 PlayFab Game Services 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 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 via 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 les 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 tout ou partie des événements à **des services web externes via des webhooks** : ceux-ci peuvent être configurés automatiquement en installant des modules complémentaires Marketplace, ou manuellement pour envoyer des événements à vos propres serveurs.
* **Une archive d’événements** : vous permet de filtrer, rechercher et afficher les événements historiques, y compris l’historique de livraison des événements.
PlayStream prend désormais en charge les **événements d’entité** ainsi que les événements PlayStream classiques. Pour en savoir plus, consultez l’article [PlayStream avec les événements d’entité](/fr/services/playfab/data-analytics/ingest-data/playstream-with-entity-events) après avoir terminé celui-ci.
Examinons plus en détail les fonctionnalités de PlayStream.
### Pipeline d’événements et moniteur PlayStream
Le moyen le 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.
Il est extrêmement utile pendant le développement, car il vous permet de voir immédiatement ce qui se passe sur le back-end lorsque vous testez votre code côté client et côté serveur. Il vous renvoie 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.
Vous pouvez également sélectionner l’ID du joueur pour accéder directement à son profil. Certains autres événements comportent aussi des champs sélectionnables.
Lorsque vous êtes dans la vue d’un joueur spécifique, vous pouvez sélectionner l’onglet **PlayStream**, qui devrait afficher la vue du moniteur en temps réel filtrée sur ce joueur.
### Segmentation des joueurs et actions
À l’aide de ces événements, vous pouvez configurer des segments, qui définissent des groupes de joueurs parmi vos utilisateurs, en fonction de la plupart des propriétés des joueurs. Tout cela se fait en temps réel ; il ne devrait donc y avoir aucun décalage 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 leurs profils. 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.
Ce segment est évalué chaque fois que la statistique nommée « Total\_XPGained » change. Si la condition (> 3000) est évaluée à **TRUE**, le joueur entre dans le segment « High XP Players » et la ou les actions correspondantes sont déclenchées. Dans ce cas, une notification Push est envoyée et de l’or est accordé au joueur.
Vous pouvez également 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 disponibles, notamment accorder un objet au joueur, accorder de la monnaie virtuelle, modifier des statistiques, bannir un joueur, envoyer un e-mail à un joueur ou envoyer une notification Push. Vous pouvez également déclencher l’exécution d’un CloudScript personnalisé à la place.
### Règles et actions
Le même système d’actions présenté ci-dessus peut également être utilisé pour réagir à des événements spécifiques 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.
À l’aide des règles et des actions, vous pouvez influer sur les comportements LiveOps de votre jeu sans apporter de modification au client du jeu.
### Webhooks
Vous pouvez également configurer des webhooks afin que tout ou partie des événements transitant par PlayStream soient transmis à un service externe.
Par exemple, vous pouvez utiliser la fonctionnalité ci-dessous pour appeler votre propre serveur back-end à chaque connexion d’un joueur.
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 pouvez 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 durée qui dépend de votre niveau de service. Vous pouvez afficher l’historique complet 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](/fr/services/playfab/data-analytics/ingest-data/playstream-custom-tags) permet aux développeurs de jeux d’enrichir davantage leurs événements PlayStream standard avec des métadonnées propres à leur activité.
Il s’agit d’une fonctionnalité de confort conçue pour faciliter les développements basés sur PlayFab et les rendre plus extensibles.
### 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 personnalisées à vos joueurs, au sein des segments, des actions associées comme CloudScript ou des expériences.
## Événements V1 et V2
PlayStream propose des événements V1 et V2, et le tableau ci-dessous compare les 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 alimenter votre jeu
Voici quelques exemples de la façon dont vous pouvez utiliser PlayStream pour alimenter votre jeu et exploiter tout son potentiel :
* Déclenchez des actions telles que l’octroi d’objets et de monnaie virtuelle lorsque les joueurs se connectent, terminent des niveaux de tutoriel ou atteignent des jalons spécifiques, et utilisez ces données pour personnaliser l’expérience du joueur.
* Signalez ou bannissez automatiquement les joueurs qui ont un comportement de triche.
* 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 de garantir une expérience à la fois stimulante et agréable pour les joueurs.
* Encouragez et récompensez les interactions sociales positives dans le jeu.
* Envoyez automatiquement des notifications Push ou des e-mails lorsque les joueurs atteignent des jalons, effectuent des achats ou terminent des niveaux.
## Related topics
- [Ajouter des services backend avec PlayFab](/fr/home/build-first-title/add-backend-services.md)
- [Ajouter des services dorsaux avec PlayFab](/fr-CA/home/build-first-title/add-backend-services.md)
- [PlayStream](/services/playfab/data-analytics/ingest-data/playstream-overview.md)
- [Habilitación o deshabilitación de eventos generados por el servicio](/es/services/playfab/data-analytics/ingest-data/opt-in-events.md)
- [Documentación de administración de servicios en vivo de PlayFab](/es/services/playfab/live-service-management/index.md)