Crear una tarjeta de contenido

Este artículo explica cómo crear una tarjeta de contenido en Braze cuando creas campañas y Canvas. Aquí te guiaremos para que elijas un tipo de mensajería, compongas tu tarjeta y programes la entrega de tu mensaje.

Paso 1: Elige dónde construir tu mensaje

Utiliza campañas para mensajes únicos y sencillos (como informar a los usuarios sobre un producto con un solo mensaje). Utiliza Canvas para recorridos de usuario de 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 mensajes

Selecciona uno de los tres tipos esenciales de tarjeta de contenido: Clásica, Imagen con subtítulos y Solo imagen.

Para saber más sobre el comportamiento esperado y el aspecto de cada tipo, consulta Detalles creativos, o echa un vistazo a los enlaces de la siguiente tabla. Estos tipos de Tarjetas 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, el texto del mensaje y una imagen opcional que se coloca a la izquierda del título y el texto. Lo mejor es utilizar una imagen cuadrada o un icono con la tarjeta clásica.
Imagen subtitulada		La tarjeta de imagen subtitulada muestra tu contenido con un texto y una imagen llamativa.
Solo imagen		La tarjeta de solo imagen llama la atención con espacio para imágenes, GIF y otros contenidos creativos no textuales.

Paso 3: Componer 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 desees de la lista proporcionada. Esto insertará Liquid en tu mensaje. Te recomendamos que selecciones tus idiomas antes de escribir el contenido para que puedas rellenar el texto donde corresponda en Liquid. Para consultar nuestra lista completa de idiomas disponibles, 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 rendericen los proveedores de servicios. Para conocer las mejores prácticas de elaboración de 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 transmitas tu mensaje y consigas que tu cliente haga clic, ¡mejor! Recomendamos títulos y contenidos de mensajes claros y concisos. Ten en cuenta que estos campos no se proporcionan para las tarjetas de solo imagen.

Imagen

Añade una imagen a tu tarjeta de contenido seleccionando Añadir imagen o proporcionando una URL de la 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 comprobar cuáles son antes de encargar o hacer una imagen desde cero. Ten en cuenta que los campos de mensaje de la tarjeta de contenido están limitados a 2 KB de tamaño total.

Anclar a la parte superior

Braze muestra una tarjeta anclada en la parte superior de la fuente del usuario y el usuario no puede descartarla. Si la fuente de un usuario tiene varias tarjetas ancladas, Braze las ordena cronológicamente. Una vez enviada 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 llevarle más adentro de tu aplicación o a otro sitio. Si eliges un comportamiento de clic para tu tarjeta de contenido, recuerda actualizar tu Texto de enlace en consecuencia.

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

Acción	Descripción
Redirigir a URL de página 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 utilizarse 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 con la versión del SDK:

Paso 4: Configurar ajustes adicionales (opcional)

Puedes utilizar pares clave-valor para crear categorías para tus tarjetas, crear múltiples fuentes 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: Revisar y desplegar

Cuando hayas terminado de construir lo último de tu campaña o Canvas, revisa sus detalles, pruébala y envíala cuando estés listo.

A continuación, consulta los informes de Tarjetas de contenido para saber cómo puedes acceder a los resultados de tus campañas de Tarjetas de contenido.

Lo que hay que saber

Limitaciones de carga útil y fuente

Para mejorar el rendimiento, las Tarjetas de contenido 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 para las Tarjetas de contenido

La carga útil total de datos de una sola tarjeta de contenido no puede superar los 2 KB después de renderizar cualquier personalización de Liquid. Esto incluye lo siguiente:

• Título
• Mensaje
• URL de la imagen (la longitud de la cadena URL en sí, no el tamaño del archivo de imagen)
• Texto de enlace
• URL de enlace para todas las plataformas especificadas (las URL 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 extraer cadenas de texto largas (como las de los atributos personalizados) puede hacer que se supere el límite.

El compositor de campañas mostrará 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 abortará en el momento del envío. Puedes ver estos abortos en el registro de actividad de mensajes con el motivo Content card maximum size exceeded.

A continuación, se indican algunas prácticas recomendadas para administrar el tamaño de la carga útil de las Tarjetas de contenido:

• Utiliza acortadores de URL para enlaces largos. Las URL, especialmente aquellas con parámetros de seguimiento extensos, pueden tener problemas de límite de tamaño. El uso de un servicio de acortamiento de URL 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 a partir de atributos de usuario o llamadas a la API, la longitud del contenido puede ser impredecible. Utiliza de forma proactiva filtros 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. El uso de URL largas y únicas para cada plataforma puede multiplicar el tamaño de la carga útil. Si es posible, utiliza un único enlace que funcione en todas las plataformas o utiliza acortadores de URL según sea necesario.
• Considera la posibilidad de utilizar banners para contenido más rico. Para los casos de uso que requieren constantemente grandes cantidades de contenido, es posible que las Tarjetas de contenido no sean el canal adecuado. Los banners no tienen la misma limitación de carga útil de 2 KB y son más adecuados para incorporar contenido más rico directamente en la experiencia de la aplicación o el sitio web.

Número de tarjetas en la fuente

Cada usuario puede tener hasta 250 Tarjetas de contenido no caducadas en su fuente en un momento dado. Cuando se supere este límite, Braze dejará 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, recomendamos seguir estas prácticas:

• Utiliza fechas de caducidad más cortas: Para las campañas que son sensibles al tiempo (como una venta de fin de semana), establece una fecha de caducidad específica. De esta manera, las tarjetas se eliminan automáticamente de la fuente y 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 al usuario que complete su perfil debe eliminarse tan pronto como se registre un evento profile_completed.
• Audita 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 la fuente con demasiadas tarjetas a lo largo del tiempo.

Comprender la reelegibilidad para las 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. En el caso de las Tarjetas de contenido, comprender cómo funciona esto es fundamental para administrar campañas recurrentes y garantizar que los usuarios no reciban 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 comienza después de que se le envíe el mensaje. El momento específico en que comienza esta cuenta atrás depende de la configuración de creación de tu tarjeta:

• Las Tarjetas de contenido que utilizan la primera impresión utilizan el tiempo de impresión para calcular la reelegibilidad.
• Las Tarjetas de contenido creadas al inicio de la campaña o a la entrada del paso en Canvas utilizan la hora de envío o la hora de impresión más reciente.

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 Tarjetas de contenido.

Todas las Tarjetas de contenido se eliminan automáticamente de los sistemas de Braze 30 días después de su envío o eliminación. 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 después de 30 días. Cuando se elimina la tarjeta original, el sistema ya no ve ningún registro de que ese usuario haya recibido la campaña, por lo que vuelve a ser elegible 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 en Canvas para los 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.

Administración de Tarjetas de contenido en vivo

Una vez enviadas las Tarjetas de contenido, quedan en espera en un «buzón de entrada» listas para ser entregadas al usuario (de forma similar a lo que ocurre con los correos electrónicos). Una vez que el contenido se ha incorporado a la tarjeta de contenido (en el momento de su visualización), no se puede modificar durante su ciclo de vida. Esto se 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 impedir el envío a nuevos usuarios y eliminarla de las fuentes de los usuarios. Si modificas una campaña, solo las futuras tarjetas que se envíen tendrán la actualización.

Actualización de las tarjetas lanzadas

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

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

El primer enfoque consiste en 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, realiza tus modificaciones y lanza la nueva versión.

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

• Si los usuarios no deben volver a ser elegibles para una tarjeta de contenido, puedes filtrar a los usuarios que no hayan recibido la versión anterior de la tarjeta de contenido configurando 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 para Last Received Message from specific campaign a hace más de X días O Received Message from Campaign con la condición Has Not.

Impacto

• Destinatarios existentes: Los nuevos destinatarios y los ya existentes verán la tarjeta actualizada en la próxima actualización de la fuente si cumplen los requisitos.
• Informes: Cada versión de la tarjeta tendría sus propios análisis.

Supongamos que has configurado una campaña para que se desencadene al inicio de una sesión y que la reelegibilidad está 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 de la fuente. 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 que sean elegibles por primera vez recibirán la nueva tarjeta, pero la actualización para los destinatarios actuales se retrasará hasta que vuelvan a ser elegibles:

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 hayan recibido la tarjeta no recibirán las tarjetas actualizadas hasta que vuelvan a ser elegibles. Si se desactiva la reelegibilidad, nunca recibirían la nueva tarjeta.
• Informes: Una campaña contendrá todos los análisis de las versiones de tarjetas lanzadas. Braze no diferenciará entre las versiones lanzadas.

Supongamos que tienes una campaña desencadenada por el inicio de una sesión y con 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 retira la tarjeta de la fuente. 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.

Eliminación y caducidad de tarjetas

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 solicite, selecciona Eliminar tarjeta después de la próxima sincronización. La tarjeta se eliminará en la próxima actualización de la fuente.

Eliminación automática de tarjetas

Puedes eliminar automáticamente una tarjeta cuando un usuario realice una acción específica, 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 realice ese evento, la tarjeta se eliminará de su fuente en una actualización posterior, una vez que Braze haya procesado el evento.

Caducidad de la tarjeta

Las Tarjetas de contenido permanecen disponibles hasta 30 días desde el momento en que se envían; transcurrido ese plazo, Braze las elimina de las fuentes de los usuarios y las borra de sus sistemas.

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

Si deseas que una tarjeta parezca que siempre está disponible (es decir, que dure más de los 30 días máximos), puedes crear una campaña recurrente que sustituya efectivamente la tarjeta cada 30 días:

1. Fija 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 en «Inicio de sesión».