보상 시스템

글로서리

작동 방식

보상 시스템을 사용하면 사용자가 실제 화폐를 사용하여 스토어에서 구매하도록 인센티브를 제공할 수 있습니다. 사용자가 클랜 구성원인 경우, 구매를 통해 클랜 전체에 가치 포인트를 제공합니다.

개인 및 클랜 기반 보상 체인을 생성하고 사용자에게 구매한 아이템에 대한 보상을 부여할 수 있습니다. 게임은 모든 유형의 보상 체인을 여러 개 포함할 수 있습니다. 각 체인은 최대 31단계까지 포함할 수 있습니다. 각 레벨마다 완료하는 데 필요한 가치 포인트 수를 정의할 수 있습니다.

맞춤형 보상 체인을 생성할 수도 있습니다. 맞춤화를 사용하면 특성에 따라 인증된 특정 사용자 그룹에게만 체인을 표시할 수 있습니다. 맞춤형 보상 체인은 개인 사용자 또는 클랜을 위해 설계할 수 있습니다.

보상 체인의 각 단계에서 사용자는 1~10개의 보상을 받을 수 있습니다. 클랜도 각 단계에서 구성원당 1~10개의 보상을 받을 수 있습니다.

사용자에게 보상으로 다음 아이템 유형을 제공할 수 있습니다:

• 가상 아이템
• 인게임 재화
• 인게임 재화 패키지
• 번들

보상 시스템이 올바르게 작동하려면 사용자 인증을 구성해야 합니다. 인증되지 않은 사용자의 경우, 진행률 없이 개인 및 클랜 보상 체인이 모두 표시됩니다. 클랜 구성원이 아닌 인증된 사용자는 개인 보상 체인만 볼 수 있습니다. 클랜 보상 체인은 사용할 수 없는 것으로 표시됩니다.

사용자 절차

1. 사용자가 사이트로 이동합니다.
2. 사용자는 아이템 카탈로그, 보상 시스템 및 각 아이템에 사용할 수 있는 가치 포인트 수를 볼 수 있습니다.
3. 사용자가 로그인합니다.
4. 이제 사용자는 보상 시스템에서 자신의 현재 진행률을 확인할 수 있습니다.
5. 사용자가 구매를 하고 보상 체인을 따라 진행합니다.

획득 방법

보상 시스템을 설정하려면 다음 세부 정보가 필요합니다.

• 보상 시스템의 시작 날짜와 종료 날짜

• 개별 및 클랜 보상 체인에서 진행을 가능하게 하는 이미지, 설명, SKU 및 가치 포인트 이름
• 가치 포인트 수
• 보상 체인의 아이템

아래 예시를 참조해 주세요.

보상 체인:

설명	예시:
이름	조각
설명 문구	보상을 받으려면 조각을 수집하세요.
SKU	ExampleSKU003
이미지 또는 해당 URL

구현해야 하는 항목:

• 스토어 내 보상 시스템 요소 표시:
  • 카탈로그에서 아이템 구매 시 지급되는 가치 포인트의 개수
  • 가치 포인트
  • 단계
  • 보상 체인
  • 인증된 사용자의 가치 포인트 잔액
  • 보상
• 엑솔라 로그인에 사용자의 클랜 데이터 전송

보상 시스템을 설정하려면 다음 API 메서드를 구현하세요.

• 가상 아이템 목록 가져오기
• 현재 사용자의 보상 체인 가져오기
• 현재 사용자의 가치 포인트 잔액 가져오기
• 단계 보상 청구하기
• 현재 사용자의 클랜 업데이트
• 클랜에서 보상 체인에 기여한 상위 10명 확보하기

사용자의 클랜 지정

엑솔라 웹사이트 빌더를 사용하지 않는 경우, 클랜 보상 체인이 올바르게 작동하려면 사용자 특성에 사용자의 클랜을 전달해야 합니다.

