보상 체인 생성

작동 방식

이 보상 시스템은 사용자가 실제 화폐로 스토어에서 구매하도록 유도합니다. 구매할 때마다 사용자는 가치 포인트를 획득하고 보상 체인을 따라 단계별로 진행하게 됩니다. 사용자가 클랜에 소속되어 있는 경우, 구매는 클랜 전체에 가치 포인트가 적립됩니다.

구매당 획득한 가치 포인트가 포함된 리워드 체인 예시:

용어집

사전 준비 사항

사용자가 가치 포인트를 얻기 위해 구매할 수 있는 아이템이 스토어에 있는지 확인하십시오.

클랜 리워드 체인을 생성하기 전에, 사용자 클랜을 설정하십시오.

가치 포인트 생성

가치 포인트 생성 방법:

1. 관리자 페이지에서 프로젝트를 열고 LiveOps > Canvas 섹션으로 이동합니다.

2. 가치 포인트 목록 영역에서 + 아이콘을 클릭합니다.

3. 가치 포인트 유형을 선택합니다 — 개인 가치 포인트 또는 클랜 가치 포인트. 가치 포인트 유형은 생성 단계에서 정의되며 이후 변경할 수 없습니다.

4. 이미지를 추가합니다(선택 사항).

5. 이름을 입력합니다.

6. 고유한 가치 포인트 SKU를 입력합니다.

7. 다음을 클릭합니다.

8. 가치 포인트 할당:

   1. 영향을 받는 아이템 추가를 클릭합니다.

   2. 아이템을 선택하고 각 아이템 구매 시 사용자가 받는 가치 포인트 수를 지정합니다.

   3. 선택을 클릭합니다.

   스토어에 아직 아이템이 없는 경우, 현재 설정을 저장하고 나중에 이 단계로 돌아올 수 있습니다.

9. 다음을 클릭합니다.

10. 가치 포인트 설정을 확인합니다.

11. 생성을 클릭합니다.

리워드 체인 생성

리워드 체인을 생성합니다:

1. 관리자 페이지에서 프로젝트를 열고 LiveOps > Canvas 섹션으로 이동합니다.
2. 다음 방법 중 하나로 리워드를 생성합니다:
   1. 도구 모음에서 + 아이콘을 클릭하고 리워드 체인을 선택합니다.
   2. 리워드 체인 목록 영역에서 + 아이콘을 클릭합니다.
   3. 캔버스의 아무 곳에서나 컨텍스트 메뉴를 열고 리워드 체인을 선택합니다.

3. 체인 유형을 선택합니다 — 개인 리워드 체인 또는 클랜 리워드 체인. 리워드 체인 유형은 생성 단계에서 정의되며 이후 변경할 수 없습니다.

4. 기본 체인 매개 변수를 지정합니다:

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

5. 다음을 클릭합니다.

6. 가치 포인트를 설정합니다 — 새로운 가치 포인트 생성 또는 기존에서 선택.

7. 다음을 클릭합니다.

8. 체인의 각 단계에 대한 리워드를 추가합니다. 단일 단계에 대한 리워드를 추가하려면:

   1. 새로운 단계 추가를 클릭합니다.

   2. 사용자가 이 단계의 리워드로 받는 아이템을 선택하고 각 아이템의 수량을 지정합니다.

   3. 아이템 추가를 클릭합니다.

9. 단계 목록에서 리워드를 받기 위해 필요한 가치 포인트의 양을 지정합니다. 각 후속 단계에 할당된 가치 포인트는 이전 단계보다 높아야 합니다. 최대 한도는 단계당 100,000 가치 포인트입니다.

10. 체인에서 리워드의 순서를 변경하려면, ☰ 아이콘을 사용하여 원하는 위치로 행을 드래그합니다(선택 사항).

11. 각 단계에 대한 리워드를 추가한 후, 다음을 클릭합니다.

