j1.1.2
API の概要
Shopper Context API を使用すると、任意のコンテキスト情報をキーと値のペアとして設定し、その情報を使用してパーソナライズされたプロモーション、支払方法、配送方法を取得できます。設定されたコンテキスト情報は、顧客グループ定義に照らして評価され、顧客グループ (買い物客セグメント) の判定に使用されます。その後、その情報は、プロモーションなど、特定のセグメントに関連付けられた体験を有効化するために使用されます。
また、Open Commerce API (OCAPI) から、Shopper Context によってトリガーされるパーソナライズされた API レスポンスを取得することもできます。B2C Commerce API と OCAPI の両方をサポートしているため、Shopper Context はハイブリッドデプロイで使用できます。
警告 Shopper Context API を含むスコープを持つアクセストークンは強力です。これらのトークンは、特定のプロモーションを有効化でき、将来ストアフロントがどのように表示されるかを確認するためにも使用できます。Web ブラウザーやクライアントアプリなどの信頼できないクライアントと共有しないでください。
Shopper Context の呼び出しはプライベートクライアント使用して行い、Shopper Context の設定はセキュアなバックエンドチャネルを通じてのみ行ってください。不正利用を避けるため、データを閲覧できるブラウザーや同様のクライアントから直接呼び出さないでください。
これに関連して、テナント用の SLAS パブリッククライアントを作成する際に、Shopper Context API スコープを追加しようとすると、そのような設定の落とし穴を認識できるよう、警告メッセージが表示されます。
注記:
Shopper Context は、ゲストの買い物客の場合は 1 日間、登録済みの買い物客の場合は 7 日間有効です。設定したコンテキストを延長するには、新しいコンテキストを作成します。ベストプラクティスとして、買い物客に適切なパーソナライズされたエクスペリエンスが表示されるよう、コンテキストを定期的に更新してください。
認証と認可
Shopper Context API には、Shopper Login and API Access Service (SLAS) の買い物客アクセストークンが必要です。
SLAS から買い物客アクセストークンをリクエストする方法の詳細については、SLAS ガイドのパブリッククライアントとプライベートクライアントのゲストユーザーフローを参照してください。
SLAS API クライアントのスコープ構成に sfcc.shopper-context.rw を追加します。
詳細については、入門ガイドの Shopper API の認可を参照してください。
警告: 他のすべての API と同様に、アクセストークンをブラウザーに保存しないでください。これはセキュリティ脆弱性の原因になります。
ユースケース
詳細な使用方法については、Shopper Context ガイドを参照してください。
Let us know so we can improve!