Preguntas frecuentes

Este artículo ofrece respuestas a algunas preguntas frecuentes sobre Canvas.

Creación y edición de Canvas

¿Cuántos pasos puedo incluir en un Canvas?

Puedes añadir hasta 200 pasos en un Canvas.

¿Hay límites de tamaño para las propiedades de entrada de Canvas?

Sí. El objeto de contexto de Canvas (propiedades de entrada de Canvas) tiene un tamaño máximo de 50 KB. Mantén las cargas útiles lo más pequeñas posible dentro de ese límite. Para saber cómo funcionan las propiedades de entrada y de evento en Canvas, consulta Propiedades de contexto y evento.

¿Por qué veo un error “Too many Canvas branches”?

Este error aparece cuando la combinación de ramificación de pasos y el tamaño del público de entrada puede causar problemas de rendimiento del clúster que impidan el envío de mensajes. Para conocer los pasos de resolución, como el uso de Rutas de Audiencia, la reducción de ramificaciones o del tamaño de la audiencia, y la reconstrucción en Canvas Flow, consulta Error “Too many Canvas branches”.

¿Puedo usar Optimizar con BrazeAI^TM con la reelegibilidad en un Canvas?

Sí. Los Canvas pueden usar Optimizar con BrazeAI^TM cuando la reelegibilidad está habilitada. Braze no puede garantizar la misma variante en el reingreso porque la asignación cambia con el tiempo. Las Campaigns requieren una ventana de reelegibilidad de 24 horas o más cuando Optimizar con BrazeAI^TM está activado.

¿Cuál es la diferencia entre un componente y un paso?

Un componente es una parte individual de tu Canvas que puedes utilizar para determinar la efectividad de tu Canvas. Los componentes pueden incluir acciones como dividir el recorrido del usuario, añadir un retraso e incluso probar múltiples rutas de Canvas. Un paso en Canvas se refiere al recorrido personalizado del usuario en las ramas de tu Canvas. Esencialmente, tu Canvas está compuesto de componentes individuales que crean pasos para el recorrido del usuario.

¿Puedo lanzar un Canvas con pasos desconectados?

Sí. También puedes guardar Canvas después del lanzamiento con pasos desconectados.

¿A dónde van los usuarios cuando llegan a un paso desconectado?

Si un usuario se encuentra en un paso desconectado del flujo de trabajo de tu Canvas, avanzará al paso siguiente si existe uno, y la configuración del paso determinará cómo debe avanzar el usuario. Esto tiene como objetivo permitir a los usuarios realizar cambios en los pasos sin tener que conectarlos directamente con el resto del Canvas. Esto también te da margen para probar antes de poner en producción inmediatamente, lo que permite guardar un borrador de manera efectiva.

Te recomendamos revisar la vista de análisis de los usuarios pendientes en un paso de Canvas antes de desconectar un paso.

¿Qué ocurre si la audiencia y la hora de envío son idénticas para un Canvas que tiene una variante, pero múltiples ramas?

Ponemos en cola un trabajo para cada paso; se ejecutan aproximadamente al mismo tiempo, y uno de ellos “gana”. En la práctica, esto puede distribuirse de manera algo uniforme, pero es probable que haya al menos un ligero sesgo hacia el paso que se creó primero.

Además, no podemos garantizar exactamente cómo será esa distribución. Si deseas una división uniforme, añade un filtro de número de contenedor aleatorio.

¿Cómo se evalúan las audiencias de Canvas?

De forma predeterminada, los filtros y Segments para los pasos completos en Canvas se verifican en el momento del envío. El paso de división de decisiones realiza una evaluación justo después de recibir un paso anterior (o antes de un retraso).

¿Cuándo se activa un evento de excepción?

Los eventos de excepción solo se activan mientras el usuario está esperando recibir el componente de Canvas con el que está asociado. Si un usuario realiza una acción con antelación, el evento de excepción no se activará. Si deseas excluir a los usuarios que ya hayan realizado un determinado evento con anterioridad, usa filtros en su lugar.

¿Cómo afecta la edición de un Canvas a los usuarios que ya están en el Canvas?

Si editas algunos de los pasos de un Canvas de múltiples pasos, los usuarios que ya estaban en la audiencia pero que no han recibido los pasos recibirán la versión actualizada del mensaje. Ten en cuenta que esto solo ocurrirá si aún no han sido evaluados para ese paso.

Para más información sobre lo que puedes editar después del lanzamiento, consulta Cambiar tu Canvas después del lanzamiento.

¿Qué sucede cuando detienes un Canvas?

Cuando detienes un Canvas, se aplica lo siguiente:

• Se impedirá que los usuarios entren en el Canvas.
• No se enviarán más mensajes, independientemente de en qué punto del flujo se encuentre un usuario.
• Excepción: los Canvas con correos electrónicos no se detendrán de inmediato. Una vez que las solicitudes de envío llegan a SendGrid, no hay nada que podamos hacer para evitar que se entreguen al usuario.

¿Debo crear un Canvas o Canvas separados por ciclo de vida del usuario?

