> ## 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.
# Configuración de segmentos
> Configure segmentos de jugadores de PlayFab en Game Manager definiendo criterios de filtro, reglas de nomenclatura y asignando acciones de entrada/salida o tareas de CloudScript.
La página **Segment configuration**, a la que se accede desde la pestaña **Players** de **Game Manager**, le permite configurar un segmento nuevo o existente ajustando el nombre, definiendo filtros y asignando tareas.
Cada segmento le permite definir grupos de jugadores útiles o interesantes y realizar acciones exclusivas sobre ese grupo.
## Cómo crear un segmento y acceder a él
Para acceder a la configuración de segmentos:
1. Seleccione **Players** en el menú de la izquierda.
2. Seleccione la pestaña **Segments**.
A continuación, puede elegir entre:
3. Usar el botón **New Segment** para crear y configurar un nuevo **segmento**.
4. Buscar un **segmento** *existente* y seleccionar la etiqueta del nombre para configurar el **segmento**.
## Cómo configurar un segmento
**Requisitos previos**:
Para configurar un segmento como el del ejemplo de este tutorial, necesitará:
* Jugadores con y sin una característica distintiva definida en PlayFab.
* Un [enlace de PlayStream de CloudScript](/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream) definido.
En este ejemplo vamos a:
* Configurar un segmento usando esta *característica distintiva*: todos los jugadores que proceden de Canadá.
* Ejecutar una función de CloudScript **helloWorld** por cada jugador que entre en el segmento.
La *característica distintiva* de un jugador puede ser:
* Hora de inicio de sesión
* Tipo de dispositivo vinculado
* Etiquetas
* Ubicación en el mundo real
* Valores de estadísticas
* Valores de moneda virtual
* Compras con dinero real, y más.
La ubicación del jugador es una de las muchas opciones posibles y solo se requiere específicamente para este ejemplo. No dude en reemplazar el requisito de país o región por otro filtro de su elección.
Cuando se define un segmento, dispone de diversas opciones de acción que se ejecutan cuando un jugador entra o sale del segmento.
CloudScript es, con diferencia, la acción más flexible, ya que le concede control total sobre la información del jugador y de la segmentación en el momento de la transición del segmento.
Utilice el segundo parámetro, *Context*, en su controlador de CloudScript para identificar al jugador y la transición del segmento. Después, realice cualquier acción que desee sobre el jugador, como conceder artículos de inventario, moneda virtual, datos de jugador o estadísticas.
En este caso concreto, la configuración del segmento requiere 4 sencillos pasos:
1. Asigne un nombre apropiado al segmento. Es una buena idea usar un nombre que incorpore su *característica distintiva*: **Canada Players**.
2. Asigne las condiciones que un jugador debe cumplir para entrar en el segmento. En este caso, queremos un filtro *Location (country/region)* con el valor estricto: *Canada*.
3. Agregue una acción de CloudScript para el desencadenador de entrada en el segmento. Configure la acción para que ejecute la función que desee. En este ejemplo, queremos **helloWorld**.
4. Confirme seleccionando el botón **Save Segment**.
Cuando se define un segmento, dispone de diversas opciones de acción que se ejecutan cuando un jugador entra o sale del segmento. CloudScript es, con diferencia, la acción más flexible, ya que le concede control total sobre la información del jugador y de la segmentación en el momento de la transición del segmento.
Utilice el segundo parámetro, *Context*, en su controlador de CloudScript para identificar al jugador y la transición del segmento. Después, realice cualquier acción que desee sobre el jugador, como conceder artículos de inventario, moneda virtual, datos de jugador o estadísticas.
En este caso concreto, la configuración del segmento requiere 4 sencillos pasos:
1. Asigne un nombre apropiado al segmento (es una buena idea usar un nombre que incorpore su *característica distintiva*: **Canada Players**).
2. Asigne las condiciones que un jugador debe cumplir para entrar en el segmento. En este caso, queremos un filtro *Location (country/region)* con el valor estricto: *Canada*.
3. Agregue una acción de **CloudScript** para el desencadenador de entrada en el segmento. Configure la acción para que ejecute la función que desee. En este ejemplo, queremos: **helloWorld**.
4. Confirme seleccionando el botón **Save Segment**.
Un **grupo (2)** es un conjunto de jugadores que cumplen todas las condiciones definidas, denominadas **filtros (3)**.
En otras palabras, para formar parte de un segmento, un jugador debe formar parte de al menos 1 grupo. Para formar parte de un grupo, un jugador debe cumplir todas las condiciones (filtros).
Esto se indica mediante los operadores OR/AND: los filtros se combinan con el operador AND, mientras que los grupos se combinan con el operador OR.
La captura de pantalla que se muestra a continuación ofrece un ejemplo de cómo se puede definir un segmento. Este segmento consta de 2 grupos. El primer grupo se define mediante 2 filtros:
* El jugador debe ser de Canadá.
* El jugador debe tener las **notificaciones push** de Apple **habilitadas**.
El segundo grupo también es para jugadores de Canadá, pero deben tener las **notificaciones push** de Google **habilitadas**.
\
Al final, tenemos un segmento de jugadores de Canadá con notificaciones push de Google o de Apple.
Cada filtro tiene una configuración y un propósito únicos. A fecha de 30/4/2017, están disponibles los siguientes filtros:
* El filtro **All players**: este filtro no tiene configuración y es único, porque le permite crear un segmento con todos los jugadores. Resulta útil cuando quiere ejecutar operaciones automáticas para cada nuevo jugador (las acciones de segmento se describen en la sección [Cómo administrar acciones](#how-to-manage-actions), más adelante en este tutorial).
* El filtro **First login (date)**: le permite filtrar según la fecha y hora del primer inicio de sesión. Por ejemplo, jugadores que iniciaron sesión por primera vez después del 1/1/2017.
* El filtro **First login (timespan)**: le permite filtrar según el intervalo de tiempo del primer inicio de sesión con respecto a la fecha y hora actuales. Por ejemplo, jugadores que iniciaron sesión por primera vez hace 20 minutos (desde ahora).
* El filtro **Last login (date)**: le permite filtrar según la fecha y hora del último inicio de sesión. Por ejemplo, jugadores que no han iniciado sesión desde el 1/1/2017.
* El filtro **Last login (timespan)**: le permite filtrar según el intervalo de tiempo del último inicio de sesión con respecto a la fecha y hora actuales. Por ejemplo, jugadores que no han iniciado sesión durante una semana (desde ahora).
* El filtro **Linked user account to**: le permite filtrar según las cuentas vinculadas de los usuarios. Por ejemplo, jugadores que tienen una cuenta de Steam vinculada con una cuenta de correo electrónico.
* El filtro **Location (country/region)**: le permite filtrar según el país o la región del jugador. Por ejemplo, jugadores de Canadá.
* El filtro **Push notifications enabled with**: le permite filtrar según la configuración y las capacidades de notificaciones push del jugador. Por ejemplo, jugadores que tienen habilitadas las notificaciones push de Google.
* El filtro **Statistics value**: le permite filtrar según su propio atributo de estadística personalizado. Por ejemplo, jugadores que infligieron 20000 puntos de daño en total.
* El filtro **Tag**: le permite filtrar según si un jugador tiene o no una etiqueta determinada. Por ejemplo, jugadores que tienen la etiqueta *cheater*.
* El filtro **Total value to date in US**: le permite filtrar según cuánto dinero en USD ha gastado un jugador en su juego. Por ejemplo, jugadores que han gastado más de 30 \$.
* El filtro **Value to date**: le permite filtrar según cuánto ha gastado un jugador de una moneda determinada en su juego. Por ejemplo, jugadores que han gastado 50 RUB.
* El filtro **User origination**: le permite filtrar según el primer método de autenticación que un jugador usó para empezar a jugar.
El truco aquí es que un jugador puede *empezar* con una autenticación basada, por ejemplo, en un id. de dispositivo iOS, pero más adelante ese *mismo* jugador puede tener una cuenta de GameCenter vinculada. En ese caso, la *procedencia del usuario* será el id. de dispositivo iOS. Por ejemplo, jugadores que iniciaron sesión por primera vez usando un id. de dispositivo iOS.
* El filtro **Virtual currency balance**: le permite filtrar según el saldo de moneda virtual personalizada de un jugador. Por ejemplo, jugadores que tienen menos de 50 Crystal.
## Cómo administrar acciones
Cada *acción* necesita un *desencadenador* para ejecutarse. Algunas acciones se ejecutan manualmente, desencadenadas directamente desde la página. Sin embargo, a veces hay que seleccionar un desencadenador: un evento que hace que se ejecute una acción.
Un desencadenador define el *contexto* de la acción. Por ejemplo, un desencadenador de *jugador que entra en el segmento* le pasa el contexto que contiene una referencia al jugador. El flujo de trabajo general del panel **Actions** es:
1. Seleccione una **Event condition**, también conocida como *desencadenador*.
2. Seleccione un **tipo** de acción. PlayFab ofrece diversas acciones. Si en algún momento necesita una acción más flexible, considere una acción de CloudScript. Este tipo de acción le permite ejecutar su propia función de CloudScript.
3. Configure la acción (específica para cada **tipo** de acción).
4. Seleccione **REMOVE** para quitar la acción del desencadenador.
5. Seleccione **Add Action** para agregar una acción al desencadenador.
## Cómo inspeccionar los segmentos de un jugador
Es posible consultar a qué segmentos pertenece un jugador mediante la página **Player Segments**. Para acceder a la página **Player Segments**:
1. Seleccione **Players** en el menú lateral.
2. A continuación, seleccione la pestaña **Players**.
3. Busque el jugador que desea inspeccionar y seleccione la etiqueta **ID**.
4. Por último, seleccione **Segments** en la **barra de herramientas de jugadores**.
En la página **Player Segments**, tenga en cuenta lo siguiente:
1. La etiqueta **Player ID** identifica al jugador que está inspeccionando actualmente.
2. La tabla **Segments** contiene una lista de todos los segmentos a los que pertenece un jugador. Seleccione la etiqueta **Segment name** para configurar un segmento.
## Related topics
- [Configuración de segmentos de jugadores](/es/services/playfab/player-progression/player-data/player-segment-configuration.md)
- [Segmentos de jugadores](/es/services/playfab/player-progression/player-data/player-segments.md)
- [Ofertas dirigidas de Economy V2](/es/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/targeted-offers.md)
- [Segmentación avanzada con propiedades personalizadas de jugador](/es/services/playfab/live-service-management/game-configuration/segmentation/advanced-segmentation.md)
- [Información general de la configuración de Economy v2](/es/services/playfab/economy-monetization/economy-v2/settings.md)