Configurando um ID de usuário
Envie seu ID de usuário interno para o Singular para habilitar o rastreamento entre dispositivos e relatórios de dados em nível de usuário.
Observação: Se você usa a solução entre dispositivos do Singular , é necessário coletar o ID de usuário em todas as plataformas.
Requisitos do ID de usuário
Privacidade e melhores práticas
Siga estas diretrizes ao implementar o rastreamento do ID de usuário para garantir a conformidade com a privacidade e a medição correta entre dispositivos.
- Sem PII: O ID de usuário não deve expor Informações de Identificação Pessoal (PII), como endereços de e-mail, nomes de usuário ou números de telefone. Use um valor hasheado e único dos seus dados próprios (first-party).
- Consistência entre plataformas: O valor do ID de usuário deve ser o mesmo identificador interno que você captura em todas as plataformas (Web/Mobile/PC/Console/Offline) para uma medição precisa entre dispositivos.
- Dados próprios (first-party): O Singular inclui o ID de usuário em exportações em nível de usuário, ETL e postbacks de BI internos (se configurados). O ID de usuário é um dado próprio e não é compartilhado com terceiros.
-
Persistência:
O ID de usuário persiste até ser explicitamente
desativado usando
unsetCustomUserId()ou até que o aplicativo seja desinstalado. Fechar ou reiniciar o aplicativo não limpa o ID de usuário.
Visão geral da implementação
Quando configurar o ID de usuário
Use
setCustomUserId()
para configurar o identificador do usuário e
unsetCustomUserId()
para limpá-lo durante o logout.
Melhor prática:
Se vários usuários compartilham um único
dispositivo, implemente um fluxo de logout que chame
setCustomUserId()
no login e
unsetCustomUserId()
no logout.
Se você já conhece o ID de usuário quando o aplicativo é aberto, chame
setCustomUserId()
antes de inicializar o SDK do Singular.
Isso garante que o Singular receba o ID de usuário desde a primeira sessão. No entanto,
o ID de usuário normalmente não está disponível até que o usuário se registre ou faça
login. Nesse caso, chame
setCustomUserId()
após a conclusão do fluxo de
registro ou autenticação.
Métodos do SDK
Configurar o Custom User ID
Envie seu ID de usuário interno para o Singular para rastreamento entre dispositivos e relatórios em nível de usuário.
// Set the user ID after login or registration
Singular.setCustomUserId("custom_user_id")// Set the user ID after login or registration
[Singular setCustomUserId:@"custom_user_id"];Assinatura do método:
+ (void)setCustomUserId:(NSString *)customUserId;
+setCustomUserId:
retorna
void
— não há sinal de sucesso/falha no ponto de chamada. O ID de usuário é
anexado à próxima sessão e evento que o SDK enviar.
O método de nome semelhante
+setDeviceCustomUserId:
está anotado como
__attribute__((deprecated))
e existe apenas para compatibilidade com código legado. Sempre chame
+setCustomUserId:
em código novo.
Desativar o Custom User ID
Limpe o ID de usuário quando um usuário fizer logout para garantir o rastreamento preciso das sessões em dispositivos multiusuário.
// Unset the user ID on logout
Singular.unsetCustomUserId()// Unset the user ID on logout
[Singular unsetCustomUserId];Assinatura do método:
+ (void)unsetCustomUserId;