보상 시스템

작동 방식

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

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

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

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

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

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

보상 시스템 설정

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

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

관리자 페이지의 프로젝트에서 아이템을 수동으로 생성하려면 아이템 카탈로그 > 모든 아이템 섹션으로 이동합니다. 아이템 생성 방법에 대한 자세한 내용은 참조 문서의 아이템 카탈로그 섹션에서 확인할 수 있습니다.

가치 포인트 생성 방법:

1. 관리자 페이지에서 프로젝트를 열고 LiveOps > 리워드 섹션으로 이동합니다.
2. 가치 포인트 생성을 클릭합니다.

3. 다음 매개 변수를 지정합니다:
   • 이미지를 추가하세요(선택 사항).
   • 이름을 입력하세요.
   • 고유한 SKU를 입력하세요.
   • 클랜 가치 포인트를 생성하는 경우, 클랜 가치 포인트로 사용 토글을 켜짐(On)으로 설정합니다. 가치 포인트 생성 후에는 이러한 설정을 변경할 수 없습니다.
   • 가치 포인트 할당: 아이템을 선택하고 각 아이템 구매 시 사용자가 받게 되는 가치 포인트 수를 지정하세요. 아직 스토어에 아이템이 포함되어 있지 않은 경우 현재 설정을 저장하고 나중에 이 단계로 돌아올 수 있습니다.

4. 행 추가를 클릭하여 원하는 수의 위치를 삽입합니다.
5. 가치 포인트 생성을 클릭합니다.

보상 체인 생성 방법:

1. 관리자 페이지에서 프로젝트를 열고 LiveOps > 리워드 섹션으로 이동합니다.
2. 보상 생성을 클릭합니다.

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

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

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

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

10. 보상 체인을 사용자 맞춤 설정하는 방법:

    1. 사용자 맞춤 설정된 보상 체인 토글을 켜짐(On)으로 설정합니다.
    2. 체인 표시 옵션 중 하나를 선택하고 다음을 클릭합니다:
       • 특정 사용자에게 보상 체인 표시. 사용자 맞춤 설정 조건 설정. 체인은 지정된 조건을 충족하는 인증된 사용자에게만 표시됩니다.
       • 조건에 부합하지 않는 사용자에게 보상 체인 표시. 사용자에게 일치하는 보상 체인이 없을 경우에만 표시됩니다. 예를 들어, 사용자가 권한이 없거나 특성이 사용자 맞춤 설정된 체인과 일치하지 않는 경우입니다.
11. 다음을 클릭합니다.
12. 보상 체인의 유효 기간을 지정합니다.
13. 시간 제한 설정 토글을 켜짐(On)으로 설정하고 보상 체인의 만료 날짜와 시간을 설정할 수 있습니다.
14. 보상 체인의 진행 상황을 자동으로 초기화하려면 체인이 종료된 후 사용자 진행 상황 새로 고침 확인란을 선택하세요.
15. 특정 시점에 보상 체인을 갱신하려면 보상 체인 갱신 가능 토글을 켜짐(On)으로 설정하고 업데이트 모드를 지정합니다.

16. 생성을 클릭합니다.

1. 관리자 페이지의 프로젝트에서, LiveOps > 일일 보상 섹션으로 이동합니다.
2. 원하는 체인의 행에서 •••를 클릭한 다음, 드롭다운 목록에서 활성화를 선택합니다.

API를 통한 설정

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

보상 시스템 표시

웹사이트 빌더를 통해 표시

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

사이트에 보상 체인을 표시하는 방법:

1. 관리자 페이지의 프로젝트에서, 스토어프론트 > 웹 사이트 섹션으로 이동합니다.
2. 사이트를 클릭하고 웹사이트 빌더 열기를 클릭합니다.
3. 빌더의 기본 영역에서 새 블록을 추가할 위치를 선택하고 블록 추가를 클릭합니다.
4. 블록 목록에서 보상 시스템을 선택합니다.
5. 드롭다운 목록에서 보상 체인을 선택합니다.

6. 버튼 및 텍스트 색상을 사용자 지정(선택 사항)합니다.
7. 체인을 미리 보려면 빌더의 오른쪽 상단 모서리 부분에 있는 미리 보기를 클릭하십시오.

8. 변경 사항을 적용하려면 웹 사이트를 다음과 같이 게시하십시오:
   1. 웹사이트 빌더의 오른쪽 상단 모서리에서, 게시를 클릭합니다.
   2. 게시하려는 페이지 옆의 확인란을 선택합니다.
   3. 게시를 클릭합니다.

웹사이트 빌더에서 가치 포인트에 대한 세부 정보 표시

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

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

예:

개별 보상 체인 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이 고정 가치로 표시됩니다.

API 호출을 통해 보상 체인 표시

1. 애플리케이션 UI에서 일일 보상 체인 단계를 표시하는 요소를 구현합니다.
2. 혜택 체인 및 가치 포인트 그룹의 다음 클라이언트 측 API 호출을 사용하여 체인 작업 로직을 구현하십시오:

3. 아이템이 사용자에게 올바르게 제공되도록 합니다.

사용자 클랜 설정

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

1. 로그인에서 특성 스키마 설정.

 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. 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}

엑솔라 로그인을 통한 인증을 사용하는 경우, 사용자의 클랜을 업데이트하려면 현재 사용자의 클랜 업데이트 API를 호출하십시오. 특성에 새로운 클랜이 포함되어 있는 경우, 사용자는 이전 클랜의 보상 체인에서 미수령 보상을 받게 되며 클랜 소속이 업데이트됩니다. 사용자가 이전에 클랜 회원이었으나 더 이상 회원이 아닌 경우, 클랜 멤버십이 취소됩니다. 이 메서드의 응답에는 사용자가 이미 수령한 보상이 포함됩니다.

웹샵 솔루션 디스플레이 세부 사항

특성 스키마 구성 후, 사용자의 클랜 데이터 전달을 구현하십시오.

사용자 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    {
 9      "key": "clan_id"
10    }
11  ]
12}

API를 통해 세부 정보 표시

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