Definindo um ID de usuário personalizado
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 em todas as plataformas.
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 em exportações ao nível do utilizador, ETL e postbacks de BI interno (se configurado). O ID de utilizador é um dado primário e não é partilhado com terceiros.
-
Persistência: A ID de utilizador persiste até ser explicitamente desactivada utilizando
UnsetCustomUserIdou até a aplicação ser desinstalada. Fechar ou reiniciar a aplicação não limpa a ID de utilizador.
Melhores práticas: Se vários utilizadores partilharem um único dispositivo, implemente um fluxo de fim de sessão que chame odedeSetCustomUserId no início de sessão e UnsetCustomUserId no fim de sessão.
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.
Se você souber a ID de usuário quando o aplicativo for aberto, chame SetCustomUserId antes de inicializar o SDK Singular. Isso garante que o Singular receba a ID de usuário da primeira sessão. No entanto, a ID de utilizador normalmente não está disponível até que o utilizador se registe ou inicie sessão, caso em que deve chamar SetCustomUserId após a conclusão do fluxo de registo 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.
// Set the user ID after login or registration
FString UserId = TEXT("user_abc123xyz");
USingularSDKBPLibrary::SetCustomUserId(UserId);
UE_LOG(LogTemp, Log, TEXT("Custom user ID set: %s"), *UserId);
Assinatura do método:
static void SetCustomUserId(FString customUserId);
Tempo: Se você souber a ID de usuário quando o aplicativo for aberto, chame SetCustomUserId antes de inicializar o SDK. Caso contrário, chame-o após a conclusão do registro ou login do usuário.
Anular o ID de utilizador personalizado
Limpe a ID de utilizador quando um utilizador termina a sessão para garantir um acompanhamento preciso da sessão para dispositivos multiutilizador.
// Clear the user ID on logout
USingularSDKBPLibrary::UnsetCustomUserId();
UE_LOG(LogTemp, Log, TEXT("Custom user ID has been cleared"));
Assinatura do método:
static void UnsetCustomUserId();