Notifica a los consumidores sobre actualizaciones de pedidos con Content Cards
Mantén una fuente personalizada de Content Cards con el estado más reciente de cada pedido. Para ello, registra las actualizaciones de pedidos desde tu sistema de gestión de pedidos (OMS), envía Content Cards para actualizaciones como enviado o cancelado y descarta en la aplicación las tarjetas obsoletas con pares clave-valor.
Acerca de este ejemplo
Flash & Thread, un comercio minorista ficticio de ropa y belleza, quiere una fuente horizontal de Content Cards en sus aplicaciones móviles donde cada tarjeta muestre el estado de una compra; por ejemplo, cuando un pedido pasa de picked a dispatched (enviado) o cuando se marca como cancelled.
Su sistema de gestión de pedidos almacena el correo electrónico del consumidor, el número de pedido, el estado del pedido y la URL de seguimiento, y puede llamar a Braze cuando esos valores se actualizan. El equipo de marketing quiere textos de tarjeta específicos para cada estado (por ejemplo, “Tu pedido está en camino” para dispatched frente a “Estamos preparando tu pedido” para picked). Las tarjetas anteriores del mismo pedido (como una tarjeta picked después de que llegue una tarjeta dispatched) deben descartarse para que los consumidores solo vean el estado más reciente.
Este ejemplo muestra cómo:
- Registrar un evento personalizado (por ejemplo,
order_update) en/users/trackcuando el sistema de gestión de pedidos registra un cambio de estado como pendiente, retenido, preparado, enviado o cancelado - Desencadenar una campaña independiente de Content Cards con entrega basada en acciones para cada uno de esos estados, con personalización de Liquid a partir de las propiedades del evento
- Establecer pares clave-valor (
extras) comoorder_numberyorder_hierarchyen cada tarjeta - En una fuente personalizada de Content Cards, conservar solo la tarjeta con el
order_hierarchymás alto para cadaorder_numbery descartar el resto
Usa este enfoque cuando los eventos de eliminación del panel por sí solos no puedan dirigirse a la tarjeta de un único pedido entre muchas tarjetas del mismo recorrido.
Consideraciones
- Las Content Cards caducan y se eliminan como máximo 30 días después del envío. Establece una caducidad más corta para los estados finales (por ejemplo, cancelado) si quieres que salgan antes de la fuente. Consulta Crear una Content Card.
- Si el sistema de gestión de pedidos solo tiene el correo electrónico, identifica al usuario en
/users/trackcon el identificador secundarioemail. Usa preferentementeexternal_idcuando el sistema de gestión de pedidos lo tenga. Los alias de usuario siguen siendo una opción cuando necesitas un tipo de identificador personalizado; establecealias_namecon el valor del identificador yalias_labelcon el tipo (por ejemplo,email). Consulta Resolución de identificadores y Objeto de alias de usuario. - Las propiedades de eventos personalizados están disponibles para la personalización de Liquid y la segmentación por propiedades del evento cuando usas la ruta desencadenada por eventos. No se guardan en el perfil como atributos, a menos que también las escribas como atributos.
- Las campañas de Content Cards desencadenadas por API son una alternativa que evita registrar un evento personalizado (y sus puntos de datos), pero cada campaña necesita su propio envío desencadenante y pierdes la segmentación por propiedades del evento para esa señal.
- Las fuentes personalizadas no se actualizan a mitad de sesión hasta el inicio de la siguiente sesión o una llamada manual a
requestContentCardsRefresh. Solicita la actualización cuando el consumidor abra la fuente de pedidos o tire hacia abajo para actualizarla. - Las interfaces de Content Cards totalmente personalizadas requieren el registro manual de análisis (impresiones, clics y descartes). Crear una subclase de la fuente predeterminada requiere menos trabajo, pero no admite un carrusel horizontal.
- Esta lógica de jerarquía da por hecho que hay un solo estado activo por número de pedido a la vez. Si un pedido puede tener varios estados simultáneos (por ejemplo, preparaciones divididas entre almacenes), añade otra clave (como un ID de preparación) e inclúyela en tus reglas para conservar o descartar.
- La lógica de descarte en la aplicación requiere una nueva versión de la aplicación. Pruébala en un espacio de trabajo de desarrollo antes de pasar a producción.
Configuración
Paso 1: Registra las actualizaciones de pedidos desde el sistema de gestión de pedidos
Cuando el sistema de gestión de pedidos registre un cambio de estado, envía un evento personalizado a /users/track. Incluye las propiedades del evento que la Content Card personaliza y que la aplicación lee de extras.
La siguiente tabla muestra propiedades de ejemplo:
| Propiedad | Finalidad |
|---|---|
order_number |
Agrupa las tarjetas del mismo pedido |
order_status |
Etiqueta de estado para el texto y los filtros de campaña |
tracking_url |
Vínculo profundo o URL de botón opcional |
Este es un ejemplo de solicitud que identifica al usuario por correo electrónico:
POST https://rest.iad-01.braze.com/users/track
Content-Type: application/json
Authorization: Bearer {YOUR_REST_API_KEY}
{
"events": [
{
"email": "[email protected]",
"name": "order_update",
"time": "2026-09-28T16:02:05Z",
"properties": {
"order_number": "12345",
"order_status": "picked",
"tracking_url": "https://www.flashandthread.example/track/12345"
}
}
]
}
Usa el endpoint REST de tu espacio de trabajo y una clave de API con el permiso users.track. Sustituye el correo electrónico y los valores de pedido de ejemplo por la carga útil de tu sistema de gestión de pedidos.
Paso 2: Crea una campaña de Content Cards por cada estado de pedido
Crea una campaña de Content Cards con entrega basada en acciones para cada estado que envíes (por ejemplo, pending, held, picked, dispatched, cancelled).
- Ve a Mensajería > Campañas, selecciona Crear campaña y, a continuación, selecciona Content Cards.
- Configura la entrega basada en acciones con el evento personalizado
order_update. Filtra por la propiedad del eventoorder_statuscorrespondiente para que solo ese estado entre en esta campaña. - Usa propiedades del evento en Liquid para personalizar el título o el cuerpo de la tarjeta:
Order {{event_properties.${order_number}}} is {{event_properties.${order_status}}}.
- En la pestaña Configuración, selecciona Añadir nuevo par y añade los pares clave-valor que usa la aplicación:
| Clave | Valor |
|---|---|
order_number |
{{event_properties.${order_number}}} |
order_status |
{{event_properties.${order_status}}} (o el estado fijo de esa campaña) |
order_hierarchy |
Número entero para este estado (fijo en cada campaña) |
La siguiente tabla muestra un ejemplo de jerarquía. La aplicación conserva la tarjeta con el valor más alto de cada pedido:
| Estado | order_hierarchy |
|---|---|
| pending | 1 |
| held | 2 |
| picked | 3 |
| dispatched | 4 |
| cancelled | 5 |
- Establece la caducidad de la tarjeta (hasta 30 días). Es preferible una duración más corta para los estados finales.
Los eventos de eliminación del panel se aplican a nivel de campaña y no pueden eliminar solo la tarjeta de un pedido y dejar las demás de la misma campaña. Por eso la aplicación descarta las tarjetas obsoletas mediante extras.
Paso 3: Conserva la tarjeta más reciente de cada pedido en la fuente personalizada
Suscríbete a las actualizaciones de Content Cards en tu fuente personalizada, lee extras y, para cada order_number, conserva la tarjeta con el order_hierarchy más alto. Descarta el resto con la API de descarte de tu plataforma para que los análisis sigan siendo precisos.
Para cada tarjeta de la fuente:
- Lee
order_numberyorder_hierarchydeextras. - Busca el
order_hierarchymás alto entre las tarjetas que comparten eseorder_number. - Si la jerarquía de la tarjeta coincide con el valor más alto, muéstrala (asigna los campos de la tarjeta a tu objeto de interfaz personalizado).
- De lo contrario, descarta la tarjeta.
Implementa las llamadas de suscripción y descarte con el SDK actual de tu plataforma. Empieza por:
Cuando el consumidor ya esté en la aplicación, llama a requestContentCardsRefresh para que las nuevas tarjetas de pedido aparezcan sin esperar a la siguiente sesión.
Paso 4: Prueba el recorrido de principio a fin
- Envía una secuencia de eventos
order_updatepara el mismo pedido con valores deorder_statuscada vez más altos. - Confirma que la campaña de cada estado envía la tarjeta esperada y que Liquid se resuelve correctamente.
- Confirma que la fuente muestra una tarjeta por pedido y que se descartan las tarjetas de jerarquía inferior.
- Confirma que las impresiones, los clics y los descartes aparecen en los análisis de la campaña para tu interfaz personalizada.