Skip to content

Curso de Braze Learning 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.

Casos de uso

Algunos casos de uso habituales 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.

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

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

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 quieras, 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 “Gestionar eventos, atributos, compras”. Las etiquetas se pueden utilizar para filtrar la lista de eventos.

Ver informes de uso

El informe de uso enumera todos los Lienzos, 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 te 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.

Expand for documentation by platform

Almacenamiento personalizado para eventos

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.

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.

!Gráfico de recuento de eventos personalizados en la página Eventos personalizados del panel que muestra las tendencias de un evento personalizado

También puedes utilizar Filtros para desglosar tus eventos personalizados por horas, usuarios medios mensuales (MAU), segmentos o fórmulas de KPI.

!Filtros personalizados de gráficos de eventos

¿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 del evento personalizadas

Las propiedades del evento personalizado son metadatos o atributos del evento personalizados que describen un suceso específico 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 registran puntos de datos (consulta Puntos de datos para ver las excepciones).

Formato previsto

Los valores de la propiedad deben ser un objeto en el que 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 propiedad pueden ser cualquiera de los siguientes tipos de datos:

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.

Puedes cambiar el tipo de datos de tu propiedad de evento personalizado, pero ten en cuenta las repercusiones de cambiar los tipos de datos después de que se hayan recopilado.

Usar propiedades del evento personalizadas

Las propiedades del evento personalizado pueden utilizarse para calificar los desencadenantes de la campaña, seguir las conversiones y personalizar los mensajes.

Desencadenar mensajes

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.

!Filtros personalizados de propiedades del evento para una tarjeta abandonada. Se combinan dos filtros con un operador AND para enviar esta campaña a los usuarios que abandonaron su tarjeta con un precio de artículo entre 100 y 200 dólares

Las propiedades de eventos personalizados anidados también se admiten en la entrega basada en acciones.

!Filtros personalizados de propiedades del evento para una tarjeta abandonada. Se selecciona un filtro si alguno de los artículos del carrito tiene un precio superior a 100 dólares.

Personalización de mensajes

También puedes utilizar propiedades del 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 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 %}
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 %}

Para obtener una lista completa de las etiquetas de Liquid que harán que los mensajes dentro de la aplicación se entreguen como mensajes de plantilla dentro de la aplicación, consulta Preguntas frecuentes.

Consideraciones con 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 incluyeras "event_property": "", tus usuarios se considerarían “no en blanco”.
  • Números enteros: Cuando filtres por una propiedad de evento personalizada numérica y el número sea muy grande, no utilices el filtro “exactamente”. Si un número es demasiado grande, puede que se redondee a una longitud determinada, por lo que tu filtro no funcionará como esperabas.

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 del evento para eventos personalizados se actualizan en tiempo real para cualquier segmento que las utilice. Puedes administrar las propiedades yendo a Configuración de datos > Eventos personalizados y seleccionando Administrar propiedades para el evento personalizado asociado. Las propiedades del evento personalizadas utilizadas en determinados filtros de segmento 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:

  1. Ve a tu evento personalizado y selecciona Gestionar propiedades.
  2. 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.

Grupo de filtrar que tiene ‘Carrito abandonado’ con propiedad ‘número de itmes’ y valor 2 más de 1 vez en los últimos 30 días naturales.](/docs/es/assets/img/nested_object3.png?e737f9afc6c05f1115860d67c189e868)

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 cuanto al uso de la suscripción, las propiedades del evento personalizado 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 la entrada en Canvas y propiedades del evento

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.

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.

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

Puedes utilizar objetos anidados (objetos dentro de otro objeto) para enviar datos JSON anidados como propiedades de eventos personalizados y compras. 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 del evento

Las propiedades del evento personalizado están diseñadas para ayudarte a aumentar la precisión de la segmentación y hacer que los mensajes parezcan aún más personalizados. Las propiedades del evento personalizadas 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:

  1. 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.

  2. Dentro y fuera de 30 días: Para cubrir la segmentación de propiedades de eventos a corto y largo plazo, puedes utilizar las 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.

Ponte en contacto con tu administrador del éxito del cliente de Braze para que te recomiende el mejor enfoque en función de tus necesidades específicas.

New Stuff!