Definir um ID de utilizador

Seguir
Avatar
Jared Ornstead
Updated
Documento

Definindo um ID de usuário

Você pode enviar seu ID de usuário interno para a Singular usando um método do SDK da Singular.

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

  • A ID de usuário pode ser qualquer identificador e não deve expor PII (Informações de identificação pessoal). Por exemplo, não deve utilizar o endereço de correio eletrónico, o nome de utilizador ou o número de telefone de um utilizador. A Singular recomenda o uso de um valor com hash exclusivo apenas para seus dados primários.
  • O valor da ID de usuário passado para a Singular também deve ser a mesma ID de usuário interna que você captura em todas as plataformas (Web/Mobile/PC/Console/Offline).
  • A Singular incluirá o ID de utilizador nas exportações ao nível do utilizador, ETL e postbacks do BI interno (se configurado). O ID do usuário é um dado primário e a Singular não o compartilha com outras partes.
  • O valor da ID de usuário, quando definido com o método Singular SDK, persistirá até que seja desmarcado usando o método unsetCustomUserId ou até que o aplicativo seja desinstalado. Fechar ou reiniciar a aplicação não anula a definição do ID de utilizador.

Para definir o ID de utilizador, utilize o método setCustomUserId. Para a anular (por exemplo, se o Utilizador "sair" da conta), ligue para unsetCustomUserId.

Nota: Se vários Utilizadores utilizarem um único dispositivo, recomendamos a implementação de um fluxo de fim de sessão para definir e anular a definição do ID de Utilizador para cada início e fim de sessão.

Se você já sabe a ID de usuário quando o aplicativo é aberto, chame setCustomUserId antes de inicializar o SDK do Singular. Dessa forma, o Singular pode ter a ID de usuário desde a primeira sessão. No entanto, a ID de usuário normalmente não está disponível até que o usuário se registre ou faça um login. Nesse caso, chame setCustomUserId depois que o fluxo de registro for concluído.

Método Singular.setCustomUserID
Descrição Envia o ID do usuário para o Singular.
Assinatura public void setCustomUserId(string customUserId)
Exemplo de uso 
Singular.setCustomUserId("custom_user_id");
Método Singular.unsetCustomUserID
Descrição Desmarca o ID do usuário que foi enviado para o Singular.
Assinatura public void unsetCustomUserId()
Exemplo de uso 
Singular.unsetCustomUserId();
Opcional: Mapeamento do dispositivo de ID de utilizador personalizado

Importante: Esta funcionalidade avançada da Enterprise só está disponível em casos excepcionais. Consulte um dos engenheiros de soluções da Singular antes de implementá-lo.

A Singular pode receber dados adicionais de rastreamento de eventos móveis por meio de uma integração de servidor para servidor. Para utilizar este recurso, é necessário mapear o ID do usuário para o identificador de rastreamento de dispositivos móveis da Singular.

Nota: Chame este método assim que possível após inicializar o SDK do Singular ou assim que tiver o ID do usuário.

Método Singular.setDeviceCustomUserId
Descrição Define o ID do usuário personalizado igual ao login e o mapeia para o identificador de rastreamento do Singular.
Assinatura public void setDeviceCustomUserId(string customUserId)
Exemplo de uso 
Singular.setDeviceCustomUserId("custom_user_id");