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.

Consejo

Durante la implementación de Braze, asegúrate de hablar sobre los objetivos de marketing con tu equipo, para que puedas decidir mejor qué datos deseas rastrear y cómo deseas rastrearlos con Braze. Para ver un ejemplo, consulta nuestro caso de estudio sobre aplicaciones de Taxi for Email/transporte compartido al final de esta guía.

Datos recopilados automáticamente

Ciertos datos de usuario son recopilados automáticamente por nuestro SDK; por ejemplo, primera vez que se usó la aplicación, última vez que se usó la aplicación, recuento total de sesiones, SO del dispositivo, etc. Si sigues nuestras guías de integración para implementar nuestros SDK, podrás aprovechar esta recopilación de datos predeterminada. Revisar esta lista puede ayudarte a evitar almacenar la misma información sobre los usuarios más de una vez. Con la excepción del inicio y fin de sesión, todos los demás datos rastreados automáticamente no cuentan para tu uso de puntos de datos.

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

Eventos personalizados

Los eventos personalizados son acciones realizadas por tus usuarios; son ideales para rastrear interacciones de alto valor de los usuarios con tu aplicación. Registrar un evento personalizado puede desencadenar cualquier cantidad de campañas de seguimiento con retrasos configurables, y habilita los siguientes filtros de segmentación en torno a la antigüedad y frecuencia de ese evento:

Braze registra la cantidad de veces que estos eventos han ocurrido, así como la última vez que cada usuario los realizó, con fines de segmentación. En la página de análisis de Custom Events, puedes ver de forma agregada con qué frecuencia ocurre cada evento personalizado, así como por segmento a lo largo del tiempo para un análisis más detallado. Esto es particularmente útil para ver cómo tus campañas han afectado la actividad de eventos personalizados, observando las líneas grises que Braze superpone en la serie temporal para indicar la última vez que se envió una campaña.

Nota

Los atributos personalizados incrementales se pueden usar para mantener un contador de acciones del usuario similar a un evento personalizado. Sin embargo, no podrás ver los datos de atributos personalizados en una serie temporal. Las acciones de usuario que no necesitan analizarse en series temporales deben registrarse mediante este método.

Almacenamiento de eventos personalizados

Todos los datos de 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 se pueden usar para calificar aún más las condiciones de activación, aumentar la personalización en los mensajes y generar análisis más sofisticados a través de 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 las propiedades no pueden ser objetos de tipo array.

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

Las propiedades de eventos personalizados también se pueden usar para la personalización dentro de la plantilla de mensajería. Cualquier campaña que use la entrega basada en acciones con un evento desencadenante puede usar propiedades de eventos personalizados de ese evento para la personalización del mensaje. Si una aplicación de videojuegos quisiera enviar un mensaje a los usuarios que completaron un nivel, podría personalizar aún más el mensaje con una propiedad del tiempo que les llevó a los usuarios completar ese nivel. En este ejemplo, el mensaje se personaliza para tres segmentos diferentes usando lógica condicional. La propiedad de 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 crear campañas de entrega basada en acciones con mayor detalle. Si deseas crear segmentos basados en la antigüedad y frecuencia de las propiedades de eventos, ponte en contacto con tu CSM o con nuestro equipo de soporte.

Atributos personalizados

Los atributos personalizados son herramientas extraordinariamente flexibles que te permiten segmentar usuarios con mayor especificidad que con los atributos estándar. Los atributos personalizados son ideales para almacenar información específica de tu marca sobre tus usuarios. Ten en cuenta que no almacenamos información de series temporales para los atributos personalizados, por lo que no obtendrás gráficos basados en ellos como en el ejemplo anterior de 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 de 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 siguiente tabla describe las opciones de segmentación disponibles para atributos de cadena.

Importante

Al segmentar con el filtro DOES NOT MATCH REGEX, es necesario que ya exista un atributo personalizado con un valor asignado en ese perfil de usuario. Braze sugiere usar la lógica “OR” para comprobar si un atributo personalizado está vacío con el fin de segmentar correctamente a los usuarios.

Consejo

Para más información sobre cómo utilizar nuestro filtro de expresiones regulares, consulta esta documentación sobre expresiones regulares compatibles con Perl (PCRE).
Más recursos sobre regex:

• Regex con Braze
• Depurador y probador de regex
• Tutorial de regex

Arrays

Los atributos de array son útiles para almacenar listas relacionadas de información sobre tus usuarios. Por ejemplo, almacenar las últimas 100 piezas de contenido que un usuario vio dentro de un array permitiría una segmentación específica por intereses.

Los arrays de atributos personalizados son conjuntos unidimensionales; no se admiten arrays multidimensionales. Añadir un elemento a un array de atributos personalizados lo agrega al final del array, a menos que ya esté presente, en cuyo caso se mueve de su posición actual al final del array. Por ejemplo, si se importa un array ['hotdog','hotdog','hotdog','pizza'], aparecerá en el atributo de array como ['hotdog', 'pizza'] porque solo se admiten valores únicos.

Si el array contiene la cantidad máxima de elementos, el primer elemento se descartará y el nuevo se añadirá al final. El siguiente código de ejemplo muestra el comportamiento del array 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 un array es 500. Puedes actualizar la cantidad máxima de arrays en el panel de Braze, en Data Settings > Custom Attributes. Los arrays que superen la cantidad máxima de elementos se truncarán para contener la cantidad máxima de elementos.

Nota

Si un atributo personalizado de array aparece en un perfil de usuario pero no muestra valores, comprueba la Max Length del atributo en Data Settings > Custom Attributes. Una Max Length de 0 impide que los valores se muestren en el perfil. Para los pasos de solución de problemas, consulta Tipos de datos de atributos personalizados.

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

Nota

Utilizamos expresiones regulares compatibles con Perl (PCRE).

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 mensajes de reactivación con contenido específico a tus usuarios.

Nota

La última fecha en que ocurrió un evento personalizado o un evento de compra se registra automáticamente y no debe registrarse de forma duplicada a través de un atributo de tiempo personalizado.

Los filtros de fecha que usan 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 Campaign que ejecutes usando estos filtros incluirá a todos los usuarios en incrementos de 24 horas. Por ejemplo, “última vez que usó la aplicación hace más de 1 día” capturará a todos los usuarios que “usaron la aplicación por última vez hace más de 24 horas” desde el momento exacto en que se ejecuta la Campaign. Lo mismo se aplica a Campaigns configuradas con rangos de fechas más largos: cinco días desde la activación significarán las 120 horas anteriores.

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

Números

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

Nota

El dinero gastado no debe registrarse mediante este método. Más bien, debe registrarse a través de nuestros métodos de compra.

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

Booleanos (verdadero/falso)

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

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

Eventos de compra / seguimiento de ingresos

El uso de nuestros métodos de compra para registrar compras dentro de la aplicación establece el valor del ciclo 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.

Nota

Si deseas segmentar por el número de veces que se ha realizado una compra específica, también deberías registrar esa compra individualmente como un atributo personalizado incremental.

Caso de uso de aplicación de Taxi for Email/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 for Email.
4. Para pedir un Taxi for Email, 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 for Email exitosas
• Solicitudes de Taxi for Email 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 for Email fallidas que no hayan ido seguidas de una solicitud de Taxi for Email exitosa en un plazo de tiempo determinado.
4. Envía promociones a usuarios avanzados con muchas solicitudes de Taxi for Email 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

Usa propiedades de evento

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

Buenas prácticas de desarrollo

Establece ID de usuario para cada usuario

Los ID de usuario deben establecerse para cada uno de tus usuarios. Estos deben ser inmutables y accesibles cuando un usuario abre la aplicación. Recomendamos encarecidamente proporcionar este identificador, ya que te permitirá:

• Hacer seguimiento de tus usuarios en distintos dispositivos y plataformas, mejorando la calidad de tus datos conductuales 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 ni un nombre de usuario en texto plano). Si dicho identificador no está disponible, Braze asignará un identificador único a tus usuarios, pero carecerás de las capacidades enumeradas para los ID de usuario. Debes evitar establecer ID de usuario para aquellos usuarios para los que no dispones de un identificador único vinculado a ellos como individuo. Proporcionar un identificador de dispositivo no ofrece ningún beneficio en comparación con el seguimiento automático de usuarios anónimos que Braze ofrece de forma predeterminada. A continuación se presentan algunos ejemplos de ID de usuario adecuados e inadecuados.

Buenas opciones para ID de usuario:

• Dirección de correo electrónico con hash o nombre de usuario único
• Identificador único de base de datos

Estos no deben usarse como ID de usuario:

• ID de 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

Importante

Para mayor seguridad, te recomendamos añadir nuestra característica de autenticación SDK para evitar la suplantación de identidad de usuarios.

Dale a los eventos y atributos personalizados nombres legibles

Imagina que eres un especialista en marketing que empieza a usar Braze uno o dos años después de la 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 hará las cosas más fáciles para todos los usuarios de tu plataforma. Ten en cuenta las siguientes buenas prácticas:

• No comiences un evento personalizado con un carácter numérico. La lista desplegable se ordena alfabéticamente y empezar con un carácter numérico dificulta la segmentación por el filtro de tu elección.
• Intenta no usar abreviaturas oscuras ni jerga técnica cuando 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 como user_country para aportar claridad a un especialista en marketing que use el panel en el futuro.

Solo registra atributos cuando cambien

Contamos cada atributo enviado a Braze como un punto de datos, incluso si el atributo enviado contiene el mismo valor guardado anteriormente. Solo registrar datos cuando cambien ayuda a evitar el uso redundante de puntos de datos y favorece una experiencia más fluida al evitar llamadas API innecesarias.

Evita generar nombres de eventos programáticamente

Si estás creando constantemente nuevos nombres de eventos, será imposible segmentar a tus usuarios de manera significativa. Generalmente debes capturar eventos genéricos (“Vio un video” o “Leyó un artículo”) en lugar de eventos altamente específicos como (“Vio Gangnam Style” o “Leyó artículo: Los 10 mejores lugares para almorzar en Midtown 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 impone un límite de longitud en bytes (479 bytes) para los nombres de eventos personalizados, los nombres (claves) de atributos personalizados y los valores de cadena de eventos personalizados. Los valores que superen este límite se truncan. Expresado 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). Idealmente, mantén los nombres y valores 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.

Restricciones de contenido

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

• Espacios en blanco al inicio y al final
• Saltos de línea
• Todos los caracteres que no sean dígitos dentro de números de teléfono
  • Ejemplo: “(732) 178-1038” se condensará a “7321781038”
• Los caracteres que no sean espacios en blanco deben convertirse en espacios
• $ no debe usarse como prefijo para ningún evento personalizado
• Cualquier valor con codificación UTF-8 no válida
  • “My \x80 Field” se condensará a “My Field”

Claves reservadas

Las siguientes claves están reservadas y no pueden usarse como propiedades de evento personalizado:

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

Definiciones de valores

• Los valores enteros son de 64 bits
• Los decimales tienen 15 dígitos decimales de forma predeterminada

Parseo 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 de nombre de tu usuario. Además, puedes intentar extraer tanto el nombre como el apellido del usuario usando espacios, pero este último método conlleva el riesgo potencial de nombrar incorrectamente a algunos de tus usuarios.