プロモーションコード
どのように動作するか
プロモーションコードを使用したプロモーションでは、ユーザーはキャンペーン設定に従ってアイテムを割引価格で購入し、ボーナスアイテムを受け取ることができます。プロモーションコード入力フィールドは、カタログまたはカートに表示することができます。
主な違いは、プロモーションコードは購入中に引き換えられるのに対し、クーポンは購入要件なしで独立して引き換えられることです。
- 購入品全体または特定のアイテムに適用される割引
ボーナスアイテム：
- ゲームキー
- 仮想通貨パッケージ
- バンドルまたは期間限定アイテムを含む仮想アイテム
主な機能：
- プロモーションコードの報酬として、割引、ボーナスアイテム、またはその両方を提供する
- キャンペーン内のプロモーションコードの引き換え数を制限する
- キャンペーン内で1人のユーザーに対するプロモーションコードの引き換え数を制限する
- 複数のプロモーションコードを生成する
- リクエストに応じて地域制限を設定する
- プロモーションコードを適用した後にボーナスアイテムをカートに追加する
- プロモーションコードを使用した後にアイテムに割引を適用する
制限：
- カートに適用できるプロモーションコードは1つだけです。
- 割引やボーナスを得るには、ユーザーはカート内の商品の代金を支払う必要があります。
- プロモーションコードに地域別販売制限のあるアイテムが含まれている場合、これらのアイテムが入手できない地域のユーザーは、これらのアイテムを受け取ることができません。
例：プロモーションコードのボーナスとして盾と剣が提供されます。盾には地域制限があり、米国でのみ購入できます。米国外のユーザーがプロモーションコードを入力した場合、プロモーションコードを検証するまたはプロモーションコードを引き換えるメソッドへの応答でエラーが返されます。ユーザーはプロモーションコードからアイテムを入手することはできません。
統合フロー
以下で説明するシナリオは、認証されたユーザーを対象としています。
未認証のユーザーの場合、プロモーションを利用できる最大回数が常に表示されます。ユーザーに残りのアイテム数を表示するには（現在の制限に従う）、仮想アイテム＆通貨メソッドグループのカタログサブセクションのメソッドを使用してアイテムカタログを要求するときにユーザーの認証データを渡します。
アイテムに対して、割引、クーポン、プロモーションコード、ボーナスなど、さまざまなタイプのプロモーションを設定することができます。
購入時に1つのアイテムに複数のプロモーションが有効な場合、割引は1つずつ項目に適用されます。割引が適用される順番は関係ありません。
例：
仮想アイテムの価格は$10です。アドミンページでは、仮想アイテムに対して、以下のプロモーションが作成されています：
- ブラックフライデー11月4日から30日まで10％割引の割引キャンペーン
- セール 11月15日から12月15日まで20％割引の割引キャンペーン
- 11月4日から30日まで、5％割引のプロモーションコードを使ったキャンペーン
11月20日にアイテムを購入した場合、割引キャンペーンとプロモーションコードによるプロモーションコードの両方が有効です。
仮想アイテムの総額は、(($10 - 10%) - 20%) - 5%で計算され、$6.84になります。
入手方法
前提条件
- パブリッシャーアカウントで登録します。
- ストアに接続して仮想アイテムと仮想通貨モージュルをセットアップします。
プロモーションコードを使用してプロモーションのセットアップ
次のいずれかの方法でプロモーションコードのプロモーションをセットアップできます：
プロモーションを設定するためのどのようなオプションにおいても、プロモコードの正しさを確認し、プロモーションコードを引き換えるためのAPIメソッドへのコールを実装する必要があります。
パブリッシャーアカウント経由のセットアップ
パブリッシャーアカウント経由でプロモーションコードのプロモーションを設定すると、次のことが可能になります：
- プロモーションの有効期間を設定する
- ユーザーがプロモーションを利用できる回数を制限する
- あらゆるタイプのアイテムに適用されるプロモーションを設定します：
- 仮想通貨パッケージ
- 仮想アイテム（期間限定アイテムを含む）
- ゲームキー
- バンドル
現在、パブリッシャーアカウントでは、「アクティブ」ステータスのプロモーションコードのプロモーションを編集できません。
APIメソッドを使用して、プロモーションコードのプロモーションの設定オプションを強化することができます。
- アドミンページでプロジェクトを開きます。
- サイドメニューで「ストア」をクリックして、「プロモーションと報酬」セクションを開きます。
- 「プロモーションを作成する」をクリックします。
- 次のパラメータを指定します：
- プロモーション名を入力します。
- プロモーションタイプとして「プロモーションコード」を選択します。
- External ID ー APIメソッドを介してプロモーションを管理するために使用される一意のプロモーション識別子を作成します。
- プロモーションコードの割引率を指定します。割引は購入全体または特定の商品に適用できます。
- ユーザーがプロモーションコードを引き換えた時に受け取るボーナスアイテムを選択します。
- 合計引き換え数とユーザーごとの引き換え数を指定します。
- キャンペーンの期間を指定します。
- 設定を確認し、プロモーションを保存します。
- プロモーション編集メニューに移動します。
- 「コード」タブで、プロモーションコードの生成方法を選択します。
- プロモーションコードを生成するか、手動で入力します。
- 変更内容を保存します。
- プロモーションをアクティブ化にします。
仮想通貨をパッケージにしたプロモーションコード
仮想通貨パッケージでプロモーションコードを作成するには：- 仮想通貨パッケージを作成します。
- 特典アイテムとして、仮想通貨パッケージを指定します。
仮想アイテムを使ったプロモーションコード
仮想アイテムでプロモーションコードを作成するには：
- 仮想アイテムを作成します。
- ボーナスアイテムとして、仮想アイテムを指定します。
バンドルや期間限定商品など、1つのプロモーションコードで1つまたは複数の異なるSKUの商品を選択することができます。
ゲームキー付きのプロモーションコード
ゲームキー付きのプロモーションコードを作成するには：- ゲームキーパッケージを作成します。
ボーナスとして作成したゲームキーパッケージのSKUと、購入するプラットフォームの選択方法を指定します：
- プロモーションコードは、すでに設定されている特定のプラットフォームに対して生成されます。
- ユーザーはプロモーションコードを使用する際に、特定のプラットフォームを選択します。
プロモーションコードを生成する
キャンペーンには、1つまたは複数のプロモコードが含まれている場合があります。プロモコードの形式には2つのオプションがあります：- 手動で入力された文字列 - 何度も使用できるプロモコードが1つだけのキャンペーンに適しています（最大128文字）。
- 生成された文字列 - 数字とラテン記号（10文字）の行。多くのプロモコードを使ったキャンペーンに適しています。
winter2021とWINTER20212つの異なるクーポンです。地域制限
地域制限はプロモーションキャンペーン全体に適用されます。地域制限は、エクソーラに電子メールにてオンデマンドで適用されます。APIメソッド経由のセットアップ
プロモーションコードのプロモーションを使用するには、プロモーションメソッドグループの「プロモーションコード」サブセクションのメソッドを使用できます。
プロモーションのセットアップ：
| タスク | APIメソッド |
|---|---|
| プロモーションコードを使用してプロモーションを作成する | プロモーションコードのプロモーションを作成する |
| プロモーションコードを使用してプロモーションをアクティブ化にする | プロモーションコードのプロモーションをアクティブ化にする |
| プロモーションを編集する | 新しいプロモーションオプションを使用してプロモーションコードのプロモーションを更新します。プロモーションの編集は、有効ステータスのプロモーションでも利用できます |
| プロモーションを非アクティブ化にする | プロモーションコードのプロモーションを非アクティブ化にする |
| 無期限のプロモーションのセットアップ | プロモーションコードのプロモーションを作成してまたはプロモーションコードのプロモーションを更新します。“date_end”:nullパラメータを指定されたメソッドに渡します。 |
| タスク | APIメソッド |
|---|---|
| プロモーションコードが正しいかどうかを確認してください | プロモーションコードを確認する |
| プロモーションコードを引き換える | プロモーションコードを引き換える |
| プロモーションコードのボーナスとしてゲームキーが提供された場合に、ユーザーに表示するゲーム配信プラットフォームのリストを取得します | プロモーションコード特典を取得する |
| タスク | APIメソッド |
|---|---|
| 指定したユーザーのプロモーションコードの残り使用回数を取得します | 指定したユーザーのプロモーションコードの上限を取得する |
| 指定したユーザーのプロモーションコードの残り使用回数を増やします | 指定したユーザーのプロモーションコードの上限を増やします |
| 指定したユーザーのプロモーションコードの使用に新しい上限を設定する | 指定したユーザーのプロモーションコードの上限を設定する |
| 指定したユーザーのプロモーションコードの残り使用回数を減らします | 指定したユーザーのプロモーションコードの上限を減らします |
プロモーションコード入力フィールドがカタログに配置されている場合、プロモーションコードを入力した後、カタログサブセクションからカタログを構築するためのメソッドのpromo_codeパラメータにプロモーションコードを渡すことによって、ユーザーのためのアイテムカタログを再度リクエストします。
指定したアイテムメソッドで注文を作成するを使用して1つのアイテムのクイック購入を実装する場合は、プロモーションコードに関する情報をpromo_codeパラメータに渡します。これにより、プロモーションコードが適用された状態で購入できるようになります。
誤字脱字などのテキストエラーを見つけましたか？ テキストを選択し、Ctrl+Enterを押します。
