買い物客のコンテキスト
Shopper Context API を利用して、ショッピング体験をパーソナライズします。
- 店舗の選択時にプロモーションを送信する
- ロケーションやデバイスの種類など、買い物客のコンテキスト情報を追跡する
- ソースコードを使用する買い物客に特別価格を提供する
- ストアフロントの今後の様子をプレビューする
Shopper Context API を範囲に含むアクセストークンは非常に役立ちます。特定のプロモーションを有効化し、ストアフロントがどのように表示されるかを確認するために使用できます。Web ブラウザーやクライアントアプリなどの信頼できないクライアントとは共有しないでください。
プライベートクライアントでは、Shopper Context 呼び出しを使用し、セキュアなバックエンドチャネルを通してのみ Shopper Context 呼び出しを設定することを強く推奨します。Shopper Context のユーザーは、悪用される可能性を避けるため、データを閲覧できるブラウザーや同様のクライアントを通して直接呼び出すことは避けるべきです。
その一環として、SLAS でテナントのパブリッククライアントを新規作成する際に Shopper Context スコープを追加しようとすると、その操作にともなうリスクに対する認識をユーザーに促す警告メッセージが表示されるようになりました。
Northern Trail Outfitters の買い物アプリでジャケットを購入するケースで、ある買い物客用にパーソナライズされたジャーニーを見てみましょう。
- 買い物客は買い物アプリを開き、ゲスト買い物客としてジャーニーを開始します。
- この買い物客はシアトルにいます。そして、シアトルから E メールによるプロモーションに登録すると購入額が 15% 割引になることに気づきます。
- 登録後、買い物アプリにログインします。2 つのコンテキストから次のことがわかります。
- シアトル市から閲覧している。
- 買い物アプリにログインしている。
- この買い物客は、15% 割引を利用して、買い物を完了しました。
Shopper Context API を使用するには、まず sfcc.shopper-context.rw を SLAS API クライアントに追加します。
次に、買い物客の USID と設定したいコンテキストの createShopperContext またはupdateShopperContext エンドポイントを指定します。
PRD インスタンスでは、コンテキストは、ゲスト買い物客の場合は 1 日間、登録済み買い物客の場合は 7 日間保存されます。その他のインスタンスでは、コンテキストは、ゲスト買い物客と登録済み買い物客の両方について 1 日間保存されます。ベストプラクティスとして、新しいコンテキストを作成して、定期的にコンテキストを拡張してください。
インスタンスごとに保存できるコンテキストの数には制限があります。PRD インスタンスは 100 万件までのコンテキストを保存できます。他のインスタンスでは 5 千件まで保存できます。制限に達すると、それ以降のコンテキスト作成リクエストでは HTTP 400 レスポンスが返されます。
| B2C インスタンスタイプ | ゲスト買い物客合計 | 登録済み買い物客合計 | コンテキストクォータの制限 |
|---|---|---|---|
| PRD | 1 日 | 7 日 | 1,000,000 |
| PRD 以外 | 1 日 | 1 日 | 5,000 |
- Business Manager にログインします。
- 管理 > グローバル環境設定 > 機能スイッチの順に進みます。
- 買い物客コンテキストの有効化をチェックします。ルーティングの問題がない限り、ベース URL の上書きを指定する必要はありません。
-
Shopper Context API ではカスタムのフィールドやオブジェクトを使用できません。
-
Shopper Context が認識されるのは、B2C Commerce と OCAPI 買い物客エンドポイントのサブセットのみです。
/baskets/baskets/{basket_id}/baskets/{basket_id}/billing_address/baskets/{basket_id}/coupons/baskets/{basket_id}/coupons/{coupon_item_id}/baskets/{basket_id}/gift_certificate_items/{gift_certificate_item_id}/baskets/{basket_id}/items/baskets/{basket_id}/items/{item_id}/baskets/{basket_id}/payment_instruments/{payment_instrument_id}/baskets/{basket_id}/payment_methods/baskets/{basket_id}/price_adjustments/baskets/{basket_id}/price_adjustments/{price_adjustment_id}/baskets/{basket_id}/shipments/baskets/{basket_id}/shipments/{shipment_id}/baskets/{basket_id}/shipments/{shipment_id}/shipping_address/baskets/{basket_id}/shipments/{shipment_id}/shipping_method/baskets/{basket_id}/shipments/{shipment_id}/shipping_methods/custom_objects/{object_type}/{key}/customers/{customer_id}/baskets/orders/orders/{order_no}/orders/{order_no}/orders/{order_no}/payment_instruments/orders/{order_no}/payment_instruments/{payment_instrument_id}/orders/{order_no}/payment_methods/product_search/products/search_suggestion