Dependiendo de lo que busques lograr con tu Canvas, es posible que necesites diferentes enfoques en la forma en que construyes el recorrido del usuario. La flexibilidad de Canvas te permite mapear recorridos del usuario para cualquier etapa del ciclo de vida del usuario. Consulta nuestras plantillas de Braze Canvas para ver varios ejemplos de enfoques simplificados para crear recorridos de usuario efectivos.

Mensajes y entrega

¿Cuándo se envían los mensajes dentro de la aplicación en Canvas?

Los mensajes dentro de la aplicación se envían al inicio de la siguiente sesión. Esto significa que si el usuario entra en el paso de Canvas antes de que el Canvas se detenga, seguirá recibiendo el mensaje dentro de la aplicación en el siguiente inicio de sesión, siempre y cuando el mensaje dentro de la aplicación no haya caducado.

Es posible que un usuario inicie una sesión antes de que el Canvas se detenga, pero no vea el mensaje dentro de la aplicación de inmediato. Esto puede ocurrir si el mensaje dentro de la aplicación se activa mediante un evento personalizado o tiene un retraso. Esto significa que es posible que un usuario registre una impresión de mensaje dentro de la aplicación y “reciba” el mensaje dentro de la aplicación después de que el Canvas se haya detenido. Sin embargo, el usuario habría tenido que iniciar la sesión antes de que el Canvas se detuviera, pero después de haber recibido el paso de Canvas.

¿Por qué un Canvas puede mostrar cero envíos aunque se registren impresiones?

Si Mensajes enviados siempre muestra cero para un Canvas que contiene un paso de mensaje dentro de la aplicación, esto se debe a que la entrega de mensajes dentro de la aplicación funciona de manera diferente a la de otros canales de mensajería.

Los mensajes dentro de la aplicación son “solicitados” por el SDK, en lugar de ser “enviados” desde Braze. Los mensajes dentro de la aplicación para usuarios elegibles se entregan automáticamente al inicio de la sesión y “esperan” el evento desencadenante antes de mostrarse. Dado que los usuarios elegibles reciben el mensaje cuando inician una sesión, Braze no reporta esto como un evento de envío. Cuando los usuarios realizan el evento desencadenante, el mensaje se muestra y Braze registra una impresión y marca el paso de Canvas (o Campaign) como recibido en el perfil del usuario. En consecuencia, el total de Envíos es cero para los mensajes dentro de la aplicación.

¿Por qué los usuarios no recibieron mi mensaje dentro de la aplicación después de un retraso largo o una rama?

Después de que se completan los pasos de Retraso anteriores y las verificaciones de audiencia, los usuarios se vuelven elegibles para un mensaje dentro de la aplicación solo cuando alcanzan el paso de Mensaje. Si el mensaje caduca en una fecha del calendario o en una ventana corta de duración después de que el paso esté disponible, los usuarios en ramas más lentas pueden llegar después de la caducidad y nunca ver el mensaje. Alinea la caducidad con los retrasos más largos y realistas de tu recorrido. Para más información y ejemplos, consulta Caducidad de mensajes dentro de la aplicación.

¿Por qué veo “Canvas Entry Properties may not be used in In-App Messages.”?

Este mensaje aparece cuando la personalización hace referencia a campos que los mensajes dentro de la aplicación no pueden resolver en Canvas. Usa el objeto context como se describe en Contexto y propiedades del evento y Paso de mensaje. El espacio de nombres Liquid heredado canvas_entry_properties tiene restricciones diferentes a context. Si necesitas que los valores persistan a lo largo de varios pasos, revisa las propiedades persistentes en el editor original de Canvas con tu equipo de Braze. Los valores almacenados se borran cuando un usuario sale del Canvas antes de que el dispositivo descargue la carga útil del mensaje dentro de la aplicación.

¿Dónde puedo encontrar los clics de botones para mensajes dentro de la aplicación de arrastrar y soltar en Canvas?

Las métricas a nivel de botón para los mensajes dentro de la aplicación de arrastrar y soltar aparecen en la tarjeta de análisis del paso de Mensaje en Detalles de Canvas, no solo en el resumen de alto nivel de Canvas. Abre el Canvas, selecciona el paso de Mensaje y revisa la participación del mensaje dentro de la aplicación ahí. Para conceptos de informes, consulta Análisis de Canvas.

¿Puedo programar diferentes horarios de envío para cada variante en el mismo paso de Mensaje de Canvas o envío multivariante?

No. Las variantes en la misma configuración multivariante o paso de Mensaje comparten un solo programa de entrega. No puedes asignar una variante para que se envíe a las 6 p.m. y otra a las 7 p.m. para ese mismo envío programado.

Para escalonar envíos o usar diferentes horarios por ruta, prueba los siguientes métodos:

• Pasos de Mensaje separados con pasos de Retraso entre ellos para que cada mensaje tenga su propio programa.
• Usa ramas o un paso de recorrido de experimentos para que los usuarios sigan rutas con diferentes tiempos.
• Campaigns separadas si el caso de uso no necesita permanecer dentro de un solo Canvas.

