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

Utiliza las campañas para mensajes únicos y sencillos (como informar a los usuarios sobre un producto con un solo mensaje). Utiliza los Canvas para recorridos del usuario de varios pasos (como enviar sugerencias de productos personalizadas en función del comportamiento del usuario a lo largo del tiempo).

• campaign
• canvas

Paso 2: Especifica tus tipos de mensajes

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

Para obtener más información sobre el comportamiento esperado y el aspecto de cada tipo, consulta Detalles creativos o los enlaces de la siguiente tabla. Tanto las aplicaciones móviles como las aplicaciones web aceptan estos tipos de Content Cards.

Tipo de mensaje	Ejemplo	Descripción
Clásica		La tarjeta clásica tiene un diseño sencillo con un título en negrita, el texto del mensaje y una imagen opcional situada al inicio del título y del texto. Lo mejor es usar una imagen o un icono cuadrado con la tarjeta clásica.
Imagen con título		La tarjeta de imagen con tí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 otros contenidos creativos que no son texto.

Paso 3: Redactar una tarjeta de contenido

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 añadir los idiomas que quieras de la lista proporcionada. Esto inserta Liquid en tu mensaje. Te recomendamos que selecciones los idiomas antes de escribir el contenido para que puedas rellenar el texto donde corresponde en el Liquid. Para ver la lista completa de idiomas disponibles que puedes utilizar, consulta Idiomas admitidos.

Crear mensajes de derecha a izquierda

El aspecto final de los mensajes de derecha a izquierda depende en gran medida de cómo los muestren los proveedores de servicios. Para conocer las mejores prácticas a la hora de 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 antes transmitas tu mensaje y consigas que tu cliente haga clic, ¡mejor! Te 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 la URL de una imagen. Al seleccionar Añadir imagen se abre la Biblioteca multimedia, donde puedes seleccionar una imagen cargada anteriormente 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 nueva imagen. Ten en cuenta que los campos de mensaje de las tarjetas de contenido están limitados a 2 KB de tamaño total.

Anclar en la parte superior

Braze muestra una tarjeta anclada en la parte superior de la fuente de un usuario, y el usuario no puede descartarla. Si la fuente de un usuario tiene varias tarjetas ancladas, Braze las ordena cronológicamente. Cuando Braze entrega una tarjeta de contenido, esta está anclada o desanclada, y ese estado no cambia durante toda la vida útil de la tarjeta. Si cambias la configuración de anclaje de una campaña, 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 la fuente de un usuario.

Comportamiento al hacer clic

Cuando tu cliente hace clic en un vínculo presentado en la tarjeta, tu vínculo puede llevarlo a una sección más profunda de tu aplicación o a otro sitio. Si eliges un comportamiento al hacer clic para tu tarjeta de contenido, recuerda actualizar el Texto del vínculo en consecuencia.

Las siguientes acciones están disponibles para los vínculos de las tarjetas de contenido:

Acción	Descripción
Redirigir a URL web	Abre una página web no nativa.
Vínculo profundo a la aplicación	Crea un vínculo profundo a una pantalla existente de tu aplicación.
Registrar evento personalizado	Elige un evento personalizado para desencadenar. Puede utilizarse para mostrar otra tarjeta de contenido o desencadenar mensajería adicional.
Registrar atributo personalizado	Elige un atributo personalizado para establecerlo para el usuario actual.

Las opciones Registrar evento personalizado y Registrar atributo personalizado requieren la siguiente compatibilidad de versiones del SDK:

Paso 4: Configura los ajustes adicionales (opcional)

Puedes usar pares clave-valor para crear categorías para tus tarjetas, crear varias 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: Crea el resto de tu Campaign o Canvas

• campaign
• canvas

Paso 6: Revisar y desplegar

Cuando termines de crear tu campaña o Canvas, revisa sus detalles, pruébala y, a continuación, 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 tarjeta de contenido.

Información importante

Limitaciones de la carga útil y de la fuente

Para mantener un buen rendimiento, las Content Cards tienen 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 una fuente.

Limitaciones de tamaño de las Content Cards

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

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

Si usas Liquid para incorporar cadenas de texto largas (por ejemplo, de atributos personalizados), puedes superar el límite.

El creador de campañas muestra una advertencia si tu contenido estático supera el límite. No calculamos de antemano el tamaño del contenido dinámico que usa Liquid. Si el tamaño del mensaje supera los 2 KB, se cancela en el momento del envío. Puedes ver estas cancelaciones en Observabilidad de mensajería con el resultado Content Card invalid.

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

