Crear una tarjeta de contenido

Este artículo explica cómo crear una tarjeta de contenido en Braze al construir campañas 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 campañas para mensajes simples y únicos (como informar a los usuarios sobre un producto con un solo mensaje). Usa Canvas para recorridos de usuario con múltiples 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 tarjeta de contenido: Clásica, Imagen con subtítulo y 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 tarjeta de contenido 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 a la izquierda 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 y una 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: Redacta una tarjeta de contenido

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

El contenido aquí varía según el 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 deseados de la lista proporcionada. Esto inserta Liquid en tu mensaje. Te recomendamos seleccionar tus idiomas antes de escribir tu contenido para que puedas completar tu texto donde corresponda en el Liquid. Para nuestra lista completa de idiomas disponibles que puedes usar, 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 sobre cómo 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 están disponibles para las tarjetas de solo imagen.

Imagen

Para añadir una imagen a tu tarjeta de contenido, puedes seleccionar Añadir imagen o proporcionar una URL de imagen. Al seleccionar Añadir imagen se abre la Biblioteca de medios, 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 verificarlos antes de encargar o crear una imagen desde cero. Ten en cuenta que los campos de mensaje de las tarjetas de contenido 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 del usuario y el usuario no puede descartarla. Si el feed de un usuario tiene múltiples tarjetas ancladas, Braze las ordena cronológicamente. Después de enviar una tarjeta, no puedes actualizar retroactivamente su opción de anclaje. Cambiar esta opción después de enviar una campaña solo afecta a los envíos futuros.

Comportamiento al hacer clic

Cuando tu cliente hace clic en un enlace presentado en la tarjeta, tu enlace puede llevarlos más profundo dentro de tu aplicación o a otro sitio. Si eliges un comportamiento al hacer clic para tu tarjeta de contenido, recuerda actualizar tu Texto del enlace de forma correspondiente.

Las siguientes acciones están disponibles para los enlaces de tarjetas de contenido:

Acción	Descripción
Redirigir a URL web	Abrir una página web no nativa.
Vínculo profundo a la aplicación	Vínculo profundo a una pantalla existente en tu aplicación.
Registrar evento personalizado	Elige un evento personalizado para desencadenar. Puede usarse para mostrar otra tarjeta de contenido o desencadenar mensajes adicionales.
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: Configura ajustes adicionales (opcional)

Puedes usar pares clave-valor para crear categorías para tus tarjetas, crear múltiples feeds de tarjetas de contenido 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: Revisa y despliega

Después de terminar de construir la última parte de tu campaña o Canvas, revisa sus detalles, pruébala y envíala cuando estés listo. Para más información, consulta Enviar mensajes de prueba.

A continuación, consulta Informes de tarjetas de contenido para aprender cómo puedes acceder a los resultados de tus campañas de tarjetas de contenido.

Cosas que debes saber

Limitaciones de carga útil y feed

Para mantener el rendimiento, las tarjetas de contenido tienen dos restricciones clave: un límite en el tamaño de la carga útil para cada tarjeta y un número máximo de tarjetas que pueden aparecer en un feed.

Limitaciones de tamaño para tarjetas de contenido

La carga útil total de datos para una sola tarjeta de contenido no puede exceder 2 KB después de que se renderice cualquier personalización con Liquid. Esto incluye:

• Título
• Mensaje
• URL de 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)

Usar Liquid para extraer cadenas largas de texto (como de atributos personalizados) puede hacer que excedas el límite.

El compositor de campañas muestra una advertencia si tu contenido estático excede el límite. (No predecimos el tamaño del contenido dinámico que usa Liquid.) Si el tamaño del mensaje excede 2 KB, se cancela en el momento del envío. Puedes ver estas cancelaciones en el Registro de actividad de mensajes con la razón Content card maximum size exceeded.

Aquí tienes algunas mejores prácticas para gestionar el tamaño de la carga útil de las tarjetas de contenido:

• Usa acortadores de URL para enlaces largos. Las URLs, especialmente aquellas con parámetros de seguimiento extensos, pueden tener problemas con el límite de tamaño. Usar un servicio de acortamiento de URLs puede reducir drásticamente el conteo 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 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 para 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 rico. Para casos de uso que requieren consistentemente grandes cantidades de contenido, las tarjetas de contenido pueden 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 rico directamente en la experiencia de una aplicación o sitio web.

Número de tarjetas en el feed

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

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

