プロモーション報奨申込 API
顧客が注文を行った後に、非価格報奨を発行し、プロモーションと顧客制限を更新します。
必要なエディション
| 使用可能なインターフェース: Lightning Experience |
| 使用可能なエディション: リアルタイムオファー管理が付属する Enterprise Edition、Unlimited Edition、および Developer Edition |
注文が行われると、API はカートに適用されたプロモーションと報奨の詳細を入力として取得します。取引先責任者と取引先の API を実行できます。会社で個人取引先を使用して顧客を管理している場合、顧客の個人取引先に関連付けられた取引先責任者 ID を指定します。
API 応答には、注文に対して顧客に提供される価格設定報奨と非価格設定報奨の詳細が含まれます。Promotion Reward Application API は、次の報奨を提供するために実行できます。
- 割引
- バウチャー
- ゲーム
また、プロモーション報奨申込 API では、API 要求に存在するパラメーターに基づいてプロモーションの関連する使用量レコードを作成または更新します。
| パラメーター | 作成または更新された使用量レコード |
|---|---|
| 報奨 | ポイントとバウチャーのプロモーション制限使用量レコードとプロモーション関係者使用量レコード。 |
| appliedPromotions | 顧客がプロモーションを使用した回数のプロモーション関係者利用状況レコード。 |
プロモーション制限使用量レコードは、プロモーションの制限に対する各プロモーション報奨の使用量を追跡するのに役立ちます。プロモーション関係者の利用状況レコードは、プロモーションの顧客レベルの制限に対する顧客の各プロモーション報奨の利用状況を追跡するのに役立ちます。
Promotion Reward Application API では、これらの制限が自動的に管理されます。
- プロモーションの制限:
- ポイント
- バウチャー
- 顧客の制限:
- ポイント
- バウチャー
- 顧客ごとの使用
カートごと、品目ごと、負債ごと、合計使用制限を管理するプロセスを設定する必要があります。
API の実行後、顧客のプロモーション関係者の使用量の [使用量] 項目の値が 1 増分されます。
クーポンを使用したプロモーションのプロモーション報奨申込 API
API を実行するときに、顧客が注文に使用したクーポンコードを指定します。クーポンコードは、顧客が注文に使用したプロモーションを一意に識別します。
API は shouldCheckCouponUsageLimit パラメータで構成されます。すでにクーポンの使用量を増やしている場合、パラメーターを False に設定します。API を使用してクーポンが償還可能かどうかを確認し、クーポン使用量を増やすには、パラメーターを True に設定します。
