Crear un Canvas
Utiliza Canvas cuando quieras guiar a los usuarios a través de un recorrido de varios pasos. Canvas conecta demoras, toma de decisiones y mensajes para que puedas ramificar experiencias en función de lo que hacen los usuarios y cuándo lo hacen. Para un solo paso de mensajería en uno o más canales, utiliza Campaigns.
Requisitos previos
- Permisos para crear y lanzar Canvas (consulta Permisos)
- Segments o filtros que definan quién debe entrar
Antes de empezar
- Revisa los conceptos básicos de Canvas para que los objetivos de entrada, mensajería y conversión se ajusten a tu caso de uso.
- Si quieres una guía paso a paso, haz el curso de Braze Learning sobre Canvas.
- Empieza a partir de una plantilla de Canvas de Braze o pídele a Operator que elabore un borrador de Canvas a partir de un resumen.
Paso 1: Configura los aspectos básicos del Canvas
- Ve a Mensajería > Canvas.
- Selecciona Crear Canvas.
- Nombra tu Canvas, asigna equipos y crea o añade etiquetas. También puedes asignar eventos de conversión para el Canvas.

Etiqueta tus Canvas para que sean fáciles de encontrar y generar informes. Por ejemplo, al usar el generador de informes, puedes filtrar por etiquetas específicas.
Elige eventos de conversión
Elige tu tipo de evento de conversión y luego selecciona las conversiones que deseas registrar. Estos eventos de conversión miden la eficiencia de tu Canvas.
Si tu Canvas tiene múltiples variantes o un grupo de control, Braze utiliza este evento de conversión para determinar la mejor variación para alcanzar este objetivo de conversión. Usando la misma lógica, puedes crear múltiples eventos de conversión.
Paso 2: Elige un calendario de entrada
Puedes elegir una de tres formas en las que los usuarios pueden entrar en tu Canvas.
Con la entrega programada, los usuarios entran según un calendario, de forma similar a como programas una Campaign. Puedes inscribir usuarios en un Canvas tan pronto como se lance, ingresarlos en tu recorrido en algún momento futuro, o de forma recurrente (diaria, semanal o mensualmente).
Si seleccionas un calendario recurrente mensual, ten en cuenta que algunos meses pueden no tener el día seleccionado. Por ejemplo, supongamos que configuras un Canvas para enviarse mensualmente el día 31. En este escenario, Braze envía el último día de ese mes, como el 30 de abril, porque el 31 de abril no existe.
Cuando uses la entrega en zona horaria local, Braze evalúa la elegibilidad de entrada dos veces: primero en la hora de Samoa (UTC+13) en el día programado, y luego en la hora local del usuario. Un usuario debe ser elegible en ambas verificaciones para entrar en el Canvas. Si tus filtros de entrada usan ventanas de tiempo relativas (por ejemplo, “hace más de 2 días”), es posible que el período de 24 horas no haya transcurrido en el momento de la primera verificación, lo que provoca que los usuarios entren un día tarde. Para evitar esto, usa una ventana de tiempo más amplia, como al menos dos días. Para más detalles, consulta ¿Cuándo evalúa Braze a los usuarios para la entrega en zona horaria local?
Con la entrega basada en acciones, los usuarios entran en el Canvas y comienzan a recibir mensajes cuando realizan acciones particulares, como abrir tu aplicación, hacer una compra o desencadenar un evento personalizado.
Puedes controlar otros aspectos del comportamiento del Canvas desde la ventana Público de entrada, incluidas las reglas de re-elegibilidad y la configuración de limitación de frecuencia. Puedes usar la entrada a Canvas basada en acciones con pasos de mensajes dentro de la aplicación. Los mensajes dentro de la aplicación no están disponibles en los pasos clásicos basados en acciones (desencadenamiento y demora).

Interact with Canvas Step no está disponible como desencadenante de entrada basado en acciones para Canvas. Solo se puede usar como desencadenante para Campaigns. Para desencadenar un Canvas desde otro, usa el componente de Canvas Enviar a destino, o crea un webhook de Braze a Braze que llame al endpoint /canvas/trigger/send.

