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

Ver los valores de las propiedades del evento para un usuario

Para ver el valor de una propiedad de evento personalizado para un usuario específico, las siguientes opciones están disponibles según tu configuración:

• Currents: Si los eventos de comportamiento del cliente están habilitados, las propiedades del evento se incluyen en la exportación de Currents.
• Registro de usuarios del evento: Si el usuario es un usuario de prueba y realizó el evento recientemente, el evento y sus propiedades aparecerán en Configuración > Registro de usuarios del evento.
• Segmentación: Si el almacenamiento de propiedades de eventos personalizados está habilitado para esa propiedad, puedes crear un segmento utilizando el filtro de propiedades del evento para comprobar si el usuario cumple los requisitos.

Importante

Cada evento personalizado o compra puede tener hasta 256 propiedades de evento personalizado distintas. Si un evento personalizado o una compra se registra con más de 256 propiedades, solo se capturarán las primeras 256 y estarán disponibles para su uso.

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 se pueden utilizar para calificar desencadenantes de Campaigns, realizar seguimiento de conversiones y personalizar la mensajería.

Desencadenar mensajes

Usa las propiedades de eventos personalizados para acotar aún más tu audiencia para una Campaign 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 público objetivo y permitir una mayor personalización de la Campaign.

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

Personalizar mensajes

También puedes usar las propiedades de eventos personalizados para la personalización dentro de la plantilla de mensajería. Cualquier Campaign que utilice entrega basada en acciones con un evento desencadenante puede usar las propiedades de eventos personalizados de ese evento para la personalización de la mensajería.

Consideraciones con los filtros

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

Coerción de tipos para comparaciones

Al usar propiedades de eventos en sentencias condicionales de Liquid, puedes encontrar el error Liquid error: comparison of String with 0 failed si estás comparando una propiedad de evento de tipo entero usando operadores como mayor que, menor que o igual a. Esto ocurre porque Liquid trata la propiedad como una cadena de forma predeterminada.

Para solucionarlo, usa el filtro plus: 0 para convertir la propiedad a un número antes de la comparación:

1
2
3
4
{% assign time_spent = {{event_properties.${time_spent}}} | plus: 0 %}
{% if time_spent >= 100 %}
  Great job completing the level quickly!
{% endif %}

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.

El siguiente mensaje está personalizado para tres segmentos diferentes usando lógica condicional. La propiedad de evento personalizado llamada time_spent se puede incluir en el mensaje llamando a {{event_properties.${time_spent}}}.

1
2
3
4
5
6
7
8
{% assign time_spent = {{event_properties.${time_spent}}} | plus: 0 %}
{% if 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 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 %}

Advertencia

Si el usuario no tiene conexión a internet, los mensajes dentro de la aplicación desencadenados con propiedades de eventos personalizados con plantilla (por ejemplo, {{event_properties.${time_spent}}}) fallan y no se muestran.

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

Canvas

En Canvas, context y event_properties tienen propósitos diferentes:

• context: Propiedades del evento o la llamada a la API que desencadenó la entrada al Canvas. Usa context en cualquier paso de mensaje, incluido el primero.
• event_properties: Propiedades de un evento personalizado o compra que ocurre durante el recorrido. Úsalas solo en el primer paso de mensaje después de un paso de Rutas de Acción, no en la ruta de Todos los demás ni en pasos de mensaje posteriores.

Importante

En el primer paso de mensaje de un Canvas, usa context en lugar de event_properties, o añade un paso de Rutas de Acción antes del paso de mensaje. Excepción: para mensajes dentro de la aplicación, puedes usar event_properties en el primer paso de mensaje cuando ese evento es el desencadenante de entrada al Canvas.

Para más información, consulta Contexto y propiedades de eventos y Propiedades de entrada de Canvas y propiedades de eventos.

Segmentación

Usa la segmentación por propiedades de eventos para segmentar 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 eventos para eventos personalizados se actualizan en tiempo real para cualquier Segment que las utilice. Puedes gestionar las propiedades yendo a Configuración de datos > Eventos personalizados y seleccionando Gestionar propiedades para el evento personalizado asociado. Las propiedades de eventos personalizados utilizadas en ciertos filtros de Segment 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 Segments basados en la frecuencia y la antigüedad de las propiedades de eventos.