사용자에게 클랜이 있는 특성을 추가하려면 특성 업데이트 메서드를 사용하고 요청 본문에 클랜 가치와 함께 attributes 배열을 전달합니다.

예:

 1
 2{
 3"attributes": [
 4{
 5
 6"key": "clan_id",
 7"value": "beetles"
 8}
 9],
10"publisher_id": 000000,
11"publisher_project_id": 000000
12}

사용자 지정 ID로 인증 API를 사용하는 경우 사용자 인증 중에 현재 특성 값을 직접 전달할 수 있습니다.

API를 사용하여 사용자의 현재 클랜을 업데이트할 수도 있습니다. 먼저, 엑솔라 로그인에서 사용자의 특성을 업데이트한 다음, 현재 사용자의 클랜 업데이트 API를 호출하세요. 특성에 새 클랜이 포함되어 있는 경우, 사용자는 이전 클랜의 보상 체인에서 미수령 보상을 받게 되며, 사용자의 클랜 소속이 업데이트됩니다. 사용자가 이전에 클랜의 구성원이었으나 더 이상 클랜 구성원이 아닌 경우, 클랜 멤버십이 철회됩니다. 이 메서드의 응답에는 사용자가 이미 수령한 보상이 포함됩니다.

관리자 페이지를 이용한 설정

보상 체인을 생성하기 전에 가치 포인트, 보상, 사용자와 클랜이 가치 포인트를 획득하기 위해 구매할 수 있는 아이템을 생성해야 합니다.

밸류 포인트 생성

가치 포인트 생성 방법:

1. 관리자 페이지의 프로젝트에서 스토어 > 라이브 운영 및 프로모션 도구 섹션으로 이동합니다.
2. 보상 탭에서, 가치 포인트 생성을 클릭합니다.

3. 다음 매개 변수를 지정합니다:
   • 이미지를 추가(선택 사항)합니다.
   • 가치 포인트에 대한 고유한 SKU를 입력합니다.
   • 클랜에 가치 포인트를 사용할지 여부를 표시합니다.
   • 가치 포인트의 이름을 제공합니다.

4. 다음을 클릭합니다.
5. 가상 아이템의 SKU를 선택하고 구매 시 사용자에게 제공되는 가치 포인트 수를 지정합니다.
6. +를 클릭하여 필요한 아이템 수를 추가합니다.
7. 저장을 클릭합니다.

생성된 가치 포인트는 보상 체인 위에 표시됩니다. 그에 따라 클랜 가치 포인트가 표시됩니다. 특정 가치 포인트의 설정을 변경하려면 해당 행에서 편집을 클릭합니다.

보상 체인 생성

보상 체인 생성 방법:

1. 관리자 페이지의 프로젝트에서 스토어 > 라이브 운영 및 프로모션 도구 섹션으로 이동합니다.
2. 보상 생성을 클릭합니다.

3. 새로운 보상 체인 유형 즉, 개별 보상 체인 또는 클랜 보상 체인을 선택합니다.
4. 다음 매개 변수를 지정합니다. 개별 보상 체인을 선택하는 경우:
   1. 보상 체인 이름을 지정합니다.
   2. 설명을 입력합니다.
   3. 드롭다운 목록에서 가치 포인트를 선택합니다.

클랜 보상 체인을 선택한 경우:
1. 드롭다운 목록 클랜 유형에서, 클랜 유형을 선택합니다.
2. 클랜 보상 체인의 매개 변수 설정 방법:
   1. 보상 체인 이름을 지정합니다.
   2. 설명을 입력합니다.
   3. 보상 체인 팝업 헤더의 제목을 지정합니다.
   4. 팝업 팁(사용자가 클랜 보상을 받기 위해 해야 할 일)에 대한 텍스트를 지정합니다.
   5. 이미지를 추가(선택 사항)합니다.
   6. 드롭다운 목록에서 가치 포인트를 선택합니다.

