> ## 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.

# 세그먼트 구성

> 필터 조건 정의, 명명 규칙 및 진입/이탈 작업이나 CloudScript 작업 할당을 통해 게임 관리자에서 PlayFab 플레이어 세그먼트를 구성합니다.

**게임 관리자**의 **플레이어** 탭에서 접근할 수 있는 **세그먼트 구성** 페이지에서는 이름 조정, 필터 정의, 작업 할당을 통해 새 세그먼트나 기존 세그먼트를 구성할 수 있습니다.

각 세그먼트를 통해 유용하거나 흥미로운 플레이어 그룹을 정의하고 해당 그룹에 대해 배타적인 작업을 수행할 수 있습니다.

## 세그먼트를 만들고 접근하는 방법

세그먼트 구성에 접근하려면 다음 단계를 수행합니다:

1. 왼쪽 메뉴에서 **플레이어**를 선택합니다.
2. **세그먼트** 탭을 선택합니다.

이후 다음 중 하나를 선택할 수 있습니다:

3. **새 세그먼트** 버튼을 사용하여 새 **세그먼트**를 만들고 구성합니다.
4. *기존* **세그먼트**를 찾아 이름 레이블을 선택하여 **세그먼트**를 구성합니다.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/tutorials/game-manager-players-segments-create-or-configure-new-segment.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=0ec5365461c0c6ae63411f71763be65c" alt="게임 관리자 - 플레이어 - 세그먼트 - 새 세그먼트 만들기 또는 구성" width="1015" height="332" data-path="images/playfab/data-analytics/acting-data/tutorials/game-manager-players-segments-create-or-configure-new-segment.png" />

## 세그먼트를 구성하는 방법

**전제 조건**:

이 자습서의 예시와 같이 세그먼트를 구성하려면 다음이 필요합니다:

* PlayFab에 정의된, 특징이 있는 플레이어와 특징이 없는 플레이어.
* 정의된 [CloudScript PlayStream 후크](/services/playfab/data-analytics/acting-data/action-rules-using-cloudscript-actions-with-playstream).

이 예제에서는 다음을 수행할 것입니다:

* 이 *정의 특성*을 사용하여 세그먼트를 구성합니다: 캐나다에서 온 모든 플레이어.
* 세그먼트에 진입하는 각 플레이어에 대해 CloudScript 함수 **helloWorld**를 실행합니다.

플레이어의 *정의 특성*은 다음이 될 수 있습니다:

* 로그인 시간
* 연결된 디바이스 유형
* 태그
* 실세계 위치
* 통계 값
* 가상 통화 값
* 실제 금액 구매 등.

플레이어의 위치는 여러 가능한 옵션 중 하나이며, 이 예제에서만 특별히 필요합니다. 국가/지역 요구 사항을 원하는 다른 필터로 자유롭게 교체할 수 있습니다.

세그먼트가 정의되면, 플레이어가 세그먼트에 진입하거나 이탈할 때 실행할 다양한 작업 옵션이 제공됩니다.

CloudScript는 단연코 가장 유연한 작업으로, 세그먼트 전환 시점에 플레이어와 세그먼트 정보에 대한 완전한 제어권을 제공합니다.

CloudScript 처리기의 두 번째 매개 변수 *Context*를 활용하여 플레이어와 세그먼트 전환을 식별합니다. 그런 다음, 인벤토리 아이템, 가상 통화, 플레이어 데이터 또는 통계 부여와 같이 플레이어에게 원하는 모든 작업을 수행합니다.

이 특정 사례에서 세그먼트 구성에는 다음의 간단한 4단계가 필요합니다:

1. 세그먼트에 적절한 이름을 지정합니다. *정의 특성*을 포함하는 이름을 사용하는 것이 좋습니다 - **Canada Players**.
2. 플레이어가 세그먼트에 진입하기 위해 충족해야 하는 조건을 지정합니다. 이 경우 엄격한 값 *Canada*를 가진 *Location (country/region)* 필터를 원합니다.
3. 진입한 세그먼트 트리거에 대한 CloudScript 작업을 추가합니다. 원하는 함수를 실행하도록 작업을 구성합니다. 이 예제에서는 **helloWorld**를 원합니다.
4. **Save Segment** 버튼을 선택하여 커밋합니다.

세그먼트가 정의되면, 플레이어가 세그먼트에 진입하거나 이탈할 때 실행할 다양한 작업 옵션이 제공됩니다. CloudScript는 단연코 가장 유연한 작업으로, 세그먼트 전환 시점에 플레이어와 세그먼트 정보에 대한 완전한 제어권을 제공합니다.

CloudScript 처리기의 두 번째 매개 변수 *Context*를 활용하여 플레이어와 세그먼트 전환을 식별합니다. 그런 다음, 인벤토리 아이템, 가상 통화, 플레이어 데이터 또는 통계 부여와 같이 플레이어에게 원하는 모든 작업을 수행합니다.

이 특정 사례에서 세그먼트 구성에는 다음의 간단한 4단계가 필요합니다:

1. 세그먼트에 적절한 이름을 지정합니다(*정의 특성*을 포함하는 이름을 사용하는 것이 좋습니다 - **Canada Players**).
2. 플레이어가 세그먼트에 진입하기 위해 충족해야 하는 조건을 지정합니다. 이 경우 엄격한 값 *Canada*를 가진 *Location (country/region)* 필터를 원합니다.
3. 진입한 세그먼트 트리거에 대한 **CloudScript** 작업을 추가합니다. 원하는 함수를 실행하도록 작업을 구성합니다. 이 예제에서는 **helloWorld**를 원합니다.
4. **Save Segment** 버튼을 선택하여 커밋합니다.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/tutorials/game-manager-players-segments-new-segment-configuration.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=e88ebd1a41c353319d8d3c5324333b14" alt="게임 관리자 - 플레이어 - 세그먼트 - 새 세그먼트 구성" width="553" height="1200" data-path="images/playfab/data-analytics/acting-data/tutorials/game-manager-players-segments-new-segment-configuration.png" />

**Group (2)** 는 **Filters (3)** 라고 하는 정의된 모든 조건을 충족하는 플레이어 집합입니다.

즉, 세그먼트의 일부가 되려면 플레이어가 최소 1개의 그룹의 일부여야 합니다. 그룹의 일부가 되려면 플레이어가 모든 조건(필터)을 충족해야 합니다.

이는 OR/AND 연산자로 표시됩니다: 필터는 AND 연산자를 사용하여 결합되고, 그룹은 OR 연산자를 사용하여 결합됩니다.

아래에 표시된 스크린샷은 세그먼트가 어떻게 정의될 수 있는지에 대한 예를 보여 줍니다. 이 세그먼트는 2개의 그룹으로 구성됩니다. 첫 번째 그룹은 2개의 필터로 정의됩니다:

* 플레이어는 캐나다 출신이어야 합니다.
* 플레이어는 Apple **푸시 알림이 사용하도록 설정**되어 있어야 합니다.

두 번째 그룹도 캐나다 출신 플레이어를 위한 것이지만, Google **푸시 알림이 사용하도록 설정**되어 있어야 합니다.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/tutorials/game-manager-players-segments-segment-filtering.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=51d978485bb9b9b35cdc67d565a9118f" alt="게임 관리자 - 플레이어 - 세그먼트 - 세그먼트 필터링" width="1622" height="500" data-path="images/playfab/data-analytics/acting-data/tutorials/game-manager-players-segments-segment-filtering.png" />\
결과적으로, Google 또는 Apple 푸시 알림을 사용하는 캐나다 출신 플레이어들의 세그먼트를 얻게 됩니다.

각 필터에는 고유한 구성과 목적이 있습니다. 2017년 4월 30일 기준으로 다음 필터를 사용할 수 있습니다:

* **All players filter** - 이 필터는 구성이 없고 고유하며, 모든 플레이어의 세그먼트를 만들 수 있게 해 줍니다. 이는 모든 새 플레이어에 대해 자동 작업을 실행하려는 경우 유용합니다(세그먼트 작업은 이 자습서의 뒷부분에 있는 [작업 관리 방법](#how-to-manage-actions) 섹션에서 설명합니다).
* **First login (date) filter** - 첫 로그인 날짜/시간을 기준으로 필터링할 수 있습니다. 예를 들어, 2017년 1월 1일 이후에 처음 로그인한 플레이어입니다.
* **First login (timespan) filter** - 현재 날짜/시간에 대한 첫 로그인 시간 범위를 기준으로 필터링할 수 있습니다. 예를 들어, 20분 전에 처음 로그인한 플레이어입니다(지금 기준).
* **Last login (date) filter** - 마지막 로그인 날짜/시간을 기준으로 필터링할 수 있습니다. 예를 들어, 2017년 1월 1일 이후 로그인하지 않은 플레이어입니다.
* **Last login (timespan) filter** - 현재 날짜/시간에 대한 마지막 로그인 시간 범위를 기준으로 필터링할 수 있습니다. 예를 들어, 일주일 동안 로그인하지 않은 플레이어입니다(지금 기준).
* **Linked user account to filter** - 사용자의 연결된 계정을 기준으로 필터링할 수 있습니다. 예를 들어, 이메일 계정에 연결된 Steam 계정을 가진 플레이어입니다.
* **Location (country/region) filter** - 플레이어의 국가/지역을 기준으로 필터링할 수 있습니다. 예를 들어, 캐나다 출신 플레이어입니다.
* **Push notifications enabled with filter** - 플레이어의 푸시 설정과 기능을 기준으로 필터링할 수 있습니다. 예를 들어, Google 푸시 알림을 사용하도록 설정한 플레이어입니다.
* **Statistics value filter** - 사용자 지정 통계 특성을 기준으로 필터링할 수 있습니다. 예를 들어, 총 20000의 피해를 입힌 플레이어입니다.
* **Tag filter** - 플레이어가 특정 태그를 가지고 있는지 여부를 기준으로 필터링할 수 있습니다. 예를 들어, *cheater* 태그를 가진 플레이어입니다.
* **Total value to date in US filter** - 플레이어가 게임에서 사용한 USD 통화 금액을 기준으로 필터링할 수 있습니다. 예를 들어, 30달러 이상 지출한 플레이어입니다.
* **Value to date filter** - 플레이어가 게임에서 사용한 특정 통화의 양을 기준으로 필터링할 수 있습니다. 예를 들어, 50 RUB를 지출한 플레이어입니다.
* **User origination filter** - 플레이어가 게임을 시작하는 데 사용한 첫 인증 방법을 기준으로 필터링할 수 있습니다.

<Note>
  여기서 요령은 플레이어가 예를 들어 iOS 디바이스 ID를 기반으로 인증을 *시작*했지만, 나중에 *동일한* 플레이어가 GameCenter 계정을 연결할 수 있다는 것입니다. 이 경우 *user origination*은 iOS 디바이스 ID가 됩니다. 예를 들어, iOS 디바이스 ID를 사용하여 처음 로그인한 플레이어입니다.
</Note>

* **Virtual currency balance filter** - 플레이어의 사용자 지정 가상 통화 예치금을 기준으로 필터링할 수 있습니다. 예를 들어, 50 Crystal 미만을 가진 플레이어입니다.

## 작업 관리 방법

각 *작업*은 실행되기 위해 *트리거*가 필요합니다. 일부 작업은 페이지에서 바로 트리거되어 수동으로 실행됩니다. 하지만 때로는 트리거, 즉 작업이 실행되도록 하는 이벤트를 선택해야 합니다.

트리거는 작업의 *컨텍스트*를 정의합니다. 예를 들어, *플레이어가 세그먼트에 진입함* 트리거는 플레이어에 대한 참조를 포함하는 컨텍스트를 전달합니다. **작업** 패널의 일반적인 워크플로는 다음과 같습니다:

1. *트리거*라고도 하는 **이벤트 조건**을 선택합니다.
2. 작업 **유형**을 선택합니다. PlayFab은 다양한 작업을 제공합니다. 어느 시점에서 더 유연한 작업이 필요하다면 CloudScript 작업을 고려하십시오. 이 작업 유형은 자체 CloudScript 함수를 실행할 수 있게 해 줍니다.
3. 작업을 구성합니다(각 작업 **유형**마다 다름).
4. **REMOVE**를 선택하여 트리거에서 작업을 제거합니다.
5. **Add Action**을 선택하여 트리거에 작업을 추가합니다.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/tutorials/game-manager-actions-panel.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=b3ab4bc8f74b0a987cdae09ac856b2c3" alt="게임 관리자 - 작업 패널" width="1068" height="409" data-path="images/playfab/data-analytics/acting-data/tutorials/game-manager-actions-panel.png" />

## 플레이어 세그먼트를 검사하는 방법

**플레이어 세그먼트** 페이지를 통해 플레이어가 속한 세그먼트를 조회할 수 있습니다. **플레이어 세그먼트** 페이지에 접근하려면:

1. 사이드바 메뉴에서 **플레이어**를 선택합니다.
2. 그런 다음 **플레이어** 탭을 선택합니다.
3. 검사할 플레이어를 찾아 **ID** 레이블을 선택합니다.
4. 마지막으로 **플레이어 도구 모음**에서 **세그먼트**를 선택합니다.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/tutorials/game-manager-open-players-segments-page.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=b678425edca12dd2a9a13ec2557eb070" alt="게임 관리자 - 열기 - 플레이어 세그먼트 페이지" width="1119" height="441" data-path="images/playfab/data-analytics/acting-data/tutorials/game-manager-open-players-segments-page.png" />

**플레이어 세그먼트** 페이지에서 다음 사항에 유의하세요:

1. **플레이어 ID** 레이블은 현재 검사 중인 플레이어를 식별합니다.
2. **세그먼트** 테이블에는 플레이어가 속한 모든 세그먼트 목록이 포함되어 있습니다. **세그먼트 이름** 레이블을 선택하여 세그먼트를 구성합니다.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/tutorials/game-manager-players-segments-page.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=7e89e5698a40640185e576836715aea2" alt="게임 관리자 - 플레이어 세그먼트 페이지" width="1046" height="720" data-path="images/playfab/data-analytics/acting-data/tutorials/game-manager-players-segments-page.png" />


## Related topics

- [플레이어 세그먼트 구성](/ko/services/playfab/player-progression/player-data/player-segment-configuration.md)
- [플레이어 세그먼트](/ko/services/playfab/player-progression/player-data/player-segments.md)
- [Economy V2 타깃 오퍼](/ko/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/targeted-offers.md)
- [차원으로서의 세그먼트 빠른 시작](/ko/services/playfab/data-analytics/learn-data/trends/segments-dimension-qs.md)
- [Economy V2 세그먼트 액션](/ko/services/playfab/economy-monetization/economy-v2/player-segmented-monetization/segment-actions.md)
