무료 아이템

무료 아이템은 사용자가 인게임 재화 또는 실물 화폐를 사용하지 않아도 얻을 수 있는 아이템 유형입니다. 여기에는 다음이 포함됩니다.

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

무료 아이템은 인증한 사용자만 사용할 수 있습니다. 인증 하지 않은 사용자는 무료 아이템의 카탈로그만 볼 수 있습니다.

사용 예시:

• 프로젝트에 있어 중요한 날짜(예: 프로젝트가 시작된 날)에 사용자의 충성도에 대한 보상을 제공하기 위해 무료 아이템을 제공할 수 있습니다.
• 스토어에서 게임용 무료 스타터 팩을 제공함으로써 새로운 사용자를 게임으로 끌어들일 수 있습니다.

사용자가 유니크 아이템을 이미 가지고 있는 경우 유니크 아이템의 무료 제공을 제한할 수 있습니다.

무료 아이템 설정 방법:

1. 카탈로그에 무료 아이템을 추가합니다.
2. 사용자가 무료 아이템을 주문하는 로직을 구현합니다.
3. 사용자에게 무료 아이템을 부여하는 로직을 구현합니다.

카탈로그에 무료 아이템 추가하기

아이템 생성에 대한 자세한 지침은 다음 문서 섹션에서 확인할 수 있습니다.

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

무료 아이템을 생성하거나 편집하려면 유료 혹은 무료 섹션에서 무료 아이템, 무료 패키지, 무료 번들 중에서 하나를 선택해야 합니다.

사용자로 무료 아이템 주문하기

사용자는 두 가지 방식으로 무료 아이템을 주문할 수 있습니다.

• 원클릭으로 (장바구니를 사용하지 않고) - 하나의 SKU만 수량 제한 없이 주문합니다. 예: 동일한 포션 100개.
• 장바구니를 통해 - 유형과 수량의 제한 없이 주문합니다.

원클릭으로 무료 아이템 주문하기

이 옵션을 구현하려면 사용자가 무료 아이템을 주문하기 위해 카탈로그에서 버튼을 클릭할 때 Store 라이브러리의 createOrderWithSpecifiedFreeItem 메소드를 호출해야 합니다.

이 메소드에 대한 요청이 성공적으로 진행되면 엑솔라 측의 사용자 인벤토리로 아이템이 즉시 배달됩니다(페이 스테이션을 열지 않아도 됨).

장바구니를 통해 무료 아이템 주문하기

사용자가 장바구니를 통해 구매하는 경우:

• 사용자의 장바구니에 유료 아이템과 무료 아이템이 모두 포함된 경우:
  1. Store 라이브러리의 createOrderFromCartById 또는 createOrderFromCurrentCart 메소드를 사용하여 결제 토큰 및 주문 ID를 가져옵니다.
  2. 결제 UI 열기를 구현합니다. 이렇게 하려면 페이먼트 솔루션 라이브러리의 createIntentBuilder 메소드를 호출하고 해당 메소드로 결제 토큰과 주문 ID를 전달합니다.

• 사용자의 장바구니에 무료 아이템만 있는 경우 Store 라이브러리의 createOrderWithFreeCart 메 소드를 호출합니다. 이 메소드에 대한 요청이 성공적으로 진행되면 엑솔라 측의 사용자 인벤토리로 아이템이 전달됩니다(페이 스테이션을 열지 않아도 됨).

사용자에게 무료 아이템 부여하기

Store 라이브러리의 getOrder 메소드를 반복적으로 호출하여 무료 아이템 주문의 상태를 추적할 수 있습니다.

주문에 성공하면 사용자 인벤토리를 표시하는 SDK 메소드를 사용하여 애플리케이션의 클라이언트 측에서 데이터를 업데이트합니다.

유용한 링크