با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
ویژگیهای کاربر ویژگیهایی هستند که برای توصیف بخشهایی از پایگاه کاربر خود، مانند ترجیح زبان یا موقعیت جغرافیایی، تعریف میکنید. از این موارد می توان برای تعریف مخاطبان برنامه شما استفاده کرد. این راهنما به شما نشان می دهد که چگونه ویژگی های کاربر را در برنامه خود تنظیم کنید.
Analytics به طور خودکار برخی از ویژگی های کاربر را ثبت می کند. برای فعال کردن آنها نیازی به اضافه کردن کد ندارید. اگر نیاز به جمعآوری دادههای اضافی دارید، میتوانید تا 25 ویژگی کاربر مختلف را در هر پروژه تنظیم کنید. توجه داشته باشید که نام ویژگی های کاربر به حروف بزرگ و کوچک حساس است و تنظیم دو ویژگی کاربر که نام آنها فقط در موارد متفاوت است منجر به ثبت دو ویژگی کاربر مجزا می شود.
نمیتوانید از مجموعه کوچکی از نامهای دارایی کاربر که توسط Google رزرو شده است استفاده کنید:
سن
جنسیت
بهره
قبل از شروع
مطمئن شوید که پروژه خود را راهاندازی کردهاید و میتوانید همانطور که در Get Started with Analytics توضیح داده شده است به Analytics دسترسی داشته باشید.
ویژگی های کاربر را تنظیم کنید
می توانید ویژگی های کاربر Analytics را برای توصیف کاربران برنامه خود تنظیم کنید. شما می توانید با ایجاد تعاریف سفارشی از ویژگی های کاربر استفاده کنید، سپس از آنها برای اعمال مقایسه در گزارش های خود یا به عنوان معیار ارزیابی مخاطب استفاده کنید.
می توانید از صفحه تعاریف سفارشیAnalytics در کنسول Firebase به این داده ها دسترسی داشته باشید. صفحه فهرستی از ویژگی های کاربر را نشان می دهد که برای برنامه خود تعریف کرده اید. میتوانید از این ویژگیها در مقایسه با بسیاری از گزارشهای موجود در Google Analytics استفاده کنید. در مورد داشبورد بیشتر بخوانید.
تاریخ آخرین بهروزرسانی 2025-08-22 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-22 بهوقت ساعت هماهنگ جهانی."],[],[],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."]]