Móvil: cómo añadir atributos de usuario.
Para crear atributos de usuario, debes añadirlos a la consola móvil y tus desarrolladores deben utilizar la API del SDK de WalkMe Mobile para configurarlos en tu aplicación.
Añadir atributos de usuario en la consola móvil
Este paso es obligatorio para todos los atributos de usuario. Añade la referencia a los atributos en la consola para utilizar los atributos en segmentos y objetivos basados en reglas.
- En la consola móvil, haz clic en CONFIGURACIÓN, Configuración de la >aplicación, ATRIBUTOS DEL USUARIO>.
- Haz clic en NUEVO ATRIBUTO.
- Establece el nombre del atributo y su nivel de privacidad:
-
- Si se trata de un atributo de usuario sin código, asegúrate de que el nombre que estableces coincida con la clave del almacenamiento de aplicaciones (consulta a continuación).
- Si se trata de un atributo de usuario de API, asegúrate de proporcionar el nombre y el tipo del atributo a tus desarrolladores para que puedan configurar los que coincidan en la llamada a la API.
Atributos privados
Para proteger la privacidad de los usuarios finales y los datos confidenciales de la aplicación, puedes establecer un atributo de usuario como privado. Esta configuración evita que WalkMe almacene los datos privados del atributo del usuario, y estos datos no se tendrán en cuenta cuando WalkMe Mobile AI proporcione predicciones sobre el comportamiento de los usuarios finales, ni se guardarán con fines de análisis.
Atributos de usuario sin código
A partir de la versión 1.18.0, el SDK de WalkMe puede obtener datos de las Preferencias compartidas (Android) o de las Preferencias de usuario (iOS) del dispositivo y almacenarlos en los atributos del usuario.
Esto significa que estos atributos de usuario se pueden establecer sin llamar a la API del SDK de WalkMe, lo que hace que la configuración de estos atributos sea mucho más rápida y sin inconvenientes. Todo lo que necesitas hacer es consultar con tus desarrolladores si los valores que deseas utilizar ya existen en SharedPreferences / UserDefaults.
Atributos sin código en iOS
En iOS, WalkMe puede acceder fácilmente a cualquier conjunto de claves en los UserDefaults. En la consola, simplemente establece el atributo con el mismo nombre que la clave UserDefaults.
Atributos sin código en Android
En Android, SharedPreferences no es un solo conjunto de variables, sino que se divide en diferentes secciones (cada sección se llama SharedPreferences).
En la consola, para configurar un atributo de usuario mediante una de las claves SharedPreferences, debe ser referenciado de acuerdo con esta convención: [nombre de la sección SharedPreferences] . [nombre de la clave] , Por ejemplo: telcosp . username .
Pasos para añadir atributos de usuario en el SDK de WalkMe Mobile
iOS
Los desarrolladores deben implementar el siguiente código:
/** Regular User Attributes **/ +(void)setUserAttributeWithKey:(NSString *)key andValue:(id)value; +(void)setUserAttributes:(NSDictionary<NSString*,id> *)attributes; /** Private User Attributes **/ +(void)setPrivateUserAttributeWithKey:(NSString *)key andValue:(id)value; +(void)setPrivateUserAttributes:(NSDictionary<NSString*,id> *)attributes; /** Clearing Private User Attributes (if needed) **/ +(void)clearPrivateUserAttributes;
Android
Los desarrolladores deben implementar el siguiente código:
/** Regular (non private) User Attributes **/ public static void setUserAttribute(String key, Object value) public static void setUserAttributes(Map<String,Object> attributes) /** Private User Attributes **/ public static void setPrivateUserAttribute(String key, Object value) public static void setPrivateUserAttributes(Map<String,Object> attributes) /** Clearing Private User Attributes (if needed) **/ public static void clearPrivateUserAttributes()
Atributos de usuario de valor múltiple
La misma API que se utiliza para establecer un atributo de usuario de un solo valor también se puede utilizar para establecer un atributo de usuario que represente una matriz.
Ejemplo de atributo de usuario con valores múltiples en iOS.
[ABBI setUserAttributeWithKey:@"numbers" andValue:@[@"1", @"2"]];
Ejemplo de atributo de usuario de valor múltiple de Android.
ABBI.setUserAttribute("numbers", new ArrayList<>(Arrays.asList("1", "2", "3")));
Pruebas de atributos de usuario
Para probar que un atributo de usuario se ha añadido correctamente, puedes verificar que aparezca en la sección "Atributos de usuario" disponible en la pantalla de información de la aplicación en el Modo de energía.