Saltar al contenido principal

​
Descripción general

En OneSignal, un Usuario representa a un individuo con una o más Suscripciones a través de tus canales de mensajería (push móvil, push web, email y SMS).
  • Cada Usuario puede tener hasta 20 Suscripciones.
  • A cada Usuario se le asigna automáticamente un OneSignal ID (UUID v4).
  • Los Usuarios comienzan como anónimos hasta que les asignes un External ID. Asignar un External ID vincula las Suscripciones y puede reemplazar el OneSignal ID existente si el usuario ya existe en tu aplicación.
  • Los Usuarios y las Suscripciones tienen propiedades diferentes. Por ejemplo, los Tags se almacenan a nivel de Usuario, mientras que el estado de suscripción (opt-in/out) pertenece a la Suscripción.
  • Cuando el contexto del Usuario cambia — por ejemplo, iniciar sesión (anónimo → identificado) o cambiar de cuenta (UserA → UserB) — la Suscripción se reasigna del Usuario anterior al nuevo.
    • La Suscripción ahora heredará las propiedades del nuevo Usuario.
    • Las propiedades vinculadas al Usuario anterior (como Tags, idioma o External ID) ya no aplicarán.
Ejemplo:
  • UserA tiene Tag premium=true
  • UserB tiene Tag premium=false
  • Si una Suscripción se mueve de UserA a UserB, ya no estará asociada con premium=true y en su lugar reflejará las propiedades de UserB.

​
Usuarios anónimos vs. identificados

  • Usuario anónimo: No tiene External ID → cada Suscripción es separada con su propio OneSignal ID (tratados como Usuarios separados).
  • Usuario identificado: Tiene un External ID → OneSignal fusiona todas las Suscripciones bajo un único OneSignal ID.
Ejemplo: Usuario anónimo
  • Suscripción de push web → OneSignal_ID_1
  • Suscripción móvil → OneSignal_ID_2
  • Suscripción de email → OneSignal_ID_3
  • Suscripción de SMS → OneSignal_ID_4
  • Resultado: Cuatro Usuarios (cada Suscripción es un Usuario separado con propiedades únicas)
Ejemplo: Usuario identificado
  • Suscripción de push web con External ID External_ID_A → OneSignal_ID_1
  • Suscripción móvil con el mismo External_ID_A → fusionado en OneSignal_ID_1
  • Suscripción de email con el mismo External_ID_A → fusionado en OneSignal_ID_1
  • Suscripción de SMS con el mismo External_ID_A → fusionado en OneSignal_ID_1
  • Resultado: Un Usuario con cuatro Suscripciones (todas vinculadas al mismo Usuario)
Siempre asigna un External ID. Esto asegura que las Suscripciones a través de canales y dispositivos se unifiquen bajo un único perfil de Usuario y previene duplicación.
  • Usa identificadores estables y no genéricos (por ejemplo, tu ID de usuario interno o dirección de email).
  • Llama a OneSignal.login temprano en el ciclo de vida de tu aplicación.

​
Propiedades del usuario

​
OneSignal ID

El OneSignal ID es un UUID v4 interno generado para representar únicamente a un usuario. Se crea automáticamente en escenarios como:
  • Primera apertura de la aplicación móvil (o después de reinstalar)
  • Nueva Suscripción de push web
  • Crear Usuarios/Suscripciones mediante Create user o Importación CSV
  • Limpiar el caché del navegador y volver al sitio
  • Cerrar sesión con OneSignal.logout
Una vez que se usa un External ID mediante OneSignal.login, cualquier OneSignal ID existente vinculado a la Suscripción actual es reemplazado por el asociado con ese External ID. Las Suscripciones a través de plataformas (Push, Email, SMS) se fusionarán bajo el mismo OneSignal ID si comparten el mismo External ID.

​
Reasignación y comportamiento

Si un usuario reinstala la aplicación o limpia el caché, se crean un nuevo OneSignal ID y Suscripción. Sin embargo, llamar a OneSignal.login vinculará la nueva Suscripción de vuelta al perfil de usuario original. Las Suscripciones agregadas mediante OneSignal.User.addEmail o addSms heredarán el OneSignal ID actual. Referencias del SDK:

​
External ID

El External ID es una cadena única que asignas a los usuarios para rastrearlos a través de dispositivos y suscripciones.

Usa el External ID para rastrear al usuario a través de sus suscripciones.

Puedes establecer o eliminar el External ID mediante:

​
IDs restringidos

No uses valores de marcador de posición o valores temporales para External IDs. Los siguientes valores no pueden usarse para External IDs:
  • NA
  • NULL
  • -1
  • 0
  • 1
  • all
  • 00000000-0000-0000-0000-000000000000

​
Múltiples usuarios en el mismo dispositivo

Cuando múltiples usuarios comparten un dispositivo, cada nuevo inicio de sesión debe activar una llamada a OneSignal.login con un External ID diferente. Esto reasigna el OneSignal ID y la Suscripción al nuevo usuario. Para manejar el cierre de sesión, puedes hacer lo siguiente para eliminar el contexto del usuario:
  • Llama a OneSignal.logout() → limpia el External ID, elimina las propiedades de usuario anteriores (Tags, Aliases, etc.), y asigna un OneSignal ID anónimo.
  • Opcionalmente deshabilita las notificaciones usando optOut, y rehabilita con optIn al iniciar sesión nuevamente.

​
Usuarios activos mensuales (MAU)

MAU se usa para facturación y se define como una Suscripción móvil que tiene una última sesión dentro del período de facturación de 30 días. Esto incluye:
  • Usuarios que abren tu aplicación por primera vez, creando una Suscripción móvil a través de nuestro SDK
  • Usuarios que reinstalan la aplicación y la abren nuevamente, creando otra Suscripción móvil a través de nuestro SDK
  • Usuarios que se importan a través de nuestra API

​
Ejemplo de facturación MAU

Si un Usuario tiene estas Suscripciones:
  • Móvil iOS (activo en los últimos 30 días)
  • Móvil Android (activo en los últimos 30 días)
  • Push web
  • Email
  • SMS
Solo las Suscripciones móviles iOS y Android cuentan, resultando en 2 MAUs. El estado de suscripción no importa para la facturación MAU.

​
Reducir MAUs (ej., casos de uso de paywall)

Puedes retrasar la inicialización del SDK y la creación de Suscripción usando los métodos de privacidad del SDK móvil.
  1. Llama a setConsentRequired() antes de inicializar el SDK – esto previene la creación automática de una Suscripción
  2. Llama a setConsentGiven() cuando estés listo para crear una Suscripción para el usuario