Definir propriedades do usuário

As propriedades do usuário são atributos que você define para descrever segmentos da sua base de usuários, como preferência de idioma ou localização geográfica. Elas podem ser usadas para definir segmentos para seu app. Neste guia, mostraremos como configurar as propriedades do usuário no seu app.

O Analytics registra automaticamente algumas propriedades de usuário. Você não precisa adicionar códigos para ativá-las. Caso seja necessário coletar mais dados, é possível configurar até 25 propriedades de usuário diferentes por projeto. Os nomes das propriedades diferenciam maiúsculas de minúsculas. Assim, registrar duas propriedades com grafias diferentes gera dois registros distintos.

Não é possível usar um pequeno conjunto de nomes de propriedades do usuário reservados pelo Google:

  • Idade
  • Gênero
  • Interesse

Antes de começar

Verifique se você configurou seu projeto e pode acessar o Analytics, como descrito em Primeiras etapas com o Analytics.

Definir propriedades do usuário

É possível definir as propriedades do Analytics para descrever os usuários do seu app. Crie definições personalizadas para usar as propriedades do usuário em comparações de relatórios ou como critérios de avaliação de público.

Para definir uma propriedade do usuário, siga estas etapas:

  1. Crie uma definição personalizada para a propriedade do usuário na página Definições personalizadas do Analytics no Console do Firebase. Para mais informações, consulte Dimensões e métricas personalizadas.
  2. Defina uma propriedade do usuário no seu app com o método setUserProperty().

Veja no exemplo a seguir como adicionar uma propriedade hipotética de "comida favorita", que atribui o valor em mFavoriteFood ao usuário ativo.

Java

mFirebaseAnalytics.setUserProperty("favorite_food", food);

Kotlin+KTX

firebaseAnalytics.setUserProperty("favorite_food", food)

Acesse esses dados na página Definições personalizadas do Analytics no Console do Firebase. A página mostra uma lista de propriedades do usuário que você definiu no app. É possível comparar essas propriedades com vários relatórios disponíveis no Google Analytics. Saiba mais sobre o Painel de relatórios do Analytics na Central de Ajuda do Firebase.