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.

¿Existen 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 de “Demasiadas ramas en Canvas”?

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 conocer los pasos de resolución —incluyendo el uso de Rutas de Audiencia, la reducción de ramificaciones o del tamaño del público, y la reconstrucción en Canvas Flow— consulta Error de “Demasiadas ramas en Canvas”.

¿Puedo usar la selección inteligente con la reelegibilidad en un Canvas?

Sí. Los Canvas pueden usar la selección inteligente cuando la reelegibilidad está habilitada, mientras que las Campaigns requieren una ventana de reelegibilidad de 24 horas o más cuando la selección inteligente está activada. Braze no puede garantizar la misma variante al reingresar porque la asignación cambia con el tiempo.

¿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 múltiples rutas de Canvas. Un paso en Canvas se refiere al recorrido personalizado del usuario en las ramas de tu Canvas. Básicamente, 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 posterior si existe uno, y la configuración del paso determinará cómo debe avanzar el usuario. Esto permite que los usuarios realicen cambios en los pasos sin tener que conectarlos directamente al resto del Canvas. Esto también te da espacio para hacer pruebas antes de publicar de inmediato, lo que permite guardar un borrador de forma efectiva.

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

¿Qué sucede si el público y la hora de envío son idénticos 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 forma algo uniforme, pero es probable que haya al menos una ligera inclinación 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 los públicos de Canvas?

De forma predeterminada, los filtros y Segments para pasos completos en el 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 anticipación, el evento de excepción no se activará. Si quieres excluir a los usuarios que han realizado un evento determinado con anticipación, 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 varios pasos, los usuarios que ya estaban en el público pero que no han recibido los pasos recibirán la versión actualizada del mensaje. Ten en cuenta que esto solo sucederá 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:

• Los usuarios no podrán ingresar al Canvas.
• No se enviarán más mensajes, sin importar en qué punto del flujo se encuentre un usuario.
• Excepción: Los Canvas con correos electrónicos no se detendrán de inmediato. Después de que las solicitudes de envío lleguen a SendGrid, no hay nada que podamos hacer para evitar que se entreguen al usuario.

¿Debo crear un solo 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 para construir el recorrido del usuario. La flexibilidad de Canvas te permite mapear recorridos de usuario para cualquier etapa del ciclo de vida del usuario. Consulta nuestras plantillas de Braze Canvas para ver varios ejemplos de enfoques optimizados 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 iniciar la siguiente sesión. Esto significa que, si el usuario entra en el paso de Canvas antes de que se detenga, seguirá recibiendo el mensaje dentro de la aplicación en su siguiente inicio de sesión, siempre que el mensaje no haya caducado aún.

Es posible que un usuario inicie una sesión antes de que se detenga Canvas, pero que no se le muestre el mensaje dentro de la aplicación de inmediato. Esto puede ocurrir si el mensaje dentro de la aplicación se desencadena por 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 después de que se haya detenido Canvas. Sin embargo, el usuario habría tenido que iniciar la sesión antes de que se detuviera Canvas, pero después de haber recibido el paso de Canvas.

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

Si los Mensajes enviados son siempre 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 forma diferente a otros canales de mensajería.

Los mensajes dentro de la aplicación son “extraídos” por el SDK, en lugar de ser “enviados” desde Braze. Los mensajes dentro de la aplicación para los usuarios elegibles se entregan automáticamente al iniciar la sesión y “esperan” al evento desencadenante antes de mostrarse. Como los usuarios elegibles reciben el mensaje cuando inician 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 de Canvas (o Campaign) como recibido en el perfil de 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 los pasos de Retraso ascendentes y las comprobaciones de audiencia se completen, 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 de ruta más largos y realistas. 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 Propiedades de contexto y 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 de 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 con editor de arrastrar y soltar en Canvas?

Las métricas a nivel de botón para los mensajes dentro de la aplicación con editor 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 Canvas, selecciona el paso de Mensaje y revisa la participación de mensajes dentro de la aplicación allí. Para conceptos de informes, consulta Medir y probar con 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 mismo programa de entrega. No puedes asignar una variante para que se envíe a las 6 pm y otra a las 7 pm para el mismo envío programado.

Para escalonar los 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 propia programación.
• Usa ramas o un paso de Recorrido de experimentos para que los usuarios sigan rutas con diferente sincronización.
• 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 reciben ese envío para el canal limitado, pero los pasos de Mensaje siguen avanzando a los usuarios cuando un mensaje no se envía 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ímites 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 push o comprobaciones de suscripción y capacidad de entrega de correo electrónico).

También se aplican factores específicos de Canvas:

• Entrada basada en acciones o activada por API: los usuarios solo entran (y reciben pasos) después de realizar el comportamiento de entrada, por lo que los envíos realizados quedan por 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 plano de Segment.
• Comprobaciones de audiencia y momento de envío: los pasos completos reevalúan los filtros en el momento del envío a menos que lo configures de otra manera. Los usuarios que calificaron cuando se creó Canvas pueden salir antes de que se envíe un mensaje.
• Grupos de control: los grupos de control globales 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 visualizando.
• 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 mayor.
• 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énes coinciden 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 desencadenantes de API o el enrutamiento por ramas pueden aumentar la cantidad de perfiles que interactúan con el recorrido en comparación con la instantánea. Los usuarios también pueden salir cuando los filtros en el momento de envío fallan, lo que reduce las entradas o envíos realizados. Compara la sincronización, los límites y la configuración 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 el número de usuarios a los que me dirigí?

Los Destinatarios únicos pueden ser más que la audiencia que esperabas porque Braze registra los destinatarios únicos diarios 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 otra vez 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 conjunto reducido de perfiles puede generar múltiples 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 diariamente envía a menos usuarios con el tiempo, comprueba lo siguiente:

• Verifica si la reelegibilidad está activada: sin reelegibilidad, Braze ingresa a cada usuario en Canvas solo una vez. En Canvas programados diariamente, solo los usuarios que coinciden con la audiencia y aún no han entrado en 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 entrada disminuye.
• Verifica si la audiencia tiene membresía fija: las audiencias construidas a partir de una lista fija de usuarios (como una importación de CSV utilizada como filtro de Segment) no incorporan nuevos miembros automáticamente. Sin nuevos entrantes, el volumen de entrada no puede recuperarse a medida que los usuarios entran en Canvas.

Para límites de velocidad de entrega y otros factores que reducen los envíos de una sola ocurrencia, 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 Segments pequeños, incluyendo los Segments del grupo de control global, pueden mostrar movimiento día a día incluso cuando la audiencia subyacente es estable. Para entender cómo funcionan las estimaciones y por qué los gráficos pueden fluctuar, consulta Ver el tamaño histórico de la membresía de un Segment.

Análisis y conversiones

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

El panel de conversiones atribuye las conversiones de Canvas en función del 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 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 los usuarios en un Canvas?.

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

Un usuario solo puede convertir una vez por entrada de Canvas. Las conversiones se asignan al mensaje más reciente recibido por el usuario para 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 o no. Cada paso posterior solo mostrará las conversiones que ocurrieron mientras ese era el paso más reciente que el usuario recibió.

Expande para ver ejemplos

Ejemplo 1

Hay una ruta en 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 siguientes.

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 retraso, pero está 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 del mensaje y completaron cualquiera de los eventos de conversión definidos.

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

Es habitual que el total de conversiones de una variante de 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 tan pronto como entra en ella. Sin embargo, ese mismo evento de conversión no cuenta para un paso del Canvas. Por lo tanto, cualquier usuario que entre en el Canvas y realice el evento de conversión antes de recibir el primer paso del Canvas se cuenta en el total de conversiones de la variante y no en el total del paso. Lo mismo ocurre con un usuario que entra en el Canvas pero sale antes de recibir cualquier 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, como el usuario técnicamente convirtió, se registra una conversión a nivel de Canvas.

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

Puedes crear un Segment 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 de Canvas si quieres confirmar que los usuarios entraron en el Canvas activado por API, o un filtro de paso recibido si quieres confirmar que recibieron un mensaje del Canvas. Luego, 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 Campaign archivado?

Los mensajes archivados no se envían hasta que los devuelvas a un estado editable. Desarchiva el Campaign o Canvas, configura el calendario de entrada o la hora de envío en 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 atributos personalizados 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 atributos personalizados incompletas, o ingresa tanto el nombre del atributo como el valor, y luego selecciona Guardar 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 de Detalles del Canvas. Aquí podrás ver los análisis de cada componente. Consulta Análisis de Canvas para más información.

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

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

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 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 sucede, lo que significa que hay variables que podrían hacer 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, la 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 estar completamente rastreadas en tus análisis. Puedes usar el Query Builder para generar un informe de estas métricas.

¿Puedo excluir a los usuarios que actualmente se encuentran en un recorrido de Canvas de un Campaign o Segment?

Usa los filtros de segmentación como Entered Canvas Variation, In Canvas Control Group o Received Message from Canvas Step para segmentar a los usuarios en función de la entrada al Canvas, la asignación de variante o la participación en un paso. Estos filtros evalúan el historial de entrada e interacciones, pero no indican si un usuario sigue avanzando 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 “Has not entered Canvas variation” e “Is not in Canvas control group”?

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

Has not entered Canvas variation

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 usuarios que entraron en otra variante y a usuarios que no han entrado en ninguna variante.

Is not in Canvas control group

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

Ten en cuenta que la asignación de variantes se produce en el momento de 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

Expande 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 han sido sustituidos por diferentes componentes de Canvas, lo que te ofrece el beneficio de una mayor visibilidad y personalización en tu experiencia de edición. Puedes ver de inmediato todos los 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 del mensaje y opciones de avance del mensaje, todo en un solo componente. En el editor actual, estas son configuraciones 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 es necesario 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 el mensaje se envíe, añade un componente de Rutas de Audiencia separado para filtrar a los usuarios que no recibieron el paso anterior.