5. 다음을 클릭합니다.
6. 새로운 단계 추가를 클릭합니다.
7. 다음 매개 변수를 지정하고 저장을 클릭합니다.
   1. 단계 이름.
   2. 보상을 받는 데 필요한 가치 포인트의 양입니다.
   3. 단계에 필요한 가상 아이템의 양입니다.
8. 다음을 클릭합니다.

9. 보상 체인을 맞춤화하는 방법:

   1. 맞춤형 보상 체인 토글을 활성화로 설정합니다.
   2. 체인 디스플레이 옵션 중 하나를 선택하고 다음을 클릭합니다.
      • 특정 사용자에게 보상 체인 표시. 활성화하면 지정된 조건을 충족하는 권한이 있는 사용자에게만 체인이 표시됩니다.
      • 조건을 충족하지 않은 사용자에게 보상 체인이 표시됩니다. 활성화하면 일치하는 보상 체인을 찾을 수 없는 경우 예를 들어, 사용자가 승인되지 않았거나 사용자의 속성이 맞춤화된 체인과 일치하지 않을 경우에만 체인이 표시됩니다.
   3. 특정 사용자에게만 체인을 표시하도록 선택한 경우:
      1. 조건 추가를 클릭하고 맞춤형 조건을 설정합니다.
         • 사용자 특성은 국가 또는 나이와 같은 사용자 특성입니다. 특성은 로그인 섹션에서 구성합니다.
         • 특성 유형은 문자열, 숫자 또는 날짜와 같은 특성 값의 형식을 지정합니다.
         • 비교 연산자는 사용자 특성 값이 어떻게 지정된 조건 예를 들어, 동일, 이상, 미만 또는 포함 등의 조건과 비교되는지 판별합니다.
         • 특성 값은 비교를 위해 사용하는 특정한 값입니다. 예를 들어, 사용자 특성이 나이, 특성 유형이 숫자, 비교 연산자가 보다 큼, 속성 값이 18인 경우 18세 이상의 사용자에게만 체인이 표시됩니다.
      2. 다른 개인화 조건을 추가하려면 조건 추가를 클릭합니다.
   4. 다음을 클릭합니다.

10. 필요한 단계 수를 생성하고 저장을 클릭합니다.

11. 다음을 클릭합니다.
12. 보상 체인의 유효 기간을 지정합니다.
13. 특정 시점에 보상 체인을 갱신하려면 보상 체인 갱신 가능 토글을 켜짐(On)으로 설정하고 업데이트 모드를 지정합니다.

12. 저장을 클릭합니다.

1. 보상 카탈로그에서 보상 체인을 선택합니다.
2. •••를 클릭하고 드롭다운 목록에서 활성화를 선택합니다.

API 호출을 통한 설정

보상 체인 및 가치 포인트 메서드 그룹의 관리자 하위 섹션에 있는 메서드를 사용하여 보상 시스템을 관리할 수 있습니다.

1. 가치 포인트 생성 API를 통해 보상에 대한 액세스 권한을 부여하는 가치 포인트를 생성합니다.
2. 아이템의 가치 포인트 설정 API를 통해 특정 아이템에 가치 포인트를 할당하면 사용자는 아이템 구매 후 이 포인트를 받게 됩니다.

3. 보상 체인 생성 API를 통해 보상 시스템을 생성합니다. 맞춤형 보상 체인을 생성하려면 attribute_conditions 어레이에 표시 조건을 전달합니다.

   조건에 정의된 특성이 없는 사용자에게 맞춤형 보상 체인을 표시할지 여부를 지정할 수 있습니다. 이렇게 하려면 can_be_missing 매개 변수에 true를 전달합니다.

   일치하는 맞춤형 체인을 찾을 수 없는 경우 사용자에게 표시되는 보상 체인을 정의할 수도 있습니다. 이렇게 하려면 is_always_visible 매개 변수에 false를 전달하십시오.

4. 보상 체인 토글 API를 통해 보상 시스템을 활성화합니다.

보상 시스템을 변경, 비활성화 또는 삭제하고 아이템 가치 포인트를 제거할 수 있습니다.