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

# Segmentation avancée avec les propriétés personnalisées de joueur

> Créez des segments de joueurs PlayFab dynamiques à partir de propriétés personnalisées définies via les API, Game Manager ou les règles PlayStream pour alimenter des actions et des tâches planifiées d'opérations en direct.

# Segmentation avancée avec les propriétés personnalisées (préversion publique)

<Note>
  La fonctionnalité Segmentation avancée avec les propriétés personnalisées est en préversion privée. Nous prévoyons d'y apporter des modifications continues à mesure que nous recueillons des commentaires et l'optimisons pour les clients.
</Note>

La segmentation avancée avec les [propriétés personnalisées (préversion publique)](/fr/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties) permet de créer des segments de joueurs dynamiques à l'aide de vos propres données commerciales, d'engagement et personnalisées. Vous pouvez stocker et gérer les informations personnalisées des joueurs à l'aide des propriétés personnalisées, puis les utiliser pour créer des segments basés sur ces propriétés spécifiques. Ces propriétés peuvent être définies sur les joueurs via les API, Game Manager ou les règles PlayStream, et peuvent servir à définir des segments regroupant des joueurs selon des caractéristiques communes. Une fois ces segments créés, ils peuvent être utilisés pour générer des actions sur les joueurs. En outre, ces segments peuvent servir à définir des tâches planifiées ou manuelles.

## Création de segments avec les propriétés personnalisées de joueur

Vous pouvez créer des segments avec les propriétés personnalisées de joueur via l'API ou Game Manager.

### Via l'API

