Reward Formula Specification v3
09. 계산 예제 (Formula Examples)
문서 ID: RES-FML-09
문서명: Formula Examples
볼륨: Volume 2 --- Reward Formula Specification v3
버전: 3.0
상태: Official Standard
공개 등급: Public Specification
1. 목적
본 문서는 Reward Engine Standard(RES)에서 정의한 계산 규칙의 적용 방식을 예제를 통해 설명한다.
본 문서의 예제는 계산 흐름을 이해하기 위한 참고 자료이며, 공식 계산 규칙은 Volume 1 및 Volume 2의 규격 문서를 따른다.
2. 예제 1. 기본 리워드 계산
입력
- Advertisement Revenue
- Ad Impression Country
- Standard eCPM
처리 순서
- 광고 수익 확인
- 광고 노출 국가 확인
- Standard eCPM 적용
- Accounting Result 생성
- Point Conversion 수행
결과
- Official Reward Result 생성
- Point 표시
3. 예제 2. 국가별 계산
동일한 사용자 활동이라도 Ad Impression Country가 다르면 적용되는 Standard eCPM이 달라질 수 있다.
예시
- 한국 광고 노출 → 한국 Standard eCPM 적용
- 미국 광고 노출 → 미국 Standard eCPM 적용
따라서 공식 Reward Result도 달라질 수 있다.
4. 예제 3. Point Conversion
Accounting Result가 생성된 이후 Experience Engine이 Point를 생성한다.
Accounting Result는 변경되지 않으며 Point는 사용자 경험을 위한 표현값이다.
5. 예제 4. Referral Reward
- 공식 Reward Result 생성
- Referral Chain 확인
- Referral Policy 적용
- Referral Reward 생성
Referral Reward는 공식 Reward Result를 기반으로 계산된다.
6. 예제 5. Group Reward
- Group Code 확인
- Group Policy 적용
- Group Reward 생성
Group Reward는 개인 공식 리워드를 변경하지 않는다.
7. 예제 6. Settlement
- 정산 대상 조회
- Settlement Policy 적용
- 소수점 처리
- Settlement Result 생성
정산은 계산 결과를 집계하는 절차이며 계산 자체를 변경하지 않는다.
8. 예제 7. Validation
동일한 입력 데이터와 동일한 Standard eCPM을 사용하면 항상 동일한 결과가 생성되어야 한다.
Reward Simulator는 동일한 입력으로 동일한 결과를 생성해야 한다.
9. 요약
본 문서는 RES 계산 규칙의 대표적인 적용 사례를 제시한다.
모든 예제는 Foundation 및 Formula Specification에서 정의한 공식 규칙을 기반으로 하며, 구현체와 Reward Simulator는 동일한 계산 흐름과 결과를 제공하여야 한다.