• Usa fechas de expiración más cortas: Para campañas sensibles al tiempo (como una venta de fin de semana), establece una fecha de expiración específica. De esta manera, las tarjetas se eliminan automáticamente del feed y no cuentan para el límite después de que ya no sean 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 debería eliminarse tan pronto como se registre un evento profile_completed.
• Audita las campañas de larga duración: Revisa las campañas 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 con el tiempo.

Entender la reelegibilidad para tarjetas de contenido

La reelegibilidad determina si un usuario puede recibir un mensaje de la misma campaña más de una vez y cuándo. Para las tarjetas de contenido, entender cómo funciona esto es fundamental para gestionar campañas recurrentes y asegurar 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 campaña 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 tu tarjeta:

• Las tarjetas de contenido que usan primera impresión usan el momento de la impresión para calcular la reelegibilidad.
• Las tarjetas de contenido creadas al lanzamiento de la campaña o al entrar en el paso de Canvas usan el momento de envío o el momento 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 campaña y la expiración automática de 30 días de todas las tarjetas de contenido.

Todas las tarjetas de contenido se purgan automáticamente de los sistemas de Braze 30 días después de ser enviadas o eliminadas. Si tienes una campaña recurrente de larga duración con la reelegibilidad desactivada, un usuario aún puede recibir la misma tarjeta nuevamente después de 30 días. Cuando la tarjeta original se purga, el sistema ya no ve un registro de que ese usuario haya recibido la campaña, haciéndolo elegible nuevamente en su próxima sesión.

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

Gestionar tarjetas de contenido activas

Después de que las tarjetas de contenido se han enviado, permanecen esperando en un “buzón de entrada” listas para ser entregadas al usuario (similar a lo que sucede con los correos electrónicos). Después de que el contenido se extrae en la tarjeta de contenido (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 punto de conexión cambian. Estos datos no se actualizarán. Solo se puede detener el envío a nuevos usuarios y eliminarla de los feeds de los usuarios. Si modificas una campaña, solo las tarjetas futuras que se envíen tendrán 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 campaña (recomendado para cambios inmediatos)

El primer enfoque es archivar la campaña y lanzar una nueva campaña duplicada:

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

Cuando duplicas la campaña, 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 tarjeta de contenido, puedes filtrar por usuarios que no hayan recibido la versión anterior de la tarjeta de contenido 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 para 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 verían la tarjeta actualizada en la próxima actualización del feed si son elegibles.
• Informes: Cada versión de la tarjeta tendría análisis separados.

Digamos que has configurado una campaña para que se desencadene al inicio de sesión, y tiene la reelegibilidad establecida en 30 días. Un usuario recibió la campaña hace dos días y quieres cambiar el texto. Primero, archivarías la campaña y eliminarías las tarjetas del feed. Segundo, duplicarías la campaña y la relanzarías con el nuevo texto. Si el usuario tiene otra sesión, recibirá inmediatamente la nueva tarjeta.

Opción 2: Detener y relanzar la misma campaña

Este enfoque mantiene todos tus análisis unificados en una sola campaña. 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 campaña y, cuando se te solicite, selecciona Eliminar tarjeta después de la próxima sincronización.
2. Edita tu campaña según sea necesario.
3. Reinicia tu campaña.

Impacto

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

Digamos que tienes una campaña que se desencadena al inicio de sesión y tiene la reelegibilidad establecida en 30 días. Un usuario recibió la campaña hace dos días y quieres cambiar el texto. Primero, detén la campaña y elimina la tarjeta del feed. Segundo, vuelve a publicar la campaña con el nuevo texto. Si el usuario tiene otra sesión, recibirá 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 campaña.

1. Abre la campaña de tarjeta de contenido y selecciona Detener campaña.
2. Cuando se te solicite, selecciona Eliminar tarjeta después de la próxima sincronización. La tarjeta se elimina en la próxima 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 campaña o paso de Canvas, especifica un evento de eliminación. Cuando un usuario realiza ese evento, la tarjeta se elimina de su feed en una actualización posterior después de que Braze procese el evento.

Expiración de tarjetas

Las tarjetas de contenido 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 campaña recurrente que efectivamente reemplace la tarjeta cada 30 días:

1. Establece la duración de la tarjeta de contenido en 30 días.
2. Establece la reelegibilidad de la campaña en 30 días.
3. Configura la campaña para que se desencadene al “Inicio de sesión”.