# 概要

プロモーションは、新規ユーザーの獲得や売上の向上を目的としたマーケティングツールです。エクソーラAPIを使用することで、以下のようなプロモーションを設定できます：

* 割引 — 選択したアイテムの価格を下げます。
* ボーナス — 購入時に、商品とあわせてユーザーに付与されるアイテムです。
* クーポン — 引き換え時1つ以上のボーナスアイテムを受け取ることができるコードです。
* プロモーションコード — ボーナスアイテムの受け取り、特定アイテムの割引、またはカート全体の割引を可能にするコードです。入力後に引き換えるクーポンとは異なり、プロモーションコードは購入手続き中（チェックアウト時）に適用されます。
* ユニークオファー — 専用のオファーコードを入力したユーザーにのみカタログに表示される、非公開のアイテムです。コードを入力しない限り、これらのアイテムは表示されません。

割引プロモーション設定のフロー例：
1. [仮想アイテムと仮想通貨](/ja/api/catalog/virtual-items-currency-admin/admin-get-virtual-items-list/)、[バンドル](/ja/api/catalog/bundles-admin/admin-create-bundle)、または[ゲームキー](/ja/api/catalog/game-keys-admin)グループの**管理者**サブセクションにあるAPIコールを使用して、アイテムを作成します。
2. [アイテムの割引プロモーション作成する](/ja/api/liveops/promotions-discounts/create-item-promotion/)コールを使用して、プロモーションを作成します。`items`配列内で、必要なアイテムのSKUを渡します。
3. プロモーションの有効期間を設定します。設定するには、[アイテムの割引プロモーションを作成する](/ja/api/liveops/promotions-discounts/create-item-promotion/)または[アイテムのプロモーションを更新する](/ja/api/liveops/promotions-discounts/update-item-promotion/)メソッドを呼び出し、`promotion_periods`フィールドを、オブジェクトの配列として渡します。ここで、`date_from`は開始日を、`date_until`は有効期間の終了日を定義します。
4. [アイテムプロモーションを更新する](/ja/api/liveops/promotions-discounts/update-item-promotion/)コールを使用して、プロモーションをアクティブ化します。`"is_enabled": true` パラメータを渡します。
5. 割引価格を含むアイテム価格の情報を取得するには、[共通 > カタログ](/ja/api/catalog/tag/common-catalog/)、[仮想アイテムと仮想通貨 > カタログ](/ja/api/catalog/virtual-items-currency-catalog/get-virtual-items/)、または[バンドル > カタログ](/ja/api/catalog/bundles-catalog/get-bundle-list/)のサブセクションにある、アイテムカタログ取得用のクライアントAPIメソッドを呼び出してください。

![プロモーションの設定例](https://cdn.xsolla.net/developers/current/images/api_docs/promo-overview.svg)

プロモーション設定の詳細については、ドキュメントを参照してください。
* [割引](https://developers.xsolla.com/ja/liveops/promotion-tools/discounts/)
* [ボーナス](https://developers.xsolla.com/ja/liveops/promotion-tools/bonuses/)
* [クーポン](https://developers.xsolla.com/ja/liveops/promotion-tools/coupons/)
* [プロモーションコード](https://developers.xsolla.com/ja/liveops/promotion-tools/promo-codes/)
* [ユニークカタログオファー](https://developers.xsolla.com/ja/liveops/promotion-tools/unique-offer/)