Comportamiento de retraso “en”

Los componentes de retraso esperarán todo el tiempo de retraso 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 p. m. Un usuario entra en el componente a las 2:01 p. m. del 13 de abril.

• En el flujo de trabajo original, el usuario pasaría al siguiente paso a las 2 p. m. del 14 de abril, lo cual 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 p. m. del 15 de abril. Ten en cuenta que esta 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 recibiría en un Canvas construido con el flujo de trabajo del 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 p. m. Un usuario entra en el paso de retraso a las 2:01 p. m.

• Flujo de trabajo actual: Pasarán 48 horas para que el retraso termine, por lo que el usuario recibe el mensaje al tercer día a las 2 p. m.
• Flujo de trabajo original: El usuario recibe el mensaje al segundo día a las 2 p. m.

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

Eventos de excepción

Horas tranquilas

El evento de excepción se aplica mediante 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ó por la Ruta de Acción (y no fue excluido con el evento de excepción), luego se encuentra con las horas tranquilas al llegar al componente de mensaje, y su Canvas estaba configurado para que el mensaje se reenvíe después del período 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 segmentos y filtros, el paso de mensaje tiene validaciones de entrega que permiten a los usuarios configurar segmentos y filtros adicionales que se validan en el momento del envío. Esto previene el caso límite de horas tranquilas mencionado anteriormente.

Configuración de programación “en” o “en el siguiente”

Los eventos de excepción se crean mediante Rutas de Acción. Las Rutas de Acción solo admiten “después de un período de tiempo X” y no “en X tiempo” o “en el siguiente X tiempo”.

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

Si encuentras un error de “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 en Canvas

¿Son los usuarios huérfanos 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 más información sobre fusiones y perfiles huérfanos, consulta Fusionar usuarios duplicados.

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

Sí. Una vez 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 pueden seguir incrementando los conteos de envío mientras 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 de inmediato.

¿Cómo puedo confirmar que un paso de webhook en Canvas se ejecutó 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. 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 prueba del lado del servidor de la recepción.

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 un 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 un cuerpo de solicitud. Vuelve a cambiar a un método que admita cuerpo si necesitas enviar datos en JSON o formulario. 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. 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 en 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 siguiente paso 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 descendente válida. Si el Canvas sigue sin cargar, contacta con el soporte de Braze con el ID de Canvas y una captura de pantalla del error de consola.

¿Por qué una marca de tiempo de conversión de Canvas en Currents difiere de 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 conversión (tipo y ventana). Los análisis de Canvas también pueden agregar las conversiones en relación con la entrada al Canvas dentro de la ventana de conversión. Al reconciliar exportaciones, compara el time de Currents con la marca de tiempo del evento de conversión y 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 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 del paso de Canvas es NULL en mis datos de Currents?.

¿Por qué mi arreglo 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 arreglos y atributos anidados necesitan rutas y valores válidos para el atributo que estás cambiando. 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 external_id?

Sí, si ya existe un perfil de usuario en Braze. Los usuarios sin external_id son usuarios anónimos y pueden ser referenciados 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 entrada basada en acciones o activada por API. La segmentación estándar de Canvas sigue requiriendo un perfil de usuario en Braze; no puedes enviar mensajes de Canvas solo a una dirección de correo electrónico sin perfil.

¿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 para que un usuario pueda entrar como máximo 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 múltiples entradas en el mismo segundo, separa los eventos desencadenantes por 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 permita múltiples desencadenantes en el mismo segundo, compara tu caso de uso con las Campaigns con las configuraciones de programación y reelegibilidad adecuadas.

¿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 retraso donde ya está en cola por 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 superar el número de envíos.

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

Test push en un perfil de usuario se entrega a todos los dispositivos con push habilitado para ese perfil. Cuando hay múltiples 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 aplicación 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 en Canvas con múltiples aplicaciones, activa Validate audience at message send en el paso de mensaje para que las comprobaciones 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 para desarrolladores.

¿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 por limitación de velocidad durante 24 horas o más. El correo electrónico se envía a los usuarios del panel que previamente realizaron cambios 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 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 retraso. El comportamiento también difiere entre los pasos programados y los pasos activados por eventos. Para cronogramas, ejemplos y matices de análisis, consulta 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 acciones que usan 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 Campaigns basados en acciones?

Braze evalúa los recorridos basados en acciones cuando se ingieren los eventos que califican y el usuario cumple tus reglas de audiencia. Si un evento llega al perfil fuera de la ventana en la que tu Canvas o Campaign estaba activa, o antes de que el usuario coincidiera con tu audiencia, la entrada o los envíos posteriores pueden no ocurrir como se esperaba. Compara las marcas de tiempo de los eventos con los momentos 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 el soporte de Braze.