보상 시스템

글로서리

작동 방식

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

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

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

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

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

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

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

사용자 절차

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

획득 방법

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

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

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

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

보상 체인:

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

구현해야 하는 항목:

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

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

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

밸류 포인트 생성

가치 포인트 생성 방법:

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. •••를 클릭하고 드롭다운 목록에서 활성화를 선택합니다.

사이트 빌더에서 블록 보상 시스템 설정

사이트 빌더에서 페이지에 보상 시스템 블록을 추가하는 방법:

1. 관리자 페이지의 프로젝트에서, 웹사이트 빌더로 이동합니다.
2. 원하는 사이트의 창에서 웹사이트 빌더 열기를 클릭합니다.

3. 사이트 템플릿에서 블록 추가를 클릭합니다.
4. 블록 목록에서 보상 시스템을 선택합니다.

5. 드롭다운 목록에서 스토어 빌더에서 구성한 보상 체인을 선택합니다.

6. 버튼 및 텍스트 색상을 사용자 지정(선택 사항)합니다.
7. 빌더의 오른쪽 상단에 있는 미리 보기를 클릭하여 보상 시스템을 확인합니다. 게시를 클릭하여 웹사이트를 게시합니다.

API 호출을 통한 설정

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

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

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

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

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

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

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

스토어 인터페이스에 보상 시스템을 표시하는 기능

가치 포인트 표시 기능

단일 블록 내에서 여러 보상 체인을 선택하고 표시 방식(둘 중 하나를 다른 하나의 아래 또는 탭에 표시)을 선택할 수 있습니다. 각 보상 체인의 모양을 개별적으로 사용자 지정할 수 있습니다.

아이템 카드에는 사이트에 추가된 보상 체인에 대한 가치 포인트만 표시됩니다. 그러나 사용자가 아이템을 구매하면 클랜 구성원은 사이트에 표시 여부와 관계없이 모든 활성 보상 체인에 대한 가치 포인트를 받게 됩니다.

예:

개별 보상 체인 1개와 클랜 보상 체인 1개, 총 2개의 보상 체인이 설정되어 있습니다. 개별 체인에는 Crystal이라는 가치 포인트가 있고, 클랜 체인에는 Magic Bubble라는 가치 포인트가 있습니다.

아이템 카탈로그에는 Sword이라는 이름의 아이템이 있으며, 가치 포인트가 할당되어 있습니다. 클랜 구성원이 이 아이템을 구매하면 20개의 Crystals과 40개의 Magic Bubbles를 받게 됩니다.

빌더에 스토어 블록을 추가하고 Sword 아이템을 포함하는 아이템 유형 및 그룹을 선택합니다.

1. 사이트에 보상 체인이 추가되지 않은 경우, Sword 아이템에 가치 포인트가 표시되지 않습니다.
2. 개별 보상 체인만 추가되어 활성화되어 있는 경우, 검 아이템은 20개의 Crystals만 표시합니다.
3. 클랜 보상 체인만 추가되어 활성화되어 있는 경우, Sword 아이템은 40개의 Magic Bubbles만 표시합니다.
4. 개별 보상 체인과 클랜 보상 체인이 모두 추가되어 활성화되어 있는 경우, Sword 아이템은 20개의 Crystals과 40개의 Magic Bubbles를 표시합니다.

클랜 구성원의 경우, 40개의 Magic Bubbles이 활성 가치로 표시됩니다.

클랜이 없는 사용자의 경우, 40개의 Magic Bubbles이 고정 가치로 표시됩니다.

사용자 클랜 지정

엑솔라는 클랜을 생성하거나 클랜 구성원에 대한 정보를 저장하지 않습니다. 사용자 측에서 클랜 시스템을 구현하고 사용자 특성을 사용하여 클랜 관련 데이터를 전달해야 합니다.

클랜 데이터의 올바른 전송 및 처리를 보장하는 방법:

1. 로그인에서 특성 구조를 설정합니다. clan_id 특성을 추가합니다.

로그인에서 특성 구조의 예:

 1{
 2	"$schema": "https://json-schema.org/draft/2020-12/schema",
 3	"additionalProperties": false,
 4	"description": "JSON Schema example for user attributes. Not the actual schema.",
 5	"properties": {
 6
 7		"clan_id": {
 8			"description": "name of clan",
 9			"type": "string"
10		},
11		"custom-id": {
12			"description": "custom-id of a user.",
13			"type": "number"
14		},
15		"had_ban": {
16			"description": "Whether the user was banned.",
17			"type": "boolean"
18		},
19		"last_purchase": {
20			"description": "Date of user's last purchase.",
21			"type": "string"
22		},
23	},
24	"required": [],
25	"title": "Example",
26	"type": "object"
27}

2. 사용자의 클랜 데이터 전송 방법:

• 사용자 ID로 인증하는 경우, 인증 시 웹샵의 사용자 인증 웹훅에 대한 응답으로 사용자의 클랜을 전달합니다.
• clan_id 특성을 추가하거나 새로고침하려면 clan_id 특성 키가 있는 attributes 개체 배열을 전달합니다.

웹훅 응답의 예:

 1{
 2  "user": {
 3    "id": "1234567890",
 4    "picture": "https://example.com",
 5    "name": "test-name"
 6  },
 7  "attributes": [
 8    {
 9     "key": "clan_id",
10     "value": "beetles"
11    }
12  ]
13}

• 사용자가 클랜을 탈퇴하고 다른 클랜에 가입하지 않은 경우, removing_keys 필드에 clan_id 값을 전달해야 합니다.

웹훅 응답의 예:

 1{
 2  "user": {
 3    "id": "1234567890",
 4    "picture": "https://example.com",
 5    "name": "test-name"
 6  },
 7  "removing_keys": [
 8    "key": "clan_id"
 9  ]
10}

• 사이트에서 엑솔라 로그인을 통한 인증을 사용하는 경우, 현재 사용자 클랜 업데이트 API를 사용하여 사용자의 클랜을 업데이트하세요.