Cómo usar eventos de comercio electrónico

Los eventos recomendados de comercio electrónico usan un esquema compartido a nivel de pedido, lo que permite a Braze construir características confiables sobre tus datos de comercio electrónico, incluyendo perfiles de usuario, segmentación, mensajería, informes y recomendaciones impulsadas por IA. Las secciones de este artículo cubren cómo usar cada capacidad en Braze.

Consulta Esquemas de eventos para los requisitos de propiedades y tipos de datos, y Validación de eventos y solución de problemas para saber qué sucede cuando un evento no pasa la validación.

Dado que los eventos de comercio electrónico siguen un esquema predecible, Braze puede construir características confiables sobre ellos, desde el seguimiento de ingresos y plantillas de Canvas prediseñadas hasta recomendaciones impulsadas por IA. Las siguientes secciones te ofrecen un resumen rápido de cada capacidad con enlaces a la documentación completa.

Nota

Los eventos de comercio electrónico de Braze y sus propiedades de eventos segmentables no cuentan como puntos de datos.

Pestaña Commerce

La pestaña Commerce en cada perfil de usuario combina dos módulos: Order activity (métricas calculadas de ingresos y pedidos) y Active cart (el carrito más reciente de los eventos ecommerce.cart_updated).

Actividad de pedidos

El módulo Order activity muestra tres métricas calculadas que se actualizan en tiempo real a medida que se procesan los eventos. El modelo a nivel de pedido de estos cálculos separa claramente los precios de los productos del valor total del pedido.

Nota

Los eventos recomendados de comercio electrónico no se muestran dentro de la sección Purchase history de la pestaña Commerce. El historial de compras se llena con los eventos de compra heredados. Usa las métricas de la siguiente tabla para los ingresos y la actividad de pedidos de los eventos recomendados.

Carrito activo

El módulo Active cart muestra el carrito más reciente en el perfil de usuario. Esta vista es especialmente útil mientras realizas pruebas. Puedes usarla para confirmar el contenido del carrito, validar recorridos basados en el carrito o verificar que los eventos ecommerce.cart_updated están actualizando el perfil como esperas.

Active cart incluye lo siguiente:

• Cart ID — Identificador del carrito que recibió por última vez un evento ecommerce.cart_updated.
• Last updated — Marca de tiempo de la actualización de carrito más reciente.
• Total cart value — Valor total de los artículos en el carrito actual.
• View products — Un enlace para abrir la lista de productos en el carrito (hasta 50 productos).

Orquestación de eCommerce

Segmentación

Braze ofrece tres formas de segmentar usuarios en función de los datos de eCommerce:

• Filtros de eCommerce: Usa la categoría eCommerce en el segmentador, que contiene filtros impulsados por eventos recomendados de eCommerce (como Last Order Placed, Total Revenue y Average Order Value). Para obtener una lista completa de los filtros disponibles, consulta Filtros de segmento.
• Filtros de eventos personalizados: Debido a que los eventos de eCommerce se comportan como eventos personalizados, todos los filtros de eventos personalizados existentes funcionan de inmediato. Por ejemplo, puedes filtrar por “Ha realizado el evento personalizado ecommerce.order_placed más de X veces” o “Primera vez que realizó el evento personalizado ecommerce.order_placed”.
• Extensiones de segmento: Para segmentar a partir de propiedades de eventos anidados, incluido el arreglo de productos anidados o las propiedades de los objetos de metadatos, usa extensiones de segmento con filtrado de propiedades de eventos anidados. Esto te permite crear audiencias como “usuarios que compraron el producto SKU-123 en los últimos 90 días” o combinar criterios entre distintas propiedades del mismo pedido.

Si necesitas filtrar por propiedades personalizadas que no forman parte del esquema de eventos documentado, anida esas propiedades bajo metadata cuando registres el evento (por ejemplo, metadata.color en lugar de color). Las propiedades personalizadas de nivel superior que envíes a través de la API o el SDK no son válidas para los filtros de propiedades de extensiones, incluso si esas propiedades aparecen en los datos de tu evento. Usar una propiedad de nivel superior que no esté en la lista permitida impide guardar o desarchivar la extensión.

Importante

Las extensiones de segmento para eventos recomendados de eCommerce son una característica de pago y se encuentran en acceso anticipado. Si te interesa participar en el acceso anticipado, contacta a tu administrador de éxito de cliente. Confirma que tu plan incluye acceso antes de recomendar la segmentación por propiedades anidadas a tu equipo.

Desencadenamiento

Puedes usar desencadenadores de eventos personalizados realizados con eventos de eCommerce en todo Braze, de la misma manera que con otros eventos personalizados. Para flujos de carrito abandonado, usa el desencadenador Update Cart para capturar correctamente las actualizaciones del carrito.

Además, Braze ofrece un desencadenador dedicado Place Order, que te permite iniciar recorridos o realizar acciones cuando un usuario realiza un pedido. Para más información, consulta Entrega basada en acciones.

Filtros de propiedades

Los desencadenadores Place Order y Update Cart también pueden filtrar por las propiedades que lleva el evento, de modo que un desencadenador se active solo para los pedidos o carritos que te interesan:

• Las propiedades básicas coinciden con una propiedad de nivel superior del evento, como total_value o currency.
• Las propiedades anidadas buscan dentro del arreglo products. Debido a que cada producto lleva sus propias propiedades, products[].metadata.category coincide cuando cualquier producto del pedido o carrito satisface la condición.

Anida los campos personalizados de productos bajo metadata (por ejemplo, products[].metadata.brand). Una propiedad de producto que no forme parte del esquema de eventos no pasa la validación, por lo que un filtro sobre ella nunca coincide.

Por ejemplo, combinar total_value es mayor que 1000 con products[].metadata.category es igual a shoes desencadena solo para pedidos de alto valor que contienen calzado. Antes de los filtros de propiedades, podías desencadenar cuando se realizaba un pedido, pero no en función de lo que contenía el pedido.

Los filtros de propiedades están disponibles en las siguientes superficies:

• Place Order: Desencadenadores de Campaign y Canvas, eventos de excepción, criterios de salida de Canvas, pasos de Rutas de Acción, eventos de conversión y eventos de eliminación de tarjetas de contenido. Se admiten propiedades básicas y anidadas. En desencadenadores de mensajes dentro de la aplicación, Place Order solo admite propiedades básicas.
• Update Cart: Desencadenadores de Campaign y Canvas, eventos de excepción, criterios de salida de Canvas y pasos de Rutas de Acción. Se admiten propiedades básicas y anidadas. En eventos de conversión, eventos de eliminación de tarjetas de contenido y desencadenadores de mensajes dentro de la aplicación, Update Cart se respalda con el evento personalizado ecommerce.cart_updated y solo admite propiedades básicas.

Nota

En un filtro anidado, no es igual a coincide cuando ningún elemento del arreglo coincide. Un carrito filtrado con products[].metadata.category no es igual a shoes coincide solo cuando se han eliminado todos los pares de zapatos del carrito, no cuando el carrito también contiene otras categorías.

Los desencadenadores de mensajes dentro de la aplicación se evalúan en el dispositivo, por lo que Place Order no puede dirigirse a un producto específico ni filtrar por propiedades anidadas allí. La opción Place order for specific product está deshabilitada en el creador. Para actuar sobre un producto específico, usa una Campaign en otro canal o un Canvas en su lugar.

Limitar un pedido a un producto específico

Para desencadenar solo cuando un pedido contiene un producto específico, agrega un filtro de propiedad anidada en el desencadenador Place Order. Esto no está disponible en desencadenadores de mensajes dentro de la aplicación.

Comportamientos guardados con alcance de producto

Si configuraste un comportamiento Place Order antes de que los filtros de propiedades estuvieran disponibles, es posible que aún use Place order for specific product con un Product Identifier (nombre de producto, product_id o variant_id). Esos comportamientos guardados siguen funcionando y continúan coincidiendo exactamente como antes, por lo que las Campaigns y los Canvas existentes no se ven afectados.

Para cambiar un comportamiento guardado a filtros de propiedades, selecciona Place any order. Esto reemplaza los controles de alcance de producto por filtros de propiedades. Usa la siguiente tabla para recrear el mismo alcance:

Importante

Cambiar un comportamiento a Place any order no se puede deshacer. Si aún lo necesitas, recrea el alcance como un filtro de propiedad anidada.

Personalización con Liquid

Los eventos de eCommerce admiten la personalización con Liquid de la misma forma que los eventos personalizados; puedes hacer referencia a las propiedades del evento directamente en tus mensajes. Para incorporar imágenes de productos, precios u otros datos del catálogo en tus mensajes, une tu catálogo con el evento usando product_id o variant_id como identificador de enlace. La etiqueta de Liquid {% shopping_cart %} te permite recorrer el contenido actual del carrito de un usuario para recordatorios de carrito abandonado, avisos de pago o confirmaciones de pedido. Para ejemplos de código listos para usar, consulta Ejemplos de eCommerce.

Como alternativa sin código, los bloques de producto de arrastrar y soltar están disponibles en el programa de acceso anticipado.

Plantillas de Canvas para eCommerce

Braze proporciona plantillas de Canvas listas para usar, preconfiguradas con eventos recomendados de eCommerce como criterios de entrada, salida y conversión, para que puedas lanzar flujos del ciclo de vida sin configuración personalizada. Cada plantilla incluye diseños de correo electrónico de arrastrar y soltar y admite bloques de producto de arrastrar y soltar (actualmente en acceso anticipado). Para ejemplos de uso detallados y ejemplos de Liquid, consulta Ejemplos de eCommerce.

Estas plantillas cubren los flujos de ciclo de vida de eCommerce más comunes. Úsalas como punto de partida y luego personaliza la temporización, los canales y el contenido creativo para tu audiencia.

• navegación abandonada
• carrito abandonado
• pago abandonado
• confirmación de pedido y cuestionario

Vuelve a involucrar a los usuarios que vieron un producto pero no lo agregaron a su carrito.

Usa esta plantilla cuando quieras que los navegantes regresen a considerar productos que vieron recientemente pero sobre los que no actuaron.

Configuración	Valor
Evento de entrada	ecommerce.product_viewed
Eventos de salida	ecommerce.product_viewed, ecommerce.cart_updated, ecommerce.checkout_started, Placed Order
Evento de conversión	Placed Order

Recupera a los usuarios que agregaron artículos a su carrito pero no iniciaron el pago.

Usa esta plantilla cuando quieras recordar a los usuarios los artículos en su carrito y llevarlos de vuelta para completar el pago.

Configuración	Valor
Evento de entrada	ecommerce.cart_updated
Eventos de salida	ecommerce.cart_updated, ecommerce.checkout_started, Placed Order
Evento de conversión	Placed Order

Consejo

El evento ecommerce.cart_updated admite reemplazo completo del carrito (cada evento puede describir el carrito completo) o actualizaciones incrementales usando los valores add y remove para la propiedad opcional action. Elige un enfoque por carrito y evita mezclar actualizaciones de reemplazo e incrementales para el mismo cart_id. El carrito almacenado conserva el currency del evento de carrito más reciente; una actualización de carrito en una moneda diferente reemplaza el carrito almacenado en lugar de mezclar valores de dos monedas. Usa la etiqueta de Liquid {% shopping_cart %} en tu mensaje para mostrar dinámicamente el contenido actual del carrito en el momento del envío.

Recupera a los usuarios que iniciaron el pago pero no completaron la compra.

Usa esta plantilla cuando quieras recuperar compras en la etapa de mayor intención del embudo.

Configuración	Valor
Evento de entrada	ecommerce.checkout_started
Evento de salida	Placed Order
Evento de conversión	Placed Order

Confirma una compra exitosa y da seguimiento con un cuestionario de opinión para impulsar la recopilación de reseñas y la participación posterior a la compra.

Usa esta plantilla cuando quieras optimizar la comunicación posterior a la compra y recopilar comentarios de los clientes en un solo flujo de trabajo.

Configuración	Valor
Evento de entrada	ecommerce.order_placed
Evento de conversión	Start Session o ecommerce.product_viewed

Personalizar plantillas

Estas plantillas están diseñadas como punto de partida. Las personalizaciones comunes incluyen:

• Personalizar el correo electrónico: Cada plantilla incluye un correo electrónico preconfigurado creado con el editor de arrastrar y soltar, que es completamente editable para adaptarse a tu marca y contenido.
• Agregar canales: Combina el correo electrónico con push, SMS o mensajes dentro de la aplicación para un refuerzo multicanal.
• Agregar retrasos y divisiones de decisiones: Ramifica a los usuarios por comportamiento (por ejemplo, carrito de alto valor frente a carrito de bajo valor) o periodos de espera entre mensajes.
• Cambiar el contenido creativo: Reemplaza la plantilla de correo electrónico incluida con el estilo visual de tu marca.
• Usar bloques de producto: Usa bloques de producto de arrastrar y soltar (en el programa de acceso anticipado) para mostrar dinámicamente el contenido del carrito abandonado o los productos visitados sin escribir Liquid personalizado.

Para estrategias de ciclo de vida más avanzadas, incluidos ejemplos de personalización con Liquid, consulta Ejemplos de eCommerce.

Informes de eCommerce

Los eventos recomendados de eCommerce alimentan las mismas superficies de ingresos que los clientes ya utilizan hoy en día. Cuando tu integración envía eventos de eCommerce, los siguientes informes incluyen automáticamente los ingresos de eCommerce:

Para campos calculados no relacionados con el usuario (por ejemplo, ingresos de Campaign o Canvas), los ingresos se calculan de la misma forma en todos los informes: price multiplicado por quantity por producto en el pedido, sumado a lo largo de los productos en cada evento order_placed.

Nota

Los cálculos de ingresos limitan las cantidades individuales de productos a 1000 unidades por pedido. Si falta el campo de cantidad para un producto, se establece de forma predeterminada en una unidad. El evento original ecommerce.order_placed conserva la cantidad completa que enviaste; solo el cálculo de ingresos aplica el límite.

Si estás migrando de eventos de compra heredados a ecommerce.order_placed, coordínalo con tu equipo de cuenta de Braze antes de realizar cualquier cambio en la integración. Durante el período de transición, envía tanto los eventos de compra heredados como los eventos ecommerce.order_placed para confirmar que se activan correctamente y para preparar tus Campaigns, Canvas y segmentos activos para migrar al nuevo evento. Tu equipo de cuenta puede ayudarte a planificar el cambio para migrar los informes de ingresos de los eventos de compra heredados a ecommerce.order_placed.

BrazeAI^TM

Predictive Events, Predictive Churn y las recomendaciones de artículos son compatibles con eventos de eCommerce como eventos objetivo y señales, y cuentan con una opción dedicada “Order Placed”. El esquema estandarizado hace que estos modelos sean más fiables porque los datos son consistentes en toda tu base de usuarios.

Exportar datos

Braze ofrece varias formas de exportar datos de eventos de eCommerce para usarlos en tu almacén de datos, herramientas de BI o sistemas posteriores. Los eventos recomendados de eCommerce se exportan a través de los mismos canales que el resto de tus datos de eventos.

¿Cómo segmento usuarios por un producto específico?

El segmentador te permite filtrar por la cantidad de veces que un usuario realizó un evento de eCommerce. Para filtrar por propiedades específicas del producto (como product_id o product_name), usa las extensiones de segmento, que admiten el filtrado de propiedades de eventos anidados. Por ejemplo, puedes encontrar todos los usuarios que compraron el producto “SKU-123” en los últimos 90 días.