Configuration des segments

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 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, 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.

• 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.