Preguntas frecuentes

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

Crear y editar Canvas

¿Cuántos pasos puedo incluir en un Canvas?

Puedes añadir hasta 200 pasos en un Canvas.

¿Cuál es la longitud máxima de caracteres para el nombre de un paso en Canvas?

Los nombres de los pasos en Canvas pueden tener hasta 256 caracteres.

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

Sí. El objeto de contexto de Canvas (propiedades de entrada en 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 de evento.

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

Este error aparece cuando la combinación de ramificaciones de pasos y el tamaño del público de entrada puede generar problemas de rendimiento en el clúster que impidan el envío de mensajes. Para ver los pasos de resolución, como usar Rutas de audiencia, reducir las ramificaciones o el tamaño de la audiencia y reconstruir en Canvas Flow, consulta Error “Too many Canvas branches”.

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

Sí. Los Canvas pueden usar Optimize with BrazeAI^TM cuando la reelegibilidad está habilitada. Braze no puede garantizar la misma variante al volver a entrar porque la asignación cambia con el tiempo. Las Campaigns requieren una ventana de reelegibilidad de 24 horas o más cuando Optimize with 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 usar para determinar la eficacia de tu Canvas. Los componentes pueden incluir acciones como dividir el recorrido del usuario, añadir un retraso e incluso probar varias rutas de Canvas. Un paso en Canvas se refiere al recorrido personalizado del usuario en las ramas de tu Canvas. En esencia, tu Canvas está formado por componentes individuales que crean pasos para el recorrido de tus usuarios.

¿Puedo lanzar un Canvas con pasos desconectados?

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

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

Si un usuario está en un paso desconectado del flujo de trabajo de tu Canvas, avanzará al paso siguiente si existe, y la configuración del paso determinará cómo debe avanzar el usuario. El objetivo es permitirte hacer cambios en los pasos sin tener que conectarlos directamente al resto del Canvas. Esto también te da cierto margen para hacer pruebas antes de pasar a producción de inmediato, lo que en la práctica te permite guardar un borrador.

Te recomendamos revisar la vista de análisis para ver si hay usuarios pendientes en un paso en Canvas antes de desconectarlo.

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

Ponemos en cola un trabajo para cada paso: se ejecutan aproximadamente al mismo tiempo y uno de ellos “gana”. En la práctica, la distribución puede ser bastante 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 quieres 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 de los pasos completos en Canvas se comprueban en el momento del envío. El paso para la división de decisiones realiza una evaluación justo después de recibir un paso anterior (o antes de un retraso).

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

Los eventos de excepción solo se desencadenan mientras el usuario está esperando recibir el componente de Canvas al que están asociados. Si un usuario realiza una acción con antelación, el evento de excepción no se desencadenará. Si quieres excluir a los usuarios que han realizado un evento determinado con antelación, usa filtros en su lugar.

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

Si editas algunos de los pasos de un Canvas de varios pasos, los usuarios que ya estaban en la audiencia pero aún no han recibido esos pasos recibirán la versión actualizada del mensaje. Ten en cuenta que esto solo ocurrirá si todavía no se les ha evaluado 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é ocurre cuando detienes un Canvas?

Cuando detienes un Canvas, ocurre lo siguiente:

• Se impide que los usuarios entren en el Canvas.
• No se envían más mensajes, independientemente de en qué punto del flujo se encuentre el usuario.
• Excepción: Los Canvas con correos electrónicos no se detienen inmediatamente. Una vez que las solicitudes de envío llegan a SendGrid, no podemos hacer nada para impedir que se entreguen al usuario.

¿Debo crear un solo Canvas o Canvas separados para cada etapa del ciclo de vida del usuario?

Según lo que quieras conseguir con tu Canvas, puede que necesites enfoques diferentes para crear el recorrido de tus usuarios. La flexibilidad de Canvas te permite trazar recorridos de usuario para cualquier etapa de su ciclo de vida. Consulta nuestras plantillas de Braze Canvas para ver varios ejemplos de enfoques simplificados para crear recorridos de usuario eficaces.

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. Si el usuario entra en el paso en Canvas antes de que se detenga el Canvas, seguirá recibiendo el mensaje dentro de la aplicación al iniciar su próxima sesión, siempre que el mensaje no haya caducado.

Un usuario puede iniciar una sesión antes de que se detenga el Canvas y no ver el mensaje dentro de la aplicación de inmediato. Esto puede ocurrir si el mensaje se desencadena por un evento personalizado o tiene un retraso. Por eso, un usuario puede registrar una impresión del mensaje dentro de la aplicación y “recibirlo” después de que se haya detenido el Canvas. Sin embargo, el usuario tendría que haber iniciado la sesión antes de que se detuviera el Canvas, pero después de haber recibido el paso en Canvas.

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

Si Mensajes enviados siempre es cero en un Canvas que contiene un paso de mensaje dentro de la aplicación, se debe a que la entrega de mensajes dentro de la aplicación funciona de forma distinta a la de otros canales de mensajería.

El SDK “extrae” los mensajes dentro de la aplicación, en lugar de que Braze los “envíe”. Los mensajes dentro de la aplicación para usuarios elegibles se entregan automáticamente al inicio de la sesión y “esperan” al evento desencadenante antes de mostrarse. Como los usuarios elegibles reciben el mensaje al iniciar una sesión, Braze no lo registra 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 en Canvas (o la campaña) como recibido en el perfil de usuario. Por lo tanto, 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?

Una vez completados los pasos de Retraso anteriores y las comprobaciones de audiencia, los usuarios solo pasan a ser elegibles para un mensaje dentro de la aplicación cuando llegan al paso Mensaje. Si el mensaje caduca en una fecha del calendario o tras un intervalo corto de duración después de que el paso esté disponible, los usuarios de las ramas más lentas pueden llegar después de la caducidad y no ver nunca el mensaje. Ajusta la caducidad a los retrasos más largos y realistas de tus rutas. Para más información y ejemplos, consulta Caducidad de los 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 Mensaje. El espacio de nombres heredado de Liquid canvas_entry_properties tiene restricciones distintas a las de context. Si necesitas que los valores persistan en 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 en botones de los mensajes dentro de la aplicación de arrastrar y soltar en Canvas?

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

¿Puedo programar horas de envío distintas para cada variante en el mismo paso Mensaje de Canvas o en un envío multivariante?

No. Las variantes de una misma configuración multivariante o de un mismo paso Mensaje comparten una única programación de entrega. No puedes asignar una variante para que se envíe a las 18:00 y otra a las 19:00 en ese mismo envío programado.

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

• Separa los pasos Mensaje con pasos de Retraso entre ellos para que cada mensaje tenga su propia programación.
• Usa ramas o un paso de Rutas de experimento para que los usuarios sigan rutas con tiempos distintos.
• Usa campañas separadas si el caso de uso no necesita permanecer dentro de un solo Canvas.

Para conceptos multivariantes y de pruebas A/B en campañas, consulta Pruebas multivariantes y A/B.

¿Qué ocurre si un usuario alcanza la limitación de frecuencia global en un paso Mensaje de Canvas?

No recibe ese envío para el canal limitado, pero los pasos Mensaje siguen haciendo avanzar a los usuarios cuando un mensaje no se envía debido a la limitación de frecuencia global. Para ver los casos de avance paso a paso, consulta Cómo avanzan los usuarios. La limitación de frecuencia global por sí sola no hace que los usuarios salgan de un Canvas; ese comportamiento es independiente de las Validaciones de entrega de un paso Mensaje. Para más información, consulta Limitación de velocidad y limitación de frecuencia.

¿Por qué los envíos son inferiores al tamaño estimado de la audiencia?

Los envíos pueden ser inferiores a la Audiencia estimada por muchas de las mismas razones que en las campañas, como la limitación de frecuencia, filtros estrictos de dispositivo o navegador, ventanas de reelegibilidad, limitación de velocidad y exclusiones a nivel de canal (por ejemplo, la alcanzabilidad push o las comprobaciones de suscripción y capacidad de entrega del correo electrónico).

También influyen factores específicos de Canvas:

• Entrada basada en acciones o desencadenada por API: Los usuarios solo entran (y reciben los pasos) después de realizar el comportamiento de entrada, por lo que los envíos reales van por detrás de la estimación inicial hasta que se producen esas acciones.
• Rutas de audiencia: Los usuarios se dirigen a la rama de mayor prioridad para la que cumplen los requisitos, por lo que las ramas posteriores pueden recibir menos usuarios de lo que sugiere un recuento simple del segmento.
• Comprobaciones de audiencia y en el momento del envío: Los pasos completos vuelven a evaluar los filtros en el momento del envío, salvo que configures lo contrario. Los usuarios que cumplían los requisitos cuando se creó el Canvas pueden quedar fuera antes de que se envíe un mensaje.
• Grupos de control: Los grupos de control globales o del Canvas excluyen de la mensajería a una parte de los usuarios que entran.
• Horas tranquilas y retrasos: Los mensajes pueden retenerse o reprogramarse, lo que desplaza los envíos fuera del intervalo de informes que estás viendo.
• Límites máximos de entrada o de audiencia: Los límites de entrada o de envío detienen a usuarios adicionales aunque el segmento subyacente sea mayor.
• Intervalo de informes: Es posible que el intervalo de análisis no incluya todos los envíos que estás comparando con la estimación.

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

La Audiencia estimada refleja quién cumple tus filtros de segmento y de entrada en el momento en que se calcula la estimación. A partir de ese momento, las entradas retrasadas o basadas en acciones, la reelegibilidad, los desencadenantes de API o el enrutamiento por ramas pueden aumentar el número de perfiles que pasan por el recorrido en comparación con esa instantánea. Los usuarios también pueden quedar fuera cuando no superan los filtros en el momento del envío, lo que reduce las entradas o los envíos reales. Compara los tiempos, los límites y la configuración de evaluación junto con ¿Por qué los envíos son inferiores al tamaño estimado de la audiencia?.

¿Por qué Destinatarios únicos es mayor que el número de usuarios a los que me dirigí?

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

Por ejemplo, si un usuario recibe un paso en Canvas el lunes y otra vez el viernes, y realiza una conversión después de cada envío, Braze puede contabilizar dos filas de destinatarios y dos conversiones dentro del ámbito. Con entradas recurrentes o reelegibilidad, un mismo grupo pequeño de perfiles puede generar varios Destinatarios únicos a lo largo de varios días.

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

Si observas que tu Canvas programado a diario envía mensajes a menos usuarios con el tiempo, comprueba lo siguiente:

• Comprueba si la reelegibilidad está activada: Sin reelegibilidad, Braze hace entrar a cada usuario en el Canvas una sola vez. En los Canvas programados a diario, solo son elegibles para cada entrada los usuarios que coinciden con la audiencia y aún no han entrado en el Canvas. A medida que entran más usuarios, cada entrada posterior tiene menos usuarios elegibles, por lo que el volumen de entradas disminuye.
• Comprueba si la audiencia tiene una pertenencia fija: Las audiencias creadas a partir de una lista fija de usuarios (como una importación CSV usada como filtro de segmento) no incorporan nuevos miembros automáticamente. Sin nuevos usuarios que entren, el volumen de entradas no puede recuperarse a medida que los usuarios entran en el Canvas.

Para conocer los límites de velocidad de entrega y otros factores que reducen los envíos en una sola ejecución, consulta ¿Por qué los envíos son inferiores al tamaño estimado de la audiencia?.

¿Por qué un segmento pequeño de grupo de control muestra cambios en la pertenencia histórica?

Los gráficos de pertenencia histórica usan muestras estimadas, por lo que los segmentos pequeños, incluidos los segmentos del grupo de control global, pueden mostrar variaciones diarias aunque la audiencia subyacente sea estable. Para saber cómo funcionan las estimaciones y por qué los gráficos pueden fluctuar, consulta Ver el tamaño histórico de pertenencia a segmentos.

Análisis y conversiones

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

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 en la 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 conocer las reglas de conversión a nivel de paso y de variante en el análisis de Canvas, consulta ¿Cómo se hace el seguimiento de las conversiones de usuarios en un Canvas?.

¿Cómo se hace el seguimiento de las conversiones de usuarios en un Canvas?

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

Amplía 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 en el primer paso y cero en todos los pasos siguientes.

Nota

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

Ejemplo 2

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

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

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

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

• El total de conversiones del Canvas refleja 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 principio de un Canvas, refleja como total agregado todas las conversiones realizadas por los usuarios dentro de esa ruta, hayan recibido o no un mensaje.
• La tasa de conversión del paso refleja cuántas personas recibieron ese paso de mensaje y completaron alguno de los eventos de conversión definidos.

¿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 habitual que el total de conversiones de una variante en Canvas sea mayor que la suma del total de sus pasos. Esto ocurre porque un usuario puede realizar un evento de conversión para una variante en cuanto entra en ella. Sin embargo, ese mismo evento de conversión no 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 contabiliza en el total de conversiones de la variante, pero no en el total del paso. Lo mismo ocurre con un usuario que entra en el Canvas pero sale de él antes de recibir ningú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 ese caso, no se registra una conversión a nivel de paso. Sin embargo, como técnicamente el usuario sí convirtió, se registra una conversión a nivel de Canvas.

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

Puedes crear un Segment con un filtro de Canvas para confirmar si los usuarios entraron en el Canvas o recibieron un paso en Canvas concreto. Por ejemplo, usa un filtro de entrada en Canvas si quieres confirmar que los usuarios entraron en el Canvas desencadenado por API, o un filtro de paso recibido si quieres confirmar que recibieron un mensaje del Canvas. Después, usa el endpoint /users/export/segment para exportar los usuarios de ese Segment.

¿Puedo eliminar un Canvas?

No, pero puedes archivar un Canvas.

¿Cómo reanudo un Canvas o una Campaign archivados?

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

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

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

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

Cuando se elimina una etiqueta de tu espacio de trabajo, Braze la quita de todas las Campaigns y Canvas que la usaban. Esa limpieza no siempre genera su propia línea en el registro de cambios de un Canvas.

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

Para ver los análisis de un componente de Canvas, ve a tu Canvas y desplázate hacia abajo en la página Detalles del Canvas. Ahí puedes ver los análisis de cada componente. Consulta Análisis de Canvas para más información.

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

Los filtros como Received Message from Canvas Step se actualizan después de que Braze registra el evento de envío, recepción o participación correspondiente a ese paso. Los mensajes dentro de la aplicación pueden registrar impresiones por separado 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 los pasos en Detalles del Canvas.

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

El segmentador ofrece una estadística más precisa de los usuarios únicos que las estadísticas de Canvas o de Campaign. Esto se debe a que las estadísticas de Canvas y de Campaign son cifras que Braze incrementa cuando ocurre algo, lo que significa que hay variables que pueden hacer que este número sea distinto del del segmentador. Por ejemplo, los usuarios pueden convertir más de una vez en un Canvas o una 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 que esperas por la forma en que se evalúan las audiencias y los desencadenantes. En Braze, la audiencia se evalúa antes que el desencadenante (salvo que uses un desencadenante de cambio en un atributo). Esto hará que los usuarios abandonen el Canvas si no forman parte de la audiencia seleccionada antes de que se evalúe cualquier acción desencadenante.

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

Aunque los usuarios anónimos pueden entrar y salir de los Canvas, sus acciones no se asocian a un perfil de usuario concreto hasta que se identifican, por lo que es posible que sus interacciones no se registren por completo en tus análisis. Puedes usar el Generador de consultas para generar un informe de estas métricas.

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

Usa filtros de segmentación como Entered Canvas Variation, In Canvas Control Group o Received Message from Canvas Step para dirigirte a los usuarios en función de su entrada en el Canvas, la variante asignada o su participación en un paso. Estos filtros evalúan el historial de entradas y las interacciones; no indican si un usuario sigue avanzando por un recorrido activo.

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

Segmentación

¿Cuál es la diferencia entre “No ha entrado en la variación 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 variación de Canvas

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

No está en el grupo de control de Canvas

El usuario entró en el Canvas, pero no está en el grupo de control y, por lo tanto, recibió una variación. Esto solo incluye a los usuarios que entraron en el Canvas.

Ten en cuenta que la asignación de variaciones se produce al entrar en el 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 original de Canvas

Amplía para ver las preguntas frecuentes sobre el editor original de Canvas

¿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 actual.

¿Cuáles son las principales diferencias entre el editor de Canvas actual y el original?

Barra de herramientas de componentes de Canvas

Antes, con el editor original de Canvas, 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 sustituyen por distintos componentes de Canvas, lo que te ofrece más visibilidad y personalización en 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

Antes, cada paso completo incluía en un solo componente información como la configuración de retraso y programación, los eventos de excepción, los filtros de audiencia, la configuración del mensaje y las opciones de avance del mensaje. En el editor actual, estas son configuraciones independientes para que la creación de tu Canvas sea más personalizable, lo que introduce algunas diferencias de funcionalidad.

Avance del componente Mensaje

Los componentes Mensaje hacen avanzar a todos los usuarios que entran en el paso. No es necesario especificar el comportamiento de avance del mensaje, lo que simplifica la configuración general del paso. Si quieres implementar la opción Avanzar cuando se envíe el mensaje, añade un paso de Rutas de audiencia independiente para filtrar a los usuarios que no recibieron el paso anterior.

Comportamiento del retraso “en”

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

Supongamos que el 12 de abril tenemos un componente Retraso configurado para enviar a tu usuario al siguiente paso en un día a las 14:00. Un usuario entra en el componente a las 14:01 del 13 de abril.

• En el flujo de trabajo original, el usuario pasaría al siguiente paso a las 14:00 del 14 de abril, es decir, menos de un día después de la hora de entrada.
• En el editor actual, el usuario pasaría al siguiente paso a las 14:00 del 15 de abril. Ten en cuenta que es la misma hora, pero más de un día después de la hora de entrada.

Comportamiento de la sincronización inteligente

Como la sincronización inteligente se almacena en el componente Mensaje, los retrasos se aplicarán antes de los cálculos de la sincronización inteligente. Esto significa que, según el momento en que un usuario entre en el componente, podría recibir el mensaje más tarde de lo que lo recibiría en un Canvas creado con el flujo de trabajo original.

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

• Flujo de trabajo actual: El retraso tardará 48 horas en transcurrir, así que el usuario recibe el mensaje el tercer día a las 14:00.
• Flujo de trabajo original: El usuario recibe el mensaje el segundo día a las 14:00.

Ten en cuenta que, si la sincronización inteligente está activada, el mensaje se enviará en las 24 horas siguientes a la entrada del usuario en el componente Mensaje, en el momento inteligente identificado (aunque no haya ningún componente Retraso).

Eventos de excepción

Horas tranquilas

El evento de excepción se aplica mediante Rutas de Acción, que son independientes de los pasos de Mensaje. Las horas tranquilas se aplican en el componente Mensaje. Esto significa que, si un usuario ya pasó el paso de Rutas de Acción (y no fue excluido por el evento de excepción), luego se encuentra con horas tranquilas al llegar al componente Mensaje, y su Canvas está configurado para que el mensaje se vuelva a enviar 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 habitual.

En cuanto a segmentos y filtros, el paso Mensaje tiene validaciones de entrega que permiten configurar segmentos y filtros adicionales que se validan en el momento del envío. Esto evita el caso límite de horas tranquilas mencionado anteriormente.

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

Los eventos de excepción se crean mediante Rutas de Acción. Las Rutas de Acción solo admiten “después de una ventana de tiempo X” y no “en X tiempo” ni “en el próximo X tiempo”.

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

Si te aparece un error “Request Timed Out” mientras editas un Canvas y necesitas ponerte en contacto con el soporte de Braze, incluye la siguiente información para ayudar a agilizar 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 pueden recibir mensajes de Canvas?

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

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

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

Sí. Cuando Braze envía una solicitud a tu proveedor de servicios de correo electrónico (ESP), Braze ya no puede cancelar ese envío. Detener un Canvas o una Campaign evita nuevas solicitudes de envío. Sin embargo, los mensajes que ya se entregaron al ESP pueden seguir llegando y seguir sumándose al recuento de envíos a medida que el ESP los procesa.

Es el mismo comportamiento descrito para detener un Canvas: los envíos de correo electrónico en curso no se interrumpen de inmediato.

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

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

Braze no incluye un píxel de seguimiento invisible integrado para los pasos de webhook. Usa las métricas de webhook de Braze y 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 usan 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 cuerpo de solicitud. Si necesitas enviar JSON o datos de formulario, vuelve a un método que admita cuerpo. Para más 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. Para confirmar la entrega, usa los informes de webhooks y los registros de tu endpoint, como se describe en ¿Cómo puedo confirmar que se ejecutó un paso de webhook en Canvas sin contenido visible para el usuario?.

¿Por qué mi Canvas no carga y muestra el error “invalid next-step-id”?

Este error de consola indica que al menos un paso apunta a un paso siguiente inexistente o no válido. Puede ocurrir, por ejemplo, después de una eliminación parcial, una clonación o una importación. Abre el Canvas en el editor y vuelve a conectar los pasos huérfanos, o elimina los pasos que ya no tengan una ruta posterior válida. Si el Canvas sigue sin cargar, ponte en contacto con el soporte de Braze e indica el ID del Canvas junto con una captura de pantalla del error de consola.

¿Por qué la marca de tiempo de una conversión de Canvas en Currents no coincide con mis análisis de Canvas?

Currents registra las conversiones de Canvas como eventos users.canvas.Conversion. El campo time del evento indica cuándo ocurrió el evento de conversión. El campo conversion_behavior de ese evento describe la definición de la conversión (tipo y ventana). Los análisis de Canvas también pueden agrupar las conversiones en relación con la entrada en el 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 con la configuración de la ventana de conversión de tu Canvas.

¿Por qué canvas_step_name es nulo en Currents?

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

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

Revisa el JSON de tu paso de actualización de usuario. Las actualizaciones de matrices y atributos anidados necesitan rutas y valores válidos para el atributo que modificas. No incluyas campos que el paso proporciona automáticamente, como el ID de usuario externo. Antes del lanzamiento, usa la pestaña Vista previa y prueba del paso para confirmar la carga útil.

¿Puedo enviar mensajes de Canvas a usuarios sin external_id?

Sí, siempre que ya exista un perfil de usuario de Braze. Los usuarios sin external_id son usuarios anónimos y se pueden referenciar con un braze_id o un alias de usuario. Crea o actualiza el perfil con el endpoint /users/track o con tu SDK antes de la entrada en el Canvas. Después, usa la entrada basada en acciones o desencadenada por API. La segmentación estándar de Canvas sigue requiriendo un perfil de usuario de Braze: no puedes enviar mensajes de Canvas solo a una dirección de correo electrónico sin perfil.

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

En los Canvas basados en acciones y desencadenados por API, Braze deduplica los eventos desencadenantes. Así, un usuario puede entrar como máximo aproximadamente una vez por segundo en el mismo Canvas. Si un usuario realiza el mismo desencadenante varias veces en un segundo, solo se procesa una entrada.

Para permitir varias entradas en el mismo segundo, separa los eventos desencadenantes al menos 1,1 segundos (por ejemplo, cuando controlas el momento de los eventos desde tu servidor). Si necesitas un comportamiento que admita varios desencadenantes en el mismo segundo, compara tu caso de uso con las Campaigns con una configuración adecuada de programación y de nueva elegibilidad.

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

Supón que un usuario vuelve a entrar en un Canvas desencadenado por API y llega a un paso de retraso en el que ya está en cola desde una entrada anterior para un mensaje idéntico. En ese caso, Braze deduplica al usuario para evitar envíos duplicados. La segunda instancia del Canvas finaliza, por lo que el número de entradas puede superar al número de envíos.

¿Por qué un push de prueba llega a la aplicación equivocada, pero los envíos en vivo parecen correctos?

El Push de prueba de un perfil de usuario se entrega a todos los dispositivos con push habilitado de ese perfil. Cuando hay varias aplicaciones instaladas en un dispositivo, el sistema operativo suele entregar la notificación de prueba a la primera aplicación disponible. Esa aplicación puede no ser la que quieres validar.

Para confirmar la segmentación por aplicación, no te limites al Push de prueba del perfil. Envía un mensaje en vivo o de prueba mediante una Campaign o un Canvas con una audiencia reducida (por ejemplo, filtrando por external_id).

En los pasos de mensaje de Canvas con varias aplicaciones, activa Validar audiencia en el envío del mensaje en el paso de mensaje. Así, las comprobaciones de Segment y de filtros se ejecutan en el momento del envío. Para más información, consulta Paso de mensaje.

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

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

Empieza por Push Stories para conocer la configuración y los requisitos creativos. Para la implementación y la gestión de notificaciones enriquecidas, consulta Notificaciones enriquecidas y Push Stories en la Guía para desarrolladores.

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

Braze envía esta notificación cuando el límite de velocidad retrasa los mensajes de Canvas 24 horas o más. El correo electrónico llega a los usuarios del panel que hicieron cambios previos en el Canvas afectado (según 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 tras un evento de excepción?

Braze registra la salida en cuanto ocurre el evento de excepción. Sin embargo, los usuarios pueden permanecer dentro de un paso hasta que terminen los temporizadores, algo que se nota sobre todo en los pasos de retraso. El comportamiento también varía entre los pasos programados y los pasos desencadenados por eventos. Para ver cronologías, ejemplos y matices de los análisis, consulta Criterios de salida.

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

Algunos grupos de acción usan desencadenantes de interactividad por correo electrónico, como Hacer clic en alias en correo electrónico o Hizo clic en un alias en cualquier paso de Campaign o Canvas. Estos grupos necesitan un paso de mensaje que ya haya enviado el mensaje con 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. También puedes elegir una interacción que corresponda a un mensaje que el usuario ya recibió en este Canvas. Para ver 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 Campaigns basados en acciones?

Braze evalúa los recorridos basados en acciones cuando se ingieren los eventos que cumplen los requisitos y el usuario cumple tus reglas de audiencia. Los eventos personalizados con fecha retroactiva pueden desencadenar la entrada en el Canvas si su marca de tiempo está dentro de la ventana de entrada del Canvas. Es posible que la entrada o los envíos posteriores no se produzcan como esperas en estos casos:

• La marca de tiempo está fuera de esa ventana.
• El Canvas o la Campaign no estaban activos.
• El usuario aún no cumplía tus criterios de audiencia.

Compara las marcas de tiempo de los eventos con las horas de puesta en marcha, la configuración de la ventana de entrada y la pertenencia a Segments. Para ello, usa el registro de actividad del perfil de usuario y los pasos de Solución de problemas de eventos personalizados. Si el comportamiento sigue sin coincidir con lo esperado, ponte en contacto con el soporte de Braze.