Eventos personalizados

Este artículo describe los eventos personalizados y sus propiedades, el historial de eventos del perfil de usuario, los filtros de segmentación relacionados, las propiedades de entrada en Canvas, los análisis relevantes y mucho más. Para conocer los eventos de Braze en general, consulta Eventos.

Los eventos personalizados son acciones realizadas por tus usuarios o actualizaciones sobre ellos. Cuando se registran eventos personalizados, pueden desencadenar cualquier número y tipo de campañas de seguimiento. A continuación, puedes utilizar filtros de segmentación para segmentar a los usuarios en función de lo recientes y frecuentes que hayan sido esos eventos personalizados. Esto hace que los eventos personalizados sean los más adecuados para el seguimiento de interacciones de usuario de alto valor dentro de tu aplicación.

Ejemplos

Algunos ejemplos comunes de eventos personalizados incluyen:

• Desencadenar una Campaign o un Canvas basándose en un evento personalizado mediante la entrega basada en acciones
• Segmentar usuarios por cuántas veces realizaron un evento personalizado, cuándo fue la última vez que ocurrió el evento y similares
• Usar los análisis de eventos personalizados del panel para ver un agregado de la frecuencia con la que ocurrió cada evento
• Encontrar análisis adicionales usando informes de embudo y retención
• Aprovechar las propiedades de entrada persistentes para usar metadatos de tu evento de cliente para la personalización en tus pasos en Canvas
• Generar análisis más sofisticados con Currents
• Configurar criterios de salida para definir cuándo los usuarios deben salir de tu Canvas

Gestión de eventos personalizados

Puedes gestionar, crear o bloquear eventos personalizados en el panel yendo a Configuración de datos > Eventos personalizados.

Solución de problemas de atributos personalizados o eventos duplicados

Si ves dos entradas de datos personalizados con el mismo nombre visible, es posible que una de ellas incluya un espacio invisible al inicio o al final.

Para solucionar y corregir esto:

1. Ve a Configuración de datos > Atributos personalizados o Eventos personalizados, y localiza las dos entradas que parecen tener el mismo nombre.
2. Confirma si uno de los nombres contiene espacios en blanco ocultos:
   1. Haz clic derecho en cada nombre y selecciona Inspeccionar.
   2. Revisa el valor del texto HTML en las herramientas de desarrollador de tu navegador.
   3. Compara los valores (por ejemplo, email frente a ` email`).
   4. Si es necesario, consulta Inspeccionar y editar páginas y estilos con Chrome DevTools.
3. Decide qué nombre debe permanecer como tu clave canónica y estandariza esa ortografía y uso de mayúsculas exactos.
4. Si una entrada incluye espacios al inicio o al final y fue creada directamente en el panel, deja de usar esa entrada y cambia a la clave canónica:
   • Actualiza cualquier flujo de trabajo del panel, importaciones CSV y runbooks internos para usar la clave canónica.
   • Bloquea datos personalizados de la entrada incorrecta cuando estés listo para retirarla.
5. Verifica tus rutas de ingesta:
   • Las cargas útiles de API y SDK eliminan automáticamente los espacios al inicio y al final.
   • Los nombres creados en el panel no se recortan automáticamente, por lo que se requieren entrada manual y gobernanza.

Selecciona el menú junto a un evento personalizado para las siguientes acciones:

Bloqueo

Puedes bloquear eventos personalizados individuales a través del menú de acciones, o seleccionar y bloquear hasta 100 eventos de forma masiva.

Cuando bloqueas un evento personalizado:

• Los datos futuros no se recopilarán para ese evento.
• Los datos existentes no estarán disponibles a menos que se desbloquee ese evento.
• Ese evento no aparecerá en filtros ni gráficos.

Además, si un evento personalizado bloqueado está actualmente referenciado por filtros o desencadenadores en otras áreas de Braze, aparecerá un modal de advertencia explicando que todas las instancias de los filtros o desencadenadores que lo referencian serán eliminadas y archivadas.

Para más detalles sobre el bloqueo y la eliminación de datos personalizados, consulta Bloquear datos personalizados.

Añadir descripciones

Puedes añadir una descripción a un evento personalizado después de crearlo si tienes el permiso de usuario Manage Events, Attributes, Purchases. Selecciona Editar descripción para el evento personalizado e introduce lo que desees, como una nota para tu equipo.

Añadir etiquetas

Puedes añadir etiquetas a un evento personalizado después de crearlo si tienes el permiso de usuario “Manage Events, Attributes, Purchases”. Las etiquetas pueden utilizarse para filtrar la lista de eventos.

Exportar datos

Para exportar la lista de eventos personalizados como un archivo CSV, selecciona Exportar todo en la parte superior de la página. Se genera el archivo CSV y se te envía un enlace de descarga por correo electrónico.