Para conceptos de pruebas multivariantes y A/B en Campaigns, consulta Pruebas multivariantes y A/B.

¿Qué sucede si un usuario tiene limitación de frecuencia global en un paso de Mensaje de Canvas?

No recibirá ese envío para el canal limitado, pero los pasos de Mensaje aún hacen avanzar a los usuarios cuando no se envía un mensaje debido a la limitación de frecuencia global. Para los casos de avance paso a paso, consulta Cómo avanzan los usuarios. La limitación de frecuencia global por sí sola no saca a los usuarios de un Canvas; ese comportamiento es independiente de las Validaciones de entrega en un paso de Mensaje. Para más detalles, consulta Límite de velocidad y limitación de frecuencia.

¿Por qué los envíos son menores que el tamaño estimado de la audiencia?

Los envíos pueden ser menores que la Audiencia estimada por muchas de las mismas razones que en las Campaigns, incluyendo límites de frecuencia, filtros estrictos de dispositivo o navegador, ventanas de reelegibilidad, límites de velocidad y exclusiones a nivel de canal (por ejemplo, alcanzabilidad de push o verificaciones de suscripción y capacidad de entrega de correo electrónico).

Los factores específicos de Canvas también aplican:

• Entrada basada en acciones o desencadenada por API: los usuarios solo entran (y reciben pasos) después de realizar el comportamiento de entrada, por lo que los envíos realizados van detrás de la estimación inicial hasta que esas acciones ocurran.
• Rutas de audiencia: los usuarios se dirigen a la rama de mayor prioridad para la que califican, por lo que las ramas posteriores pueden recibir menos usuarios de lo que sugiere un conteo de Segment simple.
• Verificaciones de audiencia y hora de envío: los pasos completos reevalúan los filtros en el momento del envío a menos que configures lo contrario. Los usuarios que calificaron cuando se creó el Canvas pueden salir antes de que se envíe un mensaje.
• Grupos de control: los grupos de control global o de Canvas retienen una parte de los entrantes de la mensajería.
• Horas tranquilas y retrasos: los mensajes pueden retenerse o reprogramarse, desplazando los envíos fuera de la ventana de informes que estás viendo.
• Límites máximos de entrada o audiencia: los límites de entrada o envío detienen a usuarios adicionales incluso cuando el Segment subyacente es más grande.
• Ventana de informes: el rango de análisis puede no incluir todos los envíos que estás comparando con la estimación.

¿Por qué la audiencia estimada y los conteos de usuarios de Canvas no coinciden?

La Audiencia estimada refleja quién coincide con tu Segment y filtros de entrada en el momento en que se ejecuta la estimación. Después de ese momento, las entradas retrasadas o basadas en acciones, la reelegibilidad, los desencadenadores de API o el enrutamiento por ramas pueden aumentar la cantidad de perfiles que tocan el recorrido en comparación con la instantánea. Los usuarios también pueden salir cuando los filtros de hora de envío fallan, lo que reduce las entradas o envíos realizados. Compara los tiempos, límites y configuraciones de evaluación junto con ¿Por qué los envíos son menores que el tamaño estimado de la audiencia?.

¿Por qué los Destinatarios únicos son más que la cantidad de usuarios a los que me dirigí?

Destinatarios únicos puede ser mayor que la audiencia que esperabas porque Braze registra destinatarios diarios únicos para los informes de Canvas y Campaigns. Esto permite una atribución de conversión precisa cada vez que un usuario recibe un mensaje en el recorrido.

Por ejemplo, si un usuario recibe un paso de Canvas el lunes y de nuevo el viernes y convierte después de cada envío, Braze puede contar dos filas de destinatarios y dos conversiones dentro del alcance. Con entradas recurrentes o reelegibilidad, el mismo pequeño conjunto de perfiles puede producir múltiples Destinatarios únicos a lo largo de varios días.

¿Por qué mi Canvas tiene tasas de envío más bajas?

Si notas que tu Canvas programado diariamente envía a menos usuarios con el tiempo, verifica lo siguiente:

• Comprueba si la reelegibilidad está activada: sin reelegibilidad, Braze ingresa a cada usuario en el Canvas una sola vez. En Canvas programados diariamente, solo los usuarios que coinciden con la audiencia y que aún no han entrado en el Canvas son elegibles para cada entrada. A medida que más usuarios entran, cada entrada posterior tiene menos usuarios elegibles, por lo que el volumen de entradas disminuye.
• Comprueba si la audiencia tiene membresía fija: las audiencias construidas a partir de una lista fija de usuarios (como una importación de CSV usada como filtro de Segment) no ganan nuevos miembros automáticamente. Sin nuevos entrantes, el volumen de entradas no puede recuperarse a medida que los usuarios ingresan al Canvas.

Para límites de velocidad de entrega y otros factores que reducen los envíos en una ocurrencia individual, consulta ¿Por qué los envíos son menores que el tamaño estimado de la audiencia?.

¿Por qué un Segment de grupo de control pequeño muestra cambios en la membresía histórica?

