買い物客のコンテキストに関するベストプラクティス
Shopper Context API は、ストアフロントでパーソナライズされたショッピング体験を管理するために不可欠です。これは、パーソナライゼーションと効率を高めるコンテキスト固有の属性を設定することにより、ゲストユーザーと登録ユーザーの両方のインタラクションを最適化するように設計されています。
買い物客のコンテキストを設定する場合、API は SLAS トークンから派生した USID
を利用し、シームレスで安全な統合を保証します。
- 買い物客のコンテキスト情報は、常にプライベートクライアントを使用して、BFF (Backend For Frontend) から設定します。この目的にはパブリッククライアントを使用しないでください。
siteId
クエリパラメーターをすべての Shopper Context API リクエスト (GET
、PUT
、PATCH
、DELETE
) に含めます。
- 初回訪問またはログイン時: 買い物客がログインするとき、または最初にストアフロントを訪問したときに、SLAS (Shopper Login and Access Services) トークンを取得した直後に、買い物客のコンテキストを実装します。
- トークンのリフレッシュ時: SLAS トークンのリフレッシュでは、既存の
USID
トークンを再利用して、継続性を維持し、レコードの重複を防ぎます。買い物客のコンテキストデータを保存するために利用できるリソースがあるため、これは重要です。 - セッション管理時: ログアウトすると既存の買い物客のコンテキストがクリアされるため、ユーザーのログイン時にコンテキストをリセットします。
- コンテキストの有効期間: 買い物客のコンテキストのレコードは、ゲスト買い物客の場合は 1 日間、登録済み買い物客の場合は 7 日間持続します。コンテキストを最新の状態に保つには、定期的な更新が不可欠です。
- クォータ制限: B2C Commerce インスタンスで作成できる買い物客のコンテキストのレコード数に関するデフォルトのクォータ制限に注意してください。
- Production (本番) 以外のインスタンスの場合は 5000 件のレコード。
- Production (本番) インスタンスの場合は 100 万件のレコード。
- Production (本番) インスタンスの制限を引き上げる正当な必要性がある場合は、Customer Success Manager またはアカウントエグゼクティブにお問い合わせください。
- クォータと使用状況を表示するには、Business Manager にログインし、管理 > サイトの開発 > Salesforce Commerce API 設定 の順に移動します。
- 重複の回避:
USID
を再利用し、新しいコンテキストを設定する前に既存のコンテキストを確認します。 - リソースの効率的な使用: 既存のコンテキストを定期的に更新して、使用可能な限られたストレージを最適化します。
- 更新の推奨タイミング: コンテキストの更新をトークンのリフレッシュイベントに合わせることで、一貫性を確保し、冗長な更新を最小限に抑えます。
- API 統合を更新して、Shopper Context API へのすべてのリクエストに
siteId
クエリパラメーターを含めます。次の例は、更新されたリクエスト形式を示しています。
顧客のプロフィールや住所などの属性が自動的に割り当てられ、評価される場合は、買い物客のコンテキストを使用しないでください。
- 店舗のパーソナライゼーション: ログイン時に、Shopper Context API を使用して
customerQualifier
とassignment
限定子の両方に店舗 ID を設定し、店舗ごとにカスタマイズされたインタラクションを確保します。 - 動的パーソナライゼーション: 買い物客のコンテキストからの店舗 ID を利用して、セッション中にパーソナライズされた価格設定とプロモーションを行います。
- 店舗 ID はコンテキストから取得され、後で参照できるようにセッションに格納されます (例:
session.custom.storeId
)。 - 特定の店舗 ID に動的顧客グループが設定されている場合は、対応する顧客グループに割り当てられた体験がアクティブになります。
- 店舗 ID はコンテキストから取得され、後で参照できるようにセッションに格納されます (例:
- 価格表とプロモーションのトリガー: 買い物客のコンテキストを使用して、特定の価格表とプロモーションをアクティブにします。たとえば、店舗 ID を
BOST1
に設定すると、その特定の店舗に対してBOSPRICEBOOK
と10%OFFPROMOTION
がトリガーされる場合があります。その後の商品取得呼び出しでは、これらのトリガーに基づいてパーソナライズされたレスポンスが返されます。
並べ替えルールはサポートされていません。