Orden de llamadas en el SDK de Android
Adapty.activate() debe completarse antes de llamar a cualquier otro método del SDK de Adapty. Hasta que finalice, el SDK no tiene estado. Cualquier llamada emitida antes o en paralelo con activate() falla con ADAPTY_NOT_INITIALIZED.
Si tu app autentica usuarios y recoges un ID de usuario personalizado después del lanzamiento, llama a Adapty.identify() en ese momento. No llames a métodos de acción de usuario hasta que se ejecute el callback de finalización de identify. Las llamadas que compiten con él devuelven un error en su callback, o recaen sobre el perfil anónimo creado en la activación. Cuando esto ocurre, la atribución, los IDs de MMP como appsflyer_id y la propiedad de la instalación no siempre se transfieren al perfil identificado. Si tu app no autentica usuarios, omite identify y sigue trabajando con el perfil anónimo.
Los SDKs de MMP y analíticas (AppsFlyer, Adjust, Branch, PostHog) siguen la misma regla. Inicialízalos primero y espera sus callbacks de UID antes de llamar a Adapty.activate. De lo contrario, el ID del MMP queda en un perfil anónimo temporal y no siempre se transfiere al perfil identificado. Para los detalles específicos de AppsFlyer, consulta AppsFlyer.
El orden correcto
Tu camino depende de dos cosas: cuándo conoces el ID de usuario personalizado y si usas un SDK de MMP o analíticas.
- Pasos 2 y 5: Obligatorios para toda app. Activa el SDK y luego llama a los métodos del SDK.
- Pasos 1 y 3: Necesarios solo si integras un SDK de MMP o analíticas (AppsFlyer, Adjust, Branch, PostHog).
- Paso 4: Necesario solo si tu app autentica usuarios y recoge el ID de usuario personalizado después del lanzamiento.
Si tienes el ID de usuario personalizado al lanzar la app, pásalo en el AdaptyConfig.Builder antes de llamar a activate() (paso 2a). Esta ruta nunca crea un perfil anónimo, por lo que el paso 4 no es necesario.
| Paso | Llamada | Cuándo | Notas |
|---|---|---|---|
| 1 | Inicializa tu SDK de MMP o analíticas (AppsFlyer, Adjust, PostHog, Branch) | Al arrancar la app, lo primero | Espera el callback de UID del MMP, por ejemplo getAppsFlyerUID. |
| 2a | Adapty.activate(context, AdaptyConfig.Builder("KEY").withCustomerUserId(...).build()) | Al arrancar la app, después del paso 1, si tienes el ID de usuario | Recomendado. No se crea ningún perfil anónimo. |
| 2b | Adapty.activate(context, AdaptyConfig.Builder("KEY").build()) sin customerUserId | Al arrancar la app, después del paso 1, si no tienes el ID de usuario (o nunca lo recoges) | Adapty crea un perfil anónimo. |
| 3 | Adapty.setIntegrationIdentifier(AdaptyIntegrationIdentifier.appsflyerId(uid)) { error -> ... } | Después del paso 2, antes de cualquier llamada de acción del usuario | Necesario para que los IDs del MMP se asocien al perfil correcto. Pasa una lista de identificadores para configurar varios MMPs en una sola llamada. |
| 4 | Adapty.identify("YOUR_USER_ID") { error -> ... } | Después del paso 3 (o del paso 2 si no hay MMP), antes del paso 5 — solo en el flujo 2b con autenticación | Usa el callback de finalización. Las llamadas concurrentes durante identify pueden caer en el perfil anónimo. |
| 5 | getPaywall, getPaywallProducts, restorePurchases, makePurchase, updateExternalAttribution, updateProfile | Después del paso 4 si llamas a identify; si no, después del paso 3 (o del paso 2 si no hay MMP) | Estas llamadas necesitan un perfil estable. |
Saltarse estos pasos provoca pérdida de acceso premium para usuarios que regresan, que falte appsflyer_id en los perfiles, y que se devuelvan paywalls para la audiencia equivocada.
Instalaciones web2app y de embudo web
Si los usuarios compran en un checkout web (Stripe, Paddle) y luego instalan la app nativa, el primer activate() del dispositivo crea un nuevo perfil anónimo. Este perfil no está vinculado al perfil web. Si puedes resolver el ID de usuario personalizado antes del lanzamiento de la app (desde tu flujo de autenticación o el referrer de instalación), pásalo directamente en el AdaptyConfig.Builder. De lo contrario, la compra web será invisible en el dispositivo hasta que llames a identify("YOUR_USER_ID") y luego a restorePurchases.
Para los metadatos que enviar con cada checkout web, consulta: