엔터프라이즈급 Unity용 SDK / 무료 아이템
  문서로 돌아가기

엔터프라이즈급 Unity용 SDK

무료 아이템

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

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

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

사용 예시:

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

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

무료 아이템 설정 방법:

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

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

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

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

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

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

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

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

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

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

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

사용자가 쇼핑 장바구니를 사용하는 경우:

  • 사용자의 장바구니에 무료 아이템과 유료 아이템이 모두 있는 경우:
    1. PurchaseCart SDK 메소드를 사용하여 결제 토큰과 주문 ID를 가져옵니다.
    2. 결제 UI 열기를 구현합니다. 이렇게 하려면 OpenPurchaseUi SDK 메소드를 호출하고 결제 토큰과 주문 ID를 전달합니다.

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

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

타이머에서 CheckOrder SDK 메소드를 호출하여 무료 아이템 주문 상태를 추적할 수 있습니다.

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

알림
엑솔라 웹훅을 처리하도록 애플리케이션 서버를 구성한 경우, order_paid 웹훅을 수신하면 애플리케이션의 클라이언트 측에서 데이터를 업데이트할 수 있습니다.
이 기사가 도움이 되었나요?
감사합니다!
개선해야 할 점이 있을까요? 메시지
유감입니다
이 기사가 도움이 안 된 이유를 설명해 주세요. 메시지
의견을 보내 주셔서 감사드립니다!
메시지를 검토한 후 사용자 경험 향상에 사용하겠습니다.
이 페이지 평가
이 페이지 평가
개선해야 할 점이 있을까요?

답하기 원하지 않습니다

의견을 보내 주셔서 감사드립니다!

유용한 링크

마지막 업데이트: 2023년 10월 10일

오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.

문제 보고
콘텐츠를 항상 검토합니다. 여러분의 피드백은 콘텐츠를 개선에 도움이 됩니다.
후속 조치를 위해 이메일을 제공해 주세요
의견을 보내 주셔서 감사드립니다!