Configuración de segmentos

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