​

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

​

Creación de segmentos con propiedades personalizadas de jugador

​

Mediante API

• Use la API Create Segment para crear un segmento.
• Agregue predicados de propiedades personalizadas mediante la API Update Segment.

​

Mediante Game Manager

• Inicie sesión en Game Manager.
• Vaya a la página Players.
• Vaya a la pestaña Segments.
• Cree o actualice un segmento.
• 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 que haga referencia a predicados de propiedades personalizadas.
2. Use la API ExportPlayersInSegment para exportar perfiles de jugador

​

Tareas programadas

1. Ejecute una tarea programada 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)\
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. 3c. Vaya a Engage -> Economy -> Catalog (V2) -> Items y, a continuación, seleccione New item para agregarlo. 3d. Seleccione Chocolate Bar en ContentType, establezca Start date, Time y Title y, a continuación, seleccione Save and Publish.

​

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

​

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