Crear una tarjeta de contenido

Este artículo explica cómo crear una tarjeta de contenido en Braze al construir Campaigns y Canvas. Aquí te guiaremos para elegir un tipo de mensaje, redactar tu tarjeta y planificar la entrega de tu mensaje.

Paso 1: Elige dónde crear tu mensaje

Usa Campaigns para mensajería simple y única (como informar a los usuarios sobre un producto con un solo mensaje). Usa Canvas para recorridos de usuario con varios pasos (como enviar sugerencias de productos personalizadas basadas en el comportamiento del usuario a lo largo del tiempo).

• campaign
• canvas

Paso 2: Especifica tus tipos de mensaje

Selecciona uno de los tres tipos esenciales de Content Cards: Clásica, Imagen con subtítulo e Solo imagen.

Para obtener más información sobre el comportamiento esperado y la apariencia de cada tipo, consulta Detalles creativos, o revisa los enlaces en la siguiente tabla. Estos tipos de Content Cards son aceptados tanto por aplicaciones móviles como por aplicaciones web.

Tipo de mensaje	Ejemplo	Descripción
Clásica		La tarjeta clásica tiene un diseño sencillo con un título en negrita, texto del mensaje y una imagen opcional que se sitúa al inicio del título y el texto. Es mejor usar una imagen cuadrada o un icono con la tarjeta clásica.
Imagen con subtítulo		La tarjeta de imagen con subtítulo muestra tu contenido con texto e imagen llamativa.
Solo imagen		La tarjeta de solo imagen capta la atención con espacio para imágenes, GIF y otro contenido creativo no textual.

Paso 3: Componer una Content Card

Puedes editar todos los aspectos del contenido y el comportamiento de tu mensaje en la pestaña Redactar del editor de mensajes.

El contenido aquí varía en función del tipo de tarjeta elegido en el paso anterior, pero puede incluir cualquiera de las siguientes opciones:

Idioma

Selecciona Añadir idiomas para agregar los idiomas que desees de la lista proporcionada. Esto inserta Liquid en tu mensaje. Te recomendamos seleccionar tus idiomas antes de escribir el contenido para que puedas completar el texto donde corresponda en Liquid. Para consultar nuestra lista completa de idiomas disponibles, consulta Idiomas compatibles.

Crear mensajes de derecha a izquierda

La apariencia final de los mensajes de derecha a izquierda depende en gran medida de cómo los proveedores de servicios los renderizan. Para conocer las mejores prácticas para crear mensajes de derecha a izquierda que se muestren con la mayor precisión posible, consulta Crear mensajes de derecha a izquierda.

Título y mensaje

Escribe lo que quieras. No hay límites, pero cuanto más rápido puedas transmitir tu mensaje y lograr que tu cliente haga clic, ¡mejor! Recomendamos títulos y contenido de mensaje claros y concisos. Ten en cuenta que estos campos no se proporcionan para las tarjetas de solo imagen.

Imagen

Para añadir una imagen a tu Content Card, puedes seleccionar Añadir imagen o proporcionar una URL de imagen. Al seleccionar Añadir imagen se abre la Biblioteca multimedia, donde puedes seleccionar una imagen cargada previamente o añadir una nueva.

Cada tipo de mensaje y plataforma puede tener sus propias proporciones y requisitos sugeridos, así que asegúrate de comprobarlos antes de encargar o crear una imagen desde cero. Ten en cuenta que los campos de mensaje de las Content Cards están limitados a un tamaño total de 2 KB.

Anclar en la parte superior

Braze muestra una tarjeta anclada en la parte superior del feed de un usuario y el usuario no puede descartarla. Si el feed de un usuario tiene varias tarjetas ancladas, Braze las ordena cronológicamente. Cuando Braze entrega una Content Card, esta está anclada o no anclada, y ese estado no cambia durante la vida útil de la tarjeta. Si cambias la configuración de anclaje en una Campaign, la actualización se aplica solo a las tarjetas enviadas después de la modificación. No cambia el estado de anclaje de las tarjetas que ya están en el feed de un usuario.

Comportamiento al hacer clic

Cuando tu cliente hace clic en un enlace presentado en la tarjeta, el enlace puede llevarlo más adentro de tu aplicación o a otro sitio. Si eliges un comportamiento al hacer clic para tu Content Card, recuerda actualizar tu texto del enlace de forma correspondiente.

Las siguientes acciones están disponibles para los enlaces de Content Cards:

Acción	Descripción
Redirigir a URL web	Abre una página web no nativa.
Vínculo profundo a la aplicación	Vincula a una pantalla existente en tu aplicación.
Registrar evento personalizado	Elige un evento personalizado para desencadenar. Puede usarse para mostrar otra Content Card o activar mensajería adicional.
Registrar atributo personalizado	Elige un atributo personalizado para establecer para el usuario actual.

Las opciones Registrar evento personalizado y Registrar atributo personalizado requieren la siguiente compatibilidad de versión del SDK:

Paso 4: Configurar ajustes adicionales (opcional)

Puedes usar pares clave-valor para crear categorías para tus tarjetas, crear múltiples fuentes de Content Cards y personalizar cómo se ordenan las tarjetas.

Para añadir pares clave-valor a tu mensaje, ve a la pestaña Configuración y selecciona Añadir nuevo par.

Paso 5: Construye el resto de tu campaña o Canvas

• campaign
• canvas

Paso 6: Revisar y desplegar

Cuando termines de crear tu Campaign o Canvas, revisa sus detalles, pruébala y luego envíala. Para más información, consulta Enviar mensajes de prueba.

A continuación, consulta Informes de Content Cards para saber cómo puedes acceder a los resultados de tus campañas de Content Cards.

Cosas que debes saber

Limitaciones de la carga útil y el feed

Para garantizar el rendimiento, Content Cards tiene dos restricciones clave: un límite en el tamaño de la carga útil de cada tarjeta y un número máximo de tarjetas que pueden aparecer en un feed.

Limitaciones de tamaño para Content Cards

La carga útil de datos completa de una única Content Card no puede superar los 2 KB después de que se procese cualquier personalización con Liquid. Esto incluye:

• Título
• Mensaje
• URL de la imagen (la longitud de la cadena de URL en sí, no el tamaño del archivo de imagen)
• Texto del enlace
• URLs de enlace para todas las plataformas especificadas (las URLs separadas para iOS, Android y Web cuentan para el total)
• Pares clave-valor (tanto los nombres de las claves como sus valores)

El uso de Liquid para incorporar cadenas de texto largas (como las de atributos personalizados) puede hacer que superes el límite.

El creador de la Campaign muestra una advertencia si tu contenido estático supera el límite. No predecimos el tamaño del contenido dinámico que utiliza Liquid. Si el tamaño del mensaje supera los 2 KB, se cancela en el momento del envío. Puedes ver estas cancelaciones en el registro de actividad de mensajes con el motivo Content card maximum size exceeded.

Estas son algunas prácticas recomendadas para gestionar el tamaño de la carga útil de Content Cards:

• Usa acortadores de URL para enlaces largos. Las URLs, especialmente aquellas con parámetros de seguimiento extensos, pueden generar problemas con el límite de tamaño. Usar un servicio de acortamiento de URLs puede reducir drásticamente el recuento de caracteres y liberar espacio en la carga útil.
• Trunca el contenido dinámico con Liquid. Al personalizar tarjetas con texto dinámico de atributos de usuario o llamadas a la API, la longitud del contenido puede ser impredecible. Usa proactivamente filtros de Liquid como truncate para limitar la longitud de cualquier texto dinámico.
• Sé eficiente con las URLs multiplataforma. El límite de 2 KB incluye las URLs de todas las plataformas que definas. Usar URLs largas y únicas para cada plataforma puede multiplicar el tamaño de la carga útil. Si es posible, usa un solo enlace que funcione en todas las plataformas o usa acortadores de URL según sea necesario.
• Considera los Banners para contenido más completo. Para ejemplos que requieran consistentemente grandes cantidades de contenido, Content Cards puede no ser el canal adecuado. Los Banners no tienen la misma limitación de carga útil de 2 KB y son más adecuados para incrustar contenido más completo directamente en una experiencia de aplicación o sitio web.

