SCAPI には、ヘッドレスストアフロントの買い物客体験をパーソナライズするために、以下の機能が用意されています。
このトピックでは、Shopper Context API の使用方法について説明します。
Shopper Context (買い物客のコンテキスト) API には、フックや Script API を使用する場合と比較して、次のような利点があります。
effectiveDate や couponCodes など、Script API で使用できない限定子を設定できます。次の表に、買い物客のパーソナライゼーションの使用例を示します。
| 使用例 | 推奨されるパーソナライゼーションメソッド | 使用される限定子 | キャッシュのサポート |
|---|---|---|---|
| 「Shop the Store」パイロット機能 | 「現時点以降の購入」の買い物客のコンテキスト “store" | "effectiveDateTime” | いいえ |
| Salesforce の全従業員が従業員価格を利用可 | ネイティブ SCAPI | 動的顧客グループ – メールアドレスの末尾が @salesforce.com | はい |
Shopper Context API を利用して、ショッピング体験をパーソナライズします。
Shopper Context API をスコープに含むアクセストークンは非常に役立ちます。特定のプロモーションを有効化し、ストアフロントがどのように表示されるかを確認するために使用できます。Web ブラウザーやクライアントアプリなどの信頼できないクライアントとは共有しないでください。
プライベートクライアントでは、Shopper Context 呼び出しを使用し、セキュアなバックエンドチャネルを通してのみ Shopper Context 呼び出しを設定することを強く推奨します。Shopper Context のユーザーは、悪用される可能性を避けるため、データを閲覧できるブラウザーや同様のクライアントを通して直接呼び出すことは避けるべきです。
その一環として、SLAS でテナントのパブリッククライアントを新規作成する際に Shopper Context スコープを追加しようとすると、その操作にともなうリスクに対する認識をユーザーに促す警告メッセージが表示されるようになりました。
Warning
Northern Trail Outfitters の買い物アプリでジャケットを購入するケースで、ある買い物客用にパーソナライズされたジャーニーを見てみましょう。
Shopper Context API を使用して買い物客のコンテキストを設定および取得するには、次のようにします。
sfcc.shopper-context.rw を SLAS API クライアントに追加します。1curl "https://$SHORTCODE.api.commercecloud.salesforce.com/shopper/shopper-context/v1/organizations/$ORG/shopper-context/$USID" \
2 --method 'PUT' \
3 --header "Authorization: Bearer $TOKEN" \
4 --header 'Content-Type: application/json' \
5 --data '{
6 "customQualifiers": {
7 "deviceType": "mobile"
8 },
9 "effectiveDateTime": "1999-12-31T23:59:59Z",
10 "assignmentQualifiers": {
11 "storeId": "boston"
12 },
13 "sourceCode": "email"
14 }'GET products です。| B2C インスタンスタイプ | ゲスト買い物客の TTL | 登録済み買い物客の TTL | コンテキストのクォータ制限 |
|---|---|---|---|
| PRD | 1 日 | 7 日 | 5,000,000 |
| 非 PRD | 1 日 | 1 日 | 5,000 |
ShopperToken (または SLAS) を使用する OCAPI とのみ互換性があります。OCAPI は他の認証スキームでも機能しますが、Shopper Context は ShopperToken 認証スキームでのみサポートされます。
j