SDK do Android - Configurando um ID de usuário

Configurando um ID de usuário

Envie seu ID de usuário interno para a Singular para habilitar o rastreamento entre dispositivos e relatórios de dados no nível do usuário.

Observação: Se você usa a solução entre dispositivos da Singular , deve 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 conformidade com a privacidade e uma medição entre dispositivos adequada.

  • Sem PII: O ID de usuário não deve expor informações de identificação pessoal (PII) como endereços de email, nomes de usuário ou números de telefone. Use um valor hash exclusivo dos seus dados de primeira parte.
  • 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 de primeira parte: A Singular inclui o ID de usuário em exportações no nível do usuário, ETL e postbacks de BI internos (se configurados). O ID de usuário é dado de primeira parte e não é compartilhado com terceiros.
  • Persistência: O ID de usuário persiste até ser explicitamente removido 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 definir o identificador do usuário e unsetCustomUserId() para limpá-lo no logout.

Melhor prática: Se vários usuários compartilham um mesmo dispositivo, implemente um fluxo de logout que chame setCustomUserId() no login e unsetCustomUserId() no logout.

Se você já souber o ID de usuário quando o aplicativo abrir, chame setCustomUserId() antes de inicializar o Singular SDK. Isso garante que a 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 o fluxo de registro ou autenticação ser concluído.


Métodos do SDK

Definir ID de usuário personalizado

Envie seu ID de usuário interno para a Singular para rastreamento entre dispositivos e relatórios no nível do usuário.

Kotlin Java
// Set the user ID after login or registration
Singular.setCustomUserId("custom_user_id")

Assinatura do método:

public static void setCustomUserId(String customUserId);

Remover ID de usuário personalizado

Limpe o ID de usuário quando o usuário fizer logout para garantir um rastreamento de sessão preciso em dispositivos compartilhados por vários usuários.

Kotlin Java
// Unset the user ID on logout
Singular.unsetCustomUserId()

Assinatura do método:

public static void unsetCustomUserId();