j1.0.38
API の概要
キャンペーンを使用すると、任意のスケジュールと適用条件に基づいて体験を提供できます。
体験がキャンペーンに割り当てられている場合、スケジュールと限定子で絞り込めるのは、その体験を含むキャンペーンのみです。キャンペーンは、特定のサイト内で定義し、複数サイト間で共有することはできません。キャンペーンは有効化または無効化できます。無効化されたキャンペーンは非アクティブであり、利用者は使用できません。無効化されたキャンペーンに含まれる有効なプロモーションも非アクティブになります。
限定子
限定子は、キャンペーンの体験を有効にするために満たす必要がある要件です。
- スケジュール: 開始日時と終了日時。期間の片側または両側を無期限にできます。
- クーポン: クーポンです。
- 顧客グループ: 顧客グループのメンバーシップ。
- ソースコード: 顧客がどこからリダイレクトされたかを識別するためにサイト URL に付加されるコードです。
詳細については、Salesforce B2C Commerce Infocenter の限定子を参照してください。
体験
プロモーション: 金額ベースの割引、またはボーナス商品です。プロモーションでは、割引の対象となる商品の数量や個数などの条件を追加できます。
認証と認可
キャンペーン情報をリクエストするクライアントは、Campaign リソースへのアクセス権が必要です。リソースにアクセスするには、Account Manager のクライアント ID とクライアントシークレットを使用してアクセストークンをリクエストする必要があります。アクセストークンは Bearer トークンとして使用され、API リクエストの Authorization ヘッダーに追加されます。クライアントはまず Account Manager に対して認証し、ログインする必要があります。
トークンの生成に使用するクライアント ID に、関連するスコープを含める必要があります。詳細については、認可スコープカタログを参照してください。
セットアップ手順の詳細は、Admin API の認可を参照してください。
ユースケース
フラッシュセール
短期間キャンペーンを実施する場合は、単一日付のプロモーションを使用します。
たとえば、「ブラックフライデーに 20% オフ」というキャンペーンでは、ブラックフライデー当日に登録済み顧客向けの 20% オフのキャンペーンを有効にできます。
日付または時刻の制限なし
日付や時刻の制限がないプロモーションを設定することもできます。これは、クーポンコードによるプロモーションや、特定の条件を満たす必要がある限定子ベースのプロモーションを実施する場合に便利です。
たとえば、「送料無料」キャンペーンでは、クーポンコード「freeship」が買い物カゴに追加されると、送料無料のプロモーションを有効にできます。
リダイレクト
リダイレクトプロモーションを使用すると、顧客が特定の場所からストアフロントにアクセスしたときにプロモーションをトリガーできます。これは、他のリソースとの提携や外部広告の実施時に役立つ場合があります。
たとえば、Facebook から誘導されたすべてのユーザーに、購入時に無料の帽子を提供できます。
詳細については、Salesforce B2C Commerce Infocenter の限定子としてのソースコードの使用を参照してください。
Let us know so we can improve!