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. Utilize um valor com hash exclusivo para os 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 limpa 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 encerramento da 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. 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
Singular.setCustomUserId("custom_user_id")// Set the user ID after login or registration
Singular.setCustomUserId("custom_user_id");Assinatura do método:
public 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.
// Unset the user ID on logout
Singular.unsetCustomUserId()ode class="="java"// Unset the user ID on logout Singular.unsetCustomUserId();
Assinatura do método:
public void unsetCustomUserId()Recursos avançados
Mapeamento de dispositivo de ID de usuário personalizado
Mapeie o ID de usuário para o identificador de rastreamento de dispositivo móvel da Singular para integrações de servidor para servidor.
Importante: Este recurso avançado da Enterprise só está disponível em casos excepcionais. Consulte um engenheiro de soluções da Singular antes de implementá-lo.
A Singular pode receber dados adicionais de rastreamento de eventos móveis através da integração servidor a servidor. Para utilizar esse recurso, é necessário mapear o ID do usuário para o identificador de rastreamento de dispositivo móvel da Singular.
Nota: Chame este método o mais rápido possível após a inicialização do SDK da Singular ou assim que tiver o ID do usuário.
Implementação
Use setDeviceCustomUserId() para definir a ID de usuário personalizada e mapeá-la para o identificador de rastreamento da Singular.
// Map user ID to device identifier for S2S integration
Singular.setDeviceCustomUserId("custom_user_id")// Map user ID to device identifier for S2S integration
Singular.setDeviceCustomUserId("custom_user_id");Assinatura do método:
public void setDeviceCustomUserId(String customUserId)Descrição: Define o ID de usuário personalizado (igual ao login) e o mapeia para o identificador de rastreamento do Singular para atribuição de eventos servidor a servidor.