Identificar usuarios en el SDK de React Native

Esta guía es para ti si tienes tu propio sistema de autenticación. Aquí aprenderás a trabajar con perfiles de usuario en Adapty para que se alinee con tu sistema de autenticación existente.

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

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 diferencia a los usuarios anónimos de los identificados:

Usuarios anónimosUsuarios identificados
Gestión de comprasRestauración de compras a nivel de storeMantienen el historial de compras en todos los dispositivos mediante su customer user ID
Gestión de perfilesNuevos perfiles en cada reinstalaciónEl mismo perfil en todas las sesiones y dispositivos
Persistencia de datosLos datos de usuarios anónimos están ligados a la instalación de la appLos datos de usuarios identificados persisten entre instalaciones de la app

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 realiza una compra en la app, esta compra queda asociada a su perfil de Adapty y a su cuenta en el store.
  3. Cuando el usuario reinstala la app o la instala en 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 activarse el SDK.

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

Las restauraciones desde copia de seguridad se comportan de forma diferente a las reinstalaciones. Por defecto, cuando un usuario restaura desde una copia de seguridad, el SDK conserva los datos en caché y no crea un nuevo perfil. Puedes configurar este comportamiento con el ajuste clearDataOnBackup. Más información.

Para los usuarios anónimos, debes contar las instalaciones por IDs 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:

Por defecto, cuando Adapty recibe una compra de un Customer User ID que está actualmente asociado a otro Customer User ID, el nivel de acceso se comparte, de modo que ambos perfiles tienen acceso de pago. Puedes configurar este ajuste para transferir el acceso de pago de un perfil a otro o desactivar el uso compartido por completo. Consulta el artículo para más detalles.

identify-diagram.webp

Durante el inicio de sesión/registro

Si identificas a los usuarios después del inicio de la app (por ejemplo, cuando inician sesión o se registran), 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 pasará a trabajar con el perfil asociado a ese customer user ID.

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.

Siempre usa await con identify antes de llamar a otros métodos del SDK. Las llamadas concurrentes generan #3006 profileWasChanged o aterrizan en el perfil anónimo. Consulta Orden de llamadas en el SDK de React Native.

try {
    await adapty.identify("YOUR_USER_ID"); // Unique for each user
    // successfully identified
} catch (error) {
    // handle the 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 configuras después de la activación, eso significa que, al activarse, Adapty creará un nuevo perfil anónimo y solo pasará al existente cuando llames a identify.

Puedes pasar un customer user ID existente (uno que ya hayas usado antes) o uno nuevo. Si pasas uno nuevo, el perfil creado al activarse se vinculará automáticamente a ese customer user ID.

Por defecto, la creación de perfiles anónimos no afecta a los dashboards de análisis, porque las instalaciones se cuentan por IDs de dispositivo.

Un ID de dispositivo representa una única instalación de la app desde el store en un dispositivo y solo se regenera cuando la app se reinstala. No depende de si es la primera instalación o una repetida, ni de si se usa un customer user ID existente.

Crear un perfil (al activar el SDK o al cerrar sesión), iniciar sesión o actualizar la app sin reinstalarla no genera eventos de instalación adicionales.

Si quieres contar las instalaciones por usuarios únicos en lugar de por dispositivos, ve a App settings y configura Installs definition for analytics.

adapty.activate("PUBLIC_SDK_KEY", {
    customerUserId: "YOUR_USER_ID" // Customer user IDs must be unique for each user. If you hardcode the parameter value, all users will be considered as one.
});

Cerrar sesión de usuarios

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

Cerrar la sesión crea un nuevo perfil anónimo para el usuario.

try {
    await adapty.logout();
    // successful logout
} catch (error) {
    // handle the error
}

Para volver a iniciar sesión en la app, usa el método identify.

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 mantengan el acceso después de iniciar 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 customer user ID nuevo (por ejemplo, la compra se realizó antes del registro), Adapty asigna el customer user ID al perfil actual, por lo que se mantiene todo el historial de compras.
    • Si es un customer user ID existente (el customer user ID ya está vinculado a un perfil), necesitas obtener el nivel de acceso actual después del 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 todo 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 como se espera
  • Onboardings: Engancha a los usuarios con onboardings y aumenta la retención
  • Integraciones: Integra con servicios de atribución de marketing y análisis con 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