Conservar las notificaciones push en un buzón de mensajes de Content Cards

Mantén disponible el contenido push importante después de que se descarte una notificación. Envía una Content Card equivalente a un buzón de mensajes personalizado dentro de la aplicación y filtra ese buzón con pares clave-valor.

Acerca de este ejemplo

Pyrite Financial, una marca ficticia de banca móvil, empieza a enviar notificaciones push con Braze. Cuando un consumidor descarta una notificación push, el mensaje desaparece de la interfaz del dispositivo.

Los equipos de Marketing y Producto quieren que los consumidores abran un buzón de mensajes persistente desde un icono de campana en la aplicación. Allí, los consumidores pueden volver a abrir alertas de documentos disponibles, avisos de transacciones y mensajes sobre interrupciones planificadas.

Ya usan Content Cards en otra parte de la aplicación (por ejemplo, para artículos). Este patrón añade una segunda ubicación de Content Cards, un buzón de mensajes que puede recibir:

• Solo una notificación push
• Solo una Content Card
• Una notificación push y una Content Card equivalente a la vez

Al tocar la notificación push y al tocar la Content Card, se puede abrir el mismo destino mediante un vínculo profundo (por ejemplo, los documentos). En algunos mensajes push, el toque abre el propio buzón.

Este ejemplo muestra cómo orquestar la entrega de notificaciones push y Content Cards. Para crear la interfaz del buzón personalizado en el SDK, consulta Tutorial: Buzones de Content Cards. Para conocer los detalles del diseño de las tarjetas, consulta Crear Content Cards personalizadas.

Consideraciones

• Las Content Cards siguen disponibles hasta 30 días después de enviarlas. Cuentan para el límite de 250 tarjetas no caducadas por usuario en la fuente, incluidas las tarjetas descartadas. La carga útil de cada tarjeta está limitada a 2 KB después de que se procese Liquid. Consulta Crear una Content Card.
• Si ya usas Content Cards en otras partes de tu aplicación, usa pares clave-valor (por ejemplo, feed_type: inbox frente a feed_type: article) para crear ubicaciones separadas. Así, cada pantalla muestra solo sus tarjetas. Todas las tarjetas comparten una única fuente del SDK hasta que tu aplicación las filtre. Consulta Personalizar las fuentes de Content Cards.
• Las Content Cards se actualizan automáticamente al iniciar la sesión. Las actualizaciones adicionales usan requestContentCardsRefresh. Actualiza cuando se abra el buzón o al deslizar para actualizar. Evita las actualizaciones continuas o en cada pestaña para no alcanzar los límites de velocidad de actualización.
• Las interfaces de buzón personalizadas deben registrar impresiones, clics y descartes manualmente. Las señales de no leído (por ejemplo, un punto en el icono de la campana) las gestiona tu aplicación.
• Cada notificación push que deba conservarse en el buzón necesita una Content Card equivalente. Incluye los pares clave-valor y los vínculos profundos correctos. Usa una plantilla de Campaign multicanal o una plantilla de Canvas para que el canal de Content Cards siga incluido.
• Usa una Campaign multicanal para enviar a la vez una notificación push y una Content Card sin lógica de seguimiento. Usa Canvas cuando necesites retrasos, ramificaciones, reactivación o pasos posteriores basados en la participación.

Configuración

Paso 1: Define los pares clave-valor y los vínculos profundos del buzón

Acuerda los extras (pares clave-valor) que usa la aplicación para filtrar las tarjetas del buzón y actuar sobre ellas. La siguiente tabla muestra un conjunto de ejemplo.

Decide los destinos de los vínculos profundos para cada caso de uso. La siguiente tabla enumera destinos de ejemplo.

Pide a tu equipo de ingeniería que implemente el filtrado, el estado opcional de no leído y el análisis a partir de estas claves. Reutiliza las mismas claves en todas las Content Cards del buzón.

Paso 2: Elige una Campaign multicanal o un Canvas

Elige una Campaign multicanal o un Canvas en función del recorrido. La siguiente tabla compara ambas opciones.

Para ver un ejemplo de este patrón, consulta Content Cards en Canvas: buzón de notificaciones push.

Paso 3: Configura la entrega de mensajes

Campaign multicanal

1. Ve a Mensajería > Campañas, selecciona Crear campaña y, a continuación, selecciona Multicanal.
2. En el paso Redactar, selecciona Añadir canal y añade push y Content Cards.
3. Redacta la notificación push. En Comportamiento al hacer clic, establece el vínculo profundo al buzón o a otro destino dentro de la aplicación.
4. Redacta la Content Card con un texto equivalente o complementario. En la pestaña Configuración, selecciona Añadir nuevo par y añade los pares clave-valor del buzón del paso 1. Establece el vínculo profundo de la Content Card.
5. Programa una entrega basada en acciones para eventos como un nuevo documento. Usa la entrega programada para las interrupciones planificadas. Define la audiencia.
6. Guarda una plantilla o una lista de comprobación para que las futuras Campaigns push con buzón incluyan el canal de Content Cards y los mismos extras.

Canvas

1. Ve a Mensajería > Canvas y selecciona Crear Canvas. Establece la programación de entrada y la audiencia del recorrido (por ejemplo, un evento personalizado cuando un documento esté listo).
2. Añade un paso de Mensaje que incluya tanto push como Content Cards. Usa pasos de Mensaje consecutivos si el flujo los necesita.
3. Redacta la notificación push y la Content Card de la misma forma que en la opción de Campaign, incluidos los vínculos profundos y los pares clave-valor del buzón.
4. Si quieres, añade pasos posteriores que usen la participación en las Content Cards. Por ejemplo, si no se produce ningún clic en 48 horas, envía un mensaje de seguimiento. Antes de depender de esos filtros, confirma qué análisis registra tu buzón personalizado.

Paso 4: Confirma el comportamiento del buzón en la aplicación

Antes del lanzamiento, confirma con tu equipo de ingeniería que la aplicación:

1. Se suscribe una sola vez a las actualizaciones de Content Cards al principio del ciclo de vida de la aplicación. Reutiliza una suscripción existente si las Content Cards ya están en vivo en otra parte.
2. Muestra el buzón a partir de las tarjetas en caché y luego actualiza al abrirlo o al deslizar para actualizar.
3. Filtra las tarjetas cuyos extras coinciden con el buzón (por ejemplo, feed_type igual a inbox).
4. Registra impresiones, clics y descartes para la interfaz personalizada. En React Native, usa estos métodos del SDK:
   • getCachedContentCards
   • requestContentCardsRefresh
   • logContentCardImpression
   • logContentCardClicked
   • logContentCardDismissed
   • processContentCardClickAction
   • Usa preferentemente getCachedContentCards en lugar del método obsoleto getContentCards.
5. De forma opcional, descarta una tarjeta cuando el consumidor completa la acción relacionada (por ejemplo, abre doc_id en los documentos). Haz esto además de permitir descartarla con un toque en el buzón.

Paso 5: Prueba los tres modos de entrega

• Solo notificación push: Llega la notificación y no aparece ninguna tarjeta en el buzón.
• Solo Content Card: La tarjeta aparece en el buzón y no se envía ninguna notificación push.
• Notificación push y Content Card: Ambas se envían a la vez y los vínculos profundos funcionan según lo previsto. La tarjeta sigue disponible después de descartar la notificación push. La señal de no leído, el descarte y el análisis funcionan como se espera.

Prueba la actualización con una navegación realista para que los límites de velocidad no bloqueen las actualizaciones del buzón durante las pruebas.

Artículos relacionados

• Crear una Content Card
• Content Cards en Canvas
• Crear una Campaign multicanal
• Tutorial: Buzones de Content Cards
• Crear Content Cards personalizadas
• Personalizar la fuente de Content Cards
• Registrar el análisis de Content Cards
• Crear un mensaje push