SDK de Unreal Engine - Establecer un ID de usuario

Seguir
Avatar
Jared Ornstead
Updated
Documento

Establecer un ID de usuario personalizado

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 en todas las plataformas.

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 capture 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. El cierre o reinicio de la aplicación no borra el ID de usuario.

Práctica recomendada: Si varios usuarios comparten un mismo dispositivo, implemente un flujo de cierre de sesión que llame a odedeSetCustomUserId en el inicio de sesión y a UnsetCustomUserId en el cierre de sesión.

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.

Si 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 identificador 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.

C++ 
// Set the user ID after login or registration
FString UserId = TEXT("user_abc123xyz");
USingularSDKBPLibrary::SetCustomUserId(UserId);
UE_LOG(LogTemp, Log, TEXT("Custom user ID set: %s"), *UserId);

Firma del método: 

static void SetCustomUserId(FString customUserId);

Tiempo: Si conoce el ID de usuario cuando se abre la aplicación, llame a SetCustomUserId antes de inicializar el SDK. De lo contrario, llámelo una vez que se haya completado el registro o el inicio de sesión del usuario.

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.

C++ 
// Clear the user ID on logout
USingularSDKBPLibrary::UnsetCustomUserId();
UE_LOG(LogTemp, Log, TEXT("Custom user ID has been cleared"));

Firma del método: 

static void UnsetCustomUserId();