SDK de iOS - Establecer un ID de usuario

Documento

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.

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

Requisitos de ID de usuario

Privacidad y buenas prácticas

Siga estas directrices cuando implemente el seguimiento de ID de usuario para garantizar el cumplimiento de la privacidad y la medición adecuada 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.

Práctica recomendada: Si varios usuarios comparten un mismo dispositivo, implementa un flujo de cierre de sesión que llame a setCustomUserId() al iniciar sesión y a unsetCustomUserId() al finalizarla.

Si ya conoce el identificador de usuario cuando se abre la aplicación, llame a setCustomUserId() antes de inicializar Singular SDK. Esto garantiza que Singular reciba el identificador 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.

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

Firma del método:

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

Desactivar ID de usuario personalizado

Borre el ID de usuario cuando un usuario cierre la sesión para garantizar un seguimiento preciso de la sesión en dispositivos multiusuario.

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

Método Firma:

+ (void)unsetCustomUserId;

Funciones avanzadas

Asignación de dispositivos de ID de usuario personalizado

Asigne el ID de usuario al identificador de seguimiento de dispositivos móviles de Singular para integraciones de servidor a servidor.

Importante: Esta función avanzada de Enterprise sólo está disponible en casos excepcionales. Consulte con un ingeniero de soluciones de Singular antes de implementarla.

Singular puede recibir datos adicionales de seguimiento de eventos móviles a través de la integración de servidor a servidor. Para utilizar esta función, debe asignar el ID de usuario al identificador de seguimiento de dispositivos móviles de Singular.

Nota: Llame a este método tan pronto como sea posible después de inicializar el SDK de Singular o una vez que tenga el ID de usuario.

Implementación

Utilice setDeviceCustomUserId() para establecer el ID de usuario personalizado y asignarlo al identificador de seguimiento de Singular.

SwiftObjective-C
// Map user ID to device identifier for S2S integration
Singular.setDeviceCustomUserId("custom_user_id")

Firma del método:

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

Descripción: Establece el ID de usuario personalizado (el mismo que el de inicio de sesión) y lo asigna al identificador de seguimiento de Singular para la atribución de eventos de servidor a servidor.