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

Você pode 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 nos 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().

Confira no exemplo a seguir como adicionar uma propriedade hipotética de "comida favorita", que atribui o valor na string food ao usuário ativo.

API modular da Web

import { getAnalytics, setUserProperties } from "firebase/analytics";

const analytics = getAnalytics();
setUserProperties(analytics, { favorite_food: 'apples' });
analytics_set_user_properties.js

API com namespace da Web

firebase.analytics().setUserProperties({favorite_food: 'apples'});
index.js

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. Leia mais sobre o painel.