j1.0.34
API の概要
Promotions API を使用すると、サイト上のプロモーション情報の作成、更新、削除、検索を行えます。プロモーションは、プロモーションのタイプ、条件、割引を定義するルールによって構成されます。
この API は、Commerce プラットフォーム内のプロモーションデータをサードパーティのプロモーション管理システムと同期するために使用できます。また、この API はカスタムのプロモーション管理アプリケーションから呼び出すこともできます。サンドボックス環境では、Promotions API は、たとえば統合テスト時や、継続的インテグレーションまたは継続的デプロイのプロセスの一部として、テストデータの作成と更新に役立ちます。
詳細については、Salesforce B2C Commerce Infocenter のキャンペーンとプロモーションを参照してください。
認証と認可
プロモーション情報をリクエストするクライアントは、Promotion リソースへのアクセス権が必要です。リソースにアクセスするには、Account Manager のクライアント ID とクライアントシークレットを使用してアクセストークンをリクエストする必要があります。アクセストークンは Bearer トークンとして使用され、API リクエストの Authorization ヘッダーに追加されます。クライアントはまず Account Manager に対して認証し、ログインする必要があります。
トークンの生成に使用するクライアント ID に、関連するスコープを含める必要があります。詳細については、認可スコープカタログを参照してください。
セットアップ手順の詳細は、Admin API の認可を参照してください。
ユースケース
注: プロモーションは、API を使用して作成、有効化、および除外の割り当てを行えますが、限定子と割引の条件は、Business Manager で割り当てる必要があります。
配送キャンペーン
Promotions API を使用して、配送プロモーションを構成します。
配送キャンペーンは、注文や個々の商品または商品の組み合わせに基づいて構成できます。また、商品固有の配送料 (定額または追加料金) も構成できます。
注: 商品に関連する配送割引は、商品プロモーションと見なされます。
複数の宛先に配送するケースでは、割引配送方法を使用する配送が自動的に判断され、最も高額なものから最も低額なものへと順に割引が適用されます。最大適用数が指定されている場合には、その数に達するまでこの処理が行われます。
たとえば、購入金額が 50 ドルを超えると送料が無料になるような配送プロモーションを作成します。
詳細については、Salesforce B2C Commerce Infocenter の 配送プロモーションを参照してください。
商品プロモーション
Promotions API を使用して、商品プロモーションを構成します。
商品プロモーションは、特定の商品、商品のグループ、ブランド、または購入商品の金額に対して定義できます。顧客が商品のセットから購入するという必須条件を定義できます。
商品プロモーションは、注文に含まれる商品ごとに比例配分、計算、および丸めを 1 回実行します。商品プロモーションは、注文プロモーションとは異なります。後者は、注文レベルで 1 回計算され、必要に応じて 1 回丸められます。
たとえば、顧客が商品を 2 点購入すると 2 つ目の商品が 50% 割引になるような商品プロモーションを作成できます。
詳細については、Salesforce B2C Commerce Infocenter の 商品プロモーションを参照してください。
注文プロモーション
Promotions API を使用して、注文プロモーションを構成します。
パーセント割引、定額割引、送料無料などの注文プロモーションを構成できます。「ボーナス商品」、または「ボーナス商品の選択」を提示でき、注文割引を階層化できます。
注文プロモーションは、注文レベルで 1 回計算され、必要に応じて 1 回丸められます。注文プロモーションは、商品プロモーションとは異なります。後者は、注文に含まれる商品ごとにプロモーションの比例配分、計算、丸めを実行します。
たとえば、顧客が対象商品を 3 点購入すると、注文全体が割引になるような注文プロモーションを作成できます。
詳細については、Salesforce B2C Commerce Infocenter の 注文プロモーションを参照してください。
Let us know so we can improve!