Eventos personalizados
Este artículo describe los eventos personalizados y sus propiedades, 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 casos habituales de uso de eventos personalizados son:
- Desencadenar una campaña o Canvas basada en un evento personalizado utilizando la entrega basada en acciones
- Segmentar a los usuarios por el número de veces que realizaron un evento personalizado, cuándo se produjo el evento por última vez y similares
- Utilizar el panel de análisis de eventos personalizados para ver un agregado de la frecuencia con la que se ha producido cada evento
- Encontrar análisis adicionales mediante informes de embudo y retención
- Aprovechar las propiedades de entrada persistentes para utilizar metadatos de tu evento de cliente para la personalización en tus pasos en Canvas
- Generar análisis más sofisticados con Currents
- Configuración de los criterios de salida para definir cuándo deben salir los usuarios 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.
Seleccione el menú situado junto a un evento personalizado para realizar las siguientes acciones:
Agregando a la lista de bloqueo
Puedes bloquear eventos personalizados individuales a través del menú de acciones, o seleccionar y bloquear hasta 100 eventos en bloque.
Cuando bloqueas un evento personalizado:
- No se recogerán datos futuros para ese evento.
- Los datos existentes no estarán disponibles a menos que se desbloquee ese evento.
- Ese evento no aparecerá en los filtros ni en los gráficos.
Además, si un evento personalizado bloqueado es referenciado actualmente por filtros o desencadenantes en otras áreas de Braze, aparecerá un modal de advertencia explicando que todas las instancias de los filtros o desencadenantes que lo referencian serán eliminadas y archivadas.
Añadir descripciones
Puede añadir una descripción a un evento personalizado después de crearlo si dispone del permiso de usuario Manage Events, Attributes, Purchases
. Seleccione Editar descripción para el evento personalizado e introduzca lo que desee, como una nota para su equipo.
Añadir etiquetas
Puedes añadir etiquetas a un evento personalizado después de crearlo si tienes el permiso de usuario “Gestionar eventos, atributos, compras”. Las etiquetas pueden utilizarse para filtrar la lista de eventos.
Visualización de informes de uso
El informe de uso enumera todos los Canvases, campañas y segmentos que utilizan un evento personalizado específico. La lista no incluye los usos de Liquid.
Puedes ver hasta 100 informes de uso a la vez seleccionando las casillas de verificación de varios eventos personalizados y, a continuación, seleccionando Ver informe de uso.
Exportar datos
Para exportar la lista de eventos personalizados como un archivo CSV, selecciona el botón Exportar todo en la parte superior de la página. Se generará el archivo CSV y se le enviará por correo electrónico un enlace de descarga.
Registro de eventos personalizados
Los eventos personalizados requieren una configuración adicional. Consulta la lista siguiente para obtener documentación sobre cada plataforma, donde encontrarás información sobre los métodos utilizados para registrar eventos personalizados y sobre cómo añadir propiedades y cantidades a tus eventos personalizados.
Ampliar para documentación por plataforma
Almacenamiento de eventos personalizado
Todos los datos almacenados en el perfil de usuario, incluidos los metadatos de eventos personalizados (primera o última aparición, recuento total y X en Y a lo largo de 30 días), se conservan indefinidamente mientras cada perfil esté activo.
Filtros de segmentación
La siguiente tabla muestra los filtros disponibles para segmentar a los usuarios por eventos personalizados.
Opciones de segmentación | Filtro desplegable | Opciones de entrada |
---|---|---|
Comprobar si el evento personalizado se ha producido más de X veces | MÁS DE | NÚMERO |
Comprobar si el evento personalizado se ha producido menos de X veces | MENOS DE | NÚMERO |
Comprueba si el evento personalizado se ha producido exactamente X número de veces | EXACTAMENTE | NÚMERO |
Comprueba si el evento personalizado ocurrió por última vez después de X fecha | DESPUÉS DE | TIME |
Comprobar si el evento personalizado ocurrió por última vez antes de X fecha | ANTES | TIME |
Compruebe si el evento personalizado se produjo por última vez hace más de X días | MÁS DE | NÚMERO DE DÍAS DESPUÉS (Número positivo) |
Compruebe si el evento personalizado se produjo por última vez hace menos de X días | MENOS DE | NÚMERO DE DÍAS DESPUÉS (Número positivo) |
Compruebe si el evento personalizado se ha producido más de X (máx. = 50) veces. | MÁS DE | en los últimos Y días (Y = 1,3,7,14,21,30) |
Comprobar si el evento personalizado se ha producido menos de X (Máx. = 50) veces | MENOS DE | en los últimos Y días (Y = 1,3,7,14,21,30) |
Comprueba si el evento personalizado ocurrió exactamente X (Máx. = 50) número de veces | EXACTAMENTE | en los últimos Y días (Y = 1,3,7,14,21,30) |
Análisis
Braze anota el número de veces que se han producido eventos personalizados y la última vez que los realizó cada usuario para la segmentación. Para ver estos análisis, ve a Análisis > Informe de eventos personalizados.
En la página Informe de eventos personalizados del panel, puedes ver de forma agregada la frecuencia con la que se produce cada evento personalizado. Las líneas grises superpuestas en la serie temporal indican la última vez que se envió una campaña, lo que resulta útil para ver cómo afectaron tus campañas a la actividad de los eventos personalizados.
También puede utilizar filtros para desglosar sus eventos personalizados por hora, usuarios medios mensuales (MAU), segmentos o fórmulas de KPI.
Incrementa los atributos personalizados para mantener un contador de una acción del usuario similar a un evento personalizado. Sin embargo, no puedes ver datos de atributos personalizados en una serie temporal. Las acciones de los usuarios que no necesiten analizarse en una serie temporal deben registrarse utilizando este método.
¿Por qué no se muestran los análisis de los eventos personalizados?
Los segmentos creados con datos de eventos personalizados no pueden mostrar datos históricos anteriores a su creación.
Propiedades personalizadas de los eventos
Las propiedades de eventos personalizadas 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 desencadenantes, aumentar la personalización de la mensajería, hacer un seguimiento de las conversiones y generar análisis más sofisticados mediante la exportación de datos sin procesar.
Las propiedades del evento personalizado no se almacenan en el perfil Braze y, por tanto, no consumen puntos de datos (consulta Puntos de datos para ver las excepciones).
Cada evento o compra personalizada puede tener hasta 256 propiedades de evento personalizadas distintas. Si se registra un evento personalizado o una compra con más de 256 propiedades, sólo se capturarán y estarán disponibles para su uso las 256 primeras.
Formato previsto
Los valores de las propiedades deben ser un objeto donde las claves son los nombres de las propiedades y los valores son los valores de las propiedades. Los nombres de las propiedades deben ser cadenas no vacías de menos o igual a 255 caracteres, sin signos de dólar al principio ($
).
Los valores de las propiedades pueden ser cualquiera de los siguientes tipos de datos:
Tipo de datos | Descripción |
---|---|
Números | Como números enteros o flotantes |
Booleanos | Valor de true o false . |
Fechas y horas | Formateados como cadenas en formato ISO-8601 o yyyy-MM-dd'T'HH:mm:ss:SSSZ . No se admite dentro de matrices. |
Cadenas | 255 caracteres o menos. |
Matrices | Las matrices no pueden incluir fechas. |
Objetos anidados | Objetos que están dentro de otros objetos. Para más información, consulte la sección de este artículo sobre Objetos anidados. |
Los objetos de propiedades del evento que contienen valores de matrices u objetos pueden tener una carga útil de propiedades del evento de hasta 100 KB.
Puede cambiar el tipo de datos de su propiedad de evento personalizada, pero tenga en cuenta las consecuencias de cambiar los tipos de datos después de que se hayan recopilado los datos.
Uso de propiedades de eventos personalizadas
Las propiedades de eventos personalizados pueden utilizarse para calificar los desencadenantes de campañas, realizar un seguimiento de las conversiones y personalizar los mensajes.
Mensajes de activación
Utiliza propiedades del evento personalizadas para delimitar aún más tu audiencia para una campaña o Canvas concretos. Por ejemplo, si tienes una aplicación de comercio electrónico y quieres enviar un mensaje a un usuario cuando abandone su carrito, puedes añadir una propiedad de evento personalizada de item price
para mejorar tu audiencia objetivo y permitir una mayor personalización de la campaña.
Las propiedades de eventos personalizados anidados también se admiten en la entrega basada en acciones.
Personalizar los mensajes
También puede utilizar propiedades de evento personalizadas 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.
Por ejemplo, si tienes una aplicación de juegos y quieres enviar un mensaje a los usuarios que completaron un nivel, podrías personalizar aún más tu 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 la lógica condicional. La propiedad de evento personalizada 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 %}
Incredible work, hero! Are you ready to test your skills against other powerful heroes? Visit the Arena for real-time battles with top players from around the globe.
{% elsif {{event_properties.${time_spent}}} < 1800 %}
Great job, hero! Don't forget to visit the town store between levels to upgrade your tools.
{% else %}
Well done, hero! Talk to villagers for tips on how to beat levels faster and unlock more rewards.
{% endif %}
Si el usuario no tiene conexión a Internet, los mensajes desencadenados dentro de la aplicación con propiedades del evento personalizadas con plantillas (por ejemplo, {{event_properties.${time_spent}}}
) fallarán y no se mostrarán.
Para obtener una lista completa de las etiquetas Liquid que harán que los mensajes in-app se entreguen como mensajes in-app con plantilla, consulte Preguntas frecuentes.
Consideraciones sobre los filtros
- Llamadas a la API: Al realizar llamadas a la API y utilizar el filtro “está en blanco”, una propiedad de evento personalizada se considera “en blanco” si se excluye de la llamada. Por ejemplo, si incluyera
"event_property": ""
, sus usuarios se considerarían “no en blanco”. - Enteros: Cuando filtre por una propiedad de evento personalizada numérica y el número sea muy grande, no utilice el filtro “exactamente”. Si un número es demasiado grande, es posible que se redondee a una longitud determinada, por lo que el filtro no funcionará como se espera.
Segmentación
Utiliza la segmentación de propiedades de eventos para dirigirte a los usuarios en función de los eventos personalizados realizados y las propiedades asociadas a esos eventos. Esto aumenta tus opciones de filtrado al segmentar por compras y eventos personalizados.
Las propiedades de los eventos personalizados se actualizan en tiempo real para cualquier segmento que los utilice. Puedes administrar propiedades yendo a Configuración de datos > Eventos personalizados y seleccionando Administrar propiedades para el evento personalizado asociado. Las propiedades de eventos personalizadas utilizadas en determinados filtros de segmentos tienen un historial retrospectivo máximo de 30 días.
Añadir propiedades del evento para la segmentación
Necesitarás permisos de usuario de “Gestionar la segmentación de propiedades de eventos personalizados” para crear segmentos basados en la recencia y frecuencia de las propiedades de los eventos.
Por defecto, puedes tener 20 propiedades del evento segmentables por espacio de trabajo. Ponte en contacto con tu director de cuentas Braze para aumentar este límite.
Para añadir propiedades del evento para la segmentación, haz lo siguiente:
- Ve a tu evento personalizado y selecciona Gestionar propiedades.
- Selecciona el conmutador Habilitar segmentación para añadir la propiedad del evento para la segmentación. Puedes acceder a opciones de filtrado adicionales al segmentar.
Los filtros de segmentación de propiedades del evento incluyen:
- Ha realizado un evento personalizado con la propiedad A con valor B, X veces en los últimos Y días.
- Ha realizado alguna compra con la propiedad A con valor B, X veces en los últimos Y días.
- Añade la posibilidad de segmentar de 1 a 30 días.
Los datos sólo se registran para una determinada propiedad del evento una vez que ha sido habilitada por tu administrador del éxito del cliente, y las propiedades del evento sólo están disponibles a partir de esa fecha en adelante.
Puntos de datos
En lo que respecta al uso de suscripciones, las propiedades de eventos personalizados habilitadas para la segmentación con los siguientes filtros se contabilizan como puntos de datos independientes, además del punto de datos contabilizado por el propio evento personalizado:
X Custom Event Property in Y Days
X Purchase Property in Y Days
Propiedades de entrada en el lienzo y propiedades de eventos
You can use Canvas entry properties and event properties in your Canvas user journeys.
Canvas entry properties are the properties you map for Canvases that are action-based or API-triggered. Note that the canvas_entry_properties
object has a maximum size limit of 50 KB.
For in-app message channels specifically, canvas_entry_properties
can only be referenced in Canvas.
You can reference canvas_entry_properties
in any Message step with this Liquid format: canvas_entry_properties.${property_name}
. Note that the events must be custom events or purchase events to be used this way.
Use case
Let’s say a retail store, RetailApp, has the following request: \"canvas_entry_properties\" : {\"product_name\" : \"shoes\", \"product_price\" : 79.99}
.
RetailApp can pull the product name (shoes) into a message with this Liquid: {{canvas_entry_properties.${product_name}}}
.
RetailApp can also trigger specific messages to send for different product_name
properties in a Canvas that targets users after they’ve triggered a purchase event. For example, they can send different messages to users who purchased shoes and users who purchased something else by adding the following Liquid into a Message step.
1
2
3
4
5
6
{% if {{canvas_entry_properties.${product_name}}} == "shoes" %}
Your order is set to ship soon. While you're waiting, why not step up your shoe care routine with a little upgrade? Check out our selection of shoelaces and premium shoe polish.
{% else %}
Your order will be on its way shortly. If you missed something, you have until the end of the week to add more items to your cart for the same discounts.
{% endif %}
Expand for original Canvas editor
You can no longer create or duplicate Canvases using the original editor. This section is available for reference only. For the Canvases built with the original editor, Canvas entry properties can be referenced in the first full step of a Canvas only.
Event properties refer to the properties you set for custom events and purchases. These event_properties
can be used in campaigns with action-based delivery and Canvases.
You can’t use event_properties
in the first Message step of your Canvas. Instead, you must use canvas_entry_properties
or add an Action Paths step with the corresponding event before the Message step that includes event_properties
.
In Canvas, custom event and purchase event properties can be used in Liquid in any Message step that follows an Action Paths step. Make sure to use {{event_properties.${property_name}}}
if you’re referencing these event properties. These events must be custom events or purchase events to be used this way in the Message component.
In the first Message step following an Action Path, you can use event properties related to the event referenced in that Action Path. However, these event properties can only be used if the user actually performed the action (and didn’t get sorted into the Everyone Else group). You can have other steps (that are not another Action Paths or Message step) in between this Action Paths and the Message step.
Expand for original Canvas editor
You can no longer create or duplicate Canvases using the original editor. This section is available for reference only. For the original Canvas editor, event properties can’t be used in scheduled full steps. However, you can use event properties in the first full step of an action-based Canvas, even if the full step is scheduled.
Refer to Canvas entry properties and event properties for more information and examples.
Objetos anidados
Puede utilizar objetos anidados (objetos dentro de otro objeto) para enviar datos JSON anidados como propiedades de eventos y compras personalizados. Estos datos anidados pueden utilizarse para plantillas de información personalizada en los mensajes, desencadenar envíos de mensajes y segmentar a los usuarios.
Para saber más, consulta nuestra página dedicada a los objetos anidados.
Almacenamiento personalizado de propiedades de eventos
Las propiedades de eventos personalizados están diseñadas para ayudarle a aumentar la precisión de la segmentación y hacer que los mensajes parezcan aún más personalizados. Las propiedades de los eventos personalizados pueden almacenarse en Braze tanto a corto como a largo plazo.
Puedes segmentar basándote en los valores de las propiedades del evento de dos formas:
- En un plazo de 30 días: El personal de soporte de Braze puede habilitar la segmentación de propiedades de eventos basándose en la frecuencia y recurrencia de valores específicos de propiedades de eventos dentro de segmentos Braze. Si quieres aprovechar las propiedades del evento dentro de los segmentos, ponte en contacto con tu ejecutivo de cuentas o administrador del éxito del cliente de Braze. Esta opción afectará al uso de datos.
- Dentro y fuera de los 30 días: Para cubrir la segmentación de propiedades de eventos tanto a corto como a largo plazo, puede utilizar Extensiones de segmento. Esta característica segmenta a los usuarios basándose en eventos personalizados y propiedades del evento de los que se ha hecho un seguimiento en los últimos dos años. Esta opción no afectará al uso de datos.
Póngase en contacto con su gestor de éxito de clientes de Braze para que le recomiende el mejor enfoque en función de sus necesidades específicas.