Dispositivos Móveis: como adicionar atributos de usuário

Last Updated dezembro 10, 2025

Para criar atributos de usuário, você deve adicioná-los ao Console Móvel e seus desenvolvedores devem usar a API WalkMe Mobile SDK para configurá-los no aplicativo.

Adicionando atributos de usuário no console móvel

Essa etapa é obrigatória para todos os atributos de usuário. Adicione a referência Atributos no Console para usar atributos em segmentos e metas baseadas em regras.

  • No Console Móvel, clique em CONFIGURAÇÕES >Configurações do >aplicativo ATRIBUTOS DO USUÁRIO .
  • Clique em NOVO ATRIBUTO.
  • Defina o nome do atributo e seu nível de privacidade:
    • Se esse for um atributo de usuário sem código, verifique se o nome definido corresponde à chave no armazenamento do aplicativo (veja abaixo)
    • Se esse for um atributo de usuário da API, certifique-se de fornecer o nome e o tipo do atributo aos desenvolvedores para que eles possam configurar os atributos correspondentes na chamada de API.

Atributos privados

Para proteger a privacidade dos usuários finais e os dados confidenciais do aplicativo, você pode definir um atributo de usuário como privado. Essa configuração impede que o WalkMe armazene os dados privados do atributo do usuário, e esses dados não serão levados em conta quando o WalkMe Mobile AI fornecer previsões sobre o comportamento dos usuários finais, nem serão salvos para fins de análise.

Atributos de usuário sem código

A partir da versão 1.18.0, o SDK do WalkMe é capaz de obter dados das SharedPreferences (Android) ou UserDefaults (iOS) do dispositivo e armazená-los em Atributos do Usuário.

Isso significa que esses atributos de usuário podem ser definidos sem chamar a API do WalkMe SDK, tornando a configuração desses atributos muito mais rápida e sem atritos. Tudo o que você precisa fazer é verificar com seus desenvolvedores se os valores que deseja usar já existem no SharedPreferences/UserDefaults.

Atributos sem código no iOS

No iOS, o WalkMe pode acessar facilmente qualquer conjunto de chaves no UserDefaults. No console, basta definir o atributo com o mesmo nome da chave UserDefaults.

Atributos sem código no Android

No Android, o SharedPreferences não é um conjunto único de variáveis, mas dividido em diferentes seções (cada seção é chamada de SharedPreferences).

No console, para configurar um atributo de usuário por uma das chaves SharedPreferences, ele precisa ser referenciado de acordo com esta convenção: [nome da seção SharePreferences] . [nome da chave] , f ou exemplo: telcosp . username .

Etapas para adicionar atributos de usuário no WalkMe Mobile SDK

iOS

Os desenvolvedores devem implementar o seguinte código:

/** Atributos de Usuário Regular **/
+(void)setUserAttributeWithKey:(NSString *)key eValue:(id)value;
+(void)setUserAttributes:(NSDictionary<NSString*,id> *)atributos;

/** Atributos de usuário privado **/
+(void)setPrivateUserAttributeWithKey:(NSString *)key andValue:(id)value; 
+(void)setPrivateUserAttributes:(NSDictionary<NSString*,id> *)atributos;

/** Limpar atributos de usuário privado (se necessário) **/
+(void)clearPrivateUserAttributes;

Android

Os desenvolvedores devem implementar o seguinte código:

/** Atributos de usuário regular (não privado) **/
public static void setUserAttribute(String key, Object value)
public static void setUserAttributes(Map<String,Object> atributos)

/** Atributos de usuário privado **/
public static void setPrivateUserAttribute(Chave String, Valor do objeto)
public static void setPrivateUserAttributes(Map<String,Object> atributos)

/** Limpar atributos de usuário privado (se necessário) **/
public static void clearPrivateUserAttributes()

Atributos de usuário de vários valores

A mesma API usada para definir um atributo de usuário de valor único também pode ser usada para definir um atributo de usuário que representa uma matriz.

Exemplo de atributo de usuário de vários valores do iOS

[ABBI setUserAttributeWithKey:@"numbers" andValue:@[@"1", @"2"];

Exemplo de atributo de usuário de vários valores do Android

ABBI.setUserAttribute("numbers", novo ArrayList)<>(Arrays.asList("1", "2", "3")));

Testando atributos de usuário

Para testar se um atributo de usuário foi adicionado com sucesso, você pode verificar se ele aparece na seção "Atributos de usuário", disponível na tela Informações do aplicativo no Modo de Energia.

Was this article helpful?

Thanks for your feedback!

Faça parte de algo maior.

Interaja com colegas, tire dúvidas e compartilhe ideias.

Explore nossa comunidade
×