> For the complete documentation index, see [llms.txt](https://docs.hackle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hackle.io/event-management/properties/custom-property.md).

# 맞춤형 속성

이 문서는 필요에 맞게 직접 정의하고 수집할 수 있는 맞춤형 속성에 대해 다룹니다.

> 📘 맞춤형 속성을 이용하려면
>
> 1. SDK 연동이 필요합니다. (코드 작업 필요!)
>
> 2. 맞춤형 속성을 지원하는 SDK는 다음과 같습니다.
>
> * Android
> * iOS
> * JavaScript
> * React
> * React Native
> * Java/Kotlin
> * Python
> * Node.js

## 설계 규칙

아래의 규칙을 적용하여 맞춤형 속성을 설계합니다.

1. 속성을 부여할 수 있는 대상은 사용자입니다.
2. 사용자는 최대 64개의 속성을 가질 수 있습니다.
3. 속성값은 예/아니오, 숫자, 문자열 중 하나로 표현할 수 있어야 합니다.
4. 속성값 중 숫자는 정수 15자리, 소수점 6자리까지 가질 수 있으며, 문자열은 64자까지 가능합니다.

## 사용법

1. **핵클 SDK를 반드시 연동해야 합니다.**\
   SDK 카테고리에서 맞춤형 속성을 지원하는 언어의 SDK 연동 방법을 확인하세요.
2. **사용자 객체를 파라미터로 사용하는 메소드를 이용해서 핵클로 전송해주세요.**\
   SDK 카테고리에서 언어 별 `사용자 식별자와 속성` 문서를 참고하세요.

## 개발자를 위한 참고 문서

| 언어           | SDK 연동                                                                      | 사용자 식별자와 속성                                                                                     |
| ------------ | --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- |
| Android      | \[Android SDK 연동]\(../../개발자 문서/android/android-sdk-init.md)                | \[Android SDK를 위한 사용자 식별자와 속성]\(../../개발자 문서/android/android-user-info/index.md)                |
| iOS          | \[iOS SDK 연동]\(../../개발자 문서/ios/ios-sdk-init.md)                            | \[iOS SDK를 위한 사용자 식별자와 속성]\(../../개발자 문서/ios/ios-user-info/index.md)                            |
| JavaScript   | \[JavaScript SDK 연동]\(../../개발자 문서/javascript/js-sdk-init.md)               | \[JavaScript SDK를 위한 사용자 식별자와 속성]\(../../개발자 문서/javascript/js-user-info/index.md)               |
| React        | \[React SDK 연동]\(../../개발자 문서/react/react-sdk-init.md)                      | \[React SDK를 위한 사용자 식별자와 속성]\(../../개발자 문서/react/react-user-info/index.md)                      |
| React Native | \[React Native SDK 연동]\(../../개발자 문서/react-native/react-native-sdk-init.md) | \[React Native SDK를 위한 사용자 식별자와 속성]\(../../개발자 문서/react-native/react-native-user-info/index.md) |
| Java/Kotlin  | \[Java/Kotlin SDK 연동]\(../../개발자 문서/java-kotlin/java-sdk-init.md)           | \[Java/Kotlin SDK를 위한 사용자 식별자와 속성]\(../../개발자 문서/java-kotlin/java-user-info/index.md)           |
| Python       | \[Python SDK 연동]\(../../개발자 문서/python/python-sdk-init/index.md)             | \[Python SDK를 위한 사용자 식별자와 속성]\(../../개발자 문서/python/python-user-info.md)                         |
| Node.js      | \[Node.js SDK 연동]\(../../개발자 문서/node-js/node-sdk-init.md)                   | \[Node.js SDK를 위한 사용자 식별자와 속성]\(../../개발자 문서/node-js/node-user-info/index.md)                   |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.hackle.io/event-management/properties/custom-property.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.