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 de 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. Como estos cálculos se basan en un modelo a nivel de pedido, los precios de los productos quedan claramente separados del valor total del pedido.

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 actualizan 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 más reciente del carrito.
• Total cart value: valor total de los artículos del carrito actual.
• View products: un enlace para abrir la lista de productos del carrito (hasta 50 productos).

Orquestación del comercio electrónico

Segmentación

Braze ofrece tres formas de segmentar usuarios en función de los datos de comercio electrónico:

• Filtros de comercio electrónico: Usa la categoría eCommerce del segmentador, que 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: Como los eventos de comercio electrónico 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 “Realizó por primera vez el evento personalizado ecommerce.order_placed”.
• Extensiones de segmento: Para segmentar según propiedades de eventos anidados, incluida la matriz anidada de productos o las propiedades de los objetos de metadatos, usa las 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 dentro de metadata al registrar 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 del SDK no son válidas para los filtros de propiedades de extensiones, aunque aparezcan en tus datos de eventos. Usar una propiedad de nivel superior que no esté en la lista de permitidas impide guardar o desarchivar la extensión.

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, contacta con tu administrador de éxito del 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 eventos de comercio electrónico en todo Braze, igual que con otros eventos personalizados. Para 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 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, para que un desencadenante se active solo 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 cualquier producto del pedido o del carrito cumple la condición.

Anida los campos personalizados de producto dentro de metadata (por ejemplo, products[].metadata.brand). Una propiedad de producto que no forma parte del esquema del evento no supera 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 hacía 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 tarjetas de contenido. 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 tarjetas de contenido 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, por lo 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 desencadenar solo cuando un pedido contiene un producto concreto, añade un filtro de propiedad anidada en el 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, es posible 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, por lo 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í se reemplazan los controles de ámbito de producto 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, vuelve a crear el ámbito como 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, incentivos para finalizar la compra o confirmaciones de pedido. Para ver ejemplos de código listos para usar, consulta Casos de uso de comercio electrónico.

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 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 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 ver casos de uso detallados y ejemplos de Liquid, consulta Casos de uso de comercio electrónico.

Estas plantillas cubren los flujos del 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 de 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 visitantes vuelvan a considerar productos que vieron recientemente 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 proceso de pago.

Usa esta plantilla cuando quieras recordar a los usuarios los artículos de su carrito y animarlos a volver para completar la compra.

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 mediante los valores add y remove de la propiedad opcional action. Elige un 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 dinámicamente el contenido actual del carrito en el momento del envío.

Recupera a los usuarios que iniciaron el proceso de 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 fomentar 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. Entre las personalizaciones más habituales se incluyen:

• Personalizar el correo electrónico: Cada plantilla incluye un correo electrónico preconfigurado creado con el editor de arrastrar y soltar, totalmente editable para adaptarlo a tu marca y contenido.
• Añadir canales: Combina el correo electrónico con push, SMS o mensajes dentro de la aplicación para reforzar la comunicación 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: Reemplaza la plantilla de correo electrónico incluida por 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 consultados sin escribir Liquid personalizado.

Para estrategias del ciclo de vida más avanzadas, incluidos ejemplos de personalización con Liquid, consulta Casos de uso 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 por producto del pedido, sumado en todos los productos de cada evento order_placed.

Nota

Los cálculos de ingresos limitan las cantidades 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; solo el cálculo de ingresos aplica el límite.

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 cualquier cambio 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 definitivo para pasar los informes de ingresos de los eventos de compra heredados a ecommerce.order_placed.

BrazeAI^TM

Eventos predictivos, 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 “Pedido realizado”. 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, herramientas de BI o sistemas posteriores. Los eventos recomendados de comercio electrónico se exportan a través de 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), utiliza 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.