Conectar Adapty con Adapty Mail
Adapty es uno de los puntos de entrada de Adapty Mail — úsalo cuando tu app ya ejecute el SDK de Adapty. Adapty transfiere perfiles, direcciones de correo electrónico y eventos de suscripción a Adapty Mail, que los utiliza para seleccionar destinatarios, asignar a cada persona un flow y atribuir los ingresos al correo que impulsó la compra.
Si tu app no ejecuta el SDK de Adapty, envía los mismos datos desde tu servidor — consulta Enviar correos y transacciones mediante la API de Adapty Mail.
Para obtener datos de ingresos precisos, la configuración mínima es instalar el SDK en modo observador y activar las notificaciones del servidor de App Store.
Adapty Mail necesita tres cosas de tu app: datos de compras (para atribuir los ingresos al email que generó cada conversión), un identificador de usuario estable y los emails de los usuarios. Configura las tres cosas, luego configura tu dominio, checkout, campaña y flow en Adapty Mail, y activa el envío al final.
1. Permite que Adapty registre tus ingresos
El primer paso depende de si ya tienes compras in-app implementadas:
- Si ya tienes compras in-app implementadas con Adapty, no necesitas hacer nada más en esta etapa.
- Si ya tienes compras in-app implementadas sin Adapty y no planeas migrar a Adapty, instala el SDK de Adapty para tu plataforma en modo observador. En esta etapa solo necesitas añadir el SDK a tu proyecto, activarlo con el modo observador habilitado e informar las transacciones. Guías por plataforma: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
- Si aún no tienes compras in-app implementadas y quieres usar Adapty, completa los pasos de la guía de inicio rápido para delegar la gestión de compras a Adapty.
Luego activa las notificaciones de servidor de App Store en Adapty para recibir actualizaciones relacionadas con los ingresos directamente desde App Store.
2. Identifica a tus usuarios
Pasa un ID estable — tu ID de usuario del backend, UID de Firebase o similar — ya sea pasándolo como customerUserId a .activate() al iniciar el SDK, o llamando a Adapty.identify() más tarde (por ejemplo, al iniciar sesión). En cualquier caso, establece el ID antes de mostrar cualquier paywall. Adapty lo utiliza para mantener un único perfil por persona entre reinstalaciones e inicios de sesión, y Adapty Mail lo almacena entre los IDs externos del perfil. Adapty Mail identifica a las personas por dirección de correo electrónico, no por este ID.
Guías por plataforma: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
3. Recopilar emails de usuarios
Una vez que un usuario proporcione su email en tu app (por ejemplo, al registrarse o durante el proceso de pago), pásalo a Adapty llamando a updateProfile con el atributo email. Todos los destinatarios de una campaña necesitan este valor.
Guías por plataforma: iOS, Android, React Native, Flutter, Unity, Kotlin Multiplatform, Capacitor.
- Pasa siempre un
customer_user_idestable, nunca un identificador anónimo. Si un usuario desinstala y reinstala tu app, Adapty usa este ID para vincular la reinstalación al perfil existente y atribuir las compras al usuario correcto. - Obtén el consentimiento explícito del usuario antes de recopilar y enviar correos electrónicos a Adapty. Eres responsable del cumplimiento del RGPD, CAN-SPAM y normativas similares en tus mercados objetivo. Para que Adapty Mail confirme cada nueva dirección antes de enviar comunicaciones de marketing, activa el doble opt-in.
Verifica la cobertura de tu email
Después de implementar la recopilación, comprueba la cobertura en Adapty:
- Ve a Customers > Profiles.
- Filtra por perfiles que tengan un email configurado.
Apunta a al menos un 30–50% de cobertura de email entre tus usuarios activos antes de lanzar tu primera campaña. No necesitas esperar al 100% — lanza en cuanto alcances el 30%. Los usuarios que proporcionen su email más adelante se inscriben automáticamente en las campañas activas cuando cumplen los requisitos.
Estrategias para recopilar emails
La mayoría de las apps no recopilan emails por defecto. Elige el enfoque que mejor se adapte al estado actual de tu app.
| Estrategia | Ideal para | Cómo funciona |
|---|---|---|
| Autenticación existente | Apps con cualquier tipo de inicio de sesión | Ya tienes el email — pásalo a Adapty después de que el usuario se autentique. |
| Captura de email antes del paywall | Apps sin autenticación — salud, bienestar, astrología, editores de fotos | Añade una pantalla de captura de email entre el onboarding y el paywall. La conversión suele situarse entre el 70–90% porque los usuarios ya han invertido tiempo. |
| Checkout del web paywall builder | Mínimo trabajo con el SDK; email capturado en web | La primera pantalla del web paywall builder recoge el email y lo pasa a Adapty — útil para usuarios que hacen clic en una campaña antes de que haya una pantalla de captura in-app activa. |
| Paso del onboarding | Onboarding basado en cuestionarios (fitness, nutrición, educación) | Coloca una pantalla de captura de email 2–3 pasos dentro del onboarding. Preséntala como entrega de valor (“Te enviaremos tu plan personalizado por email”) y evita que el paso sea omitible. |
| Adapty Mail API | Envío de emails desde tu servidor, sin el SDK de Adapty | Envía perfiles al endpoint Save profile de la Adapty Mail API. Consulta Enviar emails y transacciones mediante la Adapty Mail API. |
4. Configura el dominio, el checkout, la campaña y el flow
Para enviar correos, Adapty Mail necesita:
- Un dominio de envío verificado
- Una página de checkout a la que enlacen tus correos
- Una campaña para enviar
- Un flow que decida quién la recibe
Configura los cuatro en Adapty Mail: sigue los pasos del 3 al 8 de la guía Primeros pasos con Adapty Mail.
5. Activar el envío
Activar la integración es el último paso: los eventos empiezan a fluir, los segmentos comienzan a coincidir y los correos se envían. Si tu proyecto de Mail está vinculado a una app de Adapty solo cambia cómo lo activas, no lo que llega:
-
Vinculado a una app de Adapty. Adapty creó este proyecto la primera vez que abriste Mail desde el Adapty Dashboard.
En Adapty Mail, ve a Settings > Project y, en la sección Data integration, haz clic en Enable Adapty integration (o Enable si la integración ya existe de una configuración anterior).
-
No vinculado. Creaste este proyecto tú mismo en Adapty Mail, ya sea en una cuenta independiente o en tu cuenta de Adapty.
La sección Data integration no tiene el botón Enable Adapty integration, pero Adapty puede alimentar el proyecto igualmente: solo necesita la clave.
- En Adapty Mail, ve a Settings > Project y copia la Secret key.
- En el Adapty Dashboard, ve a Integrations > Adapty Mail, activa la integración, pega la clave en Secret Key y guarda.
Ambas opciones crean la misma integración en Adapty — el botón de Adapty Mail rellena automáticamente la clave secreta.
Una vez activada, Adapty envía cada evento de suscripción — nuevas suscripciones, renovaciones, trials, conversiones, reembolsos, problemas de facturación — a Adapty Mail. Estos eventos determinan la pertenencia a segmentos, el enrutamiento de campañas y las condiciones de parada que pausan una secuencia cuando un usuario convierte.
Limitaciones
- Usuarios anónimos: Sin un
customer_user_idestable, Adapty genera un nuevo ID de perfil cada vez que alguien reinstala la app o cierra sesión. Una compra realizada antes de que el usuario facilitara su email nunca llega a su perfil de Adapty Mail — queda vinculada al ID anterior. Sus ingresos, estado de compra y membresía en segmentos serán incorrectos a partir de ese momento. - Usuarios sin email: Adapty Mail no crea ningún perfil para quienes no hayan proporcionado una dirección de correo. No hay nada que excluir de los envíos ni de los análisis — simplemente no existen en el sistema. En cuanto se registre una dirección, el perfil se crea y el usuario pasa a ser elegible.