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

# 플레이어 사용자 지정 속성 빠른 시작

> Game Manager와 title_player_account 엔터티의 UpdatePlayerCustomProperties API를 통해 PlayFab 플레이어 사용자 지정 속성을 만들고, 수정하고, 삭제합니다.

<Note>
  플레이어 사용자 지정 속성(Player Custom Properties) 기능은 공개 미리 보기 상태입니다. 핵심 기능은 갖추어져 있지만, 피드백과 사용 패턴을 바탕으로 경험을 다듬어 나가고 있습니다.
</Note>

플레이어 사용자 지정 속성을 시작하려면 여기의 가이드를 따르세요.

## Game Manager에서 플레이어 사용자 지정 속성 만들기, 수정하기, 삭제하기

[Game Manager](https://developer.playfab.com)에 로그인합니다.

* **Players** 페이지로 이동하여 플레이어를 선택합니다.
* **Player Data** 탭을 선택합니다.
* **Custom** 하위 탭을 선택합니다.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/navigate-to-custom-properties.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=3c435e7318840d0aa58d8bdc062371fb" alt="플레이어 사용자 지정 속성으로 이동" width="1248" height="1100" data-path="images/playfab/data-analytics/acting-data/navigate-to-custom-properties.png" />

### 새 사용자 지정 속성 만들기:

* **Add**를 선택합니다.
* **Key**와 **Value** 필드를 채웁니다.
* 드롭다운에서 사용자 지정 속성 **Type**을 선택합니다.
* 하단의 **New** 레이블이 추가한 사용자 지정 속성 수만큼 증가하는 것을 확인합니다.
* **Save player data**를 선택합니다.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/create-new-custom-property.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=78abd82d2114ef5eb5c536832f42180f" alt="새 플레이어 사용자 지정 속성 만들기" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/create-new-custom-property.png" />

### 사용자 지정 속성 제거하기:

* 사용자 지정 속성의 왼쪽에 있는 **휴지통** 아이콘을 선택합니다.
* 하단의 **Removed** 레이블이 제거한 사용자 지정 속성 수만큼 증가하는 것을 확인합니다.
* **Save player data**를 선택합니다.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/remove-custom-property.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=883b09a703986fb3026f9739fdc22f99" alt="플레이어 사용자 지정 속성 제거" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/remove-custom-property.png" />

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/remove-custom-property-result.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=7bd397fd042746ad73728c12c8427ff8" alt="플레이어 사용자 지정 속성 제거 결과" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/remove-custom-property-result.png" />

사용자 지정 속성을 수정하려면:

* **Key**와 **Value** 필드를 선택해 그 안의 값을 변경합니다.
* 하단의 **Changed** 레이블이 수정한 사용자 지정 속성 수만큼 증가하는 것을 확인합니다.
* **Save player data**를 선택합니다.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/modify-custom-property.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=c5e61d47fe847f6c5a92631e30b0bef8" alt="플레이어 사용자 지정 속성 수정" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/modify-custom-property.png" />

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/modify-custom-property-result.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=7f7b75304a2a06ebe408f695b6c1f807" alt="플레이어 사용자 지정 속성 수정 결과" width="950" height="375" data-path="images/playfab/data-analytics/acting-data/modify-custom-property-result.png" />

## PlayStream 규칙을 통해 플레이어에 대한 사용자 지정 속성 만들기 및 수정하기

<Note>
  V1 및 V2 PlayStream 이벤트를 사용해 사용자 지정 속성을 설정하거나 업데이트할 수 있습니다.
</Note>

* [Game Manager](https://developer.playfab.com)에 로그인합니다.
* **Automation** 페이지로 이동하여 **Rules** 탭을 선택합니다.
* 페이지 오른쪽 상단의 **New rule** 버튼을 선택합니다.
* **Name**과 **Event** 유형 텍스트 상자를 채웁니다. V1 이벤트는 **com.playfab.** 또는 \*\*title.\*\*로 시작하고, v2 이벤트는 **playfab.** 또는 \*\*custom.\*\*으로 시작합니다.
* 원하는 경우 이벤트 내용에 따라 이 규칙을 트리거하기 위한 **Conditions**를 설정합니다.
* 사용자 지정 속성을 만들려면, **Actions** 아래에서 **Adding custom property**를 선택하고 필드를 채웁니다.
* 사용자 지정 속성을 수정하려면, **Actions** 아래에서 **Update player custom properties**를 선택합니다. 이 액션은 아래 표시된 것처럼 확장 가능한 속성 목록을 허용합니다.
* **Save action**을 선택합니다.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/custom-properties-with-playstream-rules.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=2e8e25751465ae49c593b1b512f9f20b" alt="PlayStream 규칙으로 플레이어 사용자 지정 속성 만들기 및 수정" width="726" height="381" data-path="images/playfab/data-analytics/acting-data/custom-properties-with-playstream-rules.png" />

<Note>
  규칙에 대해 선택한 이벤트가 표준 이벤트인 경우, 선택할 수 있는 사용 가능한 속성 목록이 표시됩니다. 이벤트가 사용자 지정 이벤트인 경우, 입력 상자는 개방형 텍스트 필드가 됩니다.
</Note>


## Related topics

- [플레이어 데이터 빠른 시작](/ko/services/playfab/player-progression/player-data/quickstart.md)
- [플레이어 사용자 지정 속성](/ko/services/playfab/live-service-management/game-configuration/segmentation/player-custom-properties.md)
- [플레이어 사용자 지정 속성을 활용한 고급 세그멘테이션](/ko/services/playfab/live-service-management/game-configuration/segmentation/advanced-segmentation.md)
- [Economy(레거시)에서의 플레이어 세그먼트용 사용자 지정 스토어](/ko/services/playfab/economy-monetization/economy/tutorials/custom-stores-for-player-segments.md)
- [Player Inventory 빠른 시작](/ko/services/playfab/economy-monetization/economy-v2/inventory/quickstart.md)