Número de tarjetas en el feed

Cada usuario puede tener hasta 250 Content Cards no expiradas en su feed en cualquier momento. Cuando se supera este límite, Braze deja de devolver las tarjetas más antiguas, incluso si no se han leído. Las tarjetas descartadas también cuentan para este límite, lo que significa que un gran número de tarjetas descartadas puede reducir el espacio disponible para las más antiguas.

Para prevenir problemas con el límite de tarjetas, recomendamos las siguientes prácticas:

• Usa fechas de expiración más cortas: Para Campaigns sensibles al tiempo (como una oferta de fin de semana), establece una fecha de expiración específica. De esta forma, las tarjetas se eliminan automáticamente del feed y ya no cuentan para el límite una vez que dejan de ser relevantes.
• Aprovecha la eliminación basada en acciones: Configura eventos de eliminación para tarjetas transaccionales o basadas en objetivos. Por ejemplo, una tarjeta que solicita a un usuario completar su perfil debe eliminarse tan pronto como se registre un evento profile_completed.
• Audita las Campaigns de larga duración: Revisa las Campaigns recurrentes o en curso para asegurarte de que no estén creando una mala experiencia para tus usuarios al llenar el feed con demasiadas tarjetas a lo largo del tiempo.

Comprender la reelegibilidad para Content Cards

La reelegibilidad determina si un usuario puede recibir un mensaje de la misma Campaign más de una vez y cuándo puede hacerlo. Para Content Cards, comprender cómo funciona esto es fundamental para gestionar Campaigns recurrentes y garantizar que los usuarios no reciban mensajes duplicados o desactualizados.

Cómo se calcula la reelegibilidad

Si activas la reelegibilidad, la cuenta regresiva para que un usuario pueda “reingresar” a una Campaign comienza después de que se le envía el mensaje. El momento específico en que comienza esta cuenta regresiva depende de la configuración de creación de la tarjeta:

• Las Content Cards que usan en la primera impresión utilizan el momento de la impresión para calcular la reelegibilidad.
• Las Content Cards creadas en el lanzamiento de la Campaign, en Campaigns multicanal o en la entrada de un paso en Canvas usan el momento de envío o de impresión, el que sea más reciente.

La expiración de 30 días y la reelegibilidad

Una fuente común de confusión es la interacción entre la reelegibilidad de la Campaign y la expiración automática de 30 días de todas las Content Cards.

Todas las Content Cards se eliminan automáticamente de los sistemas de Braze 30 días después de ser enviadas o eliminadas. Si tienes una Campaign recurrente de larga duración con la reelegibilidad desactivada, un usuario aún puede recibir la misma tarjeta de nuevo después de 30 días. Cuando la tarjeta original se elimina, el sistema ya no ve un registro de que ese usuario haya recibido la Campaign, lo que lo hace elegible de nuevo en su próxima sesión.

Para que los usuarios solo reciban un mensaje de una Campaign específica una vez, añade un filtro de audiencia a tu Campaign o paso en Canvas para usuarios que no hayan recibido un mensaje de esta Campaign. Este filtro es la forma más fiable de prevenir envíos duplicados en Campaigns de larga duración.

Gestión de Content Cards en vivo

Después de que se envían las Content Cards, quedan esperando en un “buzón de entrada” listas para ser entregadas al usuario (similar a lo que ocurre con los correos electrónicos). Una vez que el contenido se incorpora a la Content Card (en el momento de la visualización), no se puede cambiar durante su vida útil. Esto aplica incluso si estás llamando a una API a través de contenido conectado y los datos del endpoint cambian. Estos datos no se actualizan. Solo se puede detener el envío a nuevos usuarios y eliminarlas de los feeds de los usuarios. Si modificas una Campaign, solo las tarjetas enviadas después de la modificación incluyen la actualización.

Actualizar tarjetas lanzadas

Para cambiar una tarjeta para usuarios que ya la han recibido, debes usar uno de los siguientes métodos:

Opción 1: Duplicar la Campaign (recomendado para cambios inmediatos)

El primer enfoque es archivar la Campaign y lanzar una nueva Campaign duplicada:

1. Detén la Campaign original y, cuando se te solicite, selecciona Remove card after the next sync.
2. Duplica la Campaign, realiza tus ediciones y lanza la nueva versión.

Cuando duplicas la Campaign, necesitas definir la audiencia para la nueva versión. Usa filtros de segmentación para controlar quién recibe la tarjeta actualizada:

• Si los usuarios nunca deben ser reelegibles para una Content Card, puedes filtrar por usuarios que no hayan recibido la versión anterior de la Content Card estableciendo el filtro Received Message from Campaign con la condición Has Not.
• Si los usuarios que recibieron la tarjeta anterior deben ser reelegibles en X días, puedes establecer el filtro Last Received Message from specific campaign a más de X días atrás O Received Message from Campaign con la condición Has Not.

Impacto

• Destinatarios existentes: Los destinatarios nuevos y existentes ven la tarjeta actualizada en la siguiente actualización del feed si son elegibles.
• Informes: Cada versión de la tarjeta tiene análisis separados.

Supongamos que configuras una Campaign para que se desencadene al inicio de una sesión, y tiene la reelegibilidad establecida en 30 días. Un usuario recibió la Campaign hace dos días y quieres cambiar el texto. Primero, archiva la Campaign y elimina las tarjetas del feed. Segundo, duplica la Campaign y relánzala con el nuevo texto. Si el usuario tiene otra sesión, recibe inmediatamente la nueva tarjeta.

Opción 2: Detener y relanzar la misma Campaign

Este enfoque mantiene todos tus análisis unificados en una sola Campaign. Los usuarios recién elegibles reciben la nueva tarjeta, pero retrasa la actualización para los destinatarios existentes hasta que sean reelegibles:

1. Detén tu Campaign y, cuando se te solicite, selecciona Remove card after the next sync.
2. Edita tu Campaign según sea necesario.
3. Reinicia tu Campaign.

Impacto

• Destinatarios existentes: Los usuarios que ya han recibido la tarjeta no reciben las tarjetas actualizadas hasta que sean reelegibles. Si la reelegibilidad está desactivada, nunca reciben la nueva tarjeta.
• Informes: Una Campaign contiene todos los análisis de informes para las versiones de tarjeta lanzadas. Braze no diferencia entre las versiones lanzadas.

Supongamos que tienes una Campaign que se desencadena al inicio de una sesión y tiene la reelegibilidad establecida en 30 días. Un usuario recibió la Campaign hace dos días y quieres cambiar el texto. Primero, detén la Campaign y elimina la tarjeta del feed. Segundo, vuelve a publicar la Campaign con el nuevo texto. Si el usuario tiene otra sesión, recibe la nueva tarjeta en 28 días.

Eliminar y expirar tarjetas

Eliminación manual de tarjetas

Puedes eliminar manualmente las tarjetas de los feeds de todos los usuarios en cualquier momento deteniendo la Campaign.

1. Abre la Campaign de Content Card y selecciona Stop Campaign.
2. Cuando se te solicite, selecciona Remove card after the next sync. La tarjeta se elimina en la siguiente actualización del feed.

Eliminación automatizada de tarjetas

Puedes eliminar automáticamente una tarjeta cuando un usuario realiza una acción específica, como completar una compra o activar una característica.

En tu Campaign o paso en Canvas, especifica un evento de eliminación. Cuando un usuario realiza ese evento, Braze procesa el evento y luego elimina la tarjeta de su feed.

Expiración de tarjetas

Las Content Cards permanecen disponibles hasta 30 días desde que se envían; después de 30 días, Braze las elimina de los feeds de los usuarios y las purga de los sistemas de Braze.

Hacer que las tarjetas duren más de 30 días

Si quieres que una tarjeta parezca estar siempre disponible, puedes crear una Campaign recurrente que reemplace efectivamente la tarjeta cada 30 días:

1. Establece la duración de la Content Card en 30 días.
2. Establece la reelegibilidad de la Campaign en 30 días.
3. Configura la Campaign para que se desencadene con “Session Start.”

Sincronización y actualización de Content Cards

Las Content Cards se sincronizan según una programación y cuando tu aplicación actualiza el feed. El comportamiento de sincronización difiere entre sincronizaciones completas y parciales, y tu integración del SDK afecta cuándo se actualizan las tarjetas al inicio de la sesión. En las versiones compatibles del SDK, Braze también entrega envíos y eliminaciones durante una sesión activa a través de la entrega en tiempo real. Para detalles de implementación, consulta Personalizar el feed de Content Cards y Crear Content Cards.

Impacto de detener Campaigns de Content Cards

Cuando detienes una Campaign y seleccionas Remove card after the next sync, Braze elimina la tarjeta de los feeds de los usuarios en la siguiente actualización. Los conteos de impresiones pueden ser menores que los conteos de envío porque los usuarios no pueden registrar impresiones de tarjetas que se eliminan antes de que las vean.

Solución de problemas

¿Por qué las Content Cards no aparecen inmediatamente después de un evento desencadenante?

Para las campañas con entrega basada en acciones (como inicio de sesión), existe un breve retraso esperado entre el evento desencadenante y la disponibilidad de la tarjeta. Este retraso se produce porque:

• El evento desencadenante se envía a los servidores de Braze
• La Campaign se activa y se registra la elegibilidad del usuario
• La Content Card se crea en la base de datos para ese usuario
• La tarjeta llega al dispositivo

En versiones compatibles del SDK, la entrega en tiempo real envía la tarjeta al dispositivo tan pronto como Braze la crea, de modo que la tarjeta llega durante la sesión actual. En versiones anteriores, el SDK obtiene la tarjeta en su siguiente sincronización, y una sincronización que se ejecuta antes de que se registre la elegibilidad del usuario no devuelve nada.

Para usuarios nuevos en su primera sesión, este retraso de procesamiento es inevitable. Para usuarios existentes que necesitan disponibilidad inmediata, considera usar la entrega programada en su lugar.

Si necesitas minimizar los retrasos tanto para usuarios nuevos como existentes, puedes crear dos campañas:

• Usuarios existentes con un recuento de sesiones mayor que 0: Usa una Campaign con entrega programada. Las tarjetas se crean previamente y están disponibles de inmediato.
• Usuarios nuevos con un recuento de sesiones igual a 0: Usa una Campaign activada por acción. Las tarjetas se crean después del primer desencadenante de sesión.

Este enfoque asegura que los usuarios existentes vean las tarjetas al instante, al tiempo que sigue alcanzando a los usuarios nuevos tras un breve retraso en su primera sesión. Para estrategias adicionales para mejorar la latencia, consulta Mejorar la baja latencia para Content Cards.

¿Por qué las marcas de tiempo de impresión o descarte caen fuera del calendario de la Campaign?

Las marcas de tiempo de impresión y descarte en los análisis y Currents reflejan cuándo un usuario ve o descarta una Content Card, no cuándo Braze crea o envía la tarjeta. Una tarjeta puede permanecer en la fuente de un usuario hasta que las Content Cards se actualicen, por lo que las marcas de tiempo de impresión y descarte pueden caer después de la ventana de envío de la Campaign.

Si los tiempos aún parecen inesperados:

• Confirma si estás viendo los análisis en la zona horaria de tu empresa en lugar de la zona horaria del usuario en Currents.
• Comprueba que el usuario realmente vio o descartó la tarjeta después de recibirla, en lugar de comparar únicamente con el momento de envío.

Para más información sobre las métricas de Content Cards, consulta Informes de Content Cards.

Error “Todos los valores de expiración de una Campaign deben coincidir”

Este error aparece cuando una Campaign de Content Cards multivariante utiliza diferentes configuraciones de expiración en las variantes. Establece la misma expiración (duración o momento específico) en cada variante, o reduce la Campaign a una sola variante, y luego guarda de nuevo. Para saber cómo configurar la expiración al crear una Campaign, consulta Elegir un calendario de entrega o desencadenante.