RESDocumentation Center

Reward Formula Specification v3

01. 리워드 계산식 (Reward Formula)

문서 ID: RES-FML-01
문서명: Reward Formula
볼륨: Volume 2 --- Reward Formula Specification v3
버전: 3.0
상태: Official Standard
공개 등급: Public Specification

1. 목적

본 문서는 Reward Engine Standard(RES)의 기본 리워드 계산식을 정의한다.

본 계산식은 모든 광고 기반 리워드의 기준이 되며, 모든 RES 구현체는 동일한 계산 절차를 따라야 한다.

2. 적용 범위

본 계산식은 다음 대상에 적용된다.

  • 광고 시청 리워드
  • 광고 기반 미션
  • 출석형 광고 리워드
  • 게임 광고 리워드
  • 기타 광고 수익 기반 활동

3. 기본 원칙

모든 구현체는 다음 원칙을 준수하여야 한다.

  • SHALL Advertisement Revenue를 계산의 시작점으로 사용한다.
  • SHALL Ad Impression Country를 기준으로 계산한다.
  • SHALL Standard eCPM을 적용한다.
  • SHALL Accounting Engine에서 공식 계산을 수행한다.
  • SHALL Experience Engine은 계산 결과를 표현만 한다.

4. 입력 데이터

공식 계산에는 최소한 다음 정보가 필요하다.

  • Advertisement Revenue
  • Ad Impression Country
  • Standard eCPM
  • Reward Policy Version
  • Calculation Timestamp

5. 계산 절차

공식 계산은 다음 순서를 따른다.

  1. Advertisement Revenue 확인
  2. Ad Impression Country 확인
  3. Standard eCPM 조회
  4. 공식 Reward Value 계산
  5. Accounting Result 생성
  6. Experience Engine을 통한 Point 변환

구현체는 계산 순서를 변경하여서는 안 된다(SHALL NOT).

6. 공식 계산 결과

공식 계산의 결과는 다음 정보를 포함한다.

  • Reward Value
  • Accounting Result
  • 적용된 Standard eCPM
  • 계산 시점
  • 계산 규칙 버전

Point는 공식 계산 결과가 아니라 Experience Engine의 표현 결과이다.

7. 구현 요구사항

모든 RES 구현체는 다음 요구사항을 만족하여야 한다.

  • SHALL 동일한 입력에 대해 동일한 결과를 생성한다.
  • SHALL 공식 계산 결과를 보존한다.
  • SHALL 계산 결과를 재현할 수 있다.
  • SHALL Source of Truth를 유지한다.
  • SHALL NOT 사용자 표시값을 계산 입력으로 사용한다.

8. 관련 계산식

본 계산식은 다음 규격과 함께 사용된다.

  • Standard eCPM Formula
  • Point Conversion
  • Referral Formula
  • Group Formula
  • Settlement Formula

9. 요약

Reward Formula는 RES의 모든 공식 계산의 출발점이다.

모든 광고 기반 리워드는 본 계산 절차를 기반으로 생성되며, 이후 세부 계산은 개별 Formula 문서에서 정의한다.