Eventos de compra
Esta página cubre los eventos y propiedades de la compra, su uso, segmentación, dónde ver los análisis relevantes y mucho más.
El evento de compra heredado entrará en un estado obsoleto (modo de mantenimiento). Los eventos de compra seguirán funcionando como se espera, pero no se desarrollarán nuevas funcionalidades sobre ellos, en favor de los eventos recomendados de comercio electrónico. Si actualmente utilizas eventos de compra, recibirás un aviso previo sobre los planes de eliminación gradual. Por ahora, puedes seguir utilizando los eventos de compra hasta la fecha oficial de obsolescencia. Para más información, consulta el resumen de eventos recomendados.
Los eventos de compra son acciones de compra realizadas por tus usuarios, y se utilizan para registrar las compras dentro de la aplicación y establecer el valor de duración del ciclo de vida (LTV) para cada perfil de usuario. Estos eventos deben ser configurados por tu equipo. El registro de eventos de compra te permite añadir propiedades como la cantidad y el tipo, lo que te ayuda a segmentar aún más a tus usuarios en función de estas propiedades.
Registro de eventos de compra
Puedes registrar las compras pasando un objeto de compra a través del punto de conexión /users/track, o utilizando una de nuestras bibliotecas SDK que se enumeran a continuación.
Las propiedades de eventos de compra utilizan los mismos tipos de datos que las propiedades de eventos personalizados.
A continuación se enumeran los métodos utilizados en diversas plataformas para registrar las compras. En estas páginas también encontrarás documentación sobre cómo añadir propiedades y cantidades a tu evento de compra. Puedes segmentar aún más a tus usuarios en función de estas propiedades.
Ver datos de compra
Después de haber configurado y comenzado a registrar eventos de compra, puedes ver estos datos de compra en el perfil de un usuario en la pestaña Resumen.
Usar datos de compra
Hay varias formas en las que puedes usar los datos de compra en Braze:
- Segmentación: Usa los datos de compra para crear segmentos de usuarios en función de su comportamiento de compra.
- Personalización: Usa los datos de compra para personalizar los mensajes a los usuarios.
- Mensajes desencadenados: Configura mensajes que se desencadenen en función de eventos de compra.
- Análisis: Analiza tus datos de compra para obtener información sobre el comportamiento de los usuarios y la efectividad de tus campañas de marketing.
Segmentación
Puedes desencadenar cualquier número o tipo de campañas de seguimiento en función de los eventos de compra registrados. Por ejemplo, puedes crear un segmento de usuarios que realizaron una compra en los últimos 30 días, o un segmento de usuarios que han gastado más de una cantidad determinada.
Los siguientes filtros de segmentación están disponibles al segmentar usuarios:
- Primera compra realizada
- Primera compra en la aplicación
- Último producto comprado
- Dinero gastado
- Producto comprado
- Número total de compras
- X dinero gastado en Y días
- X producto comprado en Y días
- X propiedad de compra en Y días
- X compras en los últimos Y días
Para más detalles sobre cada filtro, consulta el glosario de filtros de segmentación y filtra por “Comportamiento de compra”.

Para segmentar por el número de veces que se ha realizado una compra específica, registra esa compra individualmente como un atributo personalizado incremental.
Personalización
Como cualquier otro tipo de datos que recopilas de tus usuarios, puedes usar los datos de compra para personalizar tu mensajería a través de Liquid. Por ejemplo, puedes enviar un correo electrónico personalizado a un usuario recomendando productos similares a los que acaba de comprar.
Supongamos que tienes una propiedad de evento de compra llamada last_purchased_product que almacena el nombre del último producto que un usuario compró. Puedes usar esta propiedad para personalizar un mensaje de correo electrónico así:
1
2
3
4
5
6
7
{% if ${last_purchased_product} == "Running Shoes" %}
We hope you're enjoying your new running shoes! Based on your recent purchase, you might also like these running shorts and water bottles.
{% elsif ${last_purchased_product} == "Yoga Mat" %}
We hope you're enjoying your new yoga mat! Based on your recent purchase, you might also like these yoga blocks and straps.
{% else %}
Thank you for your recent purchase! We hope you're enjoying your new item.
{% endif %}
En este ejemplo, el mensaje se personaliza en función de la propiedad last_purchased_product. Si el último producto que el usuario compró fue “Running Shoes”, recibe un mensaje recomendando pantalones cortos para correr y botellas de agua. Si el último producto fue “Yoga Mat”, recibe un mensaje recomendando bloques y correas de yoga. Si last_purchased_product es cualquier otra cosa, recibe un mensaje genérico de agradecimiento.
Mensajes desencadenados
Un caso de uso común es enviar automáticamente un mensaje, como un correo electrónico, cuando un usuario realiza una compra. Por ejemplo, puedes enviar un mensaje de agradecimiento o un código de descuento para una compra futura.
Para hacerlo, crea una campaña o Canvas basado en acciones, y luego establece la acción desencadenante como Realizar compra. También puedes especificar condiciones adicionales para el desencadenante, como el producto comprado o el monto de la compra.
También puedes personalizar tu mensaje desencadenado con Liquid. En el siguiente ejemplo, ${purchase_product_name} es un atributo personalizado que reemplazarías con el nombre real del atributo que almacena el nombre del producto comprado en tu configuración de Braze.
1
Thank you for your purchase of ${purchase_product_name}! As a token of our appreciation, here's a discount code for your next purchase: SAVE10
Análisis
Además de hacer seguimiento de las métricas de compra para segmentación, Braze también registra el número de compras de cada producto y los ingresos generados a lo largo del tiempo. Esto puede ser útil para identificar los productos más populares o medir el impacto de una campaña promocional en las ventas.
Puedes encontrar estos datos en la página del Informe de ingresos.
Cálculos de ingresos
| Métrica | Definición |
|---|---|
| Ingresos de por vida |
Los ingresos de toda la vida son el total de PurchaseEvents valor del precio (en USD) recibido desde el inicio.
|
| Valor de por vida por usuario | El valor de duración por usuario son los ingresos de por vida divididos por el total de tus usuarios (ubicados en tu página de inicio). |
| Ingresos diarios promedio | Los ingresos medios diarios son la media de la suma de los ingresos de la campaña y de Canvas de un día determinado. |
| Compras diarias |
Compras diarias es la media del total de compras únicas PurchaseEvents a lo largo del periodo de tiempo.
|
| Ingresos diarios por usuario | Los ingresos diarios por usuario son los ingresos medios diarios por usuario activo diario. |
Conversión de moneda
Cuando los eventos de compra se registran en una moneda distinta al USD, Braze convierte el monto a USD utilizando tasas de cambio de Open Exchange Rates. Estas tasas se actualizan una vez cada 24 horas. Debido a que las tasas de cambio se almacenan en caché, puede haber ligeras diferencias con la tasa de mercado en tiempo real, particularmente para monedas que experimentan fluctuaciones rápidas.
Cálculo de ingresos de por vida
Braze utiliza los eventos de compra para calcular los ingresos de por vida (también llamados valor de duración del ciclo de vida o LTV) de un usuario, que es una predicción de la ganancia neta atribuida a toda la relación futura con un cliente. Esto puede ayudarte a tomar decisiones informadas sobre estrategias de adquisición y retención de clientes.
\[\text{Valor promedio de compra} = \frac{\text{Gasto total en dólares}}{\text{Número total de eventos de compra}}\]Hay dos lugares principales en Braze donde puedes consultar el LTV de tus usuarios:
- Para métricas generales como Ingresos de por vida y el Valor de por vida por usuario para cada aplicación y sitio, consulta tu Informe de ingresos.
- Para entender los ingresos de por vida de un usuario específico, consulta su perfil de usuario.
Impacto de los reembolsos en los ingresos de por vida
Cuando usas eventos de compra para hacer seguimiento de los datos de compra, debes registrar los reembolsos como un evento de compra de Braze con una propiedad price negativa. Este enfoque mantiene un total preciso para los ingresos de por vida.
Sin embargo, ten en cuenta que el reembolso contará como un evento de compra adicional. Consideremos el siguiente ejemplo. Sam realiza su primera compra por $12 pero devuelve parte de la compra por un reembolso de $5. El perfil de Sam registraría:
- 1 compra con un precio de $12
- 1 compra con un precio de -$5
- Ingresos de por vida de $7
Aunque Sam tendría dos eventos de compra en su perfil, en realidad solo realizó una compra. Esto es importante tenerlo en cuenta si tienes segmentos o casos de uso construidos alrededor del número de compras que un usuario ha realizado. Los reembolsos constantes inflarán el conteo de compras en el perfil del usuario.
Propiedades de eventos de compra
Con las propiedades de eventos de compra, puedes establecer propiedades en las compras que pueden usarse para calificar aún más las condiciones de desencadenamiento, aumentar la personalización en la mensajería y generar análisis más sofisticados a través de la exportación de datos sin procesar. Los tipos de valores de las propiedades (cadena, numérico, booleano, fecha) varían según la plataforma y frecuentemente se asignan como pares clave-valor.
Las siguientes claves están reservadas y no pueden usarse como nombres de propiedades de eventos de compra: time, product_id, quantity, event_name, price y currency. Usar una clave reservada en el objeto properties devolverá el error “Invalid ‘properties’ field”.
Por ejemplo, si tienes una aplicación de comercio electrónico y quieres enviar un mensaje a un usuario después de realizar una compra, podrías mejorar adicionalmente tu audiencia objetivo y permitir una mayor personalización de la campaña añadiendo una propiedad de evento de compra de brand_name.
Ejemplo de desencadenamiento basado en propiedades de eventos de compra:

Consulta el objeto de propiedades de compra para más información.
Segmentación por propiedades de eventos
La segmentación por propiedades de eventos te permite segmentar usuarios basándote no solo en los eventos personalizados realizados, sino también en las propiedades asociadas con esos eventos. Esto añade opciones de filtrado adicionales al segmentar compras y eventos personalizados.

Estos filtros de segmentación incluyen:
- Ha realizado el evento personalizado con propiedad Y con valor V X veces en los últimos Y días
- Ha realizado cualquier compra con propiedad Y con valor V X veces en los últimos Y días
- Añade segmentación de 1 a 30 días en todas las compras, eventos y propiedades dentro de compras y eventos
A diferencia de las Extensiones de segmento, los segmentos utilizados se actualizan en tiempo real, admiten una cantidad ilimitada de segmentos, ofrecen un historial retrospectivo de como máximo 30 días y generan puntos de datos. Debido al cargo adicional de puntos de datos, debes contactar a tu administrador del éxito del cliente de Braze para activar las propiedades de eventos en tus eventos personalizados.
Una vez aprobado, se pueden añadir propiedades adicionales en el dashboard en Configuración de datos > Eventos personalizados seleccionando Administrar propiedades. Luego puedes usar estas propiedades de eventos en el paso de segmentación del constructor de campañas o Canvas.
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.
Las propiedades de entrada del lienzo son las propiedades que se asignan a los lienzos basados en acciones o activados por la API. El objeto canvas_entry_properties tiene un límite de tamaño máximo de 50 KB.
En el caso concreto de los canales de mensajes dentro de la aplicación, solocontext se puede hacer referencia a ellos en Canvas.
Puedes hacer referencia acontext en cualquier paso de mensaje con este formato Liquid: context.${property_name}. Tenga en cuenta que los eventos deben ser eventos personalizados o eventos de compra para ser utilizados de esta manera.
Caso de uso
Supongamos que una tienda minorista, RetailApp, tiene la siguiente petición: \"context\" : {\"product_name\" : \"shoes\", \"product_price\" : 79.99}.
RetailApp puede incluir el nombre del producto (zapatos) en un mensaje con este Liquid: {{context.${product_name}}}.
RetailApp también puede activar 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 activado 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 Líquido 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 %}
Expand for original Canvas editor
Ya no puedes crear o duplicar Lienzos utilizando el editor original. Esta sección está disponible sólo como referencia. Para los lienzos creados con el editor original, las propiedades de entrada del lienzo solo se pueden consultar en el primer paso completo de un lienzo.
Las propiedades de eventos se refieren a las propiedades que usted establece para los eventos y compras personalizados. Estos event_properties se pueden utilizar en campañas con entrega basada en acciones y Lienzos.
No puedes utilizarevent_properties en el primer paso Mensaje de tu Canvas. En su lugar, debe utilizar context o añadir un paso Rutas de acción con el evento correspondiente antes del paso Mensaje que incluye event_properties.
En Canvas, las propiedades del evento personalizado y las propiedades de la 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 ser utilizados de esta forma en el componente Mensaje.
En el primer paso 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 ha realizado la acción (y no ha sido clasificado en el grupo «Todos los demás»). Puede tener otros pasos (que no sean otra Ruta de Acción o paso de Mensaje) entre esta Ruta de Acción y el paso de Mensaje.
Expand for original Canvas editor
Ya no puedes crear o duplicar Lienzos utilizando el editor original. Esta sección está disponible sólo como referencia. En el editor Canvas original, las propiedades del evento no se pueden utilizar en pasos completos programados. Sin embargo, puedes utilizar las propiedades del evento en el primer paso completo de un lienzo basado en acciones, incluso si el paso completo está programado.
Consulta las propiedades de la entrada y las propiedades del evento en Canvas para obtener más información y ejemplos.
Registrar compras a nivel de pedido
Para registrar compras a nivel de pedido en lugar de a nivel de producto, usa el nombre del pedido o la categoría del pedido como product_id. Consulta nuestra especificación del objeto de compra para más información.
Convenciones de nomenclatura de ID de producto
En Braze, ofrecemos algunas convenciones generales de nomenclatura para el product_id del objeto de compra. Al elegir product_id, Braze sugiere usar nombres simples como el nombre del producto o la categoría del producto (en lugar de SKU) con la intención de agrupar todos los elementos registrados por este product_id.
Esto hace que los productos sean fáciles de identificar para segmentación y desencadenamiento.
Bloquear eventos de compra
Ocasionalmente puedes identificar eventos de compra que registran demasiados puntos de datos, ya no son útiles para tu estrategia de marketing o se registraron por error. Para evitar que estos datos se envíen a Braze, puedes bloquear el objeto de datos personalizado mientras tu equipo de ingeniería trabaja en eliminarlo del backend de tu aplicación o sitio web.
En el dashboard de Braze, puedes administrar el bloqueo desde Configuración de datos > Productos. Consulta Administrar datos personalizados para más información.