이벤트 기반 통계 규칙 개요

이 항목에서는 사용자 통계 규칙의 작동 방식을 설명합니다. 타이틀 관리 통계가 아니라 이벤트 기반 통계에 사용됩니다.

각 통계 규칙에는 4개의 부분이 있습니다.

• 생산자 이벤트
• 이름
• 운영자
• 매개 변수

이벤트

각 통계 규칙은 타이틀에서 기록하는 특정 이벤트 이름으로 트리거됩니다. 단일 이벤트에 의해 여러 통계 규칙이 트리거될 수 있습니다.

명명 요건

• 규칙 이름에 "root" 이름이 있습니다. 선택적으로 하나 이상의 "필드"가 뒤에 옵니다.

• root는 영숫자 문자열입니다. 32자까지 가능합니다.

• 통계 인스턴스 이름의 총 길이는 128자를 초과해서는 안 됩니다.

• 이름은 문자로 시작해야 하고 문자, 숫자 및 하이픈(-) 문자만 포함해야 합니다. 공백, 쉼표, 마침표, 밑줄 또는 기타 특수 문자는 허용되지 않습니다. 일부 이름 사례로는 "EnemiesDefeated", "BestScoreUnder2Minutes", "Total-Collectibles-Jewels" 등이 있습니다.

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

• 필드 이름은 제작자 이벤트에 포함된 필드 이름과 정확하게 일치해야 합니다.

Important

하나 이상의 필드가 통계 규칙 이름의 일부로 포함되어 있는 경우 이 규칙은 통계 템플릿이 됩니다. 런타임에 제작자 이벤트 내 필드의 실제 값이 통계 인스턴스 이름에 삽입됩니다.

• 유효한 템플릿 이름의 일부 샘플로는 "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, 부울	지원되는 최대 정수 값은 56비트입니다. 부울은 TRUE에서 1로, FALSE에서 0으로 변환됩니다.
부동 소수점	부동 소수점, 실수(Double)	64비트 부동 소수점
문자열	UnicodeString, GUID	최대 문자열 길이는 50자입니다.