12. 리워드 체인의 유효 기간을 지정합니다: 시간대, 시작 날짜, 종료 날짜. 유효 기간의 종료를 표시하지 않으려면 종료 날짜 없음 상자를 선택하십시오.

참고

또 다른 리워드 체인 유효 기간을 추가하려면 기간 추가를 클릭하십시오. 체인에 유효 기간이 여러 개 있는 경우, 각 기간마다 종료 날짜가 있어야 합니다. 체인은 지정된 분의 마지막 초에 종료됩니다. 예를 들어, 종료 시간이 12:00로 설정된 경우, 체인은 12:00:59까지 지속됩니다.

동일한 가치 포인트를 여러 리워드 체인에 사용할 경우, 한 체인 기간이 끝나고 다음 체인 기간이 시작되기까지 최소 15분을 두십시오. 가치 포인트와 단계 진행은 매 시각 :00, :15, :30, :45에 실행되는 백그라운드 작업에 의해 초기화됩니다(정확한 기간 종료 시점이 아님). 다음 기간이 이 시간보다 빨리 시작되면 사용자가 이전 잔액을 유지할 수 있습니다. 단계 진행을 즉시 초기화하려면 리워드 체인 초기화 API 메서드를 호출하십시오.

13. 리워드 체인의 진행 상황을 자동으로 초기화하려면 가치 포인트 초기화 토글을 켜십시오.

14. 특정 시점에 리워드 체인을 갱신하려면 리워드 체인 갱신 가능 토글을 켜고 업데이트 일정을 지정합니다.

15. 리워드 체인을 개인화하려면:

    1. 개인화된 리워드 체인 토글을 켭니다.

    2. 체인 디스플레이 옵션 중 하나를 선택합니다:

       • 적격 사용자에게 표시 — 이 경우, 체인은 지정된 조건을 충족하는 인증된 사용자에게만 표시됩니다.

       • 비적격 사용자에게 표시 — 이러한 체인의 경우, 개인화 조건을 지정할 필요가 없습니다 — 기본적으로 적용됩니다. 이는 인증되지 않은 사용자에게 표시되며, 인증된 사용자에게 맞춤형 리워드 체인이 없는 경우에도 표시됩니다.

    3. 적격 사용자에게 표시 옵션을 선택한 경우, 조건을 지정합니다:

       1. 사용자 특성 유형을 지정합니다 — 문자열, 숫자, 또는 날짜.

       2. 드롭다운 목록에서 사용자 특성을 선택합니다.

       3. 비교 연산자를 선택합니다.

       4. 사용자 특성 값을 지정합니다.

    4. 조건을 더 추가하려면, 조건 추가를 클릭하고 표시된 필드를 작성합니다(선택 사항).

16. 다음을 클릭합니다.

17. 체인을 확인합니다.

18. 체인을 즉시 활성화하려면(선택 사항), 활성 상태로 생성 토글을 켭니다.

19. 생성을 클릭합니다.

참고

활성화된 체인은 편집할 수 없습니다. 프로모션의 설정을 변경하려면 먼저 비활성화하십시오.

다음 방법으로 체인을 활성화하거나 비활성화할 수 있습니다:

• 리워드 체인 카드에서
• 리워드 체인 목록에서
• 체인을 편집하는 동안

보상 시스템 표시

웹사이트 빌더를 통해 표시

보상 시스템이 적절히 작동하도록 보장하려면 사용자 인증을 구성해야 합니다. 미인증 사용자의 경우 개인 및 클랜 보상 체인이 진행 상태 없이 표시됩니다.

클랜에 속하지 않은 인증된 사용자는 자신의 개인 보상 체인만 볼 수 있습니다. 클랜 보상 체인은 이용 불가 상태로 표시됩니다.

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

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

6. 드롭다운 목록에서 보상 체인을 선택합니다.

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

9. 변경 사항을 적용하려면 웹 사이트를 다음과 같이 게시하십시오:
   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를 사용하는 경우 사용자 인증 중에 현재 특성 값을 직접 전달할 수 있습니다.