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 “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 crear problemas de rendimiento del clúster que impidan el envío de mensajes. Para los pasos de resolución —incluido 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 “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 en el reingreso, ya que 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 utilizar 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. Esencialmente, tu Canvas está compuesto por 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.

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

Si un usuario está en un paso desconectado del flujo de tu Canvas, avanzará al paso siguiente si existe uno, y la configuración del paso determinará cómo debe avanzar el usuario. Esto está pensado para permitir a los usuarios realizar cambios en los pasos sin tener que conectarlos directamente al resto del Canvas. También te da margen para hacer pruebas antes de activarlo de inmediato, lo que permite guardar efectivamente un borrador.

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?

Encolamos 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 equitativa, 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 los 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 deseas excluir a los usuarios que ya realizaron un evento determinado, 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 ocurrirá si aún no han sido evaluados para ese paso.

Para obtener 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 al Canvas.
• No se enviarán más mensajes, independientemente de dónde se encuentre un usuario en el flujo.
• 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 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 en la forma en que construyes 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 ingresa al paso de Canvas antes de que se detenga el Canvas, aún recibirá el mensaje dentro de la aplicación en su próximo inicio de sesión, siempre y cuando el mensaje no haya expirado.

Es posible que un usuario inicie una sesión antes de que se detenga el Canvas, pero no vea el mensaje dentro de la aplicación de inmediato. Esto puede ocurrir si el mensaje 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 después de que se detenga 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 de Canvas.

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

Si Mensajes enviados siempre es 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 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 iniciar la sesión y “esperan” el evento desencadenante antes de mostrarse. Debido a que los usuarios elegibles reciben el mensaje cuando inician una sesión, Braze no lo reporta 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 completen 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 expira 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 expiración y nunca ver el mensaje. Alinea la expiración con los retrasos de ruta más largos y realistas. Para más información y ejemplos, consulta Expiración 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 en varios pasos, revisa las propiedades persistentes en el editor original de Canvas con tu equipo de Braze. Los valores almacenados se eliminan 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 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 general de Canvas. Abre el Canvas, selecciona el paso de mensaje y revisa la participación del mensaje dentro de la aplicación allí. Para conceptos de informes, consulta Análisis de Canvas.

¿Puedo programar diferentes horas 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 único programa de entrega. No puedes asignar una variante para enviar a las 6 pm y otra a las 7 pm para ese mismo envío programado.

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

• Separa los pasos de mensaje 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 diferentes horarios.
• Separa las Campaigns 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 aún avanzan 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 hace que los usuarios salgan 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, accesibilidad push o verificaciones de suscripción y capacidad de entrega de correo electrónico).

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

• Entrada basada en acciones o activada por API: Los usuarios solo ingresan (y reciben pasos) después de realizar el comportamiento de entrada, por lo que los envíos realizados van por detrás de la estimación inicial hasta que ocurran esas acciones.
• 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.
• Verificaciones de audiencia y hora 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ó el Canvas pueden quedar fuera antes de que se envíe un mensaje.
• Grupos de control: Los grupos de control globales o de Canvas retienen una parte de los participantes 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 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én coincide con tu Segment y los 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 activadores de API o el enrutamiento de ramas pueden aumentar la cantidad de perfiles que tocan el recorrido en comparación con la instantánea. Los usuarios también pueden quedar fuera cuando los filtros de hora de envío fallan, lo que reduce las entradas o envíos realizados. Compara la temporizació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é Destinatarios únicos es mayor que el número de usuarios que segmenté?

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

Por ejemplo, si un usuario recibe un paso de Canvas el lunes y nuevamente 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 pequeño de perfiles puede producir múltiples Destinatarios únicos a lo largo de varios días.

¿Por qué mi Canvas experimenta 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:

• Verifica si la reelegibilidad está activada: Sin reelegibilidad, Braze ingresa a cada usuario en el Canvas solo una vez. En Canvas programados diariamente, solo los usuarios que coinciden con la audiencia y aún no han ingresado al Canvas son elegibles para cada entrada. A medida que más usuarios ingresan, 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 CSV utilizada como filtro de Segment) no ganan nuevos miembros automáticamente. Sin nuevos participantes, el volumen de entrada 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 para 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 usan muestras estimadas, por lo que los Segments pequeños, incluidos los Segments del grupo de control global, pueden mostrar movimientos día a día incluso cuando la audiencia subyacente es estable. Para saber cómo funcionan las estimaciones y por qué los gráficos pueden fluctuar, consulta Ver el tamaño histórico de membresía de un 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 basándose en 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 a nivel 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 cada entrada al 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, hayan recibido o no 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 en 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 las horas tranquilas habilitadas:

1. El usuario entra en el Canvas.
2. El primer paso no tiene 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 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?

• 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 inicio de un Canvas refleja todas las conversiones realizadas por los usuarios dentro de esa ruta, hayan recibido o no 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 definidos.

¿Por qué la tasa de conversión de mi paso de Canvas no es igual a la tasa de conversión total de mi 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 de Canvas. Así que 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, pero no en el total del paso. Lo mismo aplica para un usuario que entre en el Canvas pero salga 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, dado que el usuario técnicamente sí 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 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 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 segmento.

¿Puedo eliminar un Canvas?

No, pero puedes archivar un Canvas.

¿Cómo reanudo un Canvas o una campaña archivados?

Los mensajes archivados no se envían hasta que los devuelvas a un estado editable. Desarchivar la campaña o el Canvas, configura el calendario de entrada o el horario de envío en una ventana futura (o duplica el recorrido si necesitas una copia limpia), y luego selecciona Resume o lanza según sea necesario. Consulta Archivar campañas y Canvas.

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

Los filtros vacíos de Custom attribute en los filtros de audiencia o 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 campaña?

Cuando se elimina una etiqueta 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 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 de Canvas Details. Aquí podrás ver los análisis de cada componente. Consulta Análisis de Canvas para más detalles.

¿Cuándo es visible la participación de un paso de Canvas en el perfil de 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 participación correspondiente 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 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 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 tu audiencia seleccionada antes de que se evalúen las acciones desencadenantes.

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

Aunque los usuarios anónimos pueden entrar y salir de los Canvas, sus acciones no se asocian con un perfil de usuario específico hasta que son identificados, 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 de una campaña o segmento a los usuarios que se encuentran 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 usuarios según la entrada al Canvas, la asignación de variante o la participación en un paso. Estos filtros evalúan el historial de entrada y las interacciones, no indican si un usuario sigue avanzando a través de un recorrido activo.

Para incluir o excluir usuarios según la 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 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 variante 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

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 de tu usuario. Estos pasos completos se han sustituido por diferentes componentes de Canvas, lo que te ofrece la ventaja 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 en Canvas.

Comportamiento de los pasos

Anteriormente, cada paso completo incluía información como la configuración de retrasos y horarios, 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 son configuraciones separadas para hacer que tu experiencia de creación de Canvas sea 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 general del paso. 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 de retraso “en”

Los componentes de retraso esperarán todo el tiempo de retraso antes de proceder 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 procederí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 procedería al siguiente paso a las 2 p. m. del 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 recibiría en un Canvas creado con el flujo de trabajo original de Canvas.

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 se complete, por lo que el usuario recibe el mensaje el tercer día a las 2 p. m.
• Flujo de trabajo original: El usuario recibe el mensaje el 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 a la hora inteligente identificada (incluso si no hay un componente de retraso involucrado).

Eventos de excepción

Horas tranquilas

El evento de excepción se aplica usando 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ó el paso de Rutas de Acción (y no fue excluido con el evento de excepción), luego encuentra las horas tranquilas al llegar al componente de mensaje, y su Canvas estaba configurado de manera que el mensaje se reenvía 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 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 de horas tranquilas mencionado anteriormente.

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

Los eventos de excepción se crean usando Rutas de Acción. Las Rutas de Acción solo admiten “después de una ventana 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” al editar 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 se encuentra en un recorrido de Canvas, 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 activos, ¿se siguen entregando los mensajes ya enviados al ESP?

Sí. Después de que Braze envía una solicitud a tu proveedor de servicios de correo electrónico (ESP), Braze no puede recuperar 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 e incrementar 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 forma inmediata.

¿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 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 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 que admita cuerpo si necesitas enviar datos JSON o de formulario. Para más detalles sobre 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 y muestra 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, clonación o 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 soporte de Braze con el ID de Canvas y una captura de pantalla del error de consola.

¿Por qué la 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 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 la ventana de conversión de tu 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 Campaign o 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?

Revisa 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 se pueden referenciar 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 un 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 aproximadamente para 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, espacía los eventos desencadenantes en 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 configuraciones apropiadas de programación y reelegibilidad.

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

Si un usuario vuelve a entrar en un Canvas activado por API y llega a un paso de Retraso donde ya está en cola desde una entrada anterior para un mensaje idéntico, Braze deduplica al usuario para prevenir 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 llega a la aplicación incorrecta, pero los envíos en vivo parecen correctos?

La notificación push de prueba en un perfil de usuario se entrega a todos los dispositivos habilitados para push de ese perfil. Cuando varias aplicaciones están instaladas en un dispositivo, el sistema operativo normalmente 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 la notificación push de prueba del perfil.

Para los pasos de Mensaje de Canvas con múltiples aplicaciones, activa Validar audiencia al momento del envío del mensaje 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 Envío de 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 creativos. 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 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 pasos programados y pasos activados por eventos. Para plazos, 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 utilizan desencadenantes de interactividad de correo electrónico (por ejemplo, Clic en alias en correo electrónico o Clic en alias en cualquier paso de Campaign o Canvas) 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 ingestan los eventos que califican y el usuario cumple con tus reglas de audiencia. Los eventos personalizados con fecha retroactiva pueden desencadenar la entrada al Canvas si la marca de tiempo del evento cae dentro de la ventana de entrada del Canvas. La entrada o los envíos posteriores pueden no ocurrir como se espera si la marca de tiempo está fuera de esa ventana, el Canvas o la Campaign no estaban activos, o el usuario aún no coincidía con tu audiencia.

Compara las marcas de tiempo de los eventos con los horarios de activación, la configuración de la ventana de entrada y la pertenencia a Segments 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 sigue sin coincidir con las expectativas, contacta con soporte de Braze.