가상 아이템

작동 방식

가상 아이템은 사용자가 실제 통화 또는 인게임 재화로 구매하거나 보너스로 받을 수 있는 인게임 아이템입니다. 가상 아이템은 물리적 형태를 갖지 않으며 게임 내에서만 사용됩니다. 가상 아이템의 예에는 스킨, 물약, 무기, 열쇠 및 게임 플레이 또는 캐릭터 외형에 영향을 주는 기타 요소가 포함됩니다.

주요 기능:

• 유연한 가격 책정 구성:
  • 단일 아이템의 가격을 현금 및/또는 가상 머니로 설정.
  • 무료 아이템 생성.
• 사용자 국가 및 통화 자동 감지.
• 가용성 구성:
  • 특정 지역에서 아이템 판매 제한.
  • 구매 가능한 아이템 수 제한.
  • 스토어에서 아이템 표시 시간 제한.
  • 구매 불가 아이템 구성. 아이템을 카탈로그에서 숨기고 번들의 일부 또는 다른 아이템의 보너스로만 제공할 수 있습니다.

설정 방법

2. 수동으로 생성 버튼을 클릭하고 드롭다운 목록에서 가상 아이템을 선택하세요.

3. General settings 섹션에서 다음을 지정하세요.
   • SKU
   • 아이템이 속할 그룹 1개 이상(선택 사항)
   • 이름
   • 짧은 설명
   • 상세 설명 - 추가하려면 해당 토글을 켜세요(선택 사항)

4. 미디어 섹션에서 이미지 또는 동영상을 한 개 이상 업로드하세요(선택 사항). 장치에서 업로드하거나 링크로 추가할 수 있습니다. 엑솔라 사이트 에디터로 만든 스토어에서는 모든 아이템 카드에 메인으로 표시된 파일이 노출되고, 나머지 파일은 미디어 갤러리가 있는 아이템 카드에서만 볼 수 있습니다. 메인으로 표시된 파일은 카탈로그 조회 API 호출의 응답에도 포함됩니다.

5. Price settings 섹션에서 가격을 설정하거나 무료 아이템을 생성하세요.
   • 가격을 설정하려면 Paid item을 선택하고 Pricing in real currency 및/또는 Pricing in virtual currency 토글을 켠 다음 가격을 지정하세요. 필요하면 지역별 가격 책정을 설정하세요.
   • 무료 아이템을 생성하려면 Free item을 선택하세요.

6. 구매 가능한 아이템 수를 제한하려면 다음을 수행하세요.
   1. Limits 섹션에서 토글을 켜고 수량을 지정하세요.
   2. 제한 초기화 주기를 설정하세요. 초기화 주기를 설정하려면 드롭다운 목록에서 기간을 선택하세요:
      1. Daily.
      2. Weekly.
      3. Monthly.
      4. Custom interval. 이 간격은 스토어 내 아이템 표시 시작일부터 계산합니다.
      5. No regular refresh.
   3. 선택한 기간에 해당하는 매개변수를 지정해 초기화 일정을 설정하세요.

7. 아이템의 디스플레이 시간 제한을 설정하려면(선택 사항) 다음을 수행하세요.

   1. Add specific display period 섹션에서 토글을 켜세요.
   2. 표준시 및 기간의 시작 및 종료 시점을 지정하세요.

   아이템의 표시 종료 시점을 지정하지 않은 상태로 두려면 No end date 토글을 켜세요.

8. 다음 옵션 중 하나를 사용하여 속성을 설정하세요(선택 사항).
   1. JSON 형식으로 속성 및 해당 값 추가.
   2. 직접 속성 및 해당 값을 생성하고 아이템에 연결.

9. 유료 아이템을 무작위 리워드 메커니즘(예: 루트박스 또는 가챠)에서 사용한다면, Mark as paid randomized reward 토글을 활성화하세요.

10. Create 버튼을 클릭하세요.

11. 열린 창에서 아이템 상태를 선택하고 Continue 버튼을 클릭하세요.

생성된 아이템은 모든 아이템 섹션에 표시됩니다.

API로 설정

가상 아이템을 설정하려면 가상 아이템 및 가상 머니 그룹의 Admin 하위 섹션에 있는 호출을 사용하세요.

스토어에 가상 아이템 표시

가상 아이템 표시 방식은 카탈로그를 웹사이트 빌더로 구현했는지, API로 구현했는지에 따라 달라집니다.

웹사이트 빌더로 표시

웹 사이트에 가상 아이템을 표시하는 방법:

1. 가상 아이템을 생성하세요.

2. 게시자 계정의 프로젝트에서 Storefronts > Websites 섹션으로 이동하세요.

3. 원하는 사이트의 패널에서 Open Site Builder를 클릭하세요.

2. 모바일 게임 계정의 프로젝트에서 Web Shop 섹션으로 이동하세요.

3. 원하는 사이트의 패널을 클릭하세요.

4. 사이트에 여러 페이지가 있다면, 필요한 페이지를 선택하세요:

   1. 에디터 상단에서 현재 페이지 제목을 클릭하세요.
   2. 드롭다운 목록에서 원하는 페이지를 선택하세요.

5. Store 블록 섹션에서 Item type 입력란에 Virtual items를 선택하고, Item group 입력란에서 웹사이트에 판매할 아이템 그룹을 선택하세요.

6. 아이템 카드 레이아웃을 설정하세요.

7. 필요한 변경을 모두 적용하고 웹사이트 출시를 준비했다면:

   1. 사이트 에디터 오른쪽 상단에서 Publish를 클릭하세요.
   2. 게시할 페이지 옆의 체크박스를 선택하세요.
   3. Publish를 클릭하세요.

사이트를 게시하면 가상 아이템 그룹이 있는 섹션이 표시됩니다. 아이템이 표시되지 않으면 상태가 Available로 설정되어 있고 시간 기반 표시 제한이 비활성화되어 있는지 확인하세요.

API로 가상 아이템 정보 가져오기

클라이언트 측에서 가상 아이템 카탈로그를 가져오려면 가상 아이템 및 가상 머니 메서드 그룹의 Catalog 하위 섹션에 있는 메서드를 사용하세요. 이 메서드를 사용하려면 인증이 필요하지 않습니다.

사용자에게 가상 아이템 지급

아이템 유형 및 통합 설정에 따라 가상 아이템은 다음과 같은 방법 중 하나로 사용자에게 부여됩니다:

• PlayFab을 통합했다면, 가상 머니와 아이템은 사용자의 PlayFab 인벤토리에 자동으로 지급됩니다.
• 커스텀 배송 시스템을 사용한다면, 모든 가상 아이템과 가상 머니는 귀사에서 지급하세요. 백엔드에서 주문 데이터를 받도록 웹훅 핸들러를 설정하는 것을 권장합니다. 필요한 데이터는 Successful payment for order 웹훅에 포함되어 있습니다.

이에 대한 자세한 내용과 기타 구매 데이터 조회 방법은 주문 상태 추적 설정 섹션을 참고하세요.

유용한 링크