Propiedades de eventos personalizados

Este artículo describe las propiedades de eventos personalizados, su formato esperado, cómo utilizarlas para mensajería y segmentación, y el almacenamiento de 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.

Las propiedades de eventos personalizados no se almacenan en el perfil de Braze y, por lo tanto, no registran puntos de datos (consulta Puntos de datos para conocer las excepciones).

Formato esperado

Los valores de las propiedades deben ser un objeto: las claves son los nombres de las propiedades (cadenas no vacías, de 255 caracteres o menos, sin $ inicial), y los valores son los valores de las propiedades. Para los tipos de datos compatibles, los requisitos de formato y los límites de carga útil, consulta Tipos de datos.

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

Claves reservadas

No puedes usar claves reservadas como nombres de propiedades de eventos. Usar una clave reservada en el objeto properties devuelve el error “Invalid ‘properties’ field”.

Uso de propiedades de eventos personalizados

Las propiedades de eventos personalizados pueden utilizarse para cualificar desencadenantes de campañas, hacer seguimiento de conversiones y personalizar la mensajería.

Desencadenar mensajes

Usa las propiedades de eventos personalizados para delimitar aún más tu audiencia para una campaña o Canvas en particular. Por ejemplo, si tienes una aplicación de comercio electrónico y quieres enviar un mensaje a un usuario cuando abandona su carrito, puedes añadir una propiedad de evento personalizado de price para mejorar tu audiencia objetivo y permitir una mayor personalización de la campaña.

Las propiedades de eventos personalizados anidadas también son compatibles con la entrega basada en acciones.

Personalizar mensajes

También puedes usar propiedades de eventos personalizados para la personalización dentro de la plantilla de mensajería. Cualquier campaña que utilice entrega basada en acciones con un evento desencadenante puede usar propiedades de eventos personalizados 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 les tomó 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 %}
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 etiquetas de Liquid que harán que los mensajes dentro de la aplicación se entreguen como mensajes dentro de la aplicación con plantilla, consulta Preguntas frecuentes.

Consideraciones con los filtros

• Llamadas a la API: Al realizar llamadas a la API y usar el filtro “is blank”, una propiedad de evento personalizado se considera “blank” si se excluye de la llamada. Por ejemplo, si incluyes "event_property": "", entonces tus usuarios se considerarían “not blank”.
• Enteros: Al filtrar por una propiedad de evento personalizado numérica y el número es muy grande, no uses el filtro “exactly”. Si un número es demasiado grande, puede redondearse a cierta longitud, por lo que tu filtro no funcionará como se espera.

Segmentación

Usa la segmentación por propiedades de eventos para dirigirte a usuarios basándote en eventos personalizados realizados y las propiedades asociadas con esos eventos. Esto aumenta tus opciones de filtrado al segmentar por compras y eventos personalizados.

Las propiedades de eventos 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 de eventos personalizados utilizadas en ciertos filtros de segmentos tienen un historial máximo de retrospectiva de 30 días.

Añadir propiedades de eventos para segmentación

Necesitas el permiso de usuario “Edit Custom Event Property Segmentation” para crear segmentos basados en la recencia y frecuencia de propiedades de eventos.

De forma predeterminada, puedes tener 20 propiedades de eventos segmentables por espacio de trabajo. Ponte en contacto con tu director de cuentas de Braze para aumentar este límite.

Para añadir propiedades de eventos para segmentación, haz lo siguiente:

1. Ve a tu evento personalizado y selecciona Administrar propiedades.
2. Activa el conmutador Habilitar segmentación para añadir la propiedad de evento para segmentación. Podrás acceder a opciones de filtrado adicionales al segmentar.

Los filtros de segmentación por propiedades de eventos incluyen:

• Ha realizado un evento personalizado con la propiedad A con valor B, X veces en los últimos Y días.
• Ha realizado cualquier compra con la propiedad A con valor B, X veces en los últimos Y días.
• Añade la capacidad de segmentar dentro de 1 a 30 días.

Los datos solo se registran para una propiedad de evento determinada después de habilitarla, y las propiedades de eventos están disponibles solo a partir de esa fecha en adelante.

Puntos de datos

En lo que respecta al uso de suscripción, las propiedades de eventos personalizados habilitadas para segmentación con los siguientes filtros se cuentan como puntos de datos separados, 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 de Canvas y propiedades de eventos

Puedes utilizar las propiedades de entrada y las propiedades del evento de Canvas en tus recorridos de usuario de Canvas.

• canvas entry properties
• event properties

1
2
3
4
5
6
{% if  {{context.${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 %}

Consulta las propiedades de la entrada y las propiedades del evento en Canvas para obtener más información y ejemplos.

Objetos anidados

Puedes usar 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 crear plantillas de información personalizada en mensajes, desencadenar envíos de mensajes y segmentar usuarios.

Para obtener más información, consulta nuestra página dedicada sobre Objetos anidados.

Almacenamiento de propiedades de eventos personalizados

Las propiedades de eventos personalizados están diseñadas para ayudarte a aumentar la precisión de la segmentación y hacer que los mensajes se sientan aún más personalizados. Las propiedades de eventos personalizados pueden almacenarse en Braze tanto a corto como a largo plazo.

Puedes segmentar basándote en los valores de las propiedades de eventos de dos maneras:

1. Dentro de 30 días: Puedes usar la segmentación por propiedades de eventos basada en la frecuencia y recencia de valores específicos de propiedades de eventos dentro de los segmentos de Braze. Esta opción afecta al uso de datos.
   
   
2. Dentro y más allá de 30 días: Para cubrir tanto la segmentación por propiedades de eventos a corto como a largo plazo, puedes usar Extensiones de segmento. Esta característica segmenta a los usuarios basándose en eventos personalizados y propiedades de eventos registrados en los últimos dos años. Esta opción no afecta al uso de datos.

Ponte en contacto con tu administrador del éxito del cliente de Braze para obtener recomendaciones sobre el mejor enfoque según tus necesidades específicas.