# 개요

프로모션은 신규 사용자를 유치하고 매출을 높이기 위해 고안된 마케팅 도구입니다. 엑솔라 API를 사용하여 다음과 같은 프로모션을 설정할 수 있습니다.

* 할인 - 선택한 아이템의 가격을 인하.
* 보너스 - 구매 시 사용자에게 제공되는 아이템.
* 쿠폰 - 사용 시 하나 이상의 보너스 아이템을 받을 수 있는 코드.
* 프로모션 코드 - 사용자가 보너스 아이템을 받거나, 특정 상품에 대해 할인을 받거나, 장바구니 전체에 대해 할인을 받을 수 있게 해주는 코드. 사용자가 입력한 후에 사용 가능한 쿠폰과 달리, 프로모션 코드는 구매를 진행할 때(결제 시)에 사용됩니다.
* 특별 혜택 - 고유한 혜택 코드를 입력한 사용자에게만 카탈로그에 표시되는 숨겨진 아이템. 코드를 입력하지 않으면 해당 아이템은 표시되지 않습니다.

할인 프로모션을 구성하는 예시 절차:
1. [가상 아이템 및 인게임 재화](/ko/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/), [번들](/ko/api/catalog/bundles-admin/admin-create-bundle) 또는 [게임 키](/ko/api/catalog/game-keys-admin) 그룹의 **관리자** 하위 섹션의 호출을 사용하여 아이템을 생성합니다.
2. [아이템 할인 프로모션 생성](/ko/api/liveops/promotions-discounts/create-item-promotion/) 호출을 사용하여 프로모션을 생성합니다. `items` 배열에서 필요한 아이템 SKU를 전달합니다.
3. 프로모션 유효 기간을 설정합니다. 이를 위해 [아이템 할인 프로모션 생성](/ko/api/liveops/promotions-discounts/create-item-promotion/) 또는 [아이템 프로모션 업데이트](/ko/api/liveops/promotions-discounts/update-item-promotion/) 메소드를 호출하고, `promotion_periods` 필드를 객체 배열로 전달합니다. 여기서  `date_from`은 유효 기간의 시작일을, `date_until`은 종료일을 정의합니다.
4. [아이템 프로모션 업데이트](/ko/api/liveops/promotions-discounts/update-item-promotion/) 호출을 사용하여 프로모션을 활성화합니다. `"is_enabled": true` 매개 변수를 전달합니다.
5. 할인 가격을 포함하여 아이템 가격 정보를 가져오려면, [일반 > 카탈로그](/ko/api/catalog/tag/common-catalog/), [가상 아이템 및 인게임 재화 > 카탈로그](/ko/api/catalog/virtual-items-currency-catalog/get-virtual-items/), [번들 > 카탈로그](/ko/api/catalog/bundles-catalog/get-bundle-list/) 하위 섹션에서 아이템 카탈로그를 가져오는 클라이언트 API 메소드를 호출합니다.

![프로모션 구성 예시](https://cdn.xsolla.net/developers/current/images/api_docs/promo-overview.svg)

프로모션 구성에 대한 자세한 내용은 참조 문서를 참조하십시오.
* [할인](https://developers.xsolla.com/ko/liveops/promotion-tools/discounts/)
* [보너스](https://developers.xsolla.com/ko/liveops/promotion-tools/bonuses/)
* [쿠폰](https://developers.xsolla.com/ko/liveops/promotion-tools/coupons/)
* [프로모션 코드](https://developers.xsolla.com/ko/liveops/promotion-tools/promo-codes/)
* [고유 카탈로그 혜택](https://developers.xsolla.com/ko/liveops/promotion-tools/unique-offer/)