Passer au contenu principal
La page de configuration des segments vous permet de configurer des segments nouveaux ou existants. Vous pouvez :
  • Ajuster le nom.
  • Définir les filtres.
  • Attribuer des tâches.
Chaque segment vous permet de définir des groupes de joueurs utiles ou intéressants et d’effectuer des actions spécifiques sur ce groupe.

Créer un segment ou y accéder

Pour accéder à la configuration des segments :
  1. Sur la gauche, sélectionnez la zone Players.
  2. Sélectionnez l’onglet Segments. Vous pouvez alors choisir de :
    • Utiliser le bouton New Segment pour créer et configurer un nouveau segment*.
    • Rechercher un segment existant et sélectionner son étiquette Name pour configurer le segment.
Game Manager - Joueurs - Créer des segments ou y accéder

Configurer un segment

Prérequis

Certains éléments doivent déjà exister pour que vous puissiez configurer un segment. Il doit déjà y avoir :
  • Des joueurs présentant ou non une caractéristique distinctive définie dans PlayFab.
  • Un hook PlayStream CloudScript défini.
Pour en savoir plus à ce sujet, consultez Utilisation des actions CloudScript avec PlayStream.

Configuration

Dans cet exemple, nous allons :
  • Configurer un segment à l’aide de la caractéristique déterminante suivante : tous les joueurs originaires du Canada.
  • Exécuter une fonction CloudScript helloWorld pour chaque joueur qui entre dans le segment.
Une caractéristique déterminante d’un joueur peut être : Configurer votre première monnaie virtuelle
  • L’heure de connexion
  • Le type d’appareil lié
  • Les balises
  • Un emplacement géographique réel
  • Ses valeurs statistiques
  • Ses soldes de monnaie virtuelle
  • Ses achats en argent réel, etc.
L’emplacement du joueur n’est qu’une de vos nombreuses options possibles et n’est requis que pour cet exemple. N’hésitez pas à remplacer l’exigence relative au pays/à la 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 : elle vous donne un contrôle total sur les informations du joueur et du segment au moment de la transition de segment. Utilisez le deuxième paramètre, context, de votre gestionnaire CloudScript pour identifier le joueur et la transition de segment. Vous pouvez ensuite effectuer n’importe quelle action pour le joueur, comme lui accorder des objets d’inventaire, de la monnaie virtuelle, des données de joueur ou des statistiques. Dans l’exemple présenté ici, la configuration du segment nécessite quatre étapes simples.
  1. Attribuez un nom de segment (1) approprié (dans notre exemple, Canadian Players).
  2. Dans la zone Player (2), définissez les conditions que le joueur doit remplir pour entrer dans le segment. (Dans notre exemple, nous voulons un filtre Location (country/region) avec une valeur stricte : Canada.)
  3. Dans la zone Type, ajoutez une action Execute CloudScript (3) pour le déclencheur d’entrée dans le segment.
  4. Configurez l’action pour qu’elle exécute la fonction souhaitée (helloWorld (3)).
  5. Utilisez le bouton Save Segment (4) pour valider vos actions.
Game Manager - Joueurs - Configuration d'un nouveau segment

Filtrage avancé des segments

Le filtrage des segments vous permet de définir les joueurs inclus dans le segment. Formellement, la zone (1) située à gauche de l’écran illustré ci-dessous est un ensemble de joueurs appartenant à au moins un groupe. Un groupe (2) est un ensemble de joueurs qui remplissent toutes les conditions définies, appelées filtres (3). Game Manager - Joueurs - Filtrage avancé des segments Ainsi, pour faire partie d’un segment :
  • Un joueur doit faire partie d’au moins un 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.
      • Les groupes sont combinés à l’aide de l’opérateur OR.
La capture d’écran ci-dessus est un exemple de définition d’un segment. Ce segment se compose de deux groupes :
  1. Le premier groupe est défini par deux filtres :
    • Le joueur doit être originaire du Canada. a. Et les notifications Push Apple doivent être activées.
    • Le second groupe concerne également les joueurs originaires du Canada, mais les notifications Push Google doivent être activées.