Si tu Canvas basado en acciones envía mensajes antes de lo esperado, verifica que la marca de tiempo de tu evento personalizado se envíe con la hora actual en lugar de una hora retroactiva. Por ejemplo, si un Canvas basado en acciones tiene una demora de tres horas después de que un usuario realiza un evento personalizado, Braze usa la marca de tiempo enviada con el evento personalizado para evaluar esa demora. Si la marca de tiempo está retroactiva por más de tres horas, Braze trata la demora como ya transcurrida y envía el mensaje de inmediato.
Con la entrega activada por API, los usuarios entran en tu Canvas y comienzan a recibir mensajes después de que los añades con el endpoint /canvas/trigger/send. El panel incluye un ejemplo de solicitud cURL.
La clave de propiedades de entrada en esa solicitud depende de las características disponibles en tu espacio de trabajo:
- Si el panel muestra Variables de contexto, pasa datos de entrada opcionales en el objeto
context. - Si el panel muestra Propiedades de entrada de Canvas, usa el objeto heredado
canvas_entry_propertiesque se muestra en el ejemplo del panel.
Por ejemplo, el objeto de destinatario usa una de las siguientes claves de datos de entrada:
Variables de contexto:
{"external_user_id": "user_123", "context": {"product_name": "shoes"}}
Propiedades de entrada de Canvas:
{"external_user_id": "user_123", "canvas_entry_properties": {"product_name": "shoes"}}
Puedes usar los siguientes endpoints para la entrega activada por API:
Después de seleccionar tu método de entrega, ajusta la configuración para que coincida con tu caso de uso y luego continúa para establecer tu público objetivo.
Comportamiento de deduplicación para Canvas que usan el editor original
Si la ventana de re-elegibilidad es menor que la duración máxima del Canvas, un usuario puede volver a entrar y recibir los mensajes de más de un componente. En el caso extremo en que la re-entrada de un usuario alcance el mismo componente que su entrada anterior, Braze deduplica los mensajes de ese componente.
Si un usuario vuelve a entrar en el Canvas, alcanza el mismo componente que su entrada anterior y es elegible para un mensaje dentro de la aplicación en cada entrada, el usuario recibe el mensaje dos veces (dependiendo de la prioridad de los mensajes dentro de la aplicación) siempre que vuelva a abrir una sesión dos veces.
Paso 3: Establecer el público objetivo
Solo los usuarios que coincidan con los criterios definidos pueden entrar en el recorrido en el paso Público objetivo, lo que significa que Braze evalúa la elegibilidad del público objetivo primero antes de que los usuarios entren en el recorrido del Canvas. Por ejemplo, si deseas dirigirte a usuarios nuevos, puedes seleccionar un segmento de usuarios que usaron tu aplicación por primera vez hace menos de una semana.

En espacios de trabajo con múltiples aplicaciones, la elegibilidad del público de entrada de Canvas se evalúa solo cuando los usuarios entran en el Canvas, no en los pasos de mensaje individuales. Para restringir los pasos de mensaje a usuarios de una aplicación específica, activa Validar audiencia en el envío de mensaje y añade un segmento dirigido a la aplicación en las validaciones de entrega del paso de mensaje, o usa Liquid en el momento del envío. Los filtros como Tiene aplicación no restringen qué aplicación recibe el mensaje.
En Controles de entrada, puedes limitar el número de usuarios cada vez que el Canvas está programado para ejecutarse. Para Canvas basados en activadores de API y basados en acciones, este límite se aplica en cada hora UTC.

Evita configurar una campaña basada en acciones o un Canvas con el mismo desencadenante que el filtro de audiencia (como un atributo modificado o la realización de un evento personalizado). Puede producirse una condición de carrera en la que el usuario no se encuentre en la audiencia en el momento en que realice el evento desencadenante, lo que significa que no recibirá la campaña ni entrará en el Canvas.
Probar tu audiencia
Después de añadir segmentos y filtros a tu público objetivo, puedes comprobar si tu audiencia está configurada como se espera buscando un usuario para confirmar si coincide con los criterios de audiencia.
Seleccionar controles de entrada
Los controles de entrada determinan si los usuarios pueden volver a entrar en un Canvas. También puedes limitar el número de personas que pueden entrar en este Canvas con una cadencia seleccionada dependiendo de tu tipo de programación de entrada:
- Programado: Tiempo de vida del Canvas o cada vez que el Canvas está programado
- Basado en acciones: Por hora, diariamente o durante el tiempo de vida del Canvas
- Activado por API: Por hora, diariamente o durante el tiempo de vida del Canvas
Por ejemplo, si tienes un Canvas programado y seleccionas Limitar volumen de entrada y estableces el campo Máximo de entradas en 500.000 usuarios con Cada vez que el Canvas está programado como cadencia límite, entonces el Canvas solo envía a 500.000 usuarios por envío programado.


