Escrito por Obed Cavanzo (Solutions Architect)

Una buena integración no termina cuando el código se sube. Termina cuando todo funciona, como debería, en el mundo real.

Esta guía está pensada para equipos que usan Braze en aplicaciones móviles (iOS y Android) y quieren asegurarse de que las bases estén bien puestas antes de cada release. Recorre paso a paso el proceso de QA para validar que la integración del SDK funcione correctamente — específicamente para los canales de push notifications e in-app messages.

Cada sección debe ejecutarse de forma separada para iOS y Android, siempre con usuarios de prueba distintos por dispositivo. Nuestro consejo: documentar cada resultado en un checklist compartido. Eso asegura trazabilidad, orden y un historial claro de lo que se validó y cuándo.

1. Identificación de Usuarios

Objetivo

Verificar que la transición de usuario anónimo a identificado preserve el historial de sesiones, asigne correctamente el número de sesión, y reasigne tokens (push, device) de manera adecuada. Esta validación es crítica para la personalización, atribución de campañas y gestión de límites de envío.

Procedimiento de Validación

1. Iniciar la aplicación y completar el flujo de creación de usuario. Es importante utilizar un usuario distinto para cada tipo de dispositivo de prueba.
2. Verificar que se invoque changeUser(external_id) en el flujo de login, inmediatamente después del registro exitoso. Esto se realiza ejecutando las siguientes acciones.
   1. Confirmar en el Dashboard de Braze (mediante Search User) que el nuevo external_id existe y está correctamente asociado.
   2. Si no se ve el usuario en el dashboard se deben revisar los logs del SDK de Braze a que la llamada a la función se esté ejecutando sin errores, y con un parámetro (external_id) valido.
3. Iniciar la aplicación y completar el flujo de login. Es importante utilizar un usuario distinto para cada tipo de dispositivo de prueba. Se debe realizar la misma validación del paso 2.a y 2.b.

Herramientas de Diagnóstico

SDK Logs / Braze Logger

• Activar verbose logs en ambiente QA para visualizar la llamada changeUser() y verificar las respuestas del SDK.
• Documentación: Android – Swift

Search User (Dashboard)

• Corroborar la existencia del usuario junto con las propiedades asociadas.
• Documentación de esto

SDK Debugger (Dashboard)

• Opcional: Crear sesión de debug para capturar tráfico y errores durante el cambio de usuario.
• Documentación de esto

2. Ingesta y Actualización de Atributos de Usuario

Objetivo

Validar que los atributos de usuario (email, nombre, atributos personalizados) se creen y actualicen correctamente, mantengan tipos de datos válidos, respeten la precedencia por timestamp, y no corrompan segmentos ni personalizaciones. Esta validación impacta directamente en la segmentación de audiencias y el contenido dinámico de campañas.

Procedimiento de Validación

1. En la sección anterior usted debió ejecutar el flujo que crea todos los atributos de un usuario desde el SDK (atributos estándar mediante funciones como setFirstName, setEmail, o atributos custom mediante setCustomAttribute) o desde la API (/users/track). Posterior a ellos se debe:
   1. Verificar en el dashboard que los atributos se visualicen correctamente: misma nomenclatura definida y tipo de dato correcto para cada atributo. Validar de forma independiente para plataformas iOS y Android.
   2. Enviar atributos con formatos o tipos de datos erróneos (fecha mal formada, string en campo numérico) y documentar cómo Braze normaliza o rechaza estos valores.

Herramientas de Diagnóstico

Search User (Dashboard): Filtrar por user_id y revisar los writes de atributos: quién los envió, qué valores y cuándo.

SDK Logs / Braze Logger: Identificar posibles errores locales al setear atributos en el cliente.

3. Tracking de Eventos Personalizados y de Purchase

Objetivo

Garantizar que los eventos personalizados y de purchase junto con sus propiedades lleguen con el esquema correcto, sirvan para segmentación de audiencias, y disparen correctamente campañas en Canvas y Campaigns. Sin eventos confiables no funcionan los triggers ni la analítica de comportamiento.

Requisitos:

1. Tener un Internal Group creado que tenga el permiso de “User Events”, asi como un usuario de prueba que pertenezca a este internal Group. Esto le permitirá tener logs en el dashboard de Braze de los eventos que ejecutan ciertos usuarios de prueba que usted defina.
   1. Si no tiene uno debe crearlo yendo a la sección Settings > Internal Groups. El Internal group debe tener habilitada la viñeta “User Events”
   2. Una vez lo cree deberá añadir su usuario de prueba seleccionando el Internal group recién creado y clickeando la opción “Add test users”
   3. Debe buscar su usuario de prueba mediante el external id. Finalmente da a Select User y completa el flujo

Procedimiento de Validación

1. Iniciar sesión con su usuario de prueba (Creado en el internal group) y ejecutar todos los eventos definidos en su tracking plan junto con sus event properties de distintos tipos: strings, numbers, booleans y fechas.
   1. Verificar la aparición en Dashboard → Events y en el Event User Log. Revisar los logs para el usuario de prueba y revisar los detalles de cada evento para confirmar la correcta ingesta: nomenclatura de nombres de evento, propiedades y tipos de datos.

