아이템 구매 한도
작동 방식
사용자별 구매 한도를 설정하고 해당 한도에 대한 정기 재설정을 구성할 수 있습니다.
다음 시나리오에 한도 구성을 사용할 수 있습니다.
- 인게임 아이템 판매 - 가상 아이템, 인게임 재화 패키지, 번들
- 게임 및 DLC를 게임 키로 판매
다음에 대해 정기 한도 재설정을 활성화할 수 있습니다.
- 반복 구매 허용
- 여러 퍼블리싱 플랫폼에서 아이템을 판매할 때 시스템과 데이터를 동기화
사용자별 구매 가능 수량을 정확히 표시하려면 인증을 구성해야 합니다.
인증되지 않은 사용자에게는 항상 구매 가능한 최대 수량이 표시됩니다. 활성 제한 설정이 적용된 사용자의 아이템 잔여 수량을 표시하려면 요청 시 사용자 인증 데이터를 포함하세요.
- 가상 아이템 및 인게임 재화 그룹의 카탈로그 하위 섹션에서 호출을 사용하여 아이템 카탈로그 요청
- 게임 키 그룹의 카탈로그 하위 섹션에서 호출을 사용하여 게임 카탈로그 요청
엑솔라는 한도를 적용하여 사용자가 설정된 한도보다 더 많이 구매하지 못하도록 막습니다.
- 페이먼트 솔루션 결제 UI가 열리고 아이템이 결제되면, 해당 아이템이 포함된 모든 미지급 주문이 무효화됩니다.
- 예시: 사용자가 구매 완료 전 한정 아이템의 결제 양식을 여러 브라우저 탭이나 다른 브라우저에서 열 수 있으며, 이로 인해 동일 아이템에 대해 여러 건의 주문이 생성될 수 있습니다. 한 탭에서 구매가 완료되면 엑솔라 측에서 해당 상품의 모든 미결제 주문을 취소합니다.
- 결제를 환불하거나 주문을 취소해도 한도는 재설정되지 않습니다. 지정된 사용자의 모든 구매 한도 새로 고침 및 지정된 사용자의 모든 프로모션 한도 새로 고침 API 호출을 사용하여 한도를 재설정할 수 있습니다.
- 예시: 구매 한도가 있는 아이템을 구매한 사용자가 게임 내에서 사용한 후 환불을 요청할 수 있습니다. 한도가 자동으로 초기화된 경우, 사용자는 해당 아이템을 다시 구매하고 사용한 후 이 과정을 반복함으로써 의도된 한도를 효과적으로 우회할 수 있습니다. 이를 방지하기 위해 결제 환불이나 주문 취소 시 한도가 초기화되지 않습니다.
프로모션 사용 한도를 구성하려면 지침을 참조하세요.
한도 구성 및 업데이트
게시자 계정에서 구성 및 업데이트하기
사용 횟수가 제한된 아이템을 생성하는 방법:
- 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 모바일 게임용 계정에서 프로젝트를 열고 카탈로그 섹션으로 이동하세요.
- 수동으로 생성 버튼을 클릭하고 드롭다운 목록에서 가상 아이템을 선택하세요.
- General settings 섹션에서 다음을 지정하세요.
- SKU
- 아이템이 속할 그룹 1개 이상(선택 사항)
- 이름
- 짧은 설명
- 상세 설명 - 추가하려면 해당 토글을 켜세요(선택 사항)
- 미디어 섹션에서 이미지 또는 동영상을 한 개 이상 업로드하세요(선택 사항). 장치에서 업로드하거나 링크로 추가할 수 있습니다. 엑솔라 사이트 에디터로 만든 스토어에서는 모든 아이템 카드에 메인으로 표시된 파일이 노출되고, 나머지 파일은 미디어 갤러리가 있는 아이템 카드에서만 볼 수 있습니다. 메인으로 표시된 파일은 카탈로그 조회 API 호출의 응답에도 포함됩니다.
- Price settings 섹션에서 가격을 설정하거나 무료 아이템을 생성하세요.
- 가격을 설정하려면 Paid item을 선택하고 Pricing in real currency 및/또는 Pricing in virtual currency 토글을 켠 다음 가격을 지정하세요. 필요하면 지역별 가격 책정을 설정하세요.
- 무료 아이템을 생성하려면 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 버튼을 클릭하세요.
생성된 아이템은 모든 아이템 섹션에 표시됩니다.
기존 아이템의 한도를 구성하거나 업데이트:
계정에서 구성 및 업데이트
사용 횟수가 제한된 아이템을 생성하는 방법:
- 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 모바일 게임용 계정에서 프로젝트를 열고 카탈로그 섹션으로 이동하세요.
- 수동으로 생성 버튼을 클릭하고 드롭다운 목록에서 가상 아이템을 선택하세요.
- General settings 섹션에서 다음을 지정하세요.
- SKU
- 아이템이 속할 그룹 1개 이상(선택 사항)
- 이름
- 짧은 설명
- 상세 설명 - 추가하려면 해당 토글을 켜세요(선택 사항)
- 미디어 섹션에서 이미지 또는 동영상을 한 개 이상 업로드하세요(선택 사항). 장치에서 업로드하거나 링크로 추가할 수 있습니다. 엑솔라 사이트 에디터로 만든 스토어에서는 모든 아이템 카드에 메인으로 표시된 파일이 노출되고, 나머지 파일은 미디어 갤러리가 있는 아이템 카드에서만 볼 수 있습니다. 메인으로 표시된 파일은 카탈로그 조회 API 호출의 응답에도 포함됩니다.
- Price settings 섹션에서 가격을 설정하거나 무료 아이템을 생성하세요.
- 가격을 설정하려면 Paid item을 선택하고 Pricing in real currency 및/또는 Pricing in virtual currency 토글을 켠 다음 가격을 지정하세요. 필요하면 지역별 가격 책정을 설정하세요.
- 무료 아이템을 생성하려면 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 버튼을 클릭하세요.
생성된 아이템은 모든 아이템 섹션에 표시됩니다.
기존 아이템의 한도를 구성하거나 업데이트:
계정에서 구성 및 업데이트
사용 횟수가 제한된 아이템을 생성하는 방법:
- 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 모바일 게임용 계정에서 프로젝트를 열고 카탈로그 섹션으로 이동하세요.
- 수동으로 생성 버튼을 클릭하고 드롭다운 목록에서 가상 아이템을 선택하세요.
- General settings 섹션에서 다음을 지정하세요.
- SKU
- 아이템이 속할 그룹 1개 이상(선택 사항)
- 이름
- 짧은 설명
- 상세 설명 - 추가하려면 해당 토글을 켜세요(선택 사항)
- 미디어 섹션에서 이미지 또는 동영상을 한 개 이상 업로드하세요(선택 사항). 장치에서 업로드하거나 링크로 추가할 수 있습니다. 엑솔라 사이트 에디터로 만든 스토어에서는 모든 아이템 카드에 메인으로 표시된 파일이 노출되고, 나머지 파일은 미디어 갤러리가 있는 아이템 카드에서만 볼 수 있습니다. 메인으로 표시된 파일은 카탈로그 조회 API 호출의 응답에도 포함됩니다.
- Price settings 섹션에서 가격을 설정하거나 무료 아이템을 생성하세요.
- 가격을 설정하려면 Paid item을 선택하고 Pricing in real currency 및/또는 Pricing in virtual currency 토글을 켠 다음 가격을 지정하세요. 필요하면 지역별 가격 책정을 설정하세요.
- 무료 아이템을 생성하려면 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 버튼을 클릭하세요.
생성된 아이템은 모든 아이템 섹션에 표시됩니다.
기존 아이템의 한도를 구성하거나 업데이트:
- 관리자 페이지에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 계정에서 프로젝트를 열고 아이템 카탈로그 > 모든 아이템 > 가상 아이템 섹션으로 이동하세요.
- 모바일 게임 계정에서 프로젝트를 열고 카탈로그 > 가상 아이템 섹션으로 이동하세요.
- 아이템이 포함된 그룹을 여세요.
- 아이템 행에서 •••를 클릭하고 드롭다운 목록에서 편집을 선택하세요.
- 단일 사용자 한도 섹션에서 한도를 설정하거나 한도 재설정 주기를 선택한 다음 시간과 시간대를 지정하세요.
- 변경 사항 저장을 클릭합니다.
API 호출을 통한 설정 및 업데이트
API를 통한 아이템 구매 한도를 설정하려면 다음 메서드에서 limits 개체를 사용하세요.
일일, 주간 또는 월간 한도 새로고침을 설정하려면 limits.recurrent_schedule 개체를 전달하세요.
구매 한도 갱신 주기가 설정되어 있는 경우, 구매 한도에 도달한 후에도 해당 아이템을 카탈로그에 계속 표시할지 여부를 관리할 수 있습니다. 이렇게 하려면 “limits.per_user.limit_exceeded_visibility”: “show” 매개 변수를 전달하십시오.
반복 새로 고침이 설정되어 있지 않은 경우, 매개 변수 값과 관계없이 한도에 도달하면 해당 아이템이 카탈로그에서 숨겨집니다.
API를 통해 한도를 업데이트하고 관리하려면 한도 메서드 그룹의 관리 하위 섹션에 있는 메서드를 사용하세요.
| 기능 | API 호출 |
|---|---|
| 지정된 아이템의 한도를 모든 사용자 또는 지정된 사용자에 대해 새로 고칩니다. | 구매 한도 새로 고침. |
| 지정된 사용자의 모든 아이템 한도를 새로 고칩니다. | 지정된 사용자의 모든 구매 한도 새로 고침. |
| 지정된 사용자에 대한 지정한 아이템의 구매 한도를 변경합니다. | 지정된 사용자에게 제공되는 아이템 수 설정. |
| 지정된 사용자에 대해 지정된 아이템에 설정된 한도 정보를 조회합니다. | 지정된 사용자에게 제공되는 아이템 수 조회. |
| 지정된 사용자가 구매할 수 있는 아이템 수를 늘립니다. | 지정된 사용자에게 제공되는 아이템 수 증가. |
| 지정된 사용자가 구매할 수 있는 아이템 수를 줄입니다. | 지정된 사용자에게 제공되는 아이템 수 감소. |
아이템 카탈로그에 한도 표시
아이템 판매 한도는 구현 방식(웹사이트 빌더를 통하거나 API를 통해)에 따라 카탈로그에 표시됩니다.
웹사이트 빌더 사용 시
웹사이트 빌더를 사용할 경우 한도가 자동으로 표시됩니다. 아이템 카드에는 사용자가 구매할 수 있는 아이템 수량이 표시됩니다.
API로 제한 정보 가져오기
API를 사용하여 카탈로그를 구현한 경우, 다음 카탈로그 관련 API 호출에서 items.limits 배열에 한도 정보가 반환됩니다.
사용자가 구매 한도에 도달한 아이템은 can_be_bought = false로 반환됩니다.
필요에 따라 이러한 한도를 업데이트할 수 있습니다.
이 데이터를 사용하여 카탈로그에 한도를 표시할 수 있습니다. 예를 들어, 구매 가능한 최대 아이템 수를 표시할 수 있습니다.
오자 또는 기타 텍스트 오류를 찾으셨나요? 텍스트를 선택하고 컨트롤+엔터를 누르세요.
