Uso de etiquetas personalizadas con eventos de PlayStream
Las etiquetas personalizadas son una colección de pares clave-valor que los estudios pueden incluir opcionalmente con cada solicitud de API. Son útiles para enriquecer los eventos estándar de PlayStream con más metadatos específicos del estudio (por ejemplo, número de compilación, identificadores de seguimiento externos, etc.). Las etiquetas personalizadas amplían las formas en que puede usar los eventos de PlayStream. El esquema básico de PlayStream es fijo y carece de extensibilidad, pero nos permitió crear métricas y análisis comunes. La naturaleza fija del esquema limitaba la capacidad de los estudios de juegos de personalizar sus datos de forma eficiente y económica, así como su capacidad de recopilar puntos de datos específicos. Las etiquetas personalizadas proporcionan una manera de ampliar el esquema para permitir mayor flexibilidad y funcionalidad.¿Qué puede hacer con las etiquetas personalizadas?
Hay muchas cosas que puede lograr con las etiquetas personalizadas. Estas son algunas sugerencias, pero siéntase libre de ser más creativo al usarlas.Automatización
Los metadatos de PlayStream pueden actuar como criterios que desencadenan ciertos eventos. Cuando es necesario realizar una tarea, un cliente de PlayFab puede configurar una regla que diga “si [etiquetas personalizadas] cumple el requisito xyz, entonces desencadenar la acción A”. Puede integrar CloudScript con las etiquetas personalizadas para lograr la automatización. Las acciones y reglas de CloudScript le permiten desencadenar eventos automáticamente en función de determinados criterios. Por ejemplo, si su estudio de juegos está invirtiendo en marketing de rendimiento para su juego y ejecuta diversas campañas de marketing para captar jugadores nuevos, ahora puede realizar el seguimiento de la campaña de marketing que captó a un jugador y agregar ese identificador de campaña a todos los eventos de PlayStream. Después, puede usar ese identificador de campaña para automatizar procesos. Por ejemplo, si su anuncio prometía “1000 monedas de oro gratis por registrarse”, envíe el evento de “jugador nuevo” y use la campaña de marketing para decidir qué incentivo dar al jugador. Por ejemplo: si campaña de marketing = ‘FREE_GOLD_COINS’, entonces dar al jugador 1000 monedas de oro.Telemetría
Los metadatos de PlayStream pueden ayudar con la recopilación y el análisis de datos. Por ejemplo, puede enviar etiquetas personalizadas como parte de los datos de eventos de PlayStream desde servicios ajenos a PlayFab y poder realizar su seguimiento mientras fluyen por las canalizaciones de datos. Si ya tiene su propio sistema de análisis (por ejemplo, basado en algún identificador), puede integrar y combinar fácilmente datos nuevos pasando ese identificador en las etiquetas personalizadas como parte de sus eventos de PlayStream. Puede incluir identificadores de campaña u otros identificadores analíticos para analizar los ingresos y determinar qué campaña generó la mayor captación de jugadores nuevos, flujo de ingresos o valor de cliente.Flujo de datos
Una vez que las etiquetas personalizadas se reciben desde la solicitud de API, los datos pasan a formar parte del evento de PlayStream, que luego fluye por las canalizaciones de PlayStream para almacenarse en Kusto, el almacenamiento de datos de back-end de PlayFab.Limitaciones
- Las etiquetas personalizadas tienen las siguientes restricciones:
- No más de 10 pares clave-valor
- Cada cadena de clave no puede tener más de 64 caracteres utf8
- Cada cadena de valor no puede tener más de 128 caracteres utf8
- Solo se admiten con llamadas a la API (es decir, no las admite la interfaz de usuario de Game Manager)
Introducción
La siguiente solicitud de ejemplo le muestra cómo agregar etiquetas personalizadas a su solicitud JSON. LasCustomTags acompañan a los eventos de PlayStream correspondientes mientras fluyen por las canalizaciones de datos, y puede acceder a estos datos más adelante con fines analíticos y de acción.
Solicitud de ejemplo
Respuesta de ejemplo
Agregar etiquetas personalizadas no altera la respuesta que recibe de la llamada al punto de conexión. La respuesta después de agregar elCustomTag node es idéntica a la que recibe cuando el nodo no está presente.