사용자 속성은 언어 환경설정, 지리적 위치와 같이 사용자층을 나눈 세그먼트를 기술하고자 개발자가 정의하는 속성입니다. 사용자 속성을 사용하면 앱의 잠재고객을 정의할 수 있습니다. 이 가이드에서는 앱에서 사용자 속성을 설정하는 방법을 설명합니다.
Analytics는 몇 가지 사용자 속성을 자동으로 로깅하며 별도의 코드 없이 이러한 속성을 사용 설정할 수 있습니다. 데이터를 추가로 수집해야 하는 경우 프로젝트별로 서로 다른 사용자 속성을 최대 25개까지 설정할 수 있습니다. 사용자 속성 이름은 대소문자를 구분하며, 이름에서 대소문자만 다른 두 사용자 속성을 설정하면 서로 다른 2개의 사용자 속성이 로깅됩니다.
Google에 예약된 일부 사용자 속성 이름은 사용할 수 없습니다.
연령
성별
관심분야
시작하기 전에
Analytics 시작하기에 설명된 대로 프로젝트가 설정되어 있고 Analytics에 액세스할 수 있는지 확인하세요.
사용자 속성 설정
앱 사용자를 설명하는 Analytics 사용자 속성을 설정할 수 있습니다. 맞춤 정의를 만든 후 보고서에서 비교를 적용하거나 잠재고객 평가 기준으로 이 정의를 사용하여 사용자 속성을 활용할 수 있습니다.
사용자 속성을 설정하려면 다음 단계를 따르세요.
Firebase Console에서 애널리틱스의 맞춤 정의 페이지에서 사용자 속성에 대한 맞춤 정의를 작성합니다. 자세한 내용은 맞춤 측정기준 및 측정항목을 참고하세요.
Firebase Console에서 Analytics의 맞춤 정의 페이지에서 이 데이터에 액세스할 수 있습니다. 이 페이지에는 앱에 정의한 사용자 속성 목록이 표시됩니다. Google Analytics에서 제공되는 다양한 보고서에서 이러한 속성을 비교하여 사용할 수 있습니다.
대시보드에 대해 자세히 알아보세요.
[null,null,["최종 업데이트: 2025-08-21(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."]]