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.
Adapty Mail es un producto independiente. Puedes usarlo aunque tus paywalls, suscripciones o análisis no estén gestionados por Adapty — no es necesario migrar toda tu infraestructura.
Para obtener datos de ingresos precisos, la configuración mínima consiste en instalar el SDK de Adapty en modo observador y activar las notificaciones del servidor de App Store.
Adapty Mail necesita tres cosas de tu app: datos de compra (para poder atribuir los ingresos al email que generó cada conversión), un identificador de usuario estable y los emails de los usuarios. Configura las tres y luego activa el envío.
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 — el ID de usuario de tu backend, un UID de Firebase o similar — ya sea incluyéndolo como customerUserId en .activate() al iniciar el SDK, o llamando a Adapty.identify() más adelante (por ejemplo, al hacer login). En cualquier caso, establece el ID antes de mostrar cualquier paywall. El customer_user_id es la forma en que Adapty Mail relaciona campañas, clics y compras con el perfil correcto.
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.
Verifica la cobertura de tu correo electrónico
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 una cobertura de email de al menos el 30–50% 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. Activar el envío
Vuelve a este paso cuando el resto de la configuración esté lista. Adapty Mail desactiva el botón Enable hasta que tengas al menos un flow, con el tooltip “Set up at least one flow before enabling Adapty integration” — así que termina primero tu dominio de envío, checkout, campaña y flow. Consulta Primeros pasos con Adapty Mail.
Activar la integración es el interruptor final: los eventos empiezan a fluir, los segmentos empiezan a coincidir y los correos empiezan a enviarse.
- En Adapty Mail, ve a Settings → Project y localiza la sección Adapty Integration.
- Haz clic en Enable Adapty integration (o en Enable si la integración ya existe de una configuración anterior).
Cuando está habilitada, Adapty envía cada evento de suscripción — nuevas suscripciones, renovaciones, pruebas, conversiones, reembolsos, problemas de facturación — a Adapty Mail. Estos eventos controlan la pertenencia a segmentos, el enrutamiento de campañas y las condiciones de parada que pausan una secuencia cuando un usuario convierte.
La sección Adapty Integration aparece únicamente en proyectos vinculados a un workspace de Adapty. Si te registraste directamente en Adapty Mail y tu proyecto no está vinculado, esta sección no estará disponible — envía tus datos a través de la API de Adapty Mail en su lugar.
El botón Adapty integration en Settings no es lo mismo que el workspace de partner de Adapty con el que iniciaste sesión en Adapty Mail. El workspace de partner es el que creó tu cuenta y (si te registraste a través de Adapty) tu marca. El botón de integración aquí controla la sincronización de eventos — debe activarse por proyecto.
Limitaciones
- Usuarios anónimos: Los usuarios sin un
customer_user_idestable no pueden recibir campañas. Identifícalos cuando creen una cuenta o inicien sesión — a partir de ese momento, cualquier email que proporcionen se asocia a su perfil de Adapty. - Usuarios sin email: Los perfiles sin email quedan excluidos de la entrega de campañas y no aparecen en los análisis de campañas. En cuanto proporcionen un email, pasan a ser elegibles para futuras campañas.