De forma predeterminada, puedes tener 20 propiedades de eventos segmentables por espacio de trabajo. Contacta a 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 Gestionar propiedades.
2. Selecciona el conmutador Habilitar segmentación para añadir la propiedad de evento para segmentación. Puedes 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 el valor B, X veces en los últimos Y días.
• Ha realizado cualquier compra con la propiedad A con el valor B, X veces en los últimos Y días.
• Añade la capacidad de segmentar en un periodo 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 la 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 contado 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 de Canvas y las propiedades del evento en tus recorridos de usuario de Canvas.

• canvas entry properties
• event properties

Las propiedades de entrada de Canvas son las propiedades que asignas a los Canvas basados en acciones o activados por API. Ten en cuenta que el objeto canvas_entry_properties tiene un límite de tamaño máximo de 50 KB.

Nota

En el caso concreto de los canales de mensajes dentro de la aplicación, solo se puede hacer referencia a context en Canvas.

Puedes hacer referencia a context en cualquier paso de mensaje con este formato Liquid: context.${property_name}. Ten en cuenta que los eventos deben ser eventos personalizados o eventos de compra para poder utilizarse de esta manera.

Caso de uso

Supongamos que una tienda de comercio minorista, RetailApp, tiene la siguiente solicitud: "context" : {"product_name" : "shoes", "product_price" : 79.99}.

RetailApp puede incluir el nombre del producto (shoes) en un mensaje con este Liquid: {{context.${product_name}}}.

RetailApp también puede desencadenar el envío de mensajes específicos para diferentes propiedades de product_name en un Canvas dirigido a los usuarios después de que hayan desencadenado un evento de compra. Por ejemplo, pueden enviar mensajes diferentes a los usuarios que compraron zapatos y a los usuarios que compraron otra cosa añadiendo el siguiente Liquid en un paso de mensaje.

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 %}

Ampliar para el editor de Canvas original

Ya no puedes crear ni duplicar Canvas con el editor original. Esta sección está disponible solo como referencia. Para los Canvas creados con el editor original, solo se puede hacer referencia a las propiedades de entrada de Canvas en el primer paso completo de un Canvas.

Las propiedades del evento se refieren a las propiedades que estableces para los eventos personalizados y las compras. Estas event_properties se pueden utilizar en Campaigns con entrega basada en acciones y en Canvas.

Importante

No puedes utilizar event_properties en el primer paso de mensaje de tu Canvas. En su lugar, debes utilizar context o añadir un paso de Rutas de acción con el evento correspondiente antes del paso de mensaje que incluye event_properties.

En Canvas, las propiedades de eventos personalizados y de eventos de compra se pueden utilizar en Liquid en cualquier paso de mensaje que siga a un paso de Rutas de acción. Asegúrate de utilizar {{event_properties.${property_name}}} si haces referencia a estas propiedades del evento. Estos eventos deben ser eventos personalizados o eventos de compra para poder utilizarse de esta forma en el componente de mensaje.

En el primer paso de mensaje que sigue a una ruta de acción, puedes utilizar las propiedades del evento relacionadas con el evento al que se hace referencia en esa ruta de acción. Sin embargo, estas propiedades del evento solo se pueden utilizar si el usuario realmente realizó la acción (y no fue clasificado en el grupo El resto). Puedes tener otros pasos (que no sean otro paso de Rutas de acción o de mensaje) entre esta ruta de acción y el paso de mensaje.

Ampliar para el editor de Canvas original

Ya no puedes crear ni duplicar Canvas con el editor original. Esta sección está disponible solo como referencia. En el editor de Canvas original, las propiedades del evento no se pueden utilizar en pasos completos planificados. Sin embargo, puedes utilizar las propiedades del evento en el primer paso completo de un Canvas basado en acciones, incluso si el paso completo está planificado.

Consulta Propiedades de entrada de Canvas y propiedades del evento 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 se pueden utilizar 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 se pueden almacenar en Braze tanto a corto como a largo plazo.

Puedes segmentar en función de los valores de las propiedades de eventos de dos maneras:

1. En los últimos 30 días: Puedes usar la segmentación por propiedades de eventos basada en la frecuencia y la antigüedad de valores específicos de propiedades de eventos dentro de Braze Segments. 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 las extensiones de segmento. Esta característica segmenta a los usuarios en función de 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 de éxito de cliente de Braze para obtener recomendaciones sobre el mejor enfoque en función de tus necesidades específicas.