Nota

No existe un límite fijo en el panel sobre cuántos eventos personalizados o atributos personalizados distintos puedes definir o almacenar en un perfil; los límites prácticos dependen de la forma de los datos, el volumen de ingesta y el rendimiento del espacio de trabajo. Si planeas hacer seguimiento de un catálogo muy grande de eventos o atributos, trabaja con tu equipo de cuentas de Braze en el modelado y la higiene de datos (por ejemplo, bloquear datos no utilizados).

Visualización de informes de uso

El informe de uso enumera todos los Canvas, Campaigns y Segments que utilizan un evento personalizado específico. Esta lista no incluye los usos de Liquid.

Puedes ver hasta 100 informes de uso a la vez seleccionando las casillas de verificación junto a los eventos personalizados correspondientes y luego seleccionando Ver informe de uso.

Registro de eventos personalizados

Los eventos personalizados requieren una configuración adicional. Consulta la siguiente documentación de la plataforma para conocer los métodos utilizados para registrar eventos personalizados y cómo añadir propiedades y cantidades a tus eventos personalizados.

Almacenamiento de eventos personalizados

Todos los datos almacenados en el perfil de usuario, incluidos los metadatos de eventos personalizados (primera o última ocurrencia, recuento total y X en Y durante 30 días), se conservan indefinidamente mientras cada perfil esté activo.

Ver el historial de eventos de un usuario

Importante

El historial de eventos se encuentra actualmente en acceso anticipado. Ponte en contacto con tu director de cuentas de Braze si te interesa participar.

Usa la pestaña Historial de eventos en el perfil de un usuario para ver sus eventos personalizados y compras recientes. Esto te ayuda a confirmar que tu integración está registrando eventos correctamente y a solucionar problemas a nivel de usuario directamente en el panel.

Para ver el historial de eventos de un usuario:

1. Ve a Audiencia > Buscar usuarios y selecciona un usuario para abrir su perfil.
2. Selecciona la pestaña Historial de eventos.

La pestaña muestra los eventos personalizados y las compras del usuario de los últimos 30 días, hasta sus 100 eventos más recientes, ordenados del más reciente al más antiguo.

Cada evento incluye:

• Tipo de evento: si el evento es un evento personalizado o una compra.
• Nombre del evento: el nombre del evento tal como fue registrado.
• Hora: cuándo ocurrió el evento.
• Propiedades: las propiedades completas del evento para esa ocurrencia, mostradas como JSON.

Los casos de uso más comunes incluyen:

• Verificar que tu integración del SDK o la API está enviando eventos como se espera durante el desarrollo o después de un lanzamiento.
• Solucionar problemas sobre por qué un usuario entró o no entró en una Campaign o Canvas desencadenados por eventos.
• Investigar un problema de soporte para un usuario específico sin necesidad de configurar una exportación de datos.

Nota

Ver la pestaña Historial de eventos requiere los permisos de usuario Buscar usuarios, Ver PII y Ver propiedades de eventos de usuario, ya que las propiedades de eventos pueden contener datos personales. Para más información, consulta Permisos de usuario de la empresa.

Filtros de segmentación

La siguiente tabla muestra los filtros disponibles para segmentar usuarios por eventos personalizados.

Análisis

Braze registra el número de veces que se han producido eventos personalizados y la última vez que cada usuario los realizó para la segmentación. Consulta estos análisis en Analytics > Custom Events Report.

En la página Custom Events Report del panel, puedes ver de forma agregada con qué frecuencia se produce cada evento personalizado. Las líneas grises superpuestas en la serie temporal indican la última vez que se envió una Campaign, lo cual es útil para ver cómo tus Campaigns afectaron a la actividad de eventos personalizados.

También puedes usar Filters para desglosar tus eventos personalizados por hora, usuarios activos mensuales (MAU), Segments o fórmulas de KPI.

Consejo

Incrementa atributos personalizados para mantener un contador de una acción de usuario similar a un evento personalizado. Sin embargo, no puedes ver datos de atributos personalizados en una serie temporal. Las acciones de usuario que no necesitan analizarse en una serie temporal deben registrarse con este método.

Por qué no se muestran los análisis de eventos personalizados

Los Segments creados con datos de eventos personalizados no pueden mostrar datos históricos anteriores a su creación.

Propiedades de eventos personalizados

Las propiedades de eventos personalizados son metadatos o atributos de eventos personalizados que describen una ocurrencia específica de un evento. Estas propiedades pueden utilizarse para cualificar aún más las condiciones de desencadenamiento, aumentar la personalización en la mensajería, hacer seguimiento de conversiones y generar análisis más sofisticados a través de la exportación de datos en bruto.

Para obtener más información, consulta Propiedades de eventos personalizados.