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 basándose en datos de eCommerce:

• Filtros de eCommerce: Usa la categoría eCommerce en el segmentador, que contiene filtros basados en eventos recomendados de eCommerce (como Último pedido realizado, Ingresos totales y Valor promedio de pedido). Para ver la lista completa de filtros disponibles, consulta Filtros de segmento.
• Filtros de eventos personalizados: Dado 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 por propiedades de eventos anidados, incluyendo el array anidado de productos 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 diferentes propiedades del mismo pedido.

Si necesitas filtrar por propiedades personalizadas que no forman parte del esquema de eventos documentado, anida esas propiedades dentro de metadata al registrar 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, 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 que la extensión se guarde o se desarchive.

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, ponte en contacto con 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, igual que con otros eventos personalizados. Para flujos de carrito abandonado, usa el desencadenador Actualizar carrito para capturar correctamente las actualizaciones del carrito.

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

Filtros de propiedades

Los desencadenadores Realizar pedido y Actualizar carrito 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:

• Propiedades básicas coinciden con una propiedad de nivel superior del evento, como total_value o currency.
• Propiedades anidadas buscan dentro del array products. Dado que cada producto tiene sus propias propiedades, products[].metadata.category coincide cuando cualquier producto del pedido o 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 forme parte del esquema de eventos no pasa la validación, por lo que un filtro sobre ella nunca coincidirá.

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 al realizarse 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:

• Realizar pedido: desencadenadores de Campaign y Canvas, eventos de excepción, criterios de salida de Canvas, Rutas de Acción, eventos de conversión y eventos de eliminación de tarjetas de contenido. Se admiten propiedades básicas y anidadas.
• Actualizar carrito: desencadenadores de Campaign y Canvas, eventos de excepción, criterios de salida de Canvas y 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, Actualizar carrito está respaldado por 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 array 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.

Las propiedades anidadas no son compatibles con los desencadenadores de mensajes dentro de la aplicación, que se evalúan en el dispositivo.

Alcance de 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 Realizar pedido:

Comportamientos guardados con alcance de producto

Si configuraste un comportamiento de Realizar pedido antes de que los filtros de propiedades estuvieran disponibles, es posible que aún use Realizar pedido para un producto específico con un Identificador de producto (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 Canvas existentes no se ven afectados.

Para cambiar un comportamiento guardado a filtros de propiedades, selecciona Realizar cualquier pedido. Esto reemplaza los controles de alcance de producto con filtros de propiedades. Usa la siguiente tabla para recrear el mismo alcance:

Importante

Cambiar un comportamiento a Realizar cualquier pedido no se puede deshacer. Si aún lo necesitas, vuelve a crear el alcance como un filtro de propiedad anidada.

Personalización con Liquid

Los eventos de eCommerce admiten personalización con Liquid de la misma manera que los eventos personalizados; puedes hacer referencia a las propiedades del evento directamente en tu mensajería. Para incorporar imágenes de productos, precios u otros datos de catálogo en tus mensajes, vincula 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 de pago o confirmaciones de pedido. Para ver ejemplos de código listos para usar, consulta Casos de uso 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 de eCommerce

Braze ofrece 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 de ciclo de vida sin configuración personalizada. Cada plantilla incluye diseños de correo electrónico de arrastrar y soltar y es compatible con bloques de producto de arrastrar y soltar (actualmente en acceso anticipado). Para casos de uso detallados y ejemplos de Liquid, consulta Casos de uso de eCommerce.

Estas plantillas cubren los flujos de ciclo de vida de eCommerce más comunes. Úsalas como punto de partida y luego personaliza los tiempos, canales y creatividades para tu audiencia.

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

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

Usa esta plantilla cuando quieras atraer de vuelta a los navegadores para que consideren 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, Pedido realizado
Evento de conversión	Pedido realizado

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 sobre los artículos en su carrito e impulsarlos a completar el pago.

Configuración	Valor
Evento de entrada	ecommerce.cart_updated
Eventos de salida	ecommerce.cart_updated, ecommerce.checkout_started, Pedido realizado
Evento de conversión	Pedido realizado

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 la 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 del embudo con mayor intención.

Configuración	Valor
Evento de entrada	ecommerce.checkout_started
Evento de salida	Pedido realizado
Evento de conversión	Pedido realizado

Confirma una compra exitosa y realiza un seguimiento con un cuestionario de opiniones 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 comentarios de los clientes en un solo flujo de trabajo.

Configuración	Valor
Evento de entrada	ecommerce.order_placed
Evento de conversión	Iniciar sesión o ecommerce.product_viewed

Personalizar plantillas

Estas plantillas están diseñadas como punto de partida. Las personalizaciones más 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 que coincida con tu marca y contenido.
• Agregar canales: Combina el correo electrónico con push, servicio de mensajes cortos o mensajes dentro de la aplicación para un refuerzo multicanal.
• Agregar retrasos y divisiones de decisiones: Segmenta a los usuarios por comportamiento (por ejemplo, carrito de alto valor en comparación con carrito de bajo valor) o períodos de espera entre mensajes.
• Cambiar la creatividad: 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 renderizar dinámicamente el contenido del carrito abandonado o los productos navegados sin escribir Liquid personalizado.

Para estrategias de ciclo de vida más avanzadas, incluyendo ejemplos de personalización con Liquid, consulta Casos de uso de eCommerce.

Informes de eCommerce

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

Para campos calculados no vinculados al usuario (por ejemplo, ingresos de Campaigns o Canvas), los ingresos se calculan de la misma manera 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 1.000 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, coordina 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 Segments activos para migrar al nuevo evento. Tu equipo de cuenta puede ayudarte a planificar la transición para cambiar los informes de ingresos de los eventos de compra heredados a ecommerce.order_placed.

BrazeAI^TM

Predictive Events, Predictive Churn y recomendaciones de artículos admiten eventos de eCommerce como eventos objetivo y señales, y tienen 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 a los 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 a todos los usuarios que compraron el producto “SKU-123” en los últimos 90 días.