Braze no recomienda seleccionar Cada vez que el Canvas está programado para el calentamiento de IP, ya que esto puede provocar un aumento en los volúmenes de envío.
Configurar criterios de salida
Configurar los criterios de salida determina qué usuarios deseas que salgan de un Canvas. Si un usuario realiza el evento de excepción o coincide con los segmentos y filtros, no recibirá más mensajes.
Calcular la población objetivo
En la sección Población objetivo, puedes ver un resumen de tu audiencia, como tus segmentos seleccionados y filtros adicionales, y un desglose de cuántos usuarios son alcanzables por canal de mensajería. Para calcular el número exacto de usuarios alcanzables en tu público objetivo en lugar de la estimación predeterminada, selecciona Calcular estadísticas exactas.
Ten en cuenta que:
- Calcular estadísticas exactas puede tardar unos minutos en ejecutarse. Esta función solo calcula las estadísticas exactas a nivel de segmento, no a nivel de filtro o grupo de filtros.
- Mientras las estadísticas exactas se cargan, puede aparecer una estimación redondeada. La cifra exacta aparece en la sección Usuarios alcanzables cuando se ha cargado. Puedes seleccionar Mostrar estadísticas adicionales para un desglose detallado.
- Para segmentos grandes, es normal ver ligeras variaciones incluso al calcular estadísticas exactas. Se espera que la precisión de esta característica sea del 99,999% o superior.
Para ver estadísticas adicionales, como los ingresos promedio del tiempo de vida de los usuarios objetivo, selecciona Mostrar estadísticas adicionales.
Por qué el recuento del público objetivo podría diferir del recuento de usuarios alcanzables
El tamaño de la población objetivo que se muestra en una Campaign o Canvas puede diferir del tamaño de la audiencia alcanzable para un segmento, incluso si estás añadiendo directamente ese segmento a tu Campaign o Canvas sin filtros adicionales. Esto puede ocurrir por varias razones:
- Cuando un grupo de control global se aplica a una Campaign o Canvas, los usuarios de ese grupo de control global quedan excluidos del recuento de usuarios alcanzables.
- El tamaño de la población objetivo en una Campaign o Canvas excluye a los usuarios con los que no se puede contactar a través de varios canales de mensajería; el comportamiento difiere de un canal a otro. Por ejemplo, la audiencia alcanzable para una Campaign o Canvas excluye a los usuarios que han cancelado su suscripción, han sido marcados como correo no deseado (en el caso de los correos electrónicos) o han tenido un rebote duro (en el caso de los correos electrónicos). El segmento en sí, sin embargo, solo excluye las cancelaciones de suscripción cuando muestra el número estimado de usuarios alcanzables por correo electrónico.
- Braze solo envía mensajes SMS a usuarios dentro del grupo de suscripción seleccionado, por lo que la población objetivo de SMS para una Campaign o Canvas también excluirá a cualquier usuario que no forme parte de tu grupo de suscripción seleccionado.
Paso 4: Selecciona la configuración de envío
Selecciona Configuración de envío para editar tu configuración de suscripción, activar la limitación de velocidad y activar las horas tranquilas. Al activar la limitación de velocidad o la limitación de frecuencia, puedes aliviar la presión de marketing sobre tus usuarios y asegurarte de que no les envías demasiados mensajes.
Para Canvas dirigidos a canales de correo electrónico y push, es posible que desees limitar tu Canvas para que solo los usuarios que hayan optado explícitamente por la adhesión voluntaria reciban el mensaje (excluyendo a los usuarios suscritos o cancelados). Por ejemplo, supongamos que tienes tres usuarios con diferentes estados de adhesión voluntaria:
- Usuario A está suscrito al correo electrónico y tiene push habilitado. Este usuario no recibe el correo electrónico, pero sí recibirá el push.
- Usuario B ha aceptado recibir correo electrónico, pero no tiene push habilitado. Este usuario recibirá el correo electrónico, pero no recibirá el push.
- Usuario C ha aceptado recibir correo electrónico y tiene push habilitado. Este usuario recibirá tanto el correo electrónico como el push.
Para hacerlo, configura los Ajustes de suscripción para enviar este Canvas “solo a usuarios con adhesión voluntaria”. Esta opción garantiza que solo los usuarios con adhesión voluntaria reciban tu correo electrónico, y Braze solo envía tu push a los usuarios que tienen el push habilitado de forma predeterminada.
Estos ajustes de suscripción se aplican paso a paso, lo que significa que no tienen efecto en el público de entrada. Por lo tanto, este ajuste se utiliza para evaluar la elegibilidad de un usuario para recibir cada paso en Canvas.

Con esta configuración, no incluyas ningún filtro en el paso Público objetivo que limite la audiencia a un solo canal (por ejemplo, Foreground Push Enabled = True o Email Subscription = Opted-In).
Puedes optar por especificar horas tranquilas (el periodo durante el cual no se envían tus mensajes) para tu Canvas. Activa Habilitar horas tranquilas en tu Configuración de envío. A continuación, selecciona tus horas tranquilas en la hora local de tu usuario y si el mensaje debe cancelarse o enviarse en el siguiente horario disponible.
Cuando se selecciona Enviar en el siguiente horario disponible, las horas tranquilas suprimen el mensaje y lo envían en el siguiente horario disponible fuera de las horas tranquilas. Por ejemplo, supongamos que las horas tranquilas están configuradas para evitar que se envíen mensajes entre las 11:30 a.m. y las 2:30 p.m. en la hora local del usuario, y un usuario entra en un paso de mensaje a las 11:35 a.m. Dado que esta hora está dentro de las horas tranquilas, el mensaje aún no se envía, y el usuario recibe el paso de mensaje a las 2:30 p.m., que es después de las horas tranquilas.
Paso 5: Construye el recorrido

Ahorra tiempo comenzando desde una plantilla de Canvas de Braze. Explora la biblioteca en busca de una plantilla que se ajuste a tu caso de uso y luego personalízala. Para más información, consulta Plantillas de Canvas.
Paso 5.1: Añadir variantes
Selecciona Añadir variante y luego añade una nueva variante a tu Canvas. Las variantes representan un recorrido que siguen tus usuarios y pueden contener varios pasos y ramas.
Puedes añadir variantes adicionales seleccionando el botón de más. Cuando añades nuevas variantes, puedes ajustar cómo se distribuyen tus usuarios entre ellas para comparar y analizar la eficacia de diferentes estrategias de participación.

De forma predeterminada, la asignación de variantes en Canvas usa un hash determinístico del ID de usuario y el ID de Canvas (no el número de contenedor aleatorio del usuario). Un usuario permanece en la misma variante al reingresar si los porcentajes de distribución no cambian. Si los porcentajes cambian después del lanzamiento, los usuarios que reingresen pueden recibir una variante diferente.
Para una asignación que permanezca fija cuando cambien los porcentajes, usa una sola variante, almacena un número aleatorio con un paso de Actualización de usuario y luego dirige a los usuarios con Rutas de audiencia. Expande los siguientes pasos para ver el patrón completo.
Expandir para ver los pasos
- Crea un atributo personalizado de tipo Número para almacenar tu número aleatorio. Ponle un nombre fácil de localizar, como
lottery_numberorandom_assignment. En tu panel, ve a Configuración de datos > Atributos personalizados. - Usa una sola variante en Canvas (o añade el mismo paso de Actualización de usuario a cada variante). Añade un paso de Actualización de usuario al inicio del recorrido. Este paso genera y almacena el número aleatorio antes de que los usuarios lleguen a tu paso de Rutas de audiencia.
- En el paso de Actualización de usuario, selecciona el Editor JSON avanzado. Usa la etiqueta {% random %} para generar el número. Para más detalles, consulta Enviar mensajes con un número aleatorio. Por ejemplo,
{% random 10 %}devuelve un entero del 0 al 9. Configura el atributo personalizado del paso 1 usando un JSON como este:
{% if {{custom_attribute.${lottery_number}}} == blank %} {% capture lottery_number_str %}{% random 10 %}{% endcapture %} { "attributes": [ { "lottery_number": {{ lottery_number_str | plus: 0 }} } ] } {% endif %}
El bloque {% if %} establece el número solo cuando el atributo está vacío, de modo que los usuarios mantienen la misma asignación cuando reingresan al Canvas.
- Añade un paso de Rutas de audiencia después del paso de Actualización de usuario. En cada grupo de audiencia, añade filtros basados en tu atributo personalizado en lugar de usar porcentajes de distribución de variantes.
Por ejemplo, si usaste{% random 10 %}, un grupo podría usarlottery_numberes menor que 4, otro es mayor que 3 y menor que 7, y un tercero es mayor que 6 y menor que 10.
Paso 5.2: Añadir pasos
Puedes añadir más pasos a tu flujo de trabajo en Canvas arrastrando y soltando componentes desde la barra lateral de Componentes. O bien, selecciona el botón de más para añadir un componente con el menú emergente. Para ver una lista completa de componentes, consulta Componentes de Canvas.

