Análisis

Obtén información sobre el análisis del SDK de Braze para comprender mejor qué datos recopila Braze, la diferencia entre eventos personalizados y atributos personalizados, y las prácticas recomendadas para gestionar los análisis.

Datos recopilados automáticamente

Nuestro SDK recopila automáticamente determinados datos de usuario, por ejemplo, la primera aplicación utilizada, la última aplicación utilizada, el recuento total de sesiones, el sistema operativo del dispositivo, etc. Si sigues nuestras guías de integración para implementar nuestros SDK, podrás aprovechar esta recopilación de datos predeterminada. Comprobar esta lista puede ayudarte a evitar almacenar la misma información sobre los usuarios más de una vez. A excepción del inicio y el final de la sesión, el resto de los datos rastreados automáticamente no cuenta para el uso de puntos de datos.

Consulta nuestro artículo de introducción al SDK para incluir en la lista de permitidos los procesos que bloquean la recopilación predeterminada de determinados elementos de datos.

Eventos personalizados

Los eventos personalizados son acciones que realizan tus usuarios; son los más adecuados para hacer seguimiento de las interacciones de alto valor de los usuarios con tu aplicación. El registro de un evento personalizado puede desencadenar cualquier número de campañas de seguimiento con retrasos configurables, y habilita los siguientes filtros de segmentación en torno a la frecuencia y la última ocurrencia de ese evento:

Braze registra el número de veces que se han producido estos eventos, así como la última vez que los realizó cada usuario para la segmentación. En la página de análisis de Eventos personalizados, puedes ver de forma agregada la frecuencia con la que se produce cada evento personalizado, así como por segmentos a lo largo del tiempo para un análisis más detallado. Esto es especialmente útil para ver cómo han afectado tus campañas a la actividad de los eventos personalizados, observando las líneas grises que Braze superpone en las series temporales para indicar la última vez que se envió una campaña.

Almacenamiento de eventos personalizados

Todos los datos del perfil de usuario (eventos personalizados, atributos personalizados, datos personalizados) se almacenan mientras esos perfiles estén activos.

Propiedades de eventos personalizados

Con las propiedades de eventos personalizados, Braze te permite establecer propiedades en eventos personalizados y compras. Estas propiedades pueden utilizarse para calificar aún más las condiciones desencadenantes, aumentar la personalización de la mensajería y generar análisis más sofisticados mediante la exportación de datos sin procesar. Los valores de las propiedades pueden ser cadenas, números, booleanos u objetos de tiempo. Sin embargo, los valores de propiedad no pueden ser matrices de objetos.

Por ejemplo, si una aplicación de comercio electrónico quisiera enviar un mensaje a un usuario cuando abandona su carrito de compras, podría mejorar aún más su audiencia objetivo y permitir una mayor personalización de la campaña añadiendo una propiedad del evento personalizado del cart_value de los carritos de los usuarios.

Las propiedades de eventos personalizados también pueden utilizarse para la personalización dentro de la plantilla de mensajería. Cualquier campaña que utilice la entrega basada en acciones con un evento desencadenante puede utilizar las propiedades del evento personalizado de ese evento para la personalización de la mensajería. Si una aplicación de juegos quisiera enviar un mensaje a los usuarios que hubieran completado un nivel, podría personalizar aún más el mensaje con una propiedad para el tiempo que tardaron los usuarios en completar ese nivel. En este ejemplo, el mensaje se personaliza para tres segmentos distintos utilizando lógica condicional. La propiedad del evento personalizado llamada time_spent puede incluirse en el mensaje llamando a {{event_properties.${time_spent}}}.

1
2
3
4
5
6
7
{% if {{event_properties.${time_spent}}} < 600 %}
Congratulations on beating that level so fast! Check out our online portal where you can play against top players from around the world!
{% elsif {{event_properties.${time_spent}}} < 1800 %}
Don't forget to visit the town store between levels to upgrade your tools.
{% else %}
Talk to villagers for essential tips on how to beat levels!
{% endif %}

Las propiedades de eventos personalizados están diseñadas para ayudarte a personalizar tus mensajes o a crear campañas granulares de entrega basada en acciones. Si deseas crear segmentos basados en la frecuencia y la última ocurrencia de las propiedades del evento, ponte en contacto con tu administrador del éxito del cliente o con nuestro equipo de soporte.

Atributos personalizados

Los atributos personalizados son herramientas extraordinariamente flexibles que te permiten dirigirte a los usuarios con mayor especificidad que con los atributos estándar. Los atributos personalizados son estupendos para almacenar información específica de la marca sobre tus usuarios. Ten en cuenta que no almacenamos información de series temporales para los atributos personalizados, por lo que no vas a obtener ningún gráfico basado en ellos como en el ejemplo anterior para los eventos personalizados.

Almacenamiento de atributos personalizados

Todos los datos del perfil de usuario (eventos personalizados, atributos personalizados, datos personalizados) se almacenan mientras esos perfiles estén activos.

Tipos de datos de atributos personalizados

Los siguientes tipos de datos pueden almacenarse como atributos personalizados:

Cadenas (caracteres alfanuméricos)

Los atributos de cadena son útiles para almacenar entradas del usuario, como una marca favorita, un número de teléfono o la última cadena de búsqueda dentro de tu aplicación. Los atributos de cadena están sujetos a las restricciones de longitud para datos personalizados (479 bytes; aproximadamente 479 caracteres de un solo byte o aproximadamente 160 caracteres para scripts multibyte, como el japonés).

La tabla siguiente describe las opciones de segmentación disponibles para los atributos de cadena.

Matrices

Los atributos de matriz son buenos para almacenar listas relacionadas de información sobre tus usuarios. Por ejemplo, almacenar en una matriz los últimos 100 contenidos que ha visto un usuario permitiría una segmentación por intereses específicos.

Las matrices de atributos personalizados son conjuntos unidimensionales; no se admiten matrices multidimensionales. Añadir un elemento a una matriz de atributos personalizados lo agrega al final de la matriz, a menos que ya esté presente, en cuyo caso se mueve desde su posición actual al final de la matriz. Por ejemplo, si se importara una matriz ['hotdog','hotdog','hotdog','pizza'], se mostraría en el atributo de matriz como ['hotdog', 'pizza'] porque solo se admiten valores únicos.

Si la matriz contiene su cantidad máxima de elementos, el primer elemento se descartará y el nuevo elemento se añadirá al final. A continuación se muestra un código de ejemplo que ilustra el comportamiento de las matrices en el SDK Web:

1
2
3
4
5
6
var abUser = appboy.getUser();
// initialize array for this user, assuming max length of favorite_foods is set to 4.
abUser.setCustomUserAttribute('favorite_foods', ['pizza', 'wings', 'pasta']); // => ['pizza', 'wings', 'pasta']
abUser.addToCustomAttributeArray('favorite_foods', 'fries'); // => ['pizza', 'wings', 'pasta', 'fries']
abUser.addToCustomAttributeArray('favorite_foods', 'pizza'); // => ['wings', 'pasta', 'fries', 'pizza']
abUser.addToCustomAttributeArray('favorite_foods', 'ice cream'); // => ['pasta', 'fries', 'pizza', 'ice cream']

La cantidad predeterminada y máxima de elementos en una matriz es 500. Puedes actualizar la cantidad máxima de matrices en el panel de Braze, en Configuración de datos > Atributos personalizados. Las matrices que superan la cantidad máxima de elementos se truncan para contener la cantidad máxima de elementos.

La tabla siguiente describe las opciones de segmentación disponibles para los atributos de matriz.

Fechas

Los atributos de tiempo son útiles para almacenar la última vez que se realizó una acción específica, de modo que puedas ofrecer a tus usuarios mensajes de reactivación de la interacción específicos del contenido.

Los filtros de fecha que utilizan fechas relativas (por ejemplo, hace más de 1 día, hace menos de 2 días) miden 1 día como 24 horas. Cualquier campaña que ejecutes utilizando estos filtros incluirá a todos los usuarios en incrementos de 24 horas. Por ejemplo, “última vez que se utilizó la aplicación hace más de 1 día” captará a todos los usuarios que “utilizaron la aplicación por última vez hace más de 24 horas” desde el momento exacto en que se ejecuta la campaña. Lo mismo ocurrirá con las campañas configuradas con intervalos de fechas más largos: así, cinco días desde la activación significarán las 120 horas anteriores.

La siguiente tabla describe las opciones de segmentación disponibles para los atributos de tiempo.

Números

Los atributos numéricos tienen una gran variedad de casos de uso. Los atributos personalizados de número incremental son útiles para almacenar el número de veces que se ha producido una determinada acción o evento. Los números estándar tienen todo tipo de usos, como registrar el número de calzado, la talla de cintura o el número de veces que un usuario ha visto una determinada característica o categoría de un producto.

La tabla siguiente describe las opciones de segmentación disponibles para los atributos numéricos.

Booleanos (verdadero/falso)

Los atributos booleanos son útiles para almacenar estados de suscripción y otros datos binarios sencillos sobre tus usuarios. Las opciones de entrada que te proporcionamos te permiten encontrar a los usuarios a los que se les ha establecido explícitamente una variable como booleana, además de los que aún no tienen ningún registro de ese atributo.

La tabla siguiente describe las opciones de segmentación disponibles para los atributos booleanos.

Eventos de compra / seguimiento de ingresos

El uso de nuestros métodos de compra para registrar las compras dentro de la aplicación establece el valor del tiempo de vida (LTV) para cada perfil de usuario individual. Estos datos se pueden ver en nuestra página de ingresos en gráficos de series temporales.

La siguiente tabla describe las opciones de segmentación disponibles para los eventos de compra.

Caso de uso de aplicación de taxi/transporte compartido

Para este ejemplo, consideremos una aplicación de transporte compartido que quiere decidir qué datos de usuario recopilar. Las siguientes preguntas y el proceso de lluvia de ideas son un gran modelo a seguir por los equipos de marketing y desarrollo. Al final de este ejercicio, ambos equipos deberían tener una comprensión sólida de qué eventos y atributos personalizados tiene sentido recopilar para ayudar a cumplir su objetivo.

Pregunta del caso nº 1: ¿Cuál es el objetivo?

Su objetivo es sencillo: quieren que los usuarios pidan taxis a través de su aplicación.

Pregunta del caso nº 2: ¿Cuáles son los pasos intermedios en el camino hacia ese objetivo desde la instalación de la aplicación?

1. Necesitan que los usuarios inicien el proceso de registro y rellenen sus datos personales.
2. Necesitan que los usuarios completen y verifiquen el proceso de registro introduciendo un código en la aplicación que reciben por SMS.
3. Tienen que intentar pedir un taxi.
4. Para pedir un taxi, debe haber uno disponible cuando lo busquen.

Estas acciones podrían entonces etiquetarse como los siguientes eventos personalizados:

• Inicio del registro
• Registro completado
• Solicitudes de taxi exitosas
• Solicitudes de taxi fallidas

Después de implementar los eventos, ahora puedes ejecutar las siguientes campañas:

1. Envía mensajes a los usuarios que iniciaron el registro, pero no desencadenaron el evento de registro completado en un plazo de tiempo determinado.
2. Envía mensajes de felicitación a los usuarios que completen el registro.
3. Envía disculpas y crédito promocional a los usuarios que hayan tenido solicitudes de taxi fallidas que no hayan ido seguidas de una solicitud de taxi exitosa en un plazo de tiempo determinado.
4. Envía promociones a usuarios avanzados con muchas solicitudes de taxi exitosas para agradecerles su fidelización.

¡Y muchas más!

Pregunta del caso nº 3: ¿Qué otra información podríamos querer saber sobre nuestros usuarios para orientar nuestra mensajería?

• ¿Tienen o no créditos promocionales?
• ¿La calificación promedio que dan a sus conductores?
• ¿Códigos promocionales únicos para el usuario?

Estas características podrían etiquetarse como los siguientes atributos personalizados:

• Saldo de crédito promocional (tipo decimal)
• Calificación promedio de los conductores (tipo numérico)
• Código promocional único (tipo de cadena)

Añadir estos atributos te permitiría enviar campañas a los usuarios, por ejemplo:

1. Recordar a los usuarios que no se han conectado en siete días, pero que tienen un crédito promocional, que su crédito existe y que deberían volver a la aplicación para utilizarlo.
2. Enviar mensajes a los usuarios que dan calificaciones bajas a los conductores para obtener opiniones directas de los clientes y saber por qué no disfrutaron de sus viajes.
3. Utilizar nuestras características de plantilla y personalización de mensajes para incluir el atributo de código promocional único en la mensajería dirigida a los usuarios.

Buenas prácticas

Buenas prácticas generales

Utilizar propiedades del evento

• Nombra un evento personalizado con algo que describa una acción que realiza un usuario.
• Utiliza generosamente las propiedades de eventos personalizados para representar datos importantes sobre un evento.
• Por ejemplo, en lugar de capturar un evento personalizado distinto para ver cada una de las 50 películas diferentes, sería más eficaz capturar simplemente “ver una película” como un evento y tener una propiedad del evento que incluya el nombre de la película.

Buenas prácticas de desarrollo

Establecer ID de usuario para cada usuario

Los ID de usuario deben establecerse para cada uno de tus usuarios. Deben ser inmutables y accesibles cuando un usuario abra la aplicación. Te recomendamos encarecidamente que proporciones este identificador, ya que te permitirá:

• Rastrear a tus usuarios a través de dispositivos y plataformas, mejorando la calidad de tus datos de comportamiento y demográficos.
• Importar datos sobre tus usuarios utilizando nuestra API de datos de usuario.
• Dirigirte a usuarios específicos con nuestra API de mensajería, tanto para mensajes generales como transaccionales.

Los ID de usuario deben tener menos de 512 caracteres y deben ser privados y no fáciles de obtener (por ejemplo, no una dirección de correo electrónico simple o un nombre de usuario). Si tal identificador no está disponible, Braze asignará un identificador único a tus usuarios, pero carecerás de las capacidades indicadas para los ID de usuario. Debes evitar configurar ID de usuario para usuarios para los que carezcas de un identificador único que esté vinculado a ellos como individuos. Pasar un identificador de dispositivo no ofrece ninguna ventaja frente al seguimiento automático de usuarios anónimos que Braze ofrece de forma predeterminada. Los siguientes son algunos ejemplos de ID de usuario adecuados e inadecuados.

Buenas opciones para los ID de usuario:

• Dirección de correo electrónico codificada o nombre de usuario único
• Identificador único de la base de datos

No deben utilizarse como ID de usuario:

• ID del dispositivo
• Número aleatorio o ID de sesión
• Cualquier ID no único
• Dirección de correo electrónico
• ID de usuario de otro proveedor externo

Dar nombres legibles a los eventos y atributos personalizados

Imagina que eres un especialista en marketing que empieza a utilizar Braze uno o dos años después de su implementación. Leer una lista desplegable llena de nombres como “usr_no_acct” sin más contexto puede resultar intimidante. Dar a tus eventos y atributos nombres identificables y legibles facilitará las cosas a todos los usuarios de tu plataforma. Ten en cuenta las siguientes buenas prácticas:

• No empieces un evento personalizado con un carácter numérico. La lista desplegable está ordenada alfabéticamente y empezar con un carácter numérico hace más difícil segmentar por el filtro que elijas.
• Intenta no utilizar abreviaturas oscuras o jerga técnica siempre que sea posible.
  • Ejemplo: usr_ctry puede estar bien como nombre de variable para el país de un usuario dentro de un fragmento de código, pero el atributo personalizado debe enviarse a Braze como algo parecido a user_country para dar algo de claridad a un especialista en marketing que utilice el dashboard más adelante.

Registrar atributos solo cuando cambian

Contamos cada atributo pasado a Braze como un punto de datos, aunque el atributo pasado contenga el mismo valor que el guardado anteriormente. Registrar los datos solo cuando cambian ayuda a evitar el uso redundante de puntos de datos y favorece una experiencia más fluida al evitar llamadas innecesarias a la API.

Evitar generar nombres de eventos mediante programación

Si estás creando constantemente nuevos nombres de eventos, va a ser imposible segmentar de forma significativa a tus usuarios. Por lo general, debes capturar eventos genéricos (“Vio un video” o “Leyó un artículo”) en lugar de eventos muy específicos como (“Vio Gangnam Style” o “Leyó artículo: Los 10 mejores sitios para comer en el centro de Manhattan”). Los datos específicos sobre el evento deben incluirse como una propiedad del evento, no como parte del nombre del evento.

Limitaciones y restricciones técnicas

Ten en cuenta las siguientes limitaciones y restricciones al implementar eventos personalizados:

Restricciones de longitud

Braze aplica un límite de longitud en bytes (479 bytes) para los nombres de eventos personalizados, los nombres de atributos personalizados (claves) y los valores de cadena de eventos personalizados. Los valores que superen este límite se truncan. Cuando se expresa en caracteres, esto equivale aproximadamente a 479 caracteres de un solo byte (por ejemplo, ASCII) o aproximadamente 160 caracteres para scripts multibyte como el japonés (suponiendo unos 3 bytes por carácter en UTF-8). Lo ideal es que los nombres y valores sean lo más cortos posible para mejorar el rendimiento de la red y la batería de tu aplicación; si es posible, limítalos a 50 caracteres.

Limitaciones de contenido

El siguiente contenido se recortará programáticamente de tus atributos y eventos. Procura no utilizar lo siguiente:

• Espacio en blanco inicial y final
• Saltos de línea
• Todos los no dígitos de los números de teléfono
  • Ejemplo: “(732) 178-1038” se condensará en “7321781038”
• Los caracteres que no sean espacios en blanco deben convertirse en espacios
• $ no debe utilizarse como prefijo de ningún evento personalizado
• Cualquier valor de codificación UTF-8 no válido
  • “Mi Campo \x80” se condensaría en “Mi Campo”

Claves reservadas

Las siguientes claves están reservadas y no pueden utilizarse como propiedades de eventos personalizados:

• time
• product_id
• quantity
• event_name
• price
• currency

Definiciones de valores

• Los valores enteros son de 64 bits
• Los decimales tienen 15 cifras decimales de forma predeterminada

Análisis sintáctico de un campo de nombre genérico

Si solo existe un único campo de nombre genérico para un usuario (por ejemplo, “JohnDoe”), puedes asignar este título completo al atributo nombre de tu usuario. Además, puedes intentar analizar tanto el nombre como el apellido del usuario utilizando espacios, pero este último método conlleva el riesgo potencial de nombrar mal a algunos de tus usuarios.