O componente Device ID gera um identificador estável e exclusivo por dispositivo (UTDID) para cada dispositivo móvel, permitindo o reconhecimento consistente entre sessões sem exigir login do usuário ou gerenciamento de IDs no servidor.
Aplicativos usam o UTDID para distinguir dispositivos em análises, controle de riscos, direcionamento de notificações push e outros cenários que exigem identificação confiável entre sessões.
Funcionamento
Quando o aplicativo chama a API do Device ID pela primeira vez, o componente gera um UTDID e o armazena localmente no dispositivo. Chamadas subsequentes retornam o mesmo UTDID sem requisição de rede. O UTDID tem escopo de aplicativo: todos os apps integrados ao mPaaS SDK no mesmo dispositivo compartilham o mesmo valor de UTDID.
Persistência do ID
A persistência do UTDID depende de como e quando o ID foi gerado. Consulte a tabela a seguir para verificar se o UTDID atende ao seu cenário:
|
Cenário |
Comportamento do UTDID |
|
Reinício do aplicativo ou do dispositivo |
Permanece inalterado |
|
Limpeza de dados ou cache do aplicativo |
Permanece inalterado |
|
Desinstalação e reinstalação do aplicativo |
Pode mudar. Um novo UTDID é gerado caso o ID armazenado localmente seja perdido. |
|
Restauração de fábrica do dispositivo |
Muda. O UTDID armazenado é apagado e um novo é gerado na próxima execução. |
|
Troca de dispositivo pelo usuário |
Muda. Cada dispositivo físico possui seu próprio UTDID. |
|
Vários aplicativos no mesmo dispositivo (todos usando mPaaS SDK) |
Permanece inalterado — todos os aplicativos compartilham o mesmo UTDID. |
Nota: Não há garantia de que o UTDID seja globalmente único em todos os dispositivos o tempo todo. Não o utilize como único identificador em cenários que exigem garantias rigorosas de unicidade, como deduplicação de transações financeiras ou verificação de identidade legal.
Comportamento por plataforma
O componente oferece suporte a Android e iOS. O comportamento do UTDID varia entre as plataformas:
Android
O UTDID fica armazenado no armazenamento local do dispositivo. Ele persiste entre atualizações e reinstalações do aplicativo, desde que o armazenamento do dispositivo permaneça intacto. Uma restauração de fábrica ou a exclusão manual dos dados do aplicativo regenera o UTDID.
iOS
O UTDID é armazenado no Keychain do iOS. Como os dados do Keychain persistem após a desinstalação de aplicativos, o UTDID sobrevive à reinstalação no iOS — diferentemente do Android, onde o UTDID pode ser regenerado após uma desinstalação.
Casos de uso
Análise e atribuição: Identifique usuários recorrentes no mesmo dispositivo sem exigir login na conta.
Controle de riscos: Detecte padrões de comportamento anormais associados a um dispositivo específico.
Direcionamento de notificações push: Encaminhe notificações para dispositivos específicos usando um identificador estável no nível do dispositivo.
Testes A/B: Atribua dispositivos a grupos de teste de forma consistente entre sessões.
Limitações
Inadequado para requisitos rígidos de unicidade: O UTDID pode ser regenerado após uma restauração de fábrica ou, no Android, após uma desinstalação. Em cenários que exigem uma impressão digital permanente e infalsificável do dispositivo, combine o UTDID com a vinculação de conta no servidor.
Inviável para rastreamento entre plataformas: Os valores de UTDID para Android e iOS de um mesmo dispositivo são independentes. Se o usuário trocar de plataforma, o ID do dispositivo mudará.
Não representa a identidade do usuário: O UTDID identifica um dispositivo, não uma conta de usuário. Caso vários usuários compartilhem o mesmo dispositivo, todos receberão o mesmo UTDID.
Próximos passos
[Integrar o componente Device ID no Android]()
[Integrar o componente Device ID no iOS]()
[Referência da API do Device ID]()