# 개요

프로모션 사용 한도를 통해 특정 사용자가 프로모션을 사용할 수 있는 횟수를 제한할 수 있습니다. 또한 예약된 한도 재설정을 구성할 수 있습니다.

한도는 엑솔라 측에 저장되며, [관리자 페이지](https://publisher.xsolla.com/0/projects/0/storefront/promotions) 또는 다음 API 호출의 `limits` 개체를 통해 프로모션 설정에서 구성됩니다:
* [아이템 할인 프로모션 생성](/ko/api/liveops/promotions-discounts/create-item-promotion/) 또는 [할인 프로모션 업데이트](/ko/api/liveops/promotions-discounts/update-item-promotion)
* [보너스 프로모션 생성](/ko/api/liveops/promotions-bonuses/create-bonus-promotion/) 또는 [보너스 프로모션 업데이트](/ko/api/liveops/promotions-bonuses/update-bonus-promotion)

한도 정보는 다음 API 호출에서 아이템 카탈로그를 가져올 때 `items.promotions.limits` 개체에 반환됩니다:
* [가상 아이템 목록 가져오기](/ko/api/catalog/virtual-items-currency-catalog/get-virtual-items/)
* [인게임 재화 목록 가져오기](/ko/api/catalog/virtual-items-currency-catalog/get-virtual-currency/)
* [인게임 재화 패키지 목록 가져오기](/ko/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package/)
* [번들 목록 가져오기](/ko/api/catalog/bundles-catalog/get-bundle-list/)
* [게임 목록 가져오기](/ko/api/catalog/game-keys-catalog/get-games-list/)

**한도** 그룹의 **관리** 하위 섹션에 있는 API 호출은 현재 한도의 상태를 검색하고 특정 사용자에 대해 업데이트할 수 있도록 합니다. 예를 들어, 퀘스트 완료 후 카운터를 재설정하거나 남은 수량을 수동으로 조정할 수 있습니다.

<div class="note">
  <b>참고</b><br><br>
  카탈로그에서 한도를 구성하는 자세한 정보는 <a href="/ko/liveops/promotion-tools/liveops-number-limits/">프로모션 사용 한도</a> 섹션을 참조하세요.
</div>

[limits.per_user](/ko/api/liveops/promotions-discounts/create-item-promotion#promotions-discounts/create-item-promotion/t=request&path=limits) - 단일 사용자가 프로모션을 사용할 수 있는 횟수에 대한 한도를 구성할 수 있습니다.

인증되지 않은 사용자에게는 항상 최대 프로모션 사용 횟수가 표시됩니다.

활성 한도가 적용된 사용자의 남은 프로모션 사용 횟수를 표시하려면 아이템 카탈로그를 요청할 때 사용자 인증 데이터를 전달하세요.

일일, 주간 또는 월간으로 예약된 재설정 기간을 구성하려면 프로모션을 [생성](/ko/api/liveops/promotions-discounts/create-item-promotion#promotions-discounts/create-item-promotion/t=request&path=limits/recurrent_schedule)하거나 프로모션을 [업데이트](/ko/api/liveops/promotions-discounts/update-item-promotion#promotions-discounts/update-item-promotion/t=request&path=limits/recurrent_schedule)할 때 `limits.recurrent_schedule` 개체를 전달하세요.

**Limit configuration and enforcement scenario**

1. [아이템 할인 프로모션 생성](/ko/api/liveops/promotions-discounts/create-item-promotion/) 또는 [보너스 프로모션 생성](/ko/api/liveops/promotions-bonuses/create-bonus-promotion/) API 호출을 사용하여 프로모션을 생성하고 `limits` 개체를 전달합니다.
2. 인증되지 않은 사용자에 대해 카탈로그를 요청합니다 - 응답은 `items.promotions.limits` 개체에 최대 프로모션 사용 횟수를 반환합니다.
3. 사용자가 로그인합니다.
4. 사용자의 인증 토큰으로 카탈로그를 요청합니다 - 응답은 활성 한도가 적용된 남은 사용 횟수를 반환합니다.
5. 사용자가 프로모션 아이템을 선택하고 구매합니다.
6. 결제가 성공적으로 완료되면 엑솔라는 `items.promotions.limits.per_user` 값을 업데이트합니다. 값이 `0`에 도달하면, 해당 아이템은 카탈로그 API 호출에서 할인이나 보너스 없이 반환됩니다.
7. **Management** 하위 섹션의 API 호출을 사용하여 한도를 업데이트할 수 있습니다:
   * [지정된 사용자의 모든 프로모션 한도 새로고침](/ko/api/liveops/user-limits-admin/reset-all-user-promotions-limit/) 또는 [특정 프로모션의 한도 새로고침](/ko/api/liveops/user-limits-admin/reset-user-promotion-limit/)
   * [특정 한도 값 설정](/ko/api/liveops/user-limits-admin/set-user-promotion-limit/)
   * [사용 가능 횟수 증가](/ko/api/liveops/user-limits-admin/add-user-promotion-limit/) 또는 [사용 가능 횟수 감소](/ko/api/liveops/user-limits-admin/remove-user-promotion-limit/)
8. 사용자의 인증 토큰으로 다음 카탈로그 요청을 할 때 `items.promotions.limits`에서 업데이트된 한도 값을 가져와 사용자에게 표시합니다.

![프로모션 제한](https://cdn.xsolla.net/developers/current/images/api_docs/promotion-limit.svg)