• Usa acortadores de URL para los enlaces largos. Las URL, sobre todo las que tienen muchos parámetros de seguimiento, pueden provocar problemas con el límite de tamaño. Un servicio de acortamiento de URL puede reducir drásticamente el número de caracteres y liberar espacio en la carga útil.
• Trunca el contenido dinámico con Liquid. Cuando personalizas tarjetas con texto dinámico procedente de atributos de usuario o llamadas a la API, la longitud del contenido puede ser impredecible. Usa de forma proactiva filtros de Liquid como truncate para limitar la longitud de cualquier texto dinámico.
• Sé eficiente con las URL multiplataforma. El límite de 2 KB incluye las URL de todas las plataformas que definas. Usar URL largas y distintas para cada plataforma puede multiplicar el tamaño de la carga útil. Si es posible, usa un único 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 casos de uso que requieren siempre grandes cantidades de contenido, puede que las Content Cards no sean el canal adecuado. Los Banners no tienen la misma limitación de 2 KB en la carga útil y son más adecuados para insertar contenido más completo directamente en una aplicación o sitio web.

Número de tarjetas en la fuente

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

Para evitar problemas con el límite de tarjetas, te recomendamos estas prácticas:

• Usa fechas de caducidad más cortas: Para campañas con plazos concretos (como una oferta de fin de semana), establece una fecha de caducidad específica. Así, las tarjetas se eliminan automáticamente de la fuente y dejan de contar para el límite cuando ya no son 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 pide al usuario que complete su perfil debería eliminarse en cuanto se registre un evento profile_completed.
• Revisa las campañas de larga duración: Revisa las campañas recurrentes o en curso para asegurarte de que no crean una mala experiencia para tus usuarios llenando la fuente con demasiadas tarjetas con el tiempo.

Comprender la reelegibilidad de las Content Cards

La reelegibilidad determina si un usuario puede recibir un mensaje de la misma campaña más de una vez, y cuándo. En las Content Cards, entender cómo funciona es fundamental para gestionar las campañas recurrentes y asegurarte de que los usuarios no reciben mensajes duplicados u obsoletos.

Cómo se calcula la reelegibilidad

Si activas la reelegibilidad, la cuenta atrás para que un usuario pueda “volver a entrar” en una campaña empieza después de que se le envía el mensaje. El momento exacto en que empieza esta cuenta atrás depende de tu configuración de creación de tarjetas:

• Las Content Cards creadas en la primera impresión usan la hora de impresión para calcular la reelegibilidad.
• Las Content Cards creadas en el lanzamiento de la campaña, en campañas multicanal o al entrar en el paso en Canvas usan la hora de envío o la hora de impresión, la que sea posterior.

La caducidad de 30 días y la reelegibilidad

Una fuente habitual de confusión es la interacción entre la reelegibilidad de la campaña y la caducidad automática de 30 días de todas las Content Cards.

Todas las Content Cards se purgan automáticamente de los sistemas de Braze 30 días después de enviarse o eliminarse. Si tienes una campaña recurrente de larga duración con la reelegibilidad desactivada, es posible que un usuario vuelva a recibir la misma tarjeta pasados 30 días. Cuando se purga la tarjeta original, el sistema deja de ver un registro de que ese usuario recibió la campaña, por lo que vuelve a ser elegible en su siguiente sesión.

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

Gestionar Content Cards en vivo

Después de enviarse, las Content Cards esperan en un “buzón de entrada” listas para entregarse al usuario (de forma parecida a lo que ocurre con los correos electrónicos). Una vez que el contenido se incorpora a la Content Card (en el momento de mostrarse), no se puede cambiar durante su vida útil. Esto se aplica incluso si llamas a una API mediante contenido conectado y los datos del endpoint cambian. Estos datos no se actualizan. Solo se puede impedir que se envíe a nuevos usuarios y eliminarla de las fuentes de los usuarios. Si modificas una campaña, solo las tarjetas enviadas después de la modificación incluyen el cambio.

Actualizar tarjetas lanzadas

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

Opción 1: Duplicar la campaña (recomendado para cambios inmediatos)

El primer método consiste en archivar la campaña y lanzar una nueva campaña duplicada:

1. Detén la campaña original y, cuando se te pida, selecciona Eliminar tarjeta tras la próxima sincronización.
2. Duplica la campaña, haz tus cambios y lanza la nueva versión.

