買い物客のコンテキスト

Shopper Context API を利用して、ショッピング体験をパーソナライズします。

Shopper Context API を範囲に含むアクセストークンは非常に役立ちます。特定のプロモーションを有効化し、ストアフロントがどのように表示されるかを確認するために使用できます。Web ブラウザーやクライアントアプリなどの信頼できないクライアントとは共有しないでください。

プライベートクライアントでは、Shopper Context 呼び出しを使用し、セキュアなバックエンドチャネルを通してのみ Shopper Context 呼び出しを設定することを強く推奨します。Shopper Context のユーザーは、悪用される可能性を避けるため、データを閲覧できるブラウザーや同様のクライアントを通して直接呼び出すことは避けるべきです。

その一環として、SLAS でテナントのパブリッククライアントを新規作成する際に Shopper Context スコープを追加しようとすると、その操作にともなうリスクに対する認識をユーザーに促す警告メッセージが表示されるようになりました。

Northern Trail Outfitters の買い物アプリでジャケットを購入するケースで、ある買い物客用にパーソナライズされたジャーニーを見てみましょう。

  1. 買い物客は買い物アプリを開き、ゲスト買い物客としてジャーニーを開始します。
  2. この買い物客はシアトルにいます。そして、シアトルから E メールによるプロモーションに登録すると購入額が 15% 割引になることに気づきます。
  3. 登録後、買い物アプリにログインします。2 つのコンテキストから次のことがわかります。
    • シアトル市から閲覧している。
    • 買い物アプリにログインしている。
  4. この買い物客は、15% 割引を利用して、買い物を完了しました。

ShopperContextJourney

Shopper Context API を使用するには、まず sfcc.shopper-context.rw を SLAS API クライアントに追加します。

次に、買い物客の USID と設定したいコンテキストの createShopperContext またはupdateShopperContext エンドポイントを指定します。

PRD インスタンスでは、コンテキストは、ゲスト買い物客の場合は 1 日間、登録済み買い物客の場合は 7 日間保存されます。その他のインスタンスでは、コンテキストは、ゲスト買い物客と登録済み買い物客の両方について 1 日間保存されます。ベストプラクティスとして、新しいコンテキストを作成して、定期的にコンテキストを拡張してください。

インスタンスごとに保存できるコンテキストの数には制限があります。PRD インスタンスは 100 万件までのコンテキストを保存できます。他のインスタンスでは 5 千件まで保存できます。制限に達すると、それ以降のコンテキスト作成リクエストでは HTTP 400 レスポンスが返されます。

B2C インスタンスタイプゲスト買い物客合計登録済み買い物客合計コンテキストクォータの制限
PRD1 日7 日1,000,000
PRD 以外1 日1 日5,000
  1. Business Manager にログインします。
  2. 管理 > グローバル環境設定 > 機能スイッチの順に進みます。
  3. 買い物客コンテキストの有効化をチェックします。ルーティングの問題がない限り、ベース 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