* Utilisez l'[API Create Segment](https://learn.microsoft.com/en-us/rest/api/playfab/admin/segments/create-segment) pour créer un segment.
* Ajoutez des prédicats de propriétés personnalisées à l'aide de l'API [Update Segment](https://learn.microsoft.com/en-us/rest/api/playfab/admin/segments/update-segment).

### Via Game Manager

* Connectez-vous à [Game Manager](https://developer.playfab.com).
* Accédez à la page **Players**.
* Accédez à l'onglet **Segments**.
* [Créez ou mettez à jour un segment](/fr/services/playfab/live-service-management/game-configuration/segmentation/segmentation-quickstart).
* Ajoutez des prédicats de propriétés personnalisées en sélectionnant **Add filter** sous **Player**.
* Enregistrez le segment.

## Exportation des joueurs d'un segment avec des propriétés personnalisées

1. [Créez un segment](/fr/services/playfab/live-service-management/game-configuration/segmentation/segmentation-quickstart) qui référence des prédicats de propriétés personnalisées.
2. Utilisez l'[API ExportPlayersInSegment](/fr/services/playfab/live-service-management/game-configuration/segmentation/segmentation-export-players-in-a-segment) pour exporter les profils de joueurs

## Tâches planifiées

1. [Exécutez une tâche planifiée](/fr/services/playfab/data-analytics/acting-data/scheduled-tasks) sur un segment à l'aide de prédicats de propriétés personnalisées.

## Scénarios de démarrage rapide

### Configurer le catalogue et l'inventaire Economy V2

1. Créez une monnaie **Gold Bar** en tant qu'article.
2. Créez une monnaie **Chocolate Bar** en tant qu'article.
   * **Paramètres requis :** Friendly ID, Title et Start Date (1er mars)\\
     <img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/advanced_segmentation_docs_2_economy_currencies.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=4d7717a09bb5a874d243bccd92600354" alt="Configuration du catalogue Economy V2" width="1715" height="578" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_2_economy_currencies.png" />
3. Créez un article de catalogue **Chocolate Bar** :\
   3a. Accédez à **Settings -> Economy (V2) -> Catalog (V2)**.\
   3b. Sous **Catalog Settings**, ajoutez un nouveau **Content Type**, **Chocolate Bar**, puis sélectionnez **Save**.

   <img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/advanced_segmentation_docs_3_economy_settings.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=a8cc51e057c5f9605d157092b51f92b8" alt="Paramètres du catalogue" width="1184" height="900" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_3_economy_settings.png" />

   3c. Accédez à **Engage -> Economy -> Catalog (V2) -> Items**, puis sélectionnez **New item** pour en ajouter un.

   <img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/advanced_segmentation_docs_4_economy_new_item.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=db3b3f74eec0156f06d22c91c77ed450" alt="Nouvel article" width="1717" height="570" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_4_economy_new_item.png" />

   3d. Sélectionnez **Chocolate Bar** sous **ContentType**, définissez une **Start date**, une **Time** et un **Title**, puis sélectionnez **Save and Publish**.

   <img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/advanced_segmentation_docs_5_create_chocolate_bar.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=3fc3d43286a7a0a5c27ae713dc6fb90b" alt="Enregistrer et publier" width="1495" height="757" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_5_create_chocolate_bar.png" />

***

### 1. Créer un segment pour les utilisateurs qui dépensent entre 25 et 50 Gold Bars (monnaie virtuelle dépensée)

1. Accédez à la page **PlayStream Rules** sous **Automation -> Rules**.

2. Créez une règle pour l'événement `items_subtracted` avec la configuration suivante :

   **Conditions :**

   * `Payload.ItemId == <id of Gold Bar currency>`
   * Facultatif : `Payload.Amount` compris entre 25 et 50 pour éviter l'écrasement par d'autres montants

   **Actions :**

   * Mettre à jour les propriétés personnalisées
     * `AmountSpent = Payload.Amount`
     * `ItemName = Payload.ItemId`

   <img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/advanced_segmentation_docs_6_gold_sub_rule.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=d60daa6e9d15493bda013cfddc1b277b" alt="Configuration de la règle de monnaie virtuelle" width="1361" height="784" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_6_gold_sub_rule.png" />

3. Accédez à la page **Segments** sous **Players -> Segments**.

4. Créez un segment avec la configuration suivante :

   * Propriété personnalisée (chaîne) `ItemName` is `<Gold Bar id>`
   * Propriété personnalisée (numérique) `AmountSpent` is `>= 25`
   * Propriété personnalisée (numérique) `AmountSpent` is `<= 50`

   <img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/advanced_segmentation_docs_7_gold_segment.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=b231ad97b5ae4bdac45fca1fd4d27a76" alt="Configuration du segment de monnaie virtuelle" width="842" height="845" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_7_gold_segment.png" />

***

### 2. Créer un segment pour les utilisateurs ayant reçu des Chocolate Bars et les ayant toutes utilisées (10) après le 1er avril 2025 (inventaire octroyé)

1. Accédez à la page **PlayStream Rules** sous **Automation -> Rules**.

2. Créez une règle pour l'événement `playfab.inventory.items_granted` avec la configuration suivante :

   **Conditions :**

   * `Payload.ItemId == <Chocolate Bars id>`

   **Actions :**

   * Mettre à jour les propriétés personnalisées du joueur
     * `AmountSpent = Payload.Amount`
     * `ItemUpdateDate = Timestamp`

   <img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/advanced_segmentation_docs_8_chocolate_sub_rule.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=762437c85d96129ed24e7b85dfbcbf32" alt="Configuration de la règle d'inventaire octroyé" width="1341" height="833" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_8_chocolate_sub_rule.png" />

3. Accédez à la page **Segments** sous **Players -> Segments**.

4. Créez un segment avec la configuration suivante :

   * Propriété personnalisée (chaîne) `ItemName = <Chocolate Bars id>`
   * Propriété personnalisée (date/heure) `ItemUpdateDate > 4/1/2025`
   * Propriété personnalisée (numérique) `ItemAmountSpent >= 10`

   <img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/advanced_segmentation_docs_9_chocolate_segment.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=c41112d6e5b2c6661ae1a28712c53ef5" alt="Configuration du segment d'inventaire octroyé" width="899" height="1250" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_9_chocolate_segment.png" />

5. **Fonctionnement :** la règle **met à jour** la propriété personnalisée du joueur avec la valeur de chaque événement individuel ; **elle n'accumule ni n'additionne les valeurs au fil du temps**. Par exemple, si un joueur dépense 1 chocolate bar à dix reprises, la propriété `ItemAmountSpent` est définie sur `1` à chaque fois, et non sur `10`. Par conséquent, le joueur ne sera **pas** inclus dans le segment qui filtre sur `ItemAmountSpent >= 10`. Si vous devez suivre des valeurs cumulées ou agrégées (par exemple, le nombre total d'articles dépensés sur plusieurs événements), nous vous recommandons d'implémenter une logique personnalisée à l'aide d'une **Azure Function** ou de **CloudScript** pour calculer et mettre à jour le total.

6. **Remarque :** les Gold Bars du scénario 1 et les Chocolate Bars du scénario 2 écrivent tous deux dans la même propriété `ItemName`. Si vous souhaitez suivre plusieurs valeurs, vous aurez besoin de plusieurs noms de propriétés pour éviter qu'un joueur oscille entre 2 segments.

***

### 3. Créer un segment pour les utilisateurs ayant acheté 1 Chocolate Bar en un seul achat (achat de catalogue)

1. Accédez à la page **PlayStream Rules** sous **Automation -> Rules**.

2. Créez une règle pour l'événement `playfab.inventory.items_purchased` avec la configuration suivante :

   **Conditions :**

   * `Payload.ItemType == ChocolateBar`
   * `Payload.Amount >= 1`
   * `Timestamp >= 5 minutes ago`

   **Actions :**

   * Mettre à jour les propriétés personnalisées
     * `ChocolateBarPurchased = Payload.Amount`

   <img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/advanced_segmentation_docs_10_chocolate_purchase_rule.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=e0dabaa54932a0f2e7e0ed7898cbdb2b" alt="Configuration de la règle d'achat de catalogue" width="1686" height="1080" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_10_chocolate_purchase_rule.png" />

3. Accédez à la page **Segments** sous **Players -> Segments**.

4. Créez un segment avec la configuration suivante :

   * Propriété personnalisée (numérique) `ChocolateBarPurchased >= 1`

   <img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/advanced_segmentation_docs_11_chocolate_purchase_segment.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=0690da9ce0f5575e8e1d19a201a2f557" alt="Configuration du segment d'achat de catalogue" width="626" height="1255" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_11_chocolate_purchase_segment.png" />

5. **Fonctionnement :** chaque fois qu'un joueur achète une **Chocolate Bar**, la condition de la règle se déclenche et exécute l'action d'ajout de la propriété personnalisée. Le joueur entre alors dans le segment et peut recevoir la récompense ou la notification configurée.


## Related topics

- [Démarrage rapide des propriétés personnalisées de joueur](/fr/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties-qs.md)
- [Segmentation](/fr/services/playfab/live-service-management/game-configuration/segmentation/segmentation-overview.md)
- [Propriétés personnalisées de joueur](/fr/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties.md)
- [Rubriques avancées sur les sessions multijoueurs](/fr/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-details.md)
- [Démarrage rapide des boutiques (Economy héritée)](/fr/services/playfab/economy-monetization/economy/stores/quickstart.md)