Los gráficos de membresía histórica utilizan muestras estimadas, por lo que los Segments pequeños, incluidos los Segments del grupo de control global, pueden mostrar movimiento día a día incluso cuando la audiencia subyacente es estable. Para comprender cómo funcionan las estimaciones y por qué los gráficos pueden fluctuar, consulta Ver el tamaño histórico de membresía de Segment.

Análisis y conversiones

¿Cómo atribuye las conversiones de Canvas el panel de Conversiones?

El panel de Conversiones atribuye las conversiones de Canvas según el método de atribución que selecciones (por ejemplo, Upon Receipt, Upon Send, Upon Open o Upon Click). Para que un usuario aparezca en el informe, debe entrar en el Canvas o Campaign, registrar el método de atribución seleccionado y realizar el evento de conversión dentro de la configuración de tu informe.

Para las reglas de conversión a nivel de paso y de variante en los análisis de Canvas, consulta ¿Cómo se rastrean las conversiones de los usuarios en un Canvas?.

¿Cómo se rastrean las conversiones de los usuarios en un Canvas?

Un usuario solo puede convertir una vez por entrada a un Canvas. Las conversiones se asignan al mensaje más reciente recibido por el usuario en esa entrada. El bloque de resumen al inicio de un Canvas refleja todas las conversiones realizadas por los usuarios dentro de esa ruta, independientemente de si recibieron un mensaje. Cada paso posterior solo mostrará las conversiones que ocurrieron mientras ese era el paso más reciente que el usuario recibió.

Expandir para ver ejemplos

Ejemplo 1

Hay una ruta de Canvas con 10 notificaciones push y el evento de conversión es “inicio de sesión” (“Abre la aplicación”):

• El usuario A abre la aplicación después de entrar, pero antes de recibir el primer mensaje.
• El usuario B abre la aplicación después de cada notificación push.

Resultado: El resumen mostrará dos conversiones, mientras que los pasos individuales mostrarán una conversión de uno en el primer paso y cero para todos los pasos posteriores.

Nota

Si las horas tranquilas están activas cuando ocurre el evento de conversión, se aplican las mismas reglas.

Ejemplo 2

Hay un Canvas de un solo paso con horas tranquilas habilitadas:

1. El usuario entra en el Canvas.
2. El primer paso no tiene un retraso, pero se encuentra dentro de las horas tranquilas configuradas, por lo que el mensaje se suprime.
3. El usuario realiza el evento de conversión.

Resultado: El usuario se contará como convertido en la variante general del Canvas, pero no en el paso, ya que no recibió el paso.

¿Cuál es la diferencia entre los distintos tipos de tasa de conversión?

• Las conversiones totales de Canvas reflejan cuántos usuarios únicos completaron un evento de conversión, no cuántas conversiones completó cada uno.
• La tasa de conversión de la variante o el bloque de resumen al inicio de un Canvas refleja todas las conversiones realizadas por los usuarios dentro de esa ruta, independientemente de si recibieron un mensaje, como un total agregado.
• La tasa de conversión del paso refleja cuántas personas recibieron ese paso de mensaje y completaron cualquiera de los eventos de conversión descritos.

¿Por qué la tasa de conversión de mi paso en Canvas no es igual a la tasa de conversión total de mi variante en Canvas?

Es común que el total de conversiones de una variante en Canvas sea mayor que la suma de los totales de sus pasos. Esto ocurre porque un usuario puede realizar un evento de conversión para una variante tan pronto como entra en ella. Sin embargo, este mismo evento de conversión no se cuenta para un paso en Canvas. Así, cualquier usuario que entre en el Canvas y realice el evento de conversión antes de recibir el primer paso en Canvas se cuenta para el total de conversiones de la variante y no para el total del paso. Lo mismo aplica para un usuario que entra en el Canvas pero sale antes de recibir algún paso.

Ten en cuenta que también es posible que un usuario entre en una variante, no reciba ningún mensaje de un paso y luego convierta. En este caso, no se registra una conversión a nivel de paso. Sin embargo, dado que el usuario técnicamente convirtió, se registra una conversión a nivel del Canvas.

¿Cómo puedo confirmar si mis usuarios recibieron un Canvas activado por API?

Puedes crear un segmento usando un filtro de Canvas para confirmar si los usuarios entraron en el Canvas o recibieron un paso específico del Canvas. Por ejemplo, usa un filtro de entrada al Canvas si deseas confirmar que los usuarios entraron en el Canvas activado por API, o un filtro de paso recibido si deseas confirmar que recibieron un mensaje del Canvas. Luego, usa el endpoint /users/export/segment para exportar los usuarios en ese segmento.

¿Puedo eliminar un Canvas?

No, pero puedes archivar un Canvas.

¿Cómo reanudo un Canvas o Campaign archivado?

Los mensajes archivados no se envían hasta que los devuelvas a un estado editable. Desarchiva el Campaign o Canvas, configura la programación de entrada o el horario de envío a una ventana futura (o duplica el recorrido si necesitas una copia limpia), y luego selecciona Reanudar o lanza según sea necesario. Consulta Archivar Campaigns y Canvas.