Herramientas de Diagnóstico

Event User Log: Inspeccionar el evento, sus propiedades y origen (SDK o API). Útil para verificar si un evento llegó pero no fue considerado para una campaña.
SDK Debugger / SDK Logs: Verificar si el evento fue encolado/enviado y detectar errores en el cliente.

4. Entrega y Visualización de Mensajes In-App

Objetivo

Validar que los mensajes in-app se muestren con la lógica, apariencia y acciones esperadas (botones, links, deep links). Es importante probar distintos layouts, personalización y condiciones de display para garantizar una experiencia de usuario correcta.

Procedimiento de Validación

1. Utilizar Preview y Send Test en el composer (Dashboard → Campaigns) para validar el aspecto visual del mensaje.
2. Crear triggers condicionados (ejemplo: evento X + atributo Y) y verificar que el mensaje in-app aparezca únicamente cuando corresponde según la lógica definida. Esto requiere que despliegue una campaña y en el segmento de usuarios incluya los external id de los usuarios de prueba.

Herramientas de Diagnóstico

Message Activity Log: Revisar errores en delivery de in-app, problemas de render o fallos específicos de campaña.
SDK Debugger / SDK: Logs Ver llamadas de fetch de in-app y/o errores de render en cliente

5. Entrega y Visualización de Push Notifications

Objetivo

Comprobar el registro de tokens, entrega a través de APNs/FCM, comportamiento en diferentes estados de la aplicación (foreground, background, killed), payloads (deep link, actions, rich media) y métricas de rendimiento (delivered/opened). Esta validación es crítica para la entrega efectiva y experiencia de usuario en dispositivos móviles.

Procedimiento de Validación

1. Verificar que al iniciar la aplicación, el push_token aparezca correctamente en el perfil del usuario en Braze.
2. Enviar Send Test push desde Dashboard al dispositivo de prueba. Probar en tres estados: foreground, background y aplicación cerrada.
3. Probar diferentes payloads: title, body, custom keys, deeplink, badge, sound y rich media.
4. Tocar la notificación y verificar que la navegación (deep link) funcione correctamente.
5. Validar métricas de entrega: comparar sends → delivered → opened en Dashboard y rastrear errores de APNs/FCM.

Herramientas de Diagnóstico

Message Activity Log: Revisar errores en envío (APNs/FCM), entregas fallidas y razones específicas.
SDK Logs: Confirmar registro de token y recepción de notificación en el cliente.

6. Navegación mediante Web Links

Objetivo

Asegurar que los links en mensajes (email, in-app, SMS) redirijan correctamente, preserven UTM y parámetros para tracking, y que el click tracking no rompa cookies o la experiencia de usuario. Esta validación impacta directamente en la atribución de conversiones y analítica de campañas.

Procedimiento de Validación

1. Enviar mensajes con links que incluyan UTM y parámetros personalizados. Comprobar que al hacer clic los parámetros lleguen intactos al destino. Verificar si se abre WebView (manejado por Braze handler) o la actividad del navegador, y confirmar que sea el comportamiento esperado.

Herramientas de Diagnóstico

Custom App: Logs Loggear información custom que permita determinar si el web link está llegando correctamente y/o si la app se está comportando como se espera (Abrir WebView o iniciar otra Activity)

7. Navegación mediante Deep Links

Objetivo

Probar que Universal Links (iOS), App Links (Android) y custom schemes abran la aplicación y naveguen al contenido correcto con parámetros intactos. Esta validación es esencial para flujos de conversión como abrir un producto específico desde una notificación.

Procedimiento de Validación

1. Opcional para Universal Links: Verificar configuración de Universal/App Links en iOS/Android (archivos apple-app-site-association y assetlinks.json) y que Braze esté configurado para utilizarlos.
2. Enviar deep links en push/in-app/email y probar con aplicación instalada: debe abrir directamente.
3. Probar que los parámetros (ejemplo: ?product_id=123) se entreguen a la aplicación y la navegación interna funcione correctamente.
4. Forzar deep link con datos inválidos para verificar que la aplicación maneje el fallback sin crash.

Herramientas de Diagnóstico

Custom App Logs: Observar cómo el SDK maneja el deep link y qué handler invoca.

Apéndice: Referencia Rápida

Checklist de Pre-Release

Antes de cada release a producción, verificar que se hayan completado las siguientes validaciones:

• Identificación de usuarios funciona correctamente en ambas plataformas
• Atributos de usuario se ingestán con nomenclatura y tipos correctos
• Eventos personalizados aparecen en Dashboard y activan segmentos
• Mensajes in-app se muestran según condiciones configuradas
• Push notifications llegan en todos los estados de la app
• Web links preservan parámetros UTM y redirigen correctamente
• Deep links navegan correctamente y manejan errores

Ubicaciones Clave en Dashboard

¿Cómo llevar esto a la práctica?

Si este enfoque te sirve como base, el verdadero valor aparece al adaptarlo a tu contexto, tu producto y tus objetivos. Llevar un proceso de QA sólido a la estrategia de engagement marca la diferencia entre implementar y realmente generar impacto. Si estás evaluando cómo llevar esto a la práctica en tu equipo, hablemos!