Pular para o conteúdo principal
O OneSignal migrou de um modelo centrado em dispositivo (Player ID) para um modelo centrado em usuário construído em torno do conceito de um usuário unificado. Este guia explica o novo modelo, como ele difere da abordagem antiga, e como migrar seu app de forma segura e bem-sucedida.
Este guia é para clientes que vêm usando o OneSignal há muito tempo nas versões 2, 3 ou 4 dos nossos Mobile SDKs ou v15 do nosso Web SDK.Se você é um novo cliente ou já migrou para a versão 5 dos nossos Mobile SDKs ou v16 do nosso Web SDK, você pode pular este guia e ir para:
Ilustração multi-canal do User Model

​
O que é o User Model?

O User Model permite que você direcione usuários reais através de todos os canais de mensagens aos quais eles se inscrevem (push móvel, push web, email, SMS e in-app) em vez de direcionar dispositivos individuais. Cada User:
  • Tem um ou mais Identity Aliases (ex: external_id, alias personalizado)
  • Pode ter múltiplas Subscriptions, uma para cada canal ou dispositivo
  • Inclui metadados como tags, idioma e histórico de atividades
Este modelo simplifica o direcionamento de público, suporta mensagens multi-canal personalizadas e desbloqueia recursos avançados como Journeys, Análises em Nível de Usuário e Resolução de Identidade em Tempo Real.
Diagrama mostrando diferença entre Player e User Models

​
Conceitos-chave

Um User representa uma pessoa real. Você pode identificar um usuário usando aliases gerados pelo sistema ou personalizados.
  • onesignal_id: Auto-gerado pelo OneSignal
  • external_id: Definido via SDK login() ou a API (alias reservado)
  • Aliases Personalizados: ex: user_id, email, facebook, etc.
Saiba mais: Users

​
Benefícios da migração

  • Identidade Unificada: Um usuário através de todos os dispositivos e canais
  • Mensagens Avançadas: Recursos poderosos como Journeys, rastreamento de login in-app e campanhas de ciclo de vida
  • Segmentação Limpa: Agrupe usuários por tags, status de inscrição, engajamento de canal e mais
  • API Simplificada: Menos endpoints, modelo de dados mais consistente

​
Passos da migração

O User Model não é compatível com versões anteriores. A migração é unidirecional do Player Model para o User Model.Antes de migrar:
  • Teste completamente com um ambiente de staging
  • Migre somente após todos os SDKs e serviços backend estarem atualizados
1

Unifique usuários com external_id

Use aliases de identidade para vincular registros de player existentes em usuários unificados.Opções:O OneSignal fará auto-merge de subscriptions sob o mesmo External ID.
2

Atualize seus SDKs OneSignal

Todos os mobile SDKs OneSignal v5+ e web SDK v16+ suportam o User Model.Implante atualizações de SDK usando estratégias de implantação faseada para minimizar risco:Veja tabela de suporte SDK abaixo.
3

Atualize seu backend para usar as novas User APIs

Substitua chamadas de API do Player Model obsoletas pelos equivalentes do novo User Model.Use nossa Referência da API e tabelas abaixo para mapear endpoints antigos para novos.

​
Suporte SDK & guias de migração

PlatformSDKMigration Guide
Androidv5+Guide
iOSv5+Guide
Unityv5+Guide
Flutterv5+Guide
React Nativev5+Guide
.NET MAUIv5+Guide
Para um mapa de métodos antigos do player model para novos métodos do user model, veja Mapeamento do Mobile SDK.

​
Referência da API

​
Próximos passos

Você está agora pronto para construir experiências de mensagens multi-canal personalizadas alimentadas pelo novo User Model!