Ir al contenido

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:

  1. Registrar un evento personalizado (por ejemplo, order_update) en /users/track cuando el sistema de gestión de pedidos registra un cambio de estado como pendiente, retenido, preparado, enviado o cancelado
  2. 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
  3. Establecer pares clave-valor (extras) como order_number y order_hierarchy en cada tarjeta
  4. En una fuente personalizada de Content Cards, conservar solo la tarjeta con el order_hierarchy más alto para cada order_number y 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/track con el identificador secundario email. Usa preferentemente external_id cuando 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; establece alias_name con el valor del identificador y alias_label con 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).

  1. Ve a Mensajería > Campañas, selecciona Crear campaña y, a continuación, selecciona Content Cards.
  2. Configura la entrega basada en acciones con el evento personalizado order_update. Filtra por la propiedad del evento order_status correspondiente para que solo ese estado entre en esta campaña.
  3. 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}}}.
  1. 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
  1. 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:

  1. Lee order_number y order_hierarchy de extras.
  2. Busca el order_hierarchy más alto entre las tarjetas que comparten ese order_number.
  3. 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).
  4. 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

  1. Envía una secuencia de eventos order_update para el mismo pedido con valores de order_status cada vez más altos.
  2. Confirma que la campaña de cada estado envía la tarjeta esperada y que Liquid se resuelve correctamente.
  3. Confirma que la fuente muestra una tarjeta por pedido y que se descartan las tarjetas de jerarquía inferior.
  4. Confirma que las impresiones, los clics y los descartes aparecen en los análisis de la campaña para tu interfaz personalizada.
New Stuff!