Saltar al contenido principal
OneSignal ha migrado de un modelo centrado en dispositivos (Player ID) a un modelo centrado en usuario construido alrededor del concepto de un usuario unificado. Esta guía explica el nuevo modelo, cómo difiere del enfoque anterior, y cómo migrar tu aplicación de manera segura y exitosa.
Esta guía es para clientes que han estado usando OneSignal durante mucho tiempo en versiones 2, 3, o 4 de nuestros SDKs Móviles o v15 de nuestro SDK Web.Si eres un cliente nuevo o ya has migrado a la versión 5 de nuestros SDKs Móviles o v16 de nuestro SDK Web, puedes omitir esta guía e ir a:
Ilustración multi-canal del Modelo de Usuario

​
¿Qué es el Modelo de Usuario?

El Modelo de Usuario te permite dirigirte a usuarios reales a través de todos los canales de mensajería a los que se suscriben (push móvil, push web, email, SMS y in-app) en lugar de dirigirte a dispositivos individuales. Cada Usuario:
  • Tiene uno o más Alias de Identidad (por ejemplo, external_id, alias personalizado)
  • Puede tener múltiples Suscripciones, una para cada canal o dispositivo
  • Incluye metadatos como tags, idioma e historial de actividad
Este modelo simplifica la segmentación de audiencia, soporta mensajería multi-canal personalizada y desbloquea características avanzadas como Journeys, Analytics a Nivel de Usuario y Resolución de Identidad en Tiempo Real.
Diagrama mostrando diferencia entre modelos Player y Usuario

​
Conceptos clave

Un Usuario representa a una persona real. Puedes identificar a un usuario usando alias generados por el sistema o personalizados.
  • onesignal_id: Auto-generado por OneSignal
  • external_id: Establecido mediante login() del SDK o la API (alias reservado)
  • Aliases Personalizados: por ejemplo, user_id, email, facebook, etc.
Aprende más: Usuarios

​
Beneficios de migrar

  • Identidad Unificada: Un usuario a través de todos los dispositivos y canales
  • Mensajería Avanzada: Potencia características como Journeys, seguimiento de inicio de sesión in-app y campañas de ciclo de vida
  • Segmentación Limpia: Agrupa usuarios por tags, estado de suscripción, compromiso con el canal y más
  • API Simplificada: Menos endpoints, modelo de datos más consistente

​
Pasos de migración

El Modelo de Usuario no es retrocompatible. La migración es unidireccional del Modelo Player al Modelo de Usuario.Antes de migrar:
  • Prueba exhaustivamente con un entorno de staging
  • Migra solo después de que todos los SDKs y servicios de backend estén actualizados
1

Unificar usuarios con external_id

Usa aliases de identidad para vincular registros de player existentes en usuarios unificados.Opciones:OneSignal auto-fusionará las suscripciones bajo el mismo External ID.
2

Actualizar tus SDKs de OneSignal

Todos los SDKs móviles de OneSignal v5+ y el SDK web v16+ soportan el Modelo de Usuario.Despliega actualizaciones del SDK usando estrategias de implementación por fases para minimizar el riesgo:Consulta la tabla de soporte de SDK abajo.
3

Actualizar tu backend para usar las nuevas APIs de Usuario

Reemplaza llamadas de API del Modelo Player obsoletas con los equivalentes del Modelo de Usuario.Usa nuestra Referencia de API y las tablas abajo para mapear endpoints antiguos a nuevos.

​
Soporte de SDK y guías de migración

PlataformaSDKGuía de Migración
Androidv5+Guía
iOSv5+Guía
Unityv5+Guía
Flutterv5+Guía
React Nativev5+Guía
.NET MAUIv5+Guía
Para un mapa de métodos antiguos del modelo player a métodos nuevos del modelo usuario, consulta Mapeo del SDK móvil.

​
Referencia de API

​
Siguientes pasos

¡Ahora estás listo para construir experiencias de mensajería multi-canal personalizadas potenciadas por el nuevo Modelo de Usuario!