> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adrop.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 프로퍼티

> 프로퍼티는 나이, 성별, 관심사, 회원 등급 등 사용자의 속성 정보입니다. 오디언스 타겟팅에 사용할 프로퍼티를 등록하고 관리하는 방법을 알아봅니다.

***

## 프로퍼티란?

**프로퍼티**는 사용자의 속성 정보입니다. 나이, 성별, 관심사, 회원 등급 등 사용자를 구분할 수 있는 모든 데이터가 프로퍼티가 될 수 있습니다.

프로퍼티는 SDK를 통해 수집되며, 수집된 프로퍼티를 조합하여 타겟팅 옵션을 만듭니다.

***

## 기본 프로퍼티

애드컨트롤에서 기본으로 제공하는 프로퍼티입니다.

| 프로퍼티   | 설명         | 수집 방식          | 데이터 포맷                       |
| ------ | ---------- | -------------- | ---------------------------- |
| **국가** | 사용자의 국가 정보 | 자동 수집          | ISO 국가 코드 2자리 (KR, US, JP)   |
| **언어** | 사용자의 언어 설정 | 자동 수집          | ISO 언어 코드 (ko, en, ja)       |
| **나이** | 사용자의 나이    | SDK에서 생일 전달 필요 | YYYY, YYYYMM, YYYYMMDD 형식    |
| **성별** | 사용자의 성별    | SDK에서 전달 필요    | M(남성), F(여성), O(그 외), U(미확인) |

<Note>
  국가, 언어는 디바이스 locale 설정에서 자동으로 수집됩니다. 나이와 성별은 SDK에서 직접 전달해야 합니다.
</Note>

***

## 커스텀 프로퍼티

<video autoPlay muted loop playsInline src="https://mintcdn.com/openrhapsody/smENmiWX3Jge7uck/videos/targeting-properties.mp4?fit=max&auto=format&n=smENmiWX3Jge7uck&q=85&s=94cb87ef138ba4f989aebfc994623ee1" data-path="videos/targeting-properties.mp4" />

기본 프로퍼티 외에 서비스에 맞는 커스텀 프로퍼티를 추가할 수 있습니다.

### 예시: 로컬 액티비티 앱

로컬 액티비티 앱에서 사용자의 활동 지역과 예약 횟수를 수집한다고 가정합니다.

| 프로퍼티                | 타입  | 설명         | 값 예시               |
| ------------------- | --- | ---------- | ------------------ |
| **`region`**        | 문자열 | 사용자의 활동 지역 | Seoul, Busan, Jeju |
| **`booking_count`** | 숫자  | 누적 예약 횟수   | 0, 5, 20           |

<Warning>
  문자열 값은 대소문자를 구분합니다. SDK에서 전달하는 값과 동일하게 입력하세요.
</Warning>

이 두 프로퍼티를 조합하면 다양한 타겟팅 옵션을 만들 수 있습니다.

### 커스텀 프로퍼티 추가하기

1. 좌측 메뉴에서 **타겟팅 → 오디언스**를 클릭합니다.
2. 상단의 **프로퍼티** 탭을 클릭합니다.
3. **프로퍼티 상세** 버튼을 클릭합니다.
4. 프로퍼티 이름과 데이터 타입을 입력합니다.
5. **저장** 버튼을 클릭합니다.

### 프로퍼티 이름 규칙

* 3\~64자의 영어 소문자, 숫자, 밑줄(\_)만 사용 가능
* 예: `membership_level`, `asset_size`, `baby_months`

### 데이터 타입

| 타입         | 설명        | 예시                             |
| ---------- | --------- | ------------------------------ |
| **문자열**    | 텍스트 값     | "premium", "gold", "drama"     |
| **숫자**     | 정수 또는 소수  | 25, 100000000, 3.5             |
| **불린**     | 참/거짓      | true, false                    |
| **날짜**     | 날짜 값      | 2024-01-15                     |
| **문자열 배열** | 여러 텍스트 값  | \["drama", "action", "comedy"] |
| **숫자 배열**  | 여러 숫자 값   | \[1, 2, 3]                     |
| **불린 배열**  | 여러 참/거짓 값 | \[true, false, true]           |

<Warning>
  프로퍼티가 타겟팅에 사용 중이면 데이터 타입을 변경할 수 없습니다.
</Warning>

***

## 다음 단계

<CardGroup cols={2}>
  <Card title="이벤트" icon="bolt" href="/ko/targeting/event">
    이벤트를 활용한 행동 기반 타겟팅 조건을 알아보세요
  </Card>

  <Card title="오디언스 타겟팅 만들기" icon="users" href="/ko/targeting/audience">
    프로퍼티와 이벤트를 조합한 타겟팅을 만들어보세요
  </Card>
</CardGroup>

***

## FAQ

<AccordionGroup>
  <Accordion title="기본 프로퍼티만으로도 타겟팅을 시작할 수 있나요?">
    네, 국가, 언어, 나이, 성별 같은 기본 프로퍼티로 바로 시작할 수 있습니다. 이후 서비스 고유의 커스텀 프로퍼티(회원 등급, 구매 이력, 관심사 등)를 추가하면 경쟁사와 차별화된 프리미엄 타겟팅을 만들 수 있습니다.
  </Accordion>

  <Accordion title="프로퍼티와 이벤트의 차이점은 무엇인가요?">
    프로퍼티는 사용자의 속성 정보(나이, 성별, 회원 등급 등)이고, 이벤트는 사용자의 행동 데이터(구매, 장바구니 추가 등)입니다. 프로퍼티는 "어떤 사용자인가"를 나타내고, 이벤트는 "무엇을 했는가"를 나타냅니다. 두 가지 모두 오디언스 타겟팅의 조건으로 사용할 수 있습니다.
  </Accordion>
</AccordionGroup>