Establecer un ID de usuario

Envíe su ID de usuario interno a Singular para permitir el seguimiento entre dispositivos y la generación de informes de datos a nivel de usuario. Este identificador vincula la actividad del usuario entre sesiones y dispositivos para un análisis de atribución exhaustivo.

Requisitos del ID de usuario

Privacidad y buenas prácticas

Siga estas pautas cuando implemente el rastreo de ID de usuario para garantizar el cumplimiento de la privacidad y la correcta medición entre dispositivos.

• Sin PII: El ID de usuario no debe exponer información personal identificable (PII) como direcciones de correo electrónico, nombres de usuario o números de teléfono. Utilice un valor hash único para sus datos de origen.
• Coherencia entre plataformas: El valor del ID de usuario debe ser el mismo identificador interno que se captura en todas las plataformas (Web/Móvil/PC/Consola/Offline) para una medición precisa entre dispositivos.
• Datos de primera parte: Singular incluye el ID de usuario en las exportaciones a nivel de usuario, ETL y postbacks de BI interno (si está configurado). El ID de usuario es un dato de primera parte y no se comparte con terceros.
• Persistencia: El ID de usuario persiste hasta que se anula explícitamente mediante unsetCustomUserId() o hasta que se desinstala la aplicación. Cerrar o reiniciar la aplicación no borra el ID de usuario.

Resumen de la implementación

Cuándo establecer el ID de usuario

Utilice setCustomUserId() para establecer el identificador de usuario y unsetCustomUserId() para borrarlo durante el cierre de sesión. Elija el enfoque de implementación en función de cuándo esté disponible el identificador de usuario en el flujo de su aplicación.

Si ya conoce el ID de usuario cuando se abre la aplicación (por ejemplo, el usuario tiene un inicio de sesión persistente), configúrelo mediante withCustomUserId() antes de inicializar Singular SDK. Esto garantiza que Singular reciba el ID de usuario desde la primera sesión. Sin embargo, el ID de usuario no suele estar disponible hasta que el usuario se registra o inicia sesión, en cuyo caso llame a setCustomUserId() una vez finalizado el flujo de registro o autenticación.

Métodos SDK

Establecer ID de usuario personalizado

Envíe su ID de usuario interno a Singular para el seguimiento entre dispositivos y la generación de informes a nivel de usuario. Llame a este método inmediatamente después de la autenticación correcta para asegurarse de que todos los eventos posteriores se asocian con el usuario.

// Set the user ID after login or registration
cordova.plugins.SingularCordovaSdk.setCustomUserId('user_123456');

Firma del método:

setCustomUserId(customUserId: string): void

Ejemplo: Establecer ID de usuario después del inicio de sesión

Llame a setCustomUserId() inmediatamente después de que el usuario complete correctamente la autenticación para asegurarse de que todos los eventos posteriores se asocien a su ID de usuario.

function handleUserLogin(email, password) {
  // Your authentication logic
  authenticateUser(email, password)
    .then(function(response) {
      if (response.success) {
        // Set the user ID in Singular after successful login
        cordova.plugins.SingularCordovaSdk.setCustomUserId(response.userId);
        
        console.log('User ID set:', response.userId);
        
        // Navigate to home screen
        navigateToHome();
      }
    })
    .catch(function(error) {
      console.error('Login failed:', error);
    });
}

Desactivar ID de usuario personalizada

Borre el ID de usuario cuando un usuario cierre la sesión para garantizar un seguimiento preciso de la sesión en dispositivos multiusuario. Esto evita que los eventos posteriores se atribuyan incorrectamente al usuario que ha cerrado la sesión.

// Unset the user ID on logout
cordova.plugins.SingularCordovaSdk.unsetCustomUserId();

Firma del método:

unsetCustomUserId(): void

Ejemplo: Anulación del ID de usuario al cerrar la sesión

Llame a unsetCustomUserId() durante el flujo de cierre de sesión para borrar el ID de usuario y evitar la atribución incorrecta de eventos posteriores.

function handleUserLogout() {
  // Clear app data and user session
  clearUserSession()
    .then(function() {
      // Unset the user ID in Singular
      cordova.plugins.SingularCordovaSdk.unsetCustomUserId();
      
      console.log('User ID cleared');
      
      // Navigate to login screen
      navigateToLogin();
    })
    .catch(function(error) {
      console.error('Logout failed:', error);
    });
}

Establecer ID de usuario durante la inicialización

Si el ID de usuario está disponible cuando se inicia la aplicación (por ejemplo, el usuario ya ha iniciado sesión con una sesión persistente), configúrelo durante la inicialización del SDK mediante withCustomUserId(). Esto garantiza que la primera sesión incluya el ID de usuario.

document.addEventListener('deviceready', initializeApp, false);

function initializeApp() {
  // Check if user is already logged in (e.g., from local storage)
  var userId = localStorage.getItem('user_id');
  
  // Create configuration
  var config = new cordova.plugins.SingularCordovaSdk.SingularConfig(
    'YOUR_SDK_KEY',
    'YOUR_SDK_SECRET'
  );
  
  // If user ID exists, set it during initialization
  if (userId) {
    config.withCustomUserId(userId);
  }
  
  // Initialize SDK
  cordova.plugins.SingularCordovaSdk.init(config);
  console.log('Singular SDK initialized');
}

Firma del método de configuración:

withCustomUserId(customUserId: string): SingularConfig