Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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:
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:
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.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-30 UTC."],[],[],null,["iOS+ Android Web Flutter \n\n\u003cbr /\u003e\n\nUser properties are attributes you define to describe segments of your\nuser base, such as language preference or geographic location. These can be used\nto define [audiences](https://support.google.com/firebase/answer/6317509)\nfor your app. This guide shows you how to set user properties in your app.\n\nAnalytics automatically logs some\n[user properties](https://support.google.com/analytics/answer/9268042); you\ndon't need to add any code to enable them. If you need to collect additional\ndata, you can set up to 25 different user properties per project. Note that user\nproperty names are case-sensitive and that setting two user properties whose\nnames differ only in case results in two distinct user properties being logged.\n\nYou can't use a small set of user property names reserved by Google:\n\n- **Age**\n- **Gender**\n- **Interest**\n\nBefore you begin\n\nMake sure that you've set up your project and can access Analytics as\ndescribed in\n[Get Started with Analytics](/docs/analytics/get-started?platform=web).\n\nSet user properties\n\nYou can set Analytics user properties to describe the users of your app.\nYou can make use of user properties by creating custom definitions, then using\nthem to apply comparisons in your reports or as audience evaluation criteria.\n\nTo set a user property, follow these steps:\n\n1. Create a custom definition for the user property in the [**Custom Definitions** page](https://console.firebase.google.com/project/_/analytics/userproperty) of *Analytics* in the Firebase console. For more information, see [Custom dimensions and metrics](https://support.google.com/analytics/answer/10075209).\n2. Set a user property in your app with the [`setUserProperty()`](/docs/reference/js/analytics#setuserproperties) method.\n\nThe following example shows how to add a hypothetical \"favorite food\" property,\nwhich assigns the value in the string `food` to the active user: \n\nWeb \n\n```javascript\nimport { getAnalytics, setUserProperties } from \"firebase/analytics\";\n\nconst analytics = getAnalytics();\nsetUserProperties(analytics, { favorite_food: 'apples' });https://github.com/firebase/snippets-web/blob/467eaa165dcbd9b3ab15711e76fa52237ba37f8b/snippets/analytics-next/index/analytics_set_user_properties.js#L8-L11\n```\n\nWeb \n\n```javascript\nfirebase.analytics().setUserProperties({favorite_food: 'apples'});https://github.com/firebase/snippets-web/blob/467eaa165dcbd9b3ab15711e76fa52237ba37f8b/analytics/index.js#L38-L38\n```\n| **Note:** After the property is registered, it can take several hours for data collected with the property to be included in reports. When the new data is available, the user property can be used as a report filter or audience definition.\n\nYou can access this data from the\n[**Custom Definitions** page](https://console.firebase.google.com/project/_/analytics/userproperty)\nof *Analytics* in the Firebase console. The page shows a list of\nuser properties that you have defined for your app. You can use these properties\nin comparisons on many of the reports available in Google Analytics.\nRead more about the\n[dashboard](https://support.google.com/analytics/answer/11014767).\n| **Note:** Data in the Analytics reporting dashboard refreshes periodically throughout the day."]]
