SDK de Android - Configurar un ID de usuario

Configurar un ID de usuario

Envíe su ID de usuario interno a Singular para habilitar el tracking entre dispositivos y los reportes de datos a nivel de usuario.

Nota: Si utiliza la solución entre dispositivos de Singular , debe recopilar el ID de usuario en todas las plataformas.

Requisitos del ID de usuario

Privacidad y mejores prácticas

Siga estas pautas al implementar el tracking del ID de usuario para garantizar el cumplimiento de privacidad y una medición entre dispositivos adecuada.

  • Sin PII: El ID de usuario no debe exponer información de identificación personal (PII) como direcciones de email, nombres de usuario o números de teléfono. Use un valor hash único de sus datos propios.
  • Consistencia entre plataformas: El valor del ID de usuario debe ser el mismo identificador interno que captura en todas las plataformas (Web/Mobile/PC/Console/Offline) para una medición precisa entre dispositivos.
  • Datos propios: Singular incluye el ID de usuario en exportaciones a nivel de usuario, ETL y postbacks de BI internos (si están configurados). El ID de usuario es dato propio y no se comparte con terceros.
  • Persistencia: El ID de usuario persiste hasta que se desconfigure explícitamente con unsetCustomUserId() o hasta que la aplicación se desinstale. Cerrar o reiniciar la aplicación no borra el ID de usuario.

Resumen de la implementación

Cuándo configurar el ID de usuario

Use setCustomUserId() para establecer el identificador de usuario y unsetCustomUserId() para borrarlo durante el cierre de sesión.

Mejor práctica: Si varios usuarios comparten un mismo dispositivo, implemente un flujo de cierre de sesión que llame a setCustomUserId() al iniciar sesión y a unsetCustomUserId() al cerrar sesión.

Si ya conoce el ID de usuario cuando la aplicación se abre, llame a setCustomUserId() antes de inicializar el Singular SDK. Esto garantiza que Singular reciba el ID de usuario desde la primera sesión. Sin embargo, el ID de usuario suele no estar disponible hasta que el usuario se registra o inicia sesión, en cuyo caso llame a setCustomUserId() después de que se complete el flujo de registro o autenticación.


Métodos del SDK

Configurar ID de usuario personalizado

Envíe su ID de usuario interno a Singular para el tracking entre dispositivos y los reportes a nivel de usuario.

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

Firma del método:

public static void setCustomUserId(String customUserId);

Desconfigurar ID de usuario personalizado

Borre el ID de usuario cuando el usuario cierre sesión para garantizar un tracking de sesión preciso en dispositivos compartidos por varios usuarios.

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

Firma del método:

public static void unsetCustomUserId();