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

# 이벤트 기반 통계 포털 구성

> Partner Center에서 이벤트 기반 XBOX Live 스탯 규칙을 추가, 편집, 복사, 삭제하여 게임 이벤트가 플레이어 통계를 업데이트하고 리더보드를 구동하도록 합니다.

> [!NOTE]
>
> 이 항목에서는 적절한 권한이 있는 경우에만 사용할 수 있는 기능에 대해 설명합니다. 자세한 내용은 계정 관리자나 Microsoft의 다른 담당자에게 문의하세요.

이 항목에서는 타이틀의 Partner Center 서비스 구성에서 스탯 규칙을 추가하고 변경하는 절차를 설명합니다. 플레이어 통계는 게임이 XBOX 서비스에 이벤트를 보낼 때 트리거되는 스탯 규칙에 따라 생성되고 업데이트됩니다.

XBOX 서비스 구성에 대한 소개는 [포털 구성 개요](/ko/services/xbox-services/fundamentals/portal-config/live-portal-config-overview.md)를 참조하세요.

데이터 플랫폼 2013에 대한 소개는 [이벤트 기반 플레이어 데이터 개요](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/live-how-data-platform-works.md)를 참조하세요.

이 항목에서는 다음 내용을 다룹니다.

* [스탯 규칙이란 무엇인가?](#ID4EMB)
* [스탯 규칙 구성 준비](#ID4ENC)
* [스탯 규칙 만들기](#ID4ELC)
* [기존 스탯 규칙 변경](#ID4E2C)
* [스탯 규칙 편집](#ID4ELE)
* [기존 스탯 규칙 복사](#ID4EMS)
* [기존 스탯 규칙 삭제](#ID4EMF)

## 스탯 규칙이란 무엇인가?

*스탯 규칙*은 특정 이름을 가진 이벤트가 XBOX 데이터 플랫폼 서비스에서 수신될 때 트리거됩니다. 스탯 규칙의 트리거(적절한 이벤트 전송을 통한)는 서비스가 하나 이상의 플레이어 통계를 생성하거나 업데이트하도록 합니다.

플레이어 통계는 개발자가 정의하고, XBOX 서비스 데이터 플랫폼 서비스에서 계산되며, 사용자별로 이름-값 쌍으로 저장됩니다. 다음은 플레이어 통계의 몇 가지 예입니다.

* 하드 난이도에서 샷건으로 죽인 좀비의 총 수
* 경기에서 격파한 적의 최고 수
* 레이스 완주 최단 시간
* 가장 최근에 운전한 자동차의 이름

플레이어 통계는 플레이어의 게임 허브 UI에 Featured 또는 Hero Stats로 표시될 수 있고, 리더보드에 표시될 수 있으며, 업적을 잠금 해제하는 데 사용될 수 있습니다.

개별 스탯 규칙은 다음 중 하나를 생성하도록 구성할 수 있습니다.

* 플레이어 통계의 단일 인스턴스
* 스탯 템플릿을 기반으로 하는 플레이어 통계의 여러 인스턴스

스탯 및 스탯 규칙에 대한 자세한 내용은 다음 항목을 참조하세요.

* [이벤트 기반 통계 개요](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/live-stats-eb-overview.md)
* [이벤트 기반 스탯 규칙 개요](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stat-rules.md)
* [사용자 스탯 시나리오](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stats-scenarios.md)

다음 다이어그램은 스탯 인스턴스를 업데이트하는 스탯 규칙을 트리거하는 이벤트의 흐름을 보여줍니다.

![스탯 인스턴스를 업데이트하는 스탯 규칙을 트리거하는 이벤트의 흐름을 보여주는 다이어그램 이미지.](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/event-stat-rule-instance-template.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=6f4d1a70d3fd9a0695069b7bd042f138)

[이 항목의 맨 위로 돌아가기.](#top)

## 스탯 규칙 구성 준비

**전제 조건:** 스탯 규칙은 이벤트를 기반으로 하기 때문에 스탯 규칙을 만들기 전에 이벤트를 만들어야 합니다. 자세한 내용은 [이벤트 포털 구성](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/live-events-portal.md)을 참조하세요.

1. [Partner Center](https://partner.microsoft.com/dashboard/)에서 계정에 로그인합니다. 제품 목록을 보여주는 **개요** 페이지가 나타납니다.

2. 타이틀을 찾아 선택합니다. **게임 개요** 페이지가 다음과 같이 나타납니다.

   ![Partner Center의 게임 개요 페이지 스크린샷.](https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-product2013-gameoverview.png?fit=max\&auto=format\&n=ktEik-YaZoen6Rhy\&q=85\&s=ca66802159931973825dcdda5a0c5415)

3. 회색 배경이 있는 왼쪽 탐색에서 **XBOX Live**를 선택하여 확장한 다음 **게임플레이 설정**을 선택합니다. **게임플레이 설정** 페이지가 다음과 같이 나타납니다.

   ![Partner Center의 게임플레이 설정 페이지 스크린샷.](https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-gameplay-setting-page.png?fit=max\&auto=format\&n=ktEik-YaZoen6Rhy\&q=85\&s=e4039ad49909a9898ad54d538fe56e70)

4. 페이지 상단에서 **플레이어 통계** 메뉴를 선택한 다음 **스탯 규칙**을 다음과 같이 선택합니다.
   이 Partner Center UI에서 "플레이어 통계"은 "이벤트 기반 User Stats"를 의미합니다.

   ![Partner Center의 플레이어 통계 메뉴 스크린샷.](https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-stat-rules-menu.png?fit=max\&auto=format\&n=ktEik-YaZoen6Rhy\&q=85\&s=c34c095faeb6de3c53d98309df1aaa26)

   **게임플레이 설정** 페이지에서 **이벤트 및 스탯 규칙** 페이지가 다음과 같이 나타납니다.

   ![Partner Center의 이벤트 및 스탯 규칙 페이지 스크린샷.](https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/pctr-events-and-stat-rules-page.png?fit=max\&auto=format\&n=ktEik-YaZoen6Rhy\&q=85\&s=7011f4c8333bfef7d5b9ec476aa087ec)

   처음에 페이지 하단의 테이블은 비어 있습니다: "구성된 플레이어 통계 없음".

5. **이벤트 및 스탯 규칙** 페이지에서 이러한 이벤트를 기반으로 하는 이벤트와 스탯 규칙을 구성합니다. 자세한 내용은 다음 섹션을 참조하세요.

[이 항목의 맨 위로 돌아가기.](#top)

## 스탯 규칙 만들기

**전제 조건:** 스탯 규칙은 이벤트를 기반으로 합니다. 결과적으로, 스탯 규칙을 만들기 전에 이벤트를 만들어야 합니다. 자세한 내용은 [이벤트 포털 구성](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/live-events-portal.md)을 참조하세요.

1. 이전 섹션에서 설명한 대로 **이벤트 및 스탯 규칙** 페이지로 이동합니다.

2. 이벤트 행의 오른쪽에 있는 **작업** 열에서 줄임표 버튼(...)을 선택한 다음, 다음과 같이 **새 스탯 규칙**을 선택합니다.

   ![Partner Center에서 스탯 규칙을 만들기 위해 이벤트를 선택하는 스크린샷.](https://mintcdn.com/microsoft-4404708b/ktEik-YaZoen6Rhy/images/gdk/services/new-stat-rule-menuitem.png?fit=max\&auto=format\&n=ktEik-YaZoen6Rhy\&q=85\&s=109ee57f08b99f317c6eb2f71a6d336b)

   **스탯 규칙 추가** 대화 상자가 다음과 같이 나타납니다.

   ![Partner Center의 스탯 규칙 추가 대화 상자 스크린샷.](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/add-stat-rule-dbox.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=469b04002c0bf6b93cb05e148e490256)

   * **스탯 규칙에 추가된 이벤트 필드**
     * 이 선택적 필드를 사용하여 스탯 규칙의 일부로 기본 이벤트에 포함되는 필드를 선택합니다.
     * 드롭다운에서 스탯 규칙에 추가할 필드를 선택합니다. 이 방법으로 여러 필드를 추가할 수 있습니다. 선택한 필드는 스탯 규칙의 루트 이름에 추가되며 점(.) 문자로 구분됩니다.
     * 필드를 제거하려면 이름 옆의 **X**를 선택합니다.

   * **스탯 규칙 이름**
     스탯 규칙을 특징짓고 쉽게 기억하고 인식할 수 있는 이름을 지정합니다. 스탯 규칙의 이름은 *루트* 이름으로 구성되며, 선택적으로 점(.) 문자로 구분된 하나 이상의 *필드* 가 뒤에 옵니다. 스탯 규칙 이름의 명명 요구 사항에 대한 자세한 내용은 [이벤트 기반 스탯 규칙 개요](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-user-stat-rules.md)를 참조하세요.

   * **연산자**
     다음 연산자 중 하나를 선택합니다.

     * **Sum**
       **매개변수** 필드에 지정된 값만큼 기존 스탯 값을 증가시킵니다.

     * **Min**
       기존 스탯 값과 **매개변수** 필드 값의 최소값을 사용합니다.

     * **Max**
       기존 스탯 값과 **매개변수** 필드 값의 최대값을 사용합니다.

     * **Replace**
       **매개변수** 필드에 지정된 값으로 스탯 값을 바꿉니다.

       이 옵션은 주로 문자열에 사용되도록 의도되었으며 업적을 구동하는 스탯에 대해 **Replace** 연산자를 사용하는 것을 권장하지 않습니다. 이벤트가 항상 순서대로 처리되지는 않으며, 이 연산자로 인해 업적이 잠금 해제되지 않을 수 있습니다. 대신 **SUM** 연산자를 사용하세요.

       이러한 이유로 **Replace** 옵션이 사용되는 경우, 해당 스탯 규칙은 Partner Center UI에서 *사용되지 않음(Deprecated)* 으로 표시됩니다.

   * **매개변수**
     **연산자** 필드에서 선택한 연산자에서 사용할 값을 지정합니다.

     * 지정한 정적 숫자를 사용하려면 **literal** 옵션 버튼을 선택하고 옵션 버튼 뒤에 있는 상자에 값을 지정합니다.

     * 필드 값을 사용하려면 **field** 옵션 버튼을 선택하고 옵션 버튼 뒤에 있는 드롭다운 목록에서 사용할 필드를 선택합니다.

   * **업적 및 Featured Stats와 같은 다른 기능이 이 정보에 액세스하지 못하도록 제한합니다.**
     스탯 규칙을 비공개로 설정하려면 이 확인란을 선택합니다.

   * **서버 이벤트에서만 이 스탯 변경을 허용합니다. 클라이언트 이벤트는 무시됩니다.**
     스탯 규칙이 콘솔 또는 PC에서 실행 중인 게임 클라이언트가 아닌 서버 대 서버 API를 통해 전송된 이벤트에 의해서만 트리거되도록 표시하려면 이 확인란을 선택합니다.

이제 규칙의 이벤트가 선택될 때마다 새 스탯 규칙이 **이벤트 및 스탯 규칙** 페이지에 나열됩니다.

[이 항목의 맨 위로 돌아가기.](#top)

## 기존 스탯 규칙 변경

> [!NOTE]
>
> 타이틀이 Final Certification을 통과한 후에는 해당 타이틀의 이벤트에 대한 기존 스탯 규칙을 변경하거나 삭제할 수 없습니다.

1. 제품 인스턴스의 **이벤트 및 스탯 규칙** 페이지의 **스탯 규칙** 열에서 변경하려는 스탯 규칙을 선택합니다.

2. 이벤트의 **스탯 규칙 업데이트** 대화 상자에서 변경합니다.

3. **저장**을 선택합니다.

[이 항목의 맨 위로 돌아가기.](#top)

## 스탯 규칙 편집

스탯 규칙 편집은 스탯 규칙의 이름 또는 이벤트 필드가 제거, 추가 또는 재정렬될 때 발생합니다.
이 작업은 스탯 규칙의 삭제 및 새로운 스탯 규칙의 생성으로 처리됩니다. 이 정의에 따라 편집의 일부로 모든 스탯 인스턴스가 삭제됩니다.

[이 항목의 맨 위로 돌아가기.](#top)

## 기존 스탯 규칙 복사

> [!NOTE]
>
> 타이틀이 Final Certification을 통과한 후에는 해당 타이틀의 이벤트에 대한 기존 스탯 규칙을 변경하거나 삭제할 수 없습니다.

1. 제품 인스턴스의 **이벤트 및 스탯 규칙** 페이지에서 삭제하려는 스탯 규칙이 있는 행을 찾습니다.

2. 해당 행의 **작업** 열에서 **복사**를 선택합니다.

3. 이벤트의 **스탯 규칙 업데이트** 대화 상자에서 변경합니다.

4. **저장**을 선택합니다.

[이 항목의 맨 위로 돌아가기.](#top)

## 기존 스탯 규칙 삭제

> [!NOTE]
>
> * 타이틀이 Final Certification을 통과한 후에는 해당 타이틀의 이벤트에 대한 기존 스탯 규칙을 변경하거나 삭제할 수 없습니다.
>
> * 스탯 규칙 삭제는 영구적인 작업이며 취소하거나 되돌릴 수 없습니다.
>
> * 스탯 규칙을 삭제하면 종속된 모든 체인 종속성이 삭제됩니다. 스탯 규칙을 삭제하기 전에 모든 종속성도 삭제하려는지 확인하세요.

1. 제품 인스턴스의 **이벤트 및 스탯 규칙** 페이지에서 삭제하려는 스탯 규칙이 있는 행을 찾습니다.

2. 해당 행의 **작업** 열에서 **삭제**를 선택합니다.

3. **확인** 대화 상자에서 **삭제**를 선택합니다.

다음 다이어그램은 스탯 이벤트 규칙을 삭제하면 해당 규칙의 모든 종속성이 삭제됨을 보여줍니다.

![스탯 규칙을 삭제하면 해당 규칙의 모든 종속성이 삭제됨을 보여주는 다이어그램 이미지.](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/services/event_delete_dependency.png?fit=max\&auto=format\&n=gzrdvT5kpqAXKEQt\&q=85\&s=c62fbfb172b5b3ea07af12d6aca27bf6)

[이 항목의 맨 위로 돌아가기.](#top)


## Related topics

- [이벤트 기반 주요 통계 포털 구성](/ko/services/xbox-services/player-data/stats-leaderboards/featured-stats/config/live-featuredstats-eb-portal.md)
- [이벤트 기반 통계 및 리더보드 포털 구성(목차)](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-statslb-eb-config-nav.md)
- [스탯 변경 알림 포털 구성](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/config/live-stat-change-notif-portal.md)
- [플레이어 데이터](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/config/index.md)
- [이벤트 포털 구성](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/events/config/live-events-config-nav.md)