La forma en que gestionas las compras de los usuarios depende del modelo de autenticación de tu app:

• Si tu app no usa autenticación de backend ni almacena datos de usuario, consulta la sección sobre usuarios anónimos.
• Si tu app tiene (o tendrá) autenticación de backend, consulta la sección sobre usuarios identificados.

Conceptos clave:

• Los perfiles son las entidades necesarias para que el SDK funcione. Adapty los crea automáticamente.
• Pueden ser anónimos (sin customer user ID) o identificados (con customer user ID).
• Proporcionas el customer user ID para cruzar los perfiles de Adapty con tu sistema de autenticación interno.

Esto es lo que difiere entre usuarios anónimos e identificados:

	Usuarios anónimos	Usuarios identificados
Gestión de compras	Restauración de compras a nivel de store	Mantienen el historial de compras entre dispositivos mediante su customer user ID
Gestión de perfiles	Nuevos perfiles en cada reinstalación	El mismo perfil entre sesiones y dispositivos
Persistencia de datos	Los datos de usuarios anónimos están ligados a la instalación de la app	Los datos de usuarios identificados persisten entre instalaciones

Usuarios anónimos

Si no tienes autenticación de backend, no necesitas gestionar la autenticación en el código de la app:

1. Cuando el SDK se activa en el primer inicio de la app, Adapty crea un nuevo perfil para el usuario.
2. Cuando el usuario compra algo en la app, esa compra se asocia a su perfil de Adapty y a su cuenta en el store.
3. Cuando el usuario reinstala la app o la instala desde un nuevo dispositivo, Adapty crea un nuevo perfil anónimo al activarse.
4. Si el usuario ya había realizado compras en tu app, por defecto sus compras se sincronizan automáticamente desde el App Store al activar el SDK.

Con usuarios anónimos, se crearán nuevos perfiles en cada instalación, pero eso no es un problema porque en los análisis de Adapty puedes configurar qué se considerará una nueva instalación.

Para los usuarios anónimos, debes contar las instalaciones por ID de dispositivo. En este caso, cada instalación de la app en un dispositivo se cuenta como una instalación, incluidas las reinstalaciones.

Usuarios identificados

Tienes dos opciones para identificar usuarios en la app:

• Durante el login/registro: Si los usuarios inician sesión después de que tu app arranque, llama a identify() con un customer user ID cuando se autentiquen.

• Durante la activación del SDK: Si ya tienes un customer user ID almacenado cuando la app se inicia, envíalo al llamar a activate().

Durante el login/registro

Si identificas a los usuarios después de que arranque la app (por ejemplo, tras iniciar sesión o registrarse), usa el método identify para establecer su customer user ID.

• Si no has usado este customer user ID antes, Adapty lo vinculará automáticamente al perfil actual.
• Si ya has usado este customer user ID para identificar al usuario antes, Adapty cambiará a trabajar con el perfil asociado a ese customer user ID.

Espera a que identify se complete (en su callback onSuccess) antes de llamar a otros métodos del SDK. Las llamadas concurrentes pueden acabar en el perfil anónimo. Consulta Orden de llamadas en el SDK de Kotlin Multiplatform.

Adapty.identify("YOUR_USER_ID") // Único para cada usuario
    .onSuccess {
        // identify exitoso
    }
    .onError { error ->
        // gestionar el error
    }

Durante la activación del SDK

Si ya conoces el customer user ID cuando activas el SDK, puedes enviarlo en el método activate en lugar de llamar a identify por separado.

Si conoces un customer user ID pero solo lo estableces después de la activación, eso significa que, al activarse, Adapty creará un nuevo perfil anónimo y cambiará al existente solo cuando llames a identify.

Puedes pasar un customer user ID existente (uno que hayas usado antes) o uno nuevo. Si pasas uno nuevo, el nuevo perfil creado en la activación se vinculará automáticamente al customer user ID.

AdaptyConfig.Builder("PUBLIC_SDK_KEY")
    .withCustomerUserId("user123") // Los customer user IDs deben ser únicos para cada usuario. Si hardcodeas el valor del parámetro, todos los usuarios se considerarán como uno solo.
    .build()

Cerrar sesión de usuarios

Si tienes un botón para cerrar la sesión de los usuarios, usa el método logout.

Adapty.logout()
    .onSuccess {
        // cierre de sesión exitoso
    }
    .onError { error ->
        // gestionar el error
    }

Permitir compras sin inicio de sesión

Si tus usuarios pueden realizar compras tanto antes como después de iniciar sesión en tu app, debes asegurarte de que mantendrán el acceso una vez que inicien sesión:

1. Cuando un usuario sin sesión iniciada realiza una compra, Adapty la vincula a su ID de perfil anónimo.
2. Cuando el usuario inicia sesión en su cuenta, Adapty pasa a trabajar con su perfil identificado.
   • Si es un nuevo customer user ID (por ejemplo, la compra se realizó antes del registro), Adapty asigna el customer user ID al perfil actual, por lo que todo el historial de compras se mantiene.
   • Si es un customer user ID existente (el customer user ID ya está vinculado a un perfil), debes obtener el nivel de acceso real tras el cambio de perfil. Puedes llamar a getProfile justo después de la identificación, o escuchar las actualizaciones del perfil para que los datos se sincronicen automáticamente.

Próximos pasos

¡Enhorabuena! Has implementado la lógica de pago in-app en tu app. ¡Te deseamos lo mejor con la monetización de tu app!

Para sacar aún más partido a Adapty, puedes explorar estos temas:

• Pruebas: Asegúrate de que todo funciona correctamente
• Integraciones: Integra con servicios de atribución de marketing y análisis en una sola línea de código
• Establecer atributos de perfil personalizados: Añade atributos personalizados a los perfiles de usuario y crea segmentos para lanzar pruebas A/B o mostrar diferentes paywalls a distintos usuarios