아이템 구매 한도
작동 방식
사용자별 구매 한도를 설정하고 해당 한도에 대한 정기적인 초기화를 구성할 수 있습니다.
다음 시나리오에 한도 구성을 사용할 수 있습니다.
- 인게임 아이템 판매 - 가상 아이템, 인게임 재화 패키지, 번들
- 게임 및 DLC를 게임 키로 판매
주기적인 한도 초기화를 활성화하여 다음을 수행할 수 있습니다:
- 반복 구매를 허용
- 여러 퍼블리싱 플랫폼에서 아이템을 판매할 때 시스템과 데이터를 동기화
사용자별 구매 가능 수량을 정확히 표시하려면 인증을 구성해야 합니다.
인증되지 않은 사용자에게는 항상 구매 가능한 최대 수량이 표시됩니다. 활성 제한 설정이 적용된 사용자의 아이템 잔여 수량을 표시하려면 요청 시 사용자 인증 데이터를 포함하십시오:
- Virtual Items & Currency 그룹의 Catalog 하위 섹션 API 호출로 아이템 카탈로그를 가져옵니다.
- Game Keys 그룹의 Catalog 하위 섹션 API 호출로 게임 카탈로그를 가져옵니다.
엑솔라는 한도를 적용하여 사용자가 설정된 한도보다 더 많이 구매하지 못하도록 막습니다.
- 결제 UI가 열리고 아이템이 결제되면, 해당 아이템이 포함된 모든 미지급 주문이 무효화됩니다.
- 예시: 사용자가 구매 완료 전 한정 아이템의 결제 양식을 여러 브라우저 탭이나 다른 브라우저에서 동시에 열 수 있으며, 이로 인해 동일 아이템에 대해 여러 건의 주문이 생성됩니다. 한 탭에서 구매가 완료되면 엑솔라 측에서 해당 상품의 미결제 주문 전체를 취소합니다.
- 결제를 환불하거나 주문을 취소해도 한도는 초기화되지 않습니다. 다음 API 호출을 사용해 초기화할 수 있습니다: 지정된 사용자의 모든 구매 한도 새로 고침 및 지정된 사용자의 모든 프로모션 한도 새로 고침.
- 예시: 구매 한도가 있는 아이템을 사용자가 구매해 게임에서 사용한 뒤 환불을 요청할 수 있습니다. 한도가 자동으로 초기화되면, 사용자는 아이템을 다시 구매해 사용하고 이 과정을 반복하여 의도한 한도를 사실상 우회할 수 있습니다. 이를 방지하기 위해 결제를 환불하거나 주문을 취소해도 한도는 초기화되지 않습니다.
프로모션 사용 한도를 구성하려면 지침을 참조하세요.
한도 구성 및 업데이트
게시자 계정에서 구성 및 업데이트
사용 횟수가 제한된 아이템을 생성하는 방법:
- 게시자 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
- 모바일 게임용 계정에서 프로젝트를 열고 Catalog 섹션으로 이동하세요.
- Create manually 버튼을 클릭하고 드롭다운 목록에서 Virtual item을 선택하세요.
- General settings 섹션에서 다음을 지정하세요:
- SKU
- 아이템이 속할 하나 이상의 그룹(선택 사항)
- 이름
- 짧은 설명
- 상세 설명 — 추가하려면 해당 토글을 켜세요(선택 사항)
- Media 섹션에서 하나 이상의 이미지 또는 동영상을 업로드하세요(선택 사항). 장치에서 업로드하거나 링크로 추가할 수 있습니다. 엑솔라 사이트 에디터로 만든 스토어에서는 모든 아이템 카드에 Main으로 표시된 파일이 노출되고, 나머지 파일은 미디어 갤러리가 있는 아이템 카드에서만 볼 수 있습니다. Main으로 표시된 파일은 카탈로그 조회 API 호출의 응답에도 포함됩니다.
- Price settings 섹션에서 가격을 설정하거나 무료 아이템을 생성하세요.
- 가격을 설정하려면 Paid item을 선택하고 Real currency prices 및/또는 Virtual currency prices 토글을 켜고 가격을 지정하세요. 필요하다면 지역별 가격 책정을 설정하세요.
- 무료 아이템을 생성하려면 Free item을 선택하세요.
아이템은 여러 실제 통화와 가상 머니로 가격을 설정할 수 있습니다. 이때 각 유형에 대해 기본 통화를 지정해야 합니다. 실제 통화 중 하나와 가상 머니 중 하나를 선택하세요.
가상 머니로 가격을 지정하려면 프로젝트에서 해당 가상 머니를 이미 생성해야 합니다.
- 구매 가능 수량을 제한하려면:
- Limits 섹션에서 토글을 켜고 수량을 지정하세요.
- 한도 초기화 주기를 구성하세요. 드롭다운 목록에서 기간을 선택하세요:
- Daily.
- Weekly.
- Monthly.
- Custom interval. 이 간격은 스토어에서 아이템 표시 시작일을 기준으로 계산됩니다.
- No regular refresh.
- 선택한 기간에 맞는 매개변수를 지정해 초기화 일정을 설정하세요.
아이템의 표시 기간을 제한하려면(선택 사항):
- Add specific display period 섹션에서 토글을 켜세요.
- 시간대와 기간의 시작 및 종료 시점을 지정하세요.
아이템의 표시 종료 시점을 지정하지 않으려면 No end date 토글을 켜세요.
- 다음 중 하나로 특성을 설정하세요(선택 사항).
- 유료 아이템을 무작위 리워드 메커니즘(예: 루트박스 또는 가챠)에서 사용한다면, Mark as paid randomized reward 토글을 활성화하세요.
Create 버튼을 클릭하세요.
열린 창에서 아이템 상태를 선택하고 Continue 버튼을 클릭하세요.
생성된 아이템은 All items 섹션에 표시됩니다.
기존 아이템에 대한 제한을 구성하거나 업데이트하는 방법:
- 게시자 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
계정에서 구성 및 업데이트
사용 횟수가 제한된 아이템을 생성하는 방법:
- 게시자 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
- 모바일 게임용 계정에서 프로젝트를 열고 Catalog 섹션으로 이동하세요.
- Create manually 버튼을 클릭하고 드롭다운 목록에서 Virtual item을 선택하세요.
- General settings 섹션에서 다음을 지정하세요:
- SKU
- 아이템이 속할 하나 이상의 그룹(선택 사항)
- 이름
- 짧은 설명
- 상세 설명 — 추가하려면 해당 토글을 켜세요(선택 사항)
- Media 섹션에서 하나 이상의 이미지 또는 동영상을 업로드하세요(선택 사항). 장치에서 업로드하거나 링크로 추가할 수 있습니다. 엑솔라 사이트 에디터로 만든 스토어에서는 모든 아이템 카드에 Main으로 표시된 파일이 노출되고, 나머지 파일은 미디어 갤러리가 있는 아이템 카드에서만 볼 수 있습니다. Main으로 표시된 파일은 카탈로그 조회 API 호출의 응답에도 포함됩니다.
- Price settings 섹션에서 가격을 설정하거나 무료 아이템을 생성하세요.
- 가격을 설정하려면 Paid item을 선택하고 Real currency prices 및/또는 Virtual currency prices 토글을 켜고 가격을 지정하세요. 필요하다면 지역별 가격 책정을 설정하세요.
- 무료 아이템을 생성하려면 Free item을 선택하세요.
아이템은 여러 실제 통화와 가상 머니로 가격을 설정할 수 있습니다. 이때 각 유형에 대해 기본 통화를 지정해야 합니다. 실제 통화 중 하나와 가상 머니 중 하나를 선택하세요.
가상 머니로 가격을 지정하려면 프로젝트에서 해당 가상 머니를 이미 생성해야 합니다.
- 구매 가능 수량을 제한하려면:
- Limits 섹션에서 토글을 켜고 수량을 지정하세요.
- 한도 초기화 주기를 구성하세요. 드롭다운 목록에서 기간을 선택하세요:
- Daily.
- Weekly.
- Monthly.
- Custom interval. 이 간격은 스토어에서 아이템 표시 시작일을 기준으로 계산됩니다.
- No regular refresh.
- 선택한 기간에 맞는 매개변수를 지정해 초기화 일정을 설정하세요.
아이템의 표시 기간을 제한하려면(선택 사항):
- Add specific display period 섹션에서 토글을 켜세요.
- 시간대와 기간의 시작 및 종료 시점을 지정하세요.
아이템의 표시 종료 시점을 지정하지 않으려면 No end date 토글을 켜세요.
- 다음 중 하나로 특성을 설정하세요(선택 사항).
- 유료 아이템을 무작위 리워드 메커니즘(예: 루트박스 또는 가챠)에서 사용한다면, Mark as paid randomized reward 토글을 활성화하세요.
Create 버튼을 클릭하세요.
열린 창에서 아이템 상태를 선택하고 Continue 버튼을 클릭하세요.
생성된 아이템은 All items 섹션에 표시됩니다.
기존 아이템의 한도를 구성하거나 업데이트하세요.
- 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
계정에서 구성 및 업데이트
사용 횟수가 제한된 아이템을 생성하는 방법:
- 게시자 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 Items catalog > All items > Virtual items 섹션으로 이동하세요.
- 모바일 게임용 계정에서 프로젝트를 열고 Catalog 섹션으로 이동하세요.
- Create manually 버튼을 클릭하고 드롭다운 목록에서 Virtual item을 선택하세요.
- General settings 섹션에서 다음을 지정하세요:
- SKU
- 아이템이 속할 하나 이상의 그룹(선택 사항)
- 이름
- 짧은 설명
- 상세 설명 — 추가하려면 해당 토글을 켜세요(선택 사항)
- Media 섹션에서 하나 이상의 이미지 또는 동영상을 업로드하세요(선택 사항). 장치에서 업로드하거나 링크로 추가할 수 있습니다. 엑솔라 사이트 에디터로 만든 스토어에서는 모든 아이템 카드에 Main으로 표시된 파일이 노출되고, 나머지 파일은 미디어 갤러리가 있는 아이템 카드에서만 볼 수 있습니다. Main으로 표시된 파일은 카탈로그 조회 API 호출의 응답에도 포함됩니다.
- Price settings 섹션에서 가격을 설정하거나 무료 아이템을 생성하세요.
- 가격을 설정하려면 Paid item을 선택하고 Real currency prices 및/또는 Virtual currency prices 토글을 켜고 가격을 지정하세요. 필요하다면 지역별 가격 책정을 설정하세요.
- 무료 아이템을 생성하려면 Free item을 선택하세요.
아이템은 여러 실제 통화와 가상 머니로 가격을 설정할 수 있습니다. 이때 각 유형에 대해 기본 통화를 지정해야 합니다. 실제 통화 중 하나와 가상 머니 중 하나를 선택하세요.
가상 머니로 가격을 지정하려면 프로젝트에서 해당 가상 머니를 이미 생성해야 합니다.
- 구매 가능 수량을 제한하려면:
- Limits 섹션에서 토글을 켜고 수량을 지정하세요.
- 한도 초기화 주기를 구성하세요. 드롭다운 목록에서 기간을 선택하세요:
- Daily.
- Weekly.
- Monthly.
- Custom interval. 이 간격은 스토어에서 아이템 표시 시작일을 기준으로 계산됩니다.
- No regular refresh.
- 선택한 기간에 맞는 매개변수를 지정해 초기화 일정을 설정하세요.
아이템의 표시 기간을 제한하려면(선택 사항):
- Add specific display period 섹션에서 토글을 켜세요.
- 시간대와 기간의 시작 및 종료 시점을 지정하세요.
아이템의 표시 종료 시점을 지정하지 않으려면 No end date 토글을 켜세요.
- 다음 중 하나로 특성을 설정하세요(선택 사항).
- 유료 아이템을 무작위 리워드 메커니즘(예: 루트박스 또는 가챠)에서 사용한다면, Mark as paid randomized reward 토글을 활성화하세요.
Create 버튼을 클릭하세요.
열린 창에서 아이템 상태를 선택하고 Continue 버튼을 클릭하세요.
생성된 아이템은 All items 섹션에 표시됩니다.
기존 아이템에 대한 제한을 구성하거나 업데이트하는 방법:
- 모바일 게임용 계정에서 프로젝트를 열고 Catalog > Virtual items 섹션으로 이동하세요.
아이템이 포함된 그룹을 여세요.
아이템 행에서 •••를 클릭하고 드롭다운 목록에서 Edit을 선택하세요.
Limits for single user 섹션에서 한도를 설정하거나 한도 초기화 주기를 선택한 다음, 시간과 시간대를 지정하세요.
- Save changes를 클릭하세요.
API 호출로 설정 및 업데이트
API를 통해 아이템 구매 한도를 설정하려면 다음 메서드에서 limits 객체를 사용하세요.
일별, 주별 또는 월별 한도 갱신을 설정하려면 limits.recurrent_schedule 개체를 전달하십시오.
구매 한도 갱신 주기가 설정되어 있다면, 구매 한도에 도달한 후에도 해당 아이템을 카탈로그에 계속 표시할지 여부를 제어할 수 있습니다. 이렇게 하려면 “limits.per_user.limit_exceeded_visibility”: “show” 매개변수를 전달하세요.
반복 갱신이 설정되어 있지 않으면, 매개변수 값과 관계없이 한도에 도달하면 해당 아이템이 카탈로그에서 숨겨집니다.
API를 통해 한도를 업데이트하고 관리하려면 한도 메서드 그룹의 관리 하위 섹션에 있는 메서드를 사용하십시오.
| Feature | API call |
|---|---|
| 지정한 아이템의 한도를 모든 사용자 또는 지정한 사용자에 대해 새로 고칩니다. | 구매 한도 새로 고침. |
| 지정한 사용자의 모든 아이템 한도를 새로 고칩니다. | 지정된 사용자의 모든 구매 한도 새로 고침. |
| 지정한 사용자에 대한 지정한 아이템의 구매 한도를 변경합니다. | 지정된 사용자에게 제공되는 아이템 수 설정. |
| 지정한 사용자에 대한 지정한 아이템에 설정된 한도 정보를 조회합니다. | 지정된 사용자에게 제공되는 아이템 수 조회. |
| 지정한 사용자가 구매할 수 있는 아이템 수를 증가시킵니다. | 지정된 사용자에게 제공되는 아이템 수 증가. |
| 지정한 사용자가 구매할 수 있는 아이템 수를 감소시킵니다. | 지정된 사용자에게 제공되는 아이템 수 감소. |
아이템 카탈로그에 한도 표시
아이템 판매 한도는 구현 방식에 따라 카탈로그에 표시됩니다. 웹사이트 빌더 또는 API를 통해 구현할 수 있습니다.
웹사이트 빌더로 표시
웹사이트 빌더를 사용할 경우 제한 사항이 자동으로 표시됩니다 - 아이템 카드에는 사용자에게 제공되는 아이템 수를 나타내는 카운터가 표시됩니다.
API로 한도 정보 가져오기
API를 사용하여 카탈로그를 구현한 경우, 다음 카탈로그 관련 API 호출에서 items.limits 배열에 제한 정보가 반환됩니다:
사용자가 구매 한도에 도달한 아이템은 can_be_bought = false로 반환됩니다.
필요에 따라 이러한 한도를 업데이트할 수 있습니다.
이 데이터를 사용하여 카탈로그에 한도를 표시할 수 있습니다. 예를 들어, 구매 가능한 최대 아이템 수를 표시할 수 있습니다.
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.
