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. Eles podem ser usados ​​para definir públicos para seu aplicativo. Este guia mostra como definir propriedades do usuário em seu aplicativo.

O Analytics registra automaticamente algumas propriedades do usuário ; você não precisa adicionar nenhum código para ativá-los. Se precisar coletar dados adicionais, você poderá configurar até 25 propriedades de usuário diferentes por projeto. Observe que os nomes das propriedades do usuário diferenciam maiúsculas de minúsculas e que a configuração de duas propriedades de usuário cujos nomes diferem apenas em maiúsculas e minúsculas resulta no registro de duas propriedades de usuário distintas.

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

  • Idade
  • Gênero
  • Interesse

Antes de você começar

Certifique-se de ter configurado seu projeto e de poder acessar o Analytics conforme descrito em Primeiros passos com o Analytics .

Definir propriedades do usuário

Você pode definir propriedades de usuário do Analytics para descrever os usuários do seu aplicativo. Você pode usar propriedades do usuário criando definições personalizadas e depois usá-las para aplicar comparações em seus relatórios ou como critérios de avaliação de público.

Para definir uma propriedade de 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 Firebase Console. Para obter mais informações, consulte Dimensões e métricas personalizadas .
  2. Defina uma propriedade de usuário em seu aplicativo com o método setUserProperty() .

O exemplo a seguir mostra como adicionar uma propriedade hipotética "comida favorita", que atribui o valor na string food ao usuário ativo:

Web modular API

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

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

Web namespaced API

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

Você pode acessar 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 para seu aplicativo. Você pode usar essas propriedades em comparações em muitos dos relatórios disponíveis no Google Analytics. Leia mais sobre o painel .