SDK de iOS - 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 la privacidad y una medición correcta entre dispositivos.

  • Sin PII: El ID de usuario no debe exponer información de identificación personal (PII) como direcciones de correo electrónico, nombres de usuario o números de teléfono. Use un valor hasheado y único de sus datos propios (first-party).
  • Consistencia entre plataformas: El valor del ID de usuario debe ser el mismo identificador interno que captura en todas las plataformas (Web/Móvil/PC/Consola/Offline) para una medición precisa entre dispositivos.
  • Datos propios (first-party): Singular incluye el ID de usuario en las exportaciones a nivel de usuario, ETL y postbacks de BI internos (si están configurados). El ID de usuario son datos propios y no se comparten con terceros.
  • Persistencia: El ID de usuario persiste hasta que se desactiva explícitamente usando 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 configurar el ID de usuario

Utilice setCustomUserId() para configurar 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() en el inicio de sesión y a unsetCustomUserId() en el cierre de sesión.

Si ya conoce el ID de usuario cuando se abre la aplicación, llame a setCustomUserId() antes de inicializar el SDK de Singular. Esto garantiza que Singular reciba el ID de usuario desde la primera sesión. Sin embargo, el ID de usuario normalmente no está 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 el Custom User ID

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

Swift Objective-C
// Set the user ID after login or registration
Singular.setCustomUserId("custom_user_id")

Firma del método:

+ (void)setCustomUserId:(NSString *)customUserId;

+setCustomUserId: devuelve void — no hay señal de éxito/error en el punto de llamada. El ID de usuario se adjunta a la siguiente sesión y evento que envía el SDK.

El método de nombre similar +setDeviceCustomUserId: está anotado como __attribute__((deprecated)) y existe únicamente por compatibilidad con código heredado. Llame siempre a +setCustomUserId: en el código nuevo.


Desactivar el Custom User ID

Borre el ID de usuario cuando un usuario cierre sesión para garantizar un tracking preciso de las sesiones en dispositivos multiusuario.

Swift Objective-C
// Unset the user ID on logout
Singular.unsetCustomUserId()

Firma del método:

+ (void)unsetCustomUserId;