Puedes añadir hasta 200 pasos en un Canvas. Si tu Canvas supera los 200 pasos, pueden producirse problemas de carga. Los nombres de los pasos pueden tener hasta 256 caracteres.
A medida que añades más pasos, puedes cambiar el nivel de zoom para centrarte en los detalles o ver el recorrido completo del usuario. Acerca con Shift + + o aleja con Shift + -.
Duración máxima
La duración máxima es el tiempo más largo posible que un usuario puede tardar en completar el Canvas. Braze la calcula sumando las demoras y las ventanas de activación a lo largo de la ruta más larga. Por ejemplo, un paso de Demora de 3 días seguido de un paso de Mensaje tiene una duración máxima de 3 días.
Editar un paso
Selecciona cualquier componente para editarlo. Por ejemplo, selecciona un paso de Demora para cambiar la demora a un día específico, como el 1 de marzo. Ese día, los usuarios avanzan al siguiente paso.
También puedes editar la Configuración de acción de un paso de Rutas de Acción para retener a los usuarios durante una ventana de evaluación y priorizar su siguiente ruta en función de las acciones realizadas en esa ventana.
Mensajes en Canvas
Usa un paso de Mensaje para enviar correos electrónicos, push para móviles, notificaciones push web o mensajes de webhook. Selecciona tus Canales de mensajería, ajusta la Configuración de entrega y personaliza el texto con Liquid.
Para datos de entrada y propiedades de evento en Liquid, consulta Propiedades de contexto y de evento. Selecciona Listo cuando termines de configurar el paso.
Paso 5.3: Editar conexiones
Para mover una conexión entre pasos, selecciona la flecha que conecta los dos componentes y selecciona un componente diferente. Para eliminar la conexión, selecciona la flecha y luego Cancelar conexión en el pie del creador de Canvas.
Si una sola variante tiene varias ramas con la misma audiencia y hora de envío, Braze no garantiza una división uniforme entre esas ramas. La distribución puede favorecer a la rama que se creó primero. Para una división uniforme, usa filtros de Número de contenedor aleatorio en cada rama. Para más información, consulta ¿Qué sucede si la audiencia y la hora de envío son idénticas para un Canvas que tiene una variante, pero varias ramas?.
Paso 6: Añade un grupo de control
Puedes añadir un grupo de control a tu Canvas seleccionando el botón más para añadir una nueva variante.
Braze realiza un seguimiento de las conversiones de los usuarios que se colocan en el grupo de control, aunque no reciban ningún mensaje. Para mantener la precisión de la prueba, Braze realiza un seguimiento del número de conversiones de tus variantes y del grupo de control durante exactamente el mismo periodo de tiempo, como se muestra en la pantalla de selección del evento de conversión.
Puedes ajustar la distribución entre tus mensajes seleccionando los encabezados Nombre de la variante.
Optimiza las variantes en Canvas con BrazeAI
En un Canvas con varias variantes de nivel superior, activa Optimizar con BrazeAI (que aparece como Selección inteligente en algunos espacios de trabajo) para ajustar automáticamente el porcentaje de usuarios que entran en cada variante. BrazeAI utiliza el rendimiento de las variantes para maximizar el número esperado de conversiones.
Añade al menos dos variantes y un evento de conversión. Después, selecciona el porcentaje de una variante para abrir Editar distribución de variantes y activa Optimizar con BrazeAI.
Una vez transcurrido el plazo inicial de conversión, BrazeAI revisa el rendimiento cada 12 horas y dirige más usuarios hacia la variante que genera más conversiones. Cuando la optimización identifica una variante ganadora clara, todos los futuros usuarios elegibles entran en esa variante.
Esta optimización funciona mejor en los Canvas en los que entran usuarios nuevos con frecuencia.
Paso 7: Guardar y lanzar
Revisa el resumen del Canvas y luego selecciona Lanzar Canvas para guardarlo y lanzarlo. Si tienes activado el flujo de trabajo de aprobación de Canvas, aprueba los detalles del Canvas indicados antes del lanzamiento. Después del lanzamiento, consulta los análisis en la página Detalles del Canvas.

Para editar un Canvas después del lanzamiento, consulta Editar Canvas después del lanzamiento.