SDK do Unity - Definir um ID de utilizador

Seguir
Avatar
Jared Ornstead
Updated
Documento

Definindo um ID de usuário

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

Nota: Se você usar a solução Cross-Device da Singular, você deve coletar o ID do usuário em todas as plataformas.

Requisitos de ID de usuário

Privacidade e práticas recomendadas

Siga estas diretrizes ao implementar o rastreamento de ID de usuário para garantir a conformidade com a privacidade e a medição adequada entre dispositivos.

  • Sem PII: A ID de utilizador não deve expor informações de identificação pessoal (PII), tais como endereços de correio eletrónico, nomes de utilizador ou números de telefone. Use um valor com hash exclusivo para seus dados primários.
  • Consistência entre plataformas: O valor da ID de utilizador deve ser o mesmo identificador interno que capta 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 utilizador nas exportações ao nível do utilizador, ETL e postbacks do BI interno (se configurado). O ID de utilizador é um dado de primeira parte e não é partilhado com terceiros.
  • Persistência: O ID de utilizador persiste até ser explicitamente desativado utilizando UnsetCustomUserId() ou até a aplicação ser desinstalada. Fechar ou reiniciar a aplicação não apaga o ID de utilizador.

Descrição geral da implementação

Quando definir o ID de utilizador

Utilize SetCustomUserId() para definir o identificador de utilizador e UnsetCustomUserId() para o limpar durante o fim de sessão.

Melhores práticas: Se vários utilizadores partilharem um único dispositivo, implemente um fluxo de fim de sessão que chame SetCustomUserId() no início de sessão e UnsetCustomUserId() no fim de sessão.

Se você já souber a ID de usuário quando o aplicativo for aberto, chame SetCustomUserId() antes de inicializar o SDK do Singular. No entanto, a 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

Definir ID de usuário personalizada

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

C# 
// Set the user ID after login or registration
SingularSDK.SetCustomUserId("custom_user_id");

Assinatura do método: 

public static void SetCustomUserId(string customUserId)

Cancelar definição da ID de usuário personalizada

Limpe a ID de usuário quando um usuário fizer logout para garantir o rastreamento preciso da sessão para dispositivos multiusuário.

C# 
// Unset the user ID on logout
SingularSDK.UnsetCustomUserId();

Assinatura do método: 

public static void UnsetCustomUserId()