¿Por qué mi Canvas no se guarda cuando no aparece ningún error?

Los filtros vacíos de Custom attribute en la audiencia o en los filtros a nivel de paso pueden bloquear el guardado sin un mensaje de validación detallado. Abre cada tarjeta de filtro, elimina las reglas de atributo personalizado incompletas o introduce tanto el nombre del atributo como el valor, y luego selecciona Save de nuevo.

¿Por qué desapareció una etiqueta de mi Canvas o Campaign?

Cuando una etiqueta se elimina de tu espacio de trabajo, Braze la elimina de cada Campaign y Canvas que la referenciaba. Esa limpieza no siempre genera su propia línea en el registro de cambios del Canvas.

¿Cómo puedo ver los análisis de cada uno de mis componentes de Canvas?

Para ver los análisis de un componente de Canvas, ve a tu Canvas y desplázate hacia abajo en la página Canvas Details. Aquí puedes ver los análisis de cada componente. Consulta Análisis de Canvas para más detalles.

¿Cuándo es visible la interacción de un paso en Canvas en el perfil de un usuario?

Los filtros como Received Message from Canvas Step se actualizan después de que Braze registra el evento de envío, recepción o interacción correspondiente para ese paso. Los mensajes dentro de la aplicación pueden registrar impresiones de forma separada de las métricas de tipo envío. Consulta ¿Por qué un Canvas puede mostrar cero envíos aunque se registren impresiones?. Esos mismos eventos aparecen en las métricas de paso en Canvas Details.

Al observar el número de usuarios únicos, ¿qué es más preciso: los análisis de Canvas o el segmentador?

El segmentador es una estadística más precisa para los datos de usuarios únicos en comparación con las estadísticas de Canvas o Campaign. Esto se debe a que las estadísticas de Canvas y Campaign son números que Braze incrementa cuando algo ocurre, lo que significa que hay variables que podrían resultar en que este número sea diferente al del segmentador. Por ejemplo, los usuarios pueden convertir más de una vez para un Canvas o Campaign.

¿Por qué el número de usuarios que entran en un Canvas no coincide con el número esperado?

El número de usuarios que entran en un Canvas puede diferir del número esperado debido a cómo se evalúan las audiencias y los desencadenadores. En Braze, una audiencia se evalúa antes del desencadenador (a menos que se use un desencadenador de cambio en atributo). Esto hará que los usuarios salgan del Canvas si no forman parte de la audiencia seleccionada antes de que se evalúen las acciones desencadenantes.

¿Qué ocurre con los usuarios anónimos durante su recorrido en Canvas?

Aunque los usuarios anónimos pueden entrar y salir de Canvas, sus acciones no se asocian con un perfil de usuario específico hasta que se identifican, por lo que sus interacciones pueden no rastrearse completamente en tus análisis. Puedes usar el Generador de consultas para generar un informe de estas métricas.

¿Puedo excluir a los usuarios que están actualmente en un recorrido de Canvas de un Campaign o Segment?

Usa filtros de segmentación como Entered Canvas Variation, In Canvas Control Group o Received Message from Canvas Step para segmentar usuarios según la entrada al Canvas, la asignación de variante o la interacción con un paso. Estos filtros evalúan el historial de entradas e interacciones; no indican si un usuario aún está progresando a través de un recorrido activo.

Para incluir o excluir usuarios según su participación activa en Canvas, añade pasos de Actualización de usuario en la entrada y salida del Canvas para establecer y borrar atributos personalizados, y luego filtra por esos atributos en Campaigns o Segments.

Segmentación

¿Cuál es la diferencia entre “No ha entrado en la variante de Canvas” y “No está en el grupo de control de Canvas”?

Consulta Filtros de segmentación para ver las definiciones completas de los filtros.

No ha entrado en la variante de Canvas

El usuario nunca entró en una ruta de variante de un Canvas específico. Se incluyen todos los usuarios que no están en el grupo de control, independientemente de si han entrado en el Canvas. Esto incluye a los usuarios que entraron en otra variante y a los usuarios que no han entrado en ninguna variante.

No está en el grupo de control de Canvas

El usuario entró en el Canvas, pero no está en el grupo de control y, en consecuencia, recibió una variante. Esto solo incluye a los usuarios que entraron en el Canvas.

Ten en cuenta que la asignación de variantes se produce en la entrada al Canvas. Si un usuario no ha entrado en un Canvas, no se le asignará ninguna variante. En otras palabras, no estará en el grupo de control ni en una variante.

Editor de Canvas original

Ampliar para ver las preguntas frecuentes del editor de Canvas original

¿Cómo convierto un Canvas existente del editor original al editor actual?

Puedes clonar tu Canvas. Esto crea una copia de tu Canvas original en el flujo de trabajo de Canvas más reciente.

¿Cuáles son las principales diferencias entre los editores de Canvas actual y original?

Barra de herramientas de componentes de Canvas