Au final, nous obtenons un segment de joueurs originaires du Canada ayant activé les notifications Push Google ou Apple. Chaque filtre a une configuration et un objectif propres. Au 30/04/2017, les filtres suivants sont disponibles :
  • Filtre All Players : ce filtre n’a aucune configuration et est unique, car il vous permet de créer un segment regroupant 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 plus loin dans ce tutoriel).
  • Filtre First login (date) : permet de filtrer en fonction de la date et de l’heure de la première connexion (par exemple, les joueurs qui se sont connectés pour la première fois après le 01/01/2017).
  • Filtre First login (timespan) : permet de filtrer en fonction du délai é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 [à partir de maintenant]).
  • Filtre Last login (date) : permet de filtrer en fonction de la date et de l’heure de la dernière connexion (par exemple, les joueurs qui ne se sont pas connectés depuis le 01/01/2017).
  • Filtre Last login (timespan) : permet de filtrer en fonction du délai é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 [à partir de maintenant]).
  • Filtre Linked user account to : permet de filtrer en fonction des comptes liés des utilisateurs (par exemple, les joueurs ayant un compte Steam lié à une adresse e-mail).
  • Filtre Location (country/region) : permet de filtrer en fonction du pays/de la région du joueur (par exemple, les joueurs originaires du Canada).
  • 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).
  • Filtre Statistics value : permet de filtrer en fonction de votre propre attribut statistique personnalisé (par exemple, les joueurs ayant infligé 20 000 points de dégâts au total).
  • Filtre Tag : permet de filtrer selon qu’un joueur possède ou non une certaine balise (par exemple, les joueurs portant une balise cheater).
  • Filtre Total value to date in USD : permet de filtrer en fonction du montant en USD dépensé par un joueur dans votre jeu (par exemple, les joueurs ayant dépensé plus de 30 $).
  • Filtre Value to date : permet de filtrer en fonction du montant d’une certaine monnaie dépensé par un joueur dans votre jeu (par exemple, les joueurs ayant dépensé 50 RUB).
  • Filtre User Origination : permet de filtrer en fonction de la première méthode d’authentification utilisée par un joueur pour commencer à jouer.
L’astuce est qu’un joueur peut commencer avec une authentification basée, par exemple, sur un ID d’appareil iOS, puis lier plus tard un compte GameCenter. Dans ce cas, l’origine du joueur 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).
  • Filtre Virtual currency balance : permet de filtrer en fonction du solde de monnaie virtuelle personnalisée d’un joueur (par exemple, les joueurs disposant de moins de 50 Crystal).

Gérer les actions

Chaque action a besoin d’un déclencheur pour s’exécuter. Certaines actions sont exécutées manuellement, directement depuis la page. Mais parfois, c’est à vous de sélectionner un déclencheur, c’est-à-dire un événement qui entraîne l’exécution d’une action. Un déclencheur définit le contexte de l’action. Par exemple, le 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 condition d’événement (1), c’est-à-dire un déclencheur.
  2. Sélectionnez le 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.
  1. Configurez l’action (3) (selon le type d’action).
  2. Supprimez une action (4) du déclencheur.
  3. Utilisez Add Action (5) pour ajouter une action au déclencheur.
Game Manager - Joueurs - Panneau Actions

Examiner les segments d’un joueur

Vous pouvez rechercher les segments auxquels appartient un joueur à l’aide de la page Player Segments. Pour accéder à Player Segments :
  1. Sélectionnez la section Players.
  2. Sélectionnez l’onglet Players.
  3. Sélectionnez l’étiquette ID du joueur que vous souhaitez examiner.
  4. Sélectionnez Segments dans la barre d’outils Players.
Game Manager - Joueurs - Accès aux segments La page Player Segments affiche les éléments suivants :
  • L’étiquette Player ID (1) identifie le joueur que vous examinez actuellement.
  • Le tableau Segment contient la liste de tous les segments auxquels appartient le joueur.
  • Sélectionnez l’étiquette Segment name (2) pour configurer le segment.
Game Manager - Joueurs - Accès aux segments
Dernière modification le 20 octobre 2026