Cuando duplicas la campaña, tienes que definir la audiencia de la nueva versión. Usa filtros de segmentación para controlar quién recibe la tarjeta actualizada:

• Si los usuarios nunca deben volver a ser elegibles para una Content Card, puedes filtrar los usuarios que no han 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 volver a ser elegibles en X días, puedes establecer el filtro Last Received Message from specific campaign en hace más de X días 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 de la fuente si son elegibles.
• Informes: Cada versión de la tarjeta tiene análisis independientes.

Supongamos que configuras una campaña que se desencadena al iniciar 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, archiva la campaña y elimina las tarjetas de la fuente. Después, duplica la campaña y vuelve a lanzarla con el nuevo texto. Si el usuario inicia otra sesión, recibe inmediatamente la nueva tarjeta.

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

Este método mantiene todos tus análisis unificados en una sola campaña. Los usuarios que pasan a ser elegibles reciben la nueva tarjeta, pero la actualización se retrasa para los destinatarios existentes hasta que vuelven a ser elegibles:

1. Detén tu campaña y, cuando se te pida, selecciona Eliminar tarjeta tras 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 reciben las tarjetas actualizadas hasta que vuelven a ser elegibles. Si la reelegibilidad está desactivada, nunca reciben la nueva tarjeta.
• Informes: Una sola campaña contiene todos los análisis de las versiones de la tarjeta lanzadas. Braze no diferencia entre las versiones lanzadas.

Supongamos que tienes una campaña que se desencadena al iniciar 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 de la fuente. Después, vuelve a publicar la campaña con el nuevo texto. Si el usuario inicia otra sesión, recibirá la nueva tarjeta dentro de 28 días.

Eliminar tarjetas y hacer que caduquen

Eliminación manual de tarjetas

Puedes eliminar manualmente las tarjetas de las fuentes 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 pida, selecciona Eliminar tarjeta tras la próxima sincronización. La tarjeta se elimina en la siguiente actualización de la fuente.

Eliminación automática de tarjetas

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

En tu campaña o paso en Canvas, especifica un evento de eliminación. Cuando un usuario realiza ese evento, Braze procesa el evento y, a continuación, elimina la tarjeta de su fuente.

Caducidad de las tarjetas

Las Content Cards permanecen disponibles hasta 30 días desde su envío; pasados 30 días, Braze las elimina de las fuentes de los usuarios y las purga de sus sistemas.

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, en la práctica, sustituya 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 campaña en 30 días.
3. Configura la campaña para que se desencadene con “Inicio de sesión”.

Sincronización y actualización de Content Cards

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

Impacto de detener campañas de Content Cards

Cuando detienes una campaña y seleccionas Eliminar tarjeta tras la próxima sincronización, Braze elimina la tarjeta de las fuentes de los usuarios en la siguiente actualización. Es posible que el número de impresiones sea inferior al de envíos, porque los usuarios no pueden generar 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?

En las Campaigns de entrega basada en acciones (como el inicio de sesión), es normal que haya un breve retraso entre el evento desencadenante y el momento en que la tarjeta está disponible. Este retraso se produce porque:

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

En las versiones del SDK compatibles, la entrega en tiempo real envía la tarjeta al dispositivo en cuanto Braze la crea, por lo 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 ejecute antes de que se registre la elegibilidad del usuario no devuelve nada.

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

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

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

Este enfoque garantiza que los usuarios existentes vean las tarjetas al instante y, al mismo tiempo, llegues a los usuarios nuevos tras un breve retraso en su primera sesión. Para conocer más estrategias para mejorar la latencia, consulta Mejorar la baja latencia de las Content Cards.

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

Las marcas de tiempo de impresión y descarte en los análisis y en 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 se actualicen las Content Cards, por lo que las marcas de tiempo de impresión y descarte pueden ser posteriores a la ventana de envío de la Campaign.

Si las horas siguen pareciendo inesperadas:

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

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

Error “All expiration values for a campaign must match”

Este error aparece cuando una Campaign de Content Cards con múltiples variantes utiliza configuraciones de caducidad diferentes entre las variantes. Establece la misma caducidad (duración u hora específica) en todas las variantes, o reduce la Campaign a una sola variante, y vuelve a guardar. Para saber cómo establecer la caducidad al crear una Campaign, consulta Elegir un programa de entrega o desencadenante.