Anteriormente, con el editor de Canvas original, se añadía un paso completo de forma predeterminada cada vez que creabas cualquier paso en el recorrido del usuario. Estos pasos completos se reemplazan por diferentes componentes de Canvas, lo que te brinda el beneficio de mayor visibilidad y personalización para tu experiencia de edición. Puedes ver inmediatamente todos tus componentes de Canvas desde la barra de herramientas de pasos de Canvas.

Comportamiento de los pasos

Anteriormente, cada paso completo incluía información como configuración de retraso y programación, eventos de excepción, filtros de audiencia, configuración de mensajes y opciones de avance de mensajes, todo en un solo componente. En el editor actual, estas configuraciones están separadas para hacer tu experiencia de creación de Canvas más personalizable, e introduce algunas diferencias en la funcionalidad.

Avance del componente de mensaje

Los componentes de mensaje hacen avanzar a todos los usuarios que entran en el paso. No hay necesidad de especificar el comportamiento de avance del mensaje, lo que simplifica la configuración del paso en general. Si deseas implementar la opción Avanzar cuando se envíe el mensaje, añade una ruta de audiencia separada para filtrar a los usuarios que no recibieron el paso anterior.

Comportamiento del retraso “en”

Los componentes de retraso esperarán el tiempo de retraso completo antes de pasar al siguiente paso.

Supongamos que el 12 de abril tenemos un componente de retraso donde el retraso está configurado para enviar a tu usuario al siguiente paso en un día a las 2 pm. Un usuario entra al componente a las 2:01 pm el 13 de abril.

• En el flujo de trabajo original, el usuario pasaría al siguiente paso a las 2 pm el 14 de abril, lo que es menos de un día desde la hora de entrada.
• En el editor actual, el usuario pasaría al siguiente paso a las 2 pm el 15 de abril. Ten en cuenta que es la misma hora, pero más de un día desde la hora de entrada.

Comportamiento de la sincronización inteligente

Dado que la sincronización inteligente se almacena en el componente de mensaje, los retrasos se aplicarán antes de los cálculos de sincronización inteligente. Esto significa que, dependiendo de cuándo un usuario entre en el componente, puede recibir el mensaje más tarde de lo que lo haría en un Canvas creado con el flujo de trabajo de Canvas original.

Supongamos que tu retraso está configurado en 2 días, la sincronización inteligente está activada y ha determinado que la mejor hora para enviar tu mensaje es a las 2 pm. Un usuario entra en el paso de retraso a las 2:01 pm.

• Flujo de trabajo actual: Tomará 48 horas para que pase el retraso, por lo que el usuario recibe el mensaje el tercer día a las 2 pm.
• Flujo de trabajo original: El usuario recibe el mensaje el segundo día a las 2 pm.

Ten en cuenta que si la sincronización inteligente está activada, el mensaje se enviará dentro de las 24 horas posteriores a que el usuario entre en el componente de mensaje en la hora inteligente identificada (incluso si no hay un componente de retraso involucrado).

Eventos de excepción

Horas tranquilas

Los eventos de excepción se aplican utilizando Rutas de Acción, que están separadas de los pasos de mensaje. Las horas tranquilas se aplican en el componente de mensaje. Esto significa que si un usuario ya pasó la Ruta de Acción (y no fue excluido con el evento de excepción), luego encuentra horas tranquilas cuando llega al componente de mensaje, y su Canvas estaba configurado para reenviar el mensaje después del periodo de horas tranquilas, el evento de excepción ya no se aplicará. Ten en cuenta que este caso de uso no es común.

Para los Segments y filtros, el paso de mensaje tiene validaciones de entrega que permiten a los usuarios configurar Segments y filtros adicionales que se validan en el momento del envío. Esto evita el caso límite mencionado anteriormente con las horas tranquilas.

Configuración de programación “en” o “en el próximo”

Los eventos de excepción se crean utilizando Rutas de Acción. Las Rutas de Acción solo admiten “después de un periodo de tiempo X” y no “en X tiempo” o “en el próximo X tiempo”.

¿Qué debo incluir al enviar un ticket de soporte por un error “Request Timed Out”?

Si encuentras un error “Request Timed Out” mientras editas un Canvas y necesitas contactar con soporte de Braze, incluye la siguiente información para ayudar a acelerar la resolución:

• Grabación de pantalla: Una grabación de los pasos que seguiste antes de ver el error, incluyendo cualquier transición de página.
• Marca de tiempo y zona horaria: La hora exacta en que ocurrió el error y tu zona horaria.
• Navegador y versión: El navegador que estás usando (por ejemplo, Chrome 120, Safari 17) y si has intentado reproducir el error en un navegador diferente.
• Pasos para reproducir: Una descripción clara de las acciones que desencadenan el error, incluyendo cualquier paso en Canvas o configuración específica involucrada.
• Registros de red (opcional): Abre las herramientas de desarrollador de tu navegador (pestaña Network), reproduce el error y exporta el registro de red como un archivo de registro HTTP Archive (HAR). Esto ayuda al equipo de soporte a identificar qué llamada a la API está agotando el tiempo de espera.

Entrega y solución de problemas de Canvas

¿Los usuarios huérfanos son elegibles para recibir mensajes de Canvas?

