무료 아이템

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

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

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

사용 예시:

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

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

무료 아이템 설정 방법:

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

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

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

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

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

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

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

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

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

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

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

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

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

• 장바구니에 유료 아이템과 무료 아이템이 모두 있는 경우 Cart 클래스의 Purchase 메소드를 호출합니다. 이 메소드에는 주문 생성, 결제 UI 열기, 주문 상태 추적용 메소드가 캡슐화되어 있습니다.

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

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

Purchase, PurchaseFreeItem, PurchaseFreeCart 메소드에는 주문 상태 추적용 논리가 포함되어 있습니다. 이러한 메소드를 호출할 때는 주문이 onSuccess 매개변수에서 done 상태로 전환될 때 호출된 함수를 전달합니다. 다음 옵션 중 하나를 사용하여 애플리케이션의 클라이언트 측에서 인벤토리를 업데이트합니다.

• 사용자 인벤토리를 표시하는 SDK 메소드 사용
• 구매 메소드의 onSuccess 콜백 함수로 전달되는 주문 콘텐츠 데이터 사용

유용한 링크