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

# 이벤트 기반 통계 규칙 개요

> 생산자 이벤트, 이름 지정, 연산자, 매개 변수, 플레이어 통계용 통계 템플릿을 포함한 이벤트 기반 XBOX Live 사용자 통계 규칙의 작동 방식.

이 항목에서는 사용자 통계 규칙의 작동 방식을 설명합니다. 이 규칙은 이벤트 기반 통계에 사용되며, 타이틀 관리 통계에는 사용되지 않습니다.

각 통계 규칙에는 네 가지 부분이 있습니다.

* 생산자 이벤트
* 이름
* 연산자
* 매개 변수

## 이벤트

각 통계 규칙은 타이틀에 의해 로깅되는 특정 이벤트 이름에 의해 트리거됩니다. 하나의 이벤트로 여러 통계 규칙이 트리거될 수 있다는 점에 유의하세요.

## 이름 지정 요구 사항

* 규칙 이름에는 "루트" 이름이 있습니다. 뒤에 하나 이상의 "필드"가 선택적으로 붙습니다.

* *루트*는 영숫자 문자열입니다. 최대 32자까지 가능합니다.

* 통계 인스턴스 이름의 총 길이는 128자를 초과할 수 없습니다.

* 이름은 반드시 문자로 시작해야 하며 문자, 숫자, 하이픈(-) 문자만 포함해야 합니다. 공백, 쉼표, 마침표, 밑줄 또는 기타 특수 문자는 허용되지 않습니다. 예시 이름은 "EnemiesDefeated", "BestScoreUnder2Minutes", "Total-Collectibles-Jewels" 등입니다.

* 필드는 점(.) 문자로 구분됩니다.

* 필드 이름은 생산자 이벤트의 일부인 필드 이름과 정확히 일치해야 합니다.

<Info>하나 이상의 필드가 통계 규칙 이름의 일부로 포함되면 이 규칙은 통계 템플릿이 됩니다. 런타임에 생산자 이벤트의 필드 실제 값이 통계 인스턴스 이름에 삽입됩니다.</Info>

* 유효한 템플릿 이름의 예로는 "EnemiesDefeated.WeaponID", "BestScoreUnder2Minutes.TrackId.DifficultyID", "Total-Collectibles-Jewels.Found"가 있습니다.

* 유효한 인스턴스 이름의 예로는 "EnemiesDefeated.WeaponID.17", "BestScoreUnder2Minutes.TrackId.40.DifficultyID.Insane", "Total-Collectibles-Jewels.Found.1"이 있습니다.

## 데이터 형식 권장 사항

* 통계 템플릿 이름의 일부인 이벤트 필드에는 정수 데이터 형식을 사용하는 것이 좋습니다.

* 이벤트 필드 데이터 형식이 부울인 경우 삽입되는 값은 `true`에 대해 "1", `false`에 대해 "0"입니다.

* 이벤트 필드 데이터 형식이 유니코드 문자열인 경우 해당 필드의 잠재적 값에 (앞서 설명한 대로) 유효한 문자만 포함되도록 해야 합니다.

## 연산자

통계 인스턴스의 값은 생산자 이벤트가 처리될 때 런타임에 계산됩니다. 통계 규칙은 지정된 *매개 변수*로 *연산*을 실행합니다. 지원되는 연산 옵션은 다음과 같습니다.

* `SUM`
* `MAX`
* `MIN`
* `REPLACE`

## 매개 변수

매개 변수는 다음 표와 같이 상수 값이거나 생산 이벤트의 필드 이름일 수 있습니다.

| 연산자       | 매개 변수    |
| --------- | -------- |
| `SUM`     | 상수 또는 필드 |
| `MIN`     | 필드       |
| `MAX`     | 필드       |
| `REPLACE` | 상수 또는 필드 |

결과 통계 인스턴스의 데이터 형식은 매개 변수의 데이터 형식에 의해 결정됩니다.

정수, 부동 소수점, 부울 데이터 형식은 모든 연산자에서 지원됩니다.

유니코드 문자열 데이터 형식은 `REPLACE` 연산자에서만 지원됩니다.

통계 및 매개 변수 데이터 형식은 다음 표에 나와 있습니다.

\| 통계 데이터 형식 | 매개 변수 데이터 형식 | 참고 |
\| --- | --- |
\| 정수 | Int32, Int64, UInt32, UInt64, Boolean | 지원되는 가장 큰 정수 값은 56비트입니다. 부울은 `TRUE`에서 1로, `FALSE`에서 0으로 변환됩니다. |
\| 부동 소수점 | Float, Double | 64비트 부동 소수점. |
\| 문자열 | UnicodeString, GUID | 최대 문자열 길이는 50자입니다. |


## Related topics

- [이벤트 기반 통계 개요](/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/live-leaderboards-eb-overview.md)
- [이벤트 기반 업적 개요](/ko/services/xbox-services/player-data/achievements/event-based/live-achievements-eb-overview.md)
- [이벤트 기반 통계 및 순위표](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/live-statslb-eb-nav.md)
- [이벤트 기반 플레이어 데이터 개요](/ko/services/xbox-services/player-data/stats-leaderboards/event-based/live-how-data-platform-works.md)