No. Los usuarios huérfanos no son elegibles para recibir mensajes. Si un perfil queda huérfano mientras un usuario está en un recorrido de Canvas, este sale silenciosamente del flujo. Es posible que los análisis no siempre muestren un evento Exited para esa salida, y el resumen del flujo de trabajo puede incluir un partial_update_token sin exited_date ni exit_reason.

Para obtener más información sobre las fusiones y los perfiles huérfanos, consulta Fusionar usuarios duplicados.

Si detengo un Canvas o una Campaign activos, ¿los mensajes ya enviados al ESP se siguen entregando?

Sí. Después de que Braze envía una solicitud a tu proveedor de servicios de correo electrónico (ESP), Braze no puede revocar ese envío. Detener un Canvas o una Campaign evita nuevas solicitudes de envío, pero los mensajes ya transferidos al ESP aún pueden entregarse y seguir incrementando los conteos de envío a medida que el ESP los procesa.

Este es el mismo comportamiento descrito para detener un Canvas: los envíos de correo electrónico en tránsito no se detienen inmediatamente.

¿Cómo puedo confirmar que un paso de webhook de Canvas se ejecutó sin contenido visible para el usuario?

Braze registra los envíos de webhooks y los resultados de entrega relacionados para los pasos de Webhook en Campaigns y Canvas. Usa los análisis del paso, los informes de webhook o los eventos de webhook de Currents para confirmar que el paso se ejecutó. Los registros de solicitudes de tu endpoint proporcionan confirmación adicional cuando necesitas una prueba de recepción del lado del servidor.

Braze no incluye un píxel de seguimiento invisible integrado para los pasos de webhook. Confía en las métricas de webhook de Braze y en los registros de tu endpoint en lugar de solicitudes personalizadas de imágenes de un píxel.

¿Por qué mi paso de webhook no tiene campo de cuerpo?

Los pasos de webhook utilizan un cuerpo de solicitud para POST, PUT, PATCH y DELETE. Si cambias el método a GET, Braze elimina el campo de cuerpo porque las solicitudes GET no admiten un cuerpo de solicitud. Vuelve a un método compatible con cuerpo si necesitas enviar JSON o datos de formulario. Para obtener detalles sobre los métodos, consulta Crear un webhook.

¿Cómo uso spacer.gif en un paso de webhook?

Braze aloja una imagen de marcador de posición spacer.gif en cdn.braze.com y braze-images.com. Algunos equipos apuntan la URL de un webhook a esta imagen cuando un paso debe ejecutarse sin llamar a un endpoint externo. Los pasos de webhook estándar deben llamar a un endpoint real. Usa los informes de webhook y los registros de tu endpoint para confirmar la entrega, como se describe en ¿Cómo puedo confirmar que un paso de webhook de Canvas se ejecutó sin contenido visible para el usuario?.

¿Por qué mi Canvas no carga con un error “invalid next-step-id”?

Este error de consola significa que al menos un paso apunta a un paso siguiente faltante o no válido, por ejemplo, después de una eliminación parcial, una clonación o una importación. Abre el Canvas en el editor, reconecta los pasos huérfanos o elimina los pasos que ya no tienen una ruta válida hacia abajo. Si el Canvas aún no carga, contacta con soporte de Braze con el ID del Canvas y una captura de pantalla del error de consola.

¿Por qué la marca de tiempo de conversión de un Canvas en Currents difiere de mis análisis de Canvas?

Currents registra las conversiones de Canvas como eventos users.canvas.Conversion. El time del evento es el momento en que ocurrió el evento de conversión. El campo conversion_behavior de ese evento describe la definición de conversión (tipo y ventana). Los análisis de Canvas también pueden agrupar las conversiones en relación con la entrada al Canvas dentro de la ventana de conversión. Al conciliar exportaciones, compara el time de Currents con la marca de tiempo del evento de conversión y la configuración de tu ventana de conversión de Canvas.

¿Por qué canvas_step_name es null en Currents?

Los campos de nombre de Campaign y Canvas, como canvas_step_name, pueden ser null cuando un evento de Currents se envía antes de que Braze termine de propagar los metadatos del paso, por ejemplo, después de crear o renombrar un paso. Para más detalles, consulta ¿Por qué el nombre de la campaña o el nombre del paso de Canvas es NULL en mis datos de Currents?.

¿Por qué mi array no se actualiza en un paso de Actualización de usuario?

Verifica el JSON en tu paso de Actualización de usuario. Las actualizaciones de arrays y atributos anidados necesitan rutas y valores válidos para el atributo que estás modificando. No incluyas campos que el paso proporciona automáticamente, como el ID de usuario externo. Usa la pestaña Vista previa y prueba del paso para confirmar la carga útil antes del lanzamiento.

¿Puedo enviar mensajes de Canvas a usuarios sin un external_id?

Sí, si ya existe un perfil de usuario en Braze. Los usuarios sin un external_id son usuarios anónimos y pueden referenciarse con un braze_id o un alias de usuario. Crea o actualiza el perfil con el endpoint /users/track o tu SDK antes de la entrada al Canvas, y luego usa la entrada basada en acciones o activada por API. La segmentación estándar de Canvas aún requiere un perfil de usuario en Braze; no puedes enviar mensajes de Canvas a una dirección de correo electrónico sin un perfil asociado.

¿Por qué un usuario entró a un Canvas menos veces de las que realizó el evento desencadenante?

Para Canvas basados en acciones y activados por API, Braze deduplica los eventos desencadenantes de modo que un usuario pueda entrar como máximo una vez por segundo aproximadamente para el mismo Canvas. Si un usuario realiza el mismo evento desencadenante varias veces en un segundo, solo se procesa una entrada.

Para permitir múltiples entradas en el mismo segundo, espacia los eventos desencadenantes al menos 1,1 segundos (por ejemplo, cuando controlas la temporización de eventos desde tu servidor). Para un comportamiento similar al de Campaigns que permite múltiples desencadenantes en el mismo segundo, compara tu caso de uso con Campaigns con la programación y configuración de reelegibilidad apropiadas.

¿Cuándo se deduplican los usuarios en Canvas activados por API?

Si un usuario vuelve a entrar a un Canvas activado por API y llega a un paso de demora donde ya está en cola desde una entrada anterior para un mensaje idéntico, Braze deduplica al usuario para evitar envíos duplicados. La segunda instancia de Canvas sale, por lo que el número de entradas puede exceder el número de envíos.

¿Por qué una notificación push de prueba llega a la aplicación incorrecta, pero los envíos en vivo se ven correctos?

La función Test push en un perfil de usuario se entrega a cada dispositivo habilitado para push de ese perfil. Cuando hay varias aplicaciones instaladas en un dispositivo, el sistema operativo generalmente entrega la notificación de prueba a la primera aplicación disponible, que puede no ser la que deseas validar.

Para confirmar la segmentación específica de la aplicación, envía un mensaje en vivo o de prueba a través de una Campaign o Canvas con una audiencia reducida (por ejemplo, filtra por external_id) en lugar de depender únicamente de Test push del perfil.

Para los pasos de mensaje de Canvas con múltiples aplicaciones, activa Validate audience at message send en el paso de mensaje para que las verificaciones de Segment y filtros se ejecuten en el momento del envío. Para más información, consulta Paso de mensaje.

Para el comportamiento general de las notificaciones push de prueba, consulta Enviar mensajes de prueba y Preguntas frecuentes sobre push.

¿Cómo depuro Push Stories en iOS y Android?

Comienza con Push Stories para los requisitos de configuración y creatividad. Para la implementación y el manejo de notificaciones enriquecidas, consulta Notificaciones enriquecidas y Push Stories en la guía del desarrollador.

¿Quién recibe el correo electrónico “Canvas Messages Delayed 24+ Hours”?

Braze envía esta notificación cuando los mensajes de Canvas se retrasan 24 horas o más debido a la limitación de velocidad. El correo electrónico se envía a los usuarios del panel que anteriormente realizaron cambios en el Canvas afectado (basándose en los registros de cambios del Canvas). Si Braze no puede determinar esos destinatarios, el correo electrónico se envía a los administradores de la empresa del espacio de trabajo.

¿Cuándo deja un usuario de recibir mensajes después de un evento de excepción?

Braze registra la salida tan pronto como ocurre el evento de excepción, pero los usuarios pueden permanecer dentro de un paso hasta que los temporizadores finalicen, lo cual es más visible en los pasos de demora. El comportamiento también difiere entre los pasos programados y los pasos activados por eventos. Para consultar cronogramas, ejemplos y matices de los análisis, revisa Criterios de salida.

¿Por qué mi paso de Rutas de Acción muestra un error cuando selecciono una interacción de alias de enlace?

Los grupos de acción que utilizan desencadenantes de interactividad de correo electrónico (por ejemplo, Click alias in email o Clicked alias in any campaign or Canvas step) necesitan un paso de mensaje que ya haya enviado el mensaje que contiene ese enlace. Añade o reordena los pasos para que el correo electrónico se envíe antes de que el paso de Rutas de Acción evalúe el clic, o elige una interacción que coincida con un mensaje que el usuario ya recibió en este Canvas. Para la lista completa de desencadenantes de interacción, consulta Entrega basada en acciones.

¿Cómo afectan las marcas de tiempo históricas de eventos personalizados a los Canvas y las Campaigns basados en acciones?

Braze evalúa los recorridos basados en acciones cuando los eventos calificados se ingestan y el usuario cumple con tus reglas de audiencia. Si un evento llega al perfil fuera de la ventana en la que tu Canvas o Campaign estaba activo, o antes de que el usuario coincidiera con tu audiencia, es posible que la entrada o los envíos posteriores no ocurran como se espera. Compara las marcas de tiempo de los eventos con los tiempos de activación y la membresía de Segment usando el registro de actividad del perfil de usuario y los pasos de solución de problemas en Solución de problemas de eventos personalizados. Si el comportamiento aún no coincide con las expectativas, contacta con soporte de Braze.