> ## 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.
# Configuration des segments
> Configurez des segments de joueurs PlayFab dans Game Manager en définissant des critères de filtre et des règles de nommage, et en attribuant des actions d'entrée/sortie ou des tâches CloudScript.
La page **Segment configuration**, accessible depuis l'onglet **Players** de **Game Manager**, vous permet de configurer un segment nouveau ou existant en modifiant son nom, en définissant des filtres et en attribuant des tâches.
Chaque segment vous permet de définir des groupes de joueurs utiles ou intéressants et d'effectuer des actions exclusives sur ces groupes.
## Comment créer un segment et y accéder
Pour accéder à la configuration des segments :
1. Sélectionnez **Players** dans le menu de gauche.
2. Sélectionnez l'onglet **Segments**.
Vous pouvez ensuite choisir de :
3. Utiliser le bouton **New Segment** pour créer et configurer un nouveau **Segment**.
4. Repérer un **Segment** *existant* et sélectionner son nom pour configurer le **Segment**.
## Comment configurer un segment
**Prérequis** :
Pour configurer un segment comme celui de l'exemple de ce tutoriel, vous aurez besoin de :
* Joueurs présentant ou non une caractéristique distinctive définie dans PlayFab.
* Un [hook PlayStream CloudScript](/fr-CA/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream) défini.
Dans cet exemple, nous allons :
* Configurer un segment à l'aide de cette *caractéristique déterminante* : tous les joueurs venant du Canada.
* Exécuter une fonction CloudScript **helloWorld** pour chaque joueur qui entre dans le segment.
La *caractéristique déterminante* d'un joueur peut être :
* L'heure de connexion
* Le type d'appareil lié
* Les balises
* La localisation réelle
* Les valeurs de statistiques
* Les valeurs de monnaie virtuelle
* Les achats en argent réel, et plus encore.
La localisation du joueur est l'une des nombreuses options possibles et n'est requise que pour cet exemple. N'hésitez pas à remplacer l'exigence de pays/région par un autre filtre de votre choix.
Lorsqu'un segment est défini, vous disposez de diverses options d'action à exécuter lorsqu'un joueur entre dans le segment ou le quitte.
CloudScript est de loin l'action la plus flexible, car elle vous donne un contrôle total sur les informations du joueur et de segmentation au moment de la transition de segment.
Utilisez le deuxième paramètre, *Context*, dans votre gestionnaire CloudScript pour identifier le joueur et la transition de segment. Effectuez ensuite toute action souhaitée sur le joueur, comme l'octroi d'articles d'inventaire, de monnaie virtuelle, de données de joueur ou de statistiques.
Dans ce cas précis, la configuration du segment nécessite 4 étapes simples :
1. Attribuez un nom approprié au segment. Il est conseillé d'utiliser un nom qui reflète votre *caractéristique déterminante* : **Canada Players**.
2. Attribuez les conditions qu'un joueur doit remplir pour entrer dans le segment. Dans ce cas, nous voulons un filtre *Location (country/region)* avec la valeur stricte : *Canada*.
3. Ajoutez une action CloudScript pour le déclencheur d'entrée dans le segment. Configurez l'action pour exécuter la fonction souhaitée. Dans cet exemple, nous voulons **helloWorld**.
4. Validez en sélectionnant le bouton **Save Segment**.
Lorsqu'un segment est défini, vous disposez de diverses options d'action à exécuter lorsqu'un joueur entre dans le segment ou le quitte. CloudScript est de loin l'action la plus flexible, car elle vous donne un contrôle total sur les informations du joueur et de segmentation au moment de la transition de segment.
Utilisez le deuxième paramètre, *Context*, dans votre gestionnaire CloudScript pour identifier le joueur et la transition de segment. Effectuez ensuite toute action souhaitée sur le joueur, comme l'octroi d'articles d'inventaire, de monnaie virtuelle, de données de joueur ou de statistiques.
Dans ce cas précis, la configuration du segment nécessite 4 étapes simples :
1. Attribuez un nom approprié au segment (il est conseillé d'utiliser un nom qui reflète votre *caractéristique déterminante* : **Canada Players**).
2. Attribuez les conditions qu'un joueur doit remplir pour entrer dans le segment. Dans ce cas, nous voulons un filtre *Location (country/region)* avec la valeur stricte : *Canada*.
3. Ajoutez une action **CloudScript** pour le déclencheur d'entrée dans le segment. Configurez l'action pour exécuter la fonction souhaitée. Dans cet exemple, nous voulons : **helloWorld**.
4. Validez en sélectionnant le bouton **Save Segment**.
Un **groupe (2)** est un ensemble de joueurs qui remplissent toutes les conditions définies, appelées **filtres (3)**.
En d'autres termes, pour faire partie d'un segment, un joueur doit faire partie d'au moins 1 groupe. Pour faire partie d'un groupe, un joueur doit remplir toutes les conditions (filtres).
Cela est indiqué par les opérateurs OR/AND : les filtres sont combinés à l'aide de l'opérateur AND, tandis que les groupes sont combinés à l'aide de l'opérateur OR.
La capture d'écran ci-dessous montre un exemple de définition d'un segment. Ce segment se compose de 2 groupes. Le premier groupe est défini par 2 filtres :
* Le joueur doit venir du Canada.
* Le joueur doit avoir les **Push notifications enabled** d'Apple.
Le deuxième groupe concerne également les joueurs du Canada, mais ceux-ci doivent avoir les **Push notifications enabled** de Google.
\
Au final, nous obtenons un segment de joueurs du Canada ayant activé les notifications push Google ou Apple.
Chaque filtre a une configuration et un objectif uniques. Au 30/04/2017, les filtres suivants sont disponibles :
* Le filtre **All players** : ce filtre n'a aucune configuration et il est unique, car il vous permet de créer un segment de tous les joueurs. Il est utile lorsque vous souhaitez exécuter des opérations automatiques pour chaque nouveau joueur (les actions de segment sont décrites dans la section [Comment gérer les actions](#how-to-manage-actions), plus loin dans ce tutoriel).
* Le filtre **First login (date)** : permet de filtrer en fonction de la date et de l'heure de première connexion. Par exemple, les joueurs qui se sont connectés pour la première fois après le 01/01/2017.
* Le filtre **First login (timespan)** : permet de filtrer en fonction de l'intervalle écoulé depuis la première connexion par rapport à la date et l'heure actuelles. Par exemple, les joueurs qui se sont connectés pour la première fois il y a 20 minutes.
* Le filtre **Last login (date)** : permet de filtrer en fonction de la date et de l'heure de dernière connexion. Par exemple, les joueurs qui ne se sont pas connectés depuis le 01/01/2017.
* Le filtre **Last login (timespan)** : permet de filtrer en fonction de l'intervalle écoulé depuis la dernière connexion par rapport à la date et l'heure actuelles. Par exemple, les joueurs qui ne se sont pas connectés depuis une semaine.
* Le filtre **Linked user account to** : permet de filtrer en fonction des comptes liés des utilisateurs. Par exemple, les joueurs dont un compte Steam est lié à un compte de messagerie.
* Le filtre **Location (country/region)** : permet de filtrer en fonction du pays/de la région du joueur. Par exemple, les joueurs du Canada.
* Le filtre **Push notifications enabled with** : permet de filtrer en fonction des paramètres et des capacités de notification push du joueur. Par exemple, les joueurs ayant activé les notifications push Google.
* Le filtre **Statistics value** : permet de filtrer en fonction de votre propre attribut de statistique personnalisé. Par exemple, les joueurs ayant infligé 20 000 dégâts au total.
* Le filtre **Tag** : permet de filtrer selon qu'un joueur possède ou non une certaine balise. Par exemple, les joueurs ayant une balise *cheater*.
* Le filtre **Total value to date in US** : permet de filtrer en fonction du montant en USD qu'un joueur a dépensé dans votre jeu. Par exemple, les joueurs ayant dépensé plus de 30 \$.
* Le filtre **Value to date** : permet de filtrer en fonction du montant d'une certaine devise qu'un joueur a dépensé dans votre jeu. Par exemple, les joueurs ayant dépensé 50 RUB.
* Le filtre **User origination** : permet de filtrer en fonction de la première méthode d'authentification utilisée par un joueur pour commencer à jouer.
La subtilité est qu'un joueur peut *commencer* avec une authentification basée, par exemple, sur un ID d'appareil iOS, puis, plus tard, le *même* joueur peut avoir un compte GameCenter lié. Dans ce cas, l'*origine de l'utilisateur* sera l'ID d'appareil iOS. Par exemple, les joueurs qui se sont connectés pour la première fois à l'aide d'un ID d'appareil iOS.
* Le filtre **Virtual currency balance** : permet de filtrer en fonction du solde de monnaie virtuelle personnalisée d'un joueur. Par exemple, les joueurs ayant moins de 50 Crystal.
## Comment gérer les actions
Chaque *action* a besoin d'un *déclencheur* pour s'exécuter. Certaines actions sont exécutées manuellement, déclenchées directement depuis la page. Parfois, cependant, vous devez sélectionner un déclencheur, c'est-à-dire un événement qui provoque l'exécution d'une action.
Un déclencheur définit le *contexte* de l'action. Par exemple, un déclencheur *player entered segment* vous transmet le contexte contenant une référence au joueur. Le flux de travail général du panneau **Actions** est le suivant :
1. Sélectionnez une **Event condition**, également appelée *déclencheur*.
2. Sélectionnez un **Type** d'action. PlayFab propose diverses actions. Si, à un moment donné, vous avez besoin d'une action plus flexible, envisagez une action CloudScript. Ce type d'action vous permet d'exécuter votre propre fonction CloudScript.
3. Configurez l'action (propre à chaque **Type** d'action).
4. Sélectionnez **REMOVE** pour retirer l'action du déclencheur.
5. Sélectionnez **Add Action** pour ajouter une action au déclencheur.
## Comment inspecter les segments d'un joueur
Vous pouvez consulter les segments auxquels appartient un joueur à l'aide de la page **Player Segments**. Pour accéder à la page **Player Segments** :
1. Sélectionnez **Players** dans le menu latéral.
2. Sélectionnez ensuite l'onglet **Players**.
3. Repérez le joueur que vous souhaitez inspecter et sélectionnez son **ID**.
4. Enfin, sélectionnez **Segments** dans la **Players Toolbar**.
Sur la page **Player Segments**, notez les éléments suivants :
1. L'étiquette **Player ID** identifie le joueur que vous inspectez actuellement.
2. Le tableau **Segments** contient la liste de tous les segments auxquels appartient un joueur. Sélectionnez le **Segment name** pour configurer un segment.
## Related topics
- [Configuration des segments de joueurs](/fr-CA/services/playfab/player-progression/player-data/player-segment-configuration.md)
- [Segments de joueurs](/fr-CA/services/playfab/player-progression/player-data/player-segments.md)
- [Offres ciblées d'Economy V2](/fr-CA/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/targeted-offers.md)
- [Réorganisation dynamique des segments](/fr-CA/build/core-features/common/packaging/packaging-chunkreordering.md)
- [Segmentation des joueurs](/fr-CA/services/playfab/live-service-management/game-configuration/segmentation/segmentation-quickstart.md)