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 comercio electrónico

Segmentación

Braze ofrece tres formas de segmentar a los usuarios según los datos de comercio electrónico:

• Filtros de comercio electrónico: Usa la categoría eCommerce del segmentador. Contiene filtros basados en los eventos recomendados de comercio electrónico, como Last Order Placed, Total Revenue y Average Order Value. Para ver la lista completa de filtros disponibles, consulta Filtros de Segment.
• Filtros de eventos personalizados: Los eventos de comercio electrónico se comportan como eventos personalizados, así que todos los filtros de eventos personalizados existentes funcionan desde el primer momento. Por ejemplo, puedes filtrar por “Ha realizado el evento personalizado ecommerce.order_placed más de X veces” o “Realizó por primera vez el evento personalizado ecommerce.order_placed”.
• Extensiones de segmento: Para segmentar según propiedades de eventos anidados, como la matriz anidada de productos o las propiedades de los objetos de metadatos, usa Extensiones de segmento con filtrado de propiedades de eventos anidados. Así puedes crear audiencias como “usuarios que compraron el producto SKU-123 en los últimos 90 días” o combinar criterios de distintas propiedades del mismo pedido.

Si necesitas filtrar por propiedades personalizadas que no forman parte del esquema de eventos documentado, anídalas en metadata cuando registres el evento (por ejemplo, metadata.color en lugar de color). Las propiedades personalizadas de nivel superior que envías a través de la API o el SDK no son válidas para los filtros de propiedades de extensión, aunque aparezcan en los datos de tus eventos. Si usas una propiedad de nivel superior que no está en la lista de permitidas, la extensión no se puede guardar ni desarchivar.

Importante

Las extensiones de segmento para eventos recomendados de comercio electrónico son una característica de pago y están en acceso anticipado. Si te interesa participar en el acceso anticipado, ponte en contacto con tu administrador de éxito de cliente. Confirma que tu plan incluye el acceso antes de recomendar la segmentación por propiedades anidadas a tu equipo.

Desencadenamiento

Puedes usar desencadenantes de evento personalizado realizado con los eventos de comercio electrónico en toda la plataforma de Braze, igual que con otros eventos personalizados. Para los flujos de carrito abandonado, usa el desencadenante Update Cart para capturar correctamente las actualizaciones del carrito.

Además, Braze ofrece un desencadenante específico, Place Order, que te permite iniciar recorridos o realizar acciones cuando un usuario hace un pedido. Para obtener más información, consulta Entrega basada en acciones.

Filtros de propiedades

Los desencadenantes Place Order y Update Cart también pueden filtrar por las propiedades que incluye el evento, de modo que el desencadenante solo se active con 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 de la matriz products. Como cada producto tiene sus propias propiedades, products[].metadata.category coincide cuando algún producto del pedido o del carrito cumple la condición.

Anida los campos de producto personalizados en metadata (por ejemplo, products[].metadata.brand). Una propiedad de producto que no forma parte del esquema del evento no supera la validación, así que un filtro basado en ella nunca coincide.

Por ejemplo, si combinas total_value es mayor que 1000 con products[].metadata.category es igual a shoes, el desencadenante solo se activa con pedidos de alto valor que contienen calzado. Antes de los filtros de propiedades, podías desencadenar con la realización de un pedido, pero no según lo que contenía.

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

• Place Order: Desencadenantes 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 Content Cards. Se admiten propiedades básicas y anidadas. En los desencadenantes de mensajes dentro de la aplicación, Place Order solo admite propiedades básicas.
• Update Cart: Desencadenantes 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 los eventos de conversión, los eventos de eliminación de Content Cards y los desencadenantes de mensajes dentro de la aplicación, Update Cart se basa en 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 de la matriz coincide. Un carrito filtrado por products[].metadata.category no es igual a shoes solo coincide cuando se han eliminado del carrito todos los pares de zapatos, no cuando el carrito también contiene otras categorías.

Los desencadenantes de mensajes dentro de la aplicación se evalúan en el dispositivo, así que ahí Place Order no puede dirigirse a un producto concreto ni filtrar por propiedades anidadas. La opción Place order for specific product está deshabilitada en el creador. Para actuar sobre un producto concreto, usa una campaña en otro canal o un Canvas.

Limitar un pedido a un producto concreto

Para que el desencadenante solo se active cuando un pedido contiene un producto concreto, añade un filtro de propiedad anidada al desencadenante Place Order. Esto no está disponible en los desencadenantes de mensajes dentro de la aplicación.

Comportamientos guardados con ámbito de producto

Si configuraste un comportamiento Place Order antes de que existieran los filtros de propiedades, puede que todavía use Place order for specific product con un Product Identifier (nombre del producto, product_id o variant_id). Esos comportamientos guardados siguen funcionando y coinciden exactamente igual que antes, así que las campañas y los Canvas existentes no se ven afectados.

Para cambiar un comportamiento guardado a filtros de propiedades, selecciona Place any order. Así, los controles de ámbito de producto se sustituyen por filtros de propiedades. Usa la siguiente tabla para recrear el mismo ámbito:

Importante

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

Personalización con Liquid

Los eventos de comercio electrónico admiten la personalización con Liquid igual que los eventos personalizados: puedes hacer referencia a las propiedades del evento directamente en tus mensajes. Para incluir 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 para completar el pago o confirmaciones de pedidos. Para ver ejemplos de código listos para usar, consulta Ejemplos de comercio electrónico.

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

Plantillas de Canvas de comercio electrónico

Braze ofrece plantillas de Canvas listas para usar, preconfiguradas con eventos recomendados de comercio electrónico como criterios de entrada, salida y conversión, para que puedas lanzar flujos de ciclo de vida sin configuraciones personalizadas. Cada plantilla incluye diseños de correo electrónico de arrastrar y soltar y admite bloques de productos de arrastrar y soltar (actualmente en acceso anticipado). Para ver ejemplos detallados y casos de Liquid, consulta Ejemplos de comercio electrónico.

Estas plantillas cubren los flujos de ciclo de vida de comercio electrónico más habituales. Úsalas como punto de partida y luego personaliza los tiempos, los canales y las creatividades para tu audiencia.

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

Vuelve a captar a los usuarios que vieron un producto pero no lo añadieron al carrito.

Usa esta plantilla cuando quieras que los usuarios que navegaron vuelvan a considerar productos que vieron hace poco pero con los que no interactuaron.

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 añadieron artículos al carrito pero no iniciaron el pago.

Usa esta plantilla cuando quieras recordar a los usuarios los artículos de su carrito y animarlos a volver 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 la sustitución completa del carrito (cada evento puede describir el carrito entero) o actualizaciones incrementales con los valores add y remove de la propiedad opcional action. Elige un único enfoque por carrito y evita mezclar actualizaciones de sustitución e incrementales para el mismo cart_id. El carrito almacenado conserva la currency del evento de carrito más reciente; una actualización del carrito en otra moneda sustituye el carrito almacenado en lugar de mezclar valores de dos monedas. Usa la etiqueta de Liquid {% shopping_cart %} en tu mensaje para mostrar de forma dinámica 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 realizada con éxito y hace un 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 simplificar la comunicación posterior a la compra y recopilar la opinión de los clientes en un único flujo de trabajo.

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

Personalizar plantillas

Estas plantillas están pensadas como punto de partida. Algunas personalizaciones habituales son:

• Personalizar el correo electrónico: Cada plantilla incluye un correo electrónico preconfigurado, creado con el editor de arrastrar y soltar, que puedes editar por completo para adaptarlo a tu marca y tu contenido.
• Añadir canales: Combina el correo electrónico con push, SMS o mensajes dentro de la aplicación para reforzar el mensaje de forma multicanal.
• Añadir retrasos y divisiones de decisiones: Ramifica a los usuarios según su comportamiento (por ejemplo, carrito de alto valor frente a carrito de bajo valor) o añade periodos de espera entre mensajes.
• Cambiar las creatividades: Sustituye la plantilla de correo electrónico incluida por el estilo visual de tu marca.
• Usar bloques de productos: Usa bloques de productos de arrastrar y soltar (en el programa de acceso anticipado) para mostrar de forma dinámica el contenido de carritos abandonados o los productos vistos sin escribir Liquid personalizado.

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

Informes de comercio electrónico

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

Para los campos calculados que no son de usuario (por ejemplo, los ingresos de una Campaign o un Canvas), los ingresos se calculan de la misma forma en todos los informes: price multiplicado por quantity para cada producto del pedido, sumado entre todos los productos de cada evento order_placed.

Nota

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

Si vas a migrar de los eventos de compra heredados a ecommerce.order_placed, coordínate con tu equipo de cuenta de Braze antes de hacer cambios en la integración. Durante el periodo de transición, envía tanto los eventos de compra heredados como los eventos ecommerce.order_placed para confirmar que se desencadenan correctamente y para preparar tus Campaigns, Canvas y Segments activos para migrar al nuevo evento. Después, tu equipo de cuenta puede ayudarte a planificar el cambio de 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 admiten eventos de comercio electrónico como eventos objetivo y señales, y tienen una opción específica “Order Placed”. El esquema estandarizado hace que estos modelos sean más fiables, porque los datos son coherentes en toda tu base de usuarios.

Exportar datos

Braze ofrece varias formas de exportar los datos de eventos de comercio electrónico para usarlos en tu almacén de datos, tus herramientas de BI o tus sistemas posteriores. Los eventos recomendados de comercio electrónico se exportan por los mismos canales que el resto de tus datos de eventos.

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

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