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

# Segmentación avanzada con propiedades personalizadas de jugador

> Cree segmentos de jugadores dinámicos de PlayFab a partir de propiedades personalizadas establecidas mediante API, Game Manager o reglas de PlayStream para impulsar acciones y tareas programadas de operaciones en vivo.

# Segmentación avanzada con propiedades personalizadas (versión preliminar pública)

<Note>
  La característica de segmentación avanzada con propiedades personalizadas está en versión preliminar privada. Prevemos cambios continuos en ella a medida que seguimos recopilando comentarios y optimizándola para el uso de los clientes.
</Note>

La segmentación avanzada con [propiedades personalizadas (versión preliminar pública)](/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties) permite crear segmentos de jugadores dinámicos usando sus propios datos de comercio, involucración y datos personalizados. Puede almacenar y administrar información personalizada de los jugadores mediante propiedades personalizadas y, después, usarla para crear segmentos basados en esas propiedades específicas. Estas propiedades se pueden establecer en los jugadores mediante API, Game Manager o reglas de PlayStream, y se pueden usar para definir segmentos que agrupen a los jugadores según características compartidas. Una vez creados estos segmentos, se pueden usar para generar acciones sobre los jugadores. Además, estos segmentos se pueden usar para definir tareas programadas o manuales.

## Creación de segmentos con propiedades personalizadas de jugador

Puede crear segmentos con propiedades personalizadas de jugador mediante API o Game Manager.

### Mediante API

* Use la [API Create Segment](https://learn.microsoft.com/en-us/rest/api/playfab/admin/segments/create-segment) para crear un segmento.
* Agregue predicados de propiedades personalizadas mediante la API [Update Segment](https://learn.microsoft.com/en-us/rest/api/playfab/admin/segments/update-segment).

### Mediante Game Manager

* Inicie sesión en [Game Manager](https://developer.playfab.com).
* Vaya a la página **Players**.
* Vaya a la pestaña **Segments**.
* [Cree o actualice un segmento](/services/playfab/live-service-management/game-configuration/segmentation/segmentation-quickstart).
* Agregue predicados de propiedades personalizadas seleccionando **Add filter** en **Player**.
* Guarde el segmento.

## Exportación de jugadores desde un segmento con propiedades personalizadas

1. [Cree un segmento](/services/playfab/live-service-management/game-configuration/segmentation/segmentation-quickstart) que haga referencia a predicados de propiedades personalizadas.
2. Use la [API ExportPlayersInSegment](/services/playfab/live-service-management/game-configuration/segmentation/segmentation-export-players-in-a-segment) para exportar perfiles de jugador

## Tareas programadas

1. [Ejecute una tarea programada](/services/playfab/data-analytics/acting-data/scheduled-tasks) en un segmento usando predicados de propiedades personalizadas.

## Escenarios de inicio rápido

### Configuración del catálogo e inventario de Economy V2

1. Cree una moneda **Gold Bar** como artículo.
2. Cree una moneda **Chocolate Bar** como artículo.
   * **Parámetros obligatorios:** Friendly ID, Title y Start Date (1 de marzo)\\
     <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="Configuración del catálogo de Economy V2" width="1715" height="578" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_2_economy_currencies.png" />
3. Cree un artículo de catálogo **Chocolate Bar**:\
   3a. Vaya a **Settings -> Economy (V2) -> Catalog (V2)**.\
   3b. En **Catalog Settings**, agregue un nuevo **Content Type** - **Chocolate Bar** y seleccione **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="Configuración del catálogo" width="1184" height="900" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_3_economy_settings.png" />

   3c. Vaya a **Engage -> Economy -> Catalog (V2) -> Items** y, a continuación, seleccione **New item** para agregarlo.

   <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="Nuevo artículo" width="1717" height="570" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_4_economy_new_item.png" />

   3d. Seleccione **Chocolate Bar** en **ContentType**, establezca **Start date**, **Time** y **Title** y, a continuación, seleccione **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="Guardar y publicar" width="1495" height="757" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_5_create_chocolate_bar.png" />

***

### 1. Creación de un segmento para usuarios que gastan entre 25 y 50 Gold Bars (moneda virtual gastada)

1. Vaya a la página **PlayStream Rules** en **Automation -> Rules**.

2. Cree una regla para el evento `items_subtracted` con la siguiente configuración:

   **Condiciones:**

   * `Payload.ItemId == <id of Gold Bar currency>`
   * Opcional: `Payload.Amount` entre 25 y 50 para evitar sobrescrituras de otras cantidades

   **Acciones:**

   * Actualizar propiedades personalizadas
     * `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="Configuración de la regla de moneda virtual" width="1361" height="784" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_6_gold_sub_rule.png" />

3. Vaya a la página **Segments** en **Players -> Segments**.

4. Cree un segmento con la siguiente configuración:

   * La propiedad personalizada (cadena) `ItemName` es `<Gold Bar id>`
   * La propiedad personalizada (numérica) `AmountSpent` es `>= 25`
   * La propiedad personalizada (numérica) `AmountSpent` es `<= 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="Configuración del segmento de moneda virtual" width="842" height="845" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_7_gold_segment.png" />

***

### 2. Creación de un segmento para usuarios a los que se les concedieron Chocolate Bars y las usaron todas (10) después del 1 de abril de 2025 (inventario concedido)

1. Vaya a la página **PlayStream Rules** en **Automation -> Rules**.

2. Cree una regla para el evento `playfab.inventory.items_granted` con la siguiente configuración:

   **Condiciones:**

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

   **Acciones:**

   * Actualizar propiedades personalizadas del jugador
     * `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="Configuración de la regla de inventario concedido" width="1341" height="833" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_8_chocolate_sub_rule.png" />

3. Vaya a la página **Segments** en **Players -> Segments**.

4. Cree un segmento con la siguiente configuración:

   * Propiedad personalizada (cadena) `ItemName = <Chocolate Bars id>`
   * Propiedad personalizada (fecha y hora) `ItemUpdateDate > 4/1/2025`
   * Propiedad personalizada (numérica) `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="Configuración del segmento de inventario concedido" width="899" height="1250" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_9_chocolate_segment.png" />

5. **Cómo funciona:** La regla **actualizará** la propiedad personalizada del jugador con el valor de cada evento individual: **no acumulará ni sumará valores a lo largo del tiempo**. Por ejemplo, si un jugador gasta 1 chocolate bar diez veces distintas, la propiedad `ItemAmountSpent` se establecerá en `1` cada vez, no en `10`. Como resultado, el jugador **no** se incluiría en el segmento que filtra por `ItemAmountSpent >= 10`. Si necesita hacer un seguimiento de valores acumulados o agregados (por ejemplo, el total de artículos gastados en varios eventos), le recomendamos implementar lógica personalizada mediante una **Azure Function** o **CloudScript** para calcular y actualizar el total.

6. **Nota:** Las Gold Bars del escenario 1 y las Chocolate Bars del escenario 2 escriben ambas en la misma propiedad `ItemName`. Si desea hacer un seguimiento de varios valores, necesitará varios nombres de propiedad para evitar que un jugador oscile entre 2 segmentos.

***

### 3. Creación de un segmento para usuarios que compraron 1 Chocolate Bar en una sola compra (compra de catálogo)

1. Vaya a la página **PlayStream Rules** en **Automation -> Rules**.

2. Cree una regla para el evento `playfab.inventory.items_purchased` con la siguiente configuración:

   **Condiciones:**

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

   **Acciones:**

   * Actualizar propiedades personalizadas
     * `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="Configuración de la regla de compra de catálogo" width="1686" height="1080" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_10_chocolate_purchase_rule.png" />

3. Vaya a la página **Segments** en **Players -> Segments**.

4. Cree un segmento con la siguiente configuración:

   * Propiedad personalizada (numérica) `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="Configuración del segmento de compra de catálogo" width="626" height="1255" data-path="images/playfab/data-analytics/acting-data/advanced_segmentation_docs_11_chocolate_purchase_segment.png" />

5. **Cómo funciona:**  Cada vez que un jugador compra una **Chocolate Bar**, se desencadena la condición de la regla, que ejecuta la acción de agregar la propiedad personalizada. El jugador entra entonces en el segmento y puede recibir la recompensa o notificación configurada.


## Related topics

- [Propiedades personalizadas de jugador](/es/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties.md)
- [Inicio rápido de propiedades personalizadas de jugador](/es/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties-qs.md)
- [Pilas de inventario](/es/services/playfab/economy-monetization/economy-v2/inventory/stacks.md)
- [Segmentación](/es/services/playfab/live-service-management/game-configuration/segmentation/segmentation-overview.md)
- [Documentación de datos y análisis de PlayFab](/es/services/playfab/data-analytics/index.md)