パーソナライズされたプロモーション、配送、支払方法

Shopper Context API を他の B2C Commerce API (買い物カゴ、配送、支払、商品など) とともに使用して、パーソナライズされたプロモーションやカスタマイズされたプロモーションを設定します。

例: デバイスタイプに応じた商品のパーソナライゼーション

デバイスタイプがモバイルの買い物客に特定の商品を表示することで、買い物客のデバイスタイプに基づいて商品ページをパーソナライズするシナリオを考えてみましょう。

買い物客のコンテキストの設定と取得の手順に従います。
GET products のレスポンスには、“Product Promotion” という新しいプロパティがあり、このプロパティには、商品に関連付けられ、買い物客のコンテキスト条件に一致するすべてのプロモーションがリストされます。たとえば、レスポンスには、買い物客のコンテキストに基づいた割引価格が含まれる場合があります。

マーチャントは買い物客コンテキストに有効日を設定し、特別な価格表をトリガーすることができます。
マーチャントは、動的セッションベースの顧客グループ (deviceType = mobile など) を含めることができ、これにより 10% 割引などのプロモーションをトリガーできます。

1#!/bin/bash
2# Shopper Context Custom Qualifers: https://developer.salesforce.com/docs/commerce/commerce-api/references?meta=shopper-context:Summary
3set -euo pipefail
4
5SHORTCODE='kv7kzm78'
6ORG='f_ecom_zzrf_006'
7SLAS_CLIENT_ID='d4f49c7a-b037-4561-91d9-5c7d547e71b5'
8SLAS_CLIENT_SECRET=$SLAS_CLIENT_SECRET
9SITE='RefArchGlobal'
10
11# 1. Get Guest Token & USID
12BASE="https://$SHORTCODE.api.commercecloud.salesforce.com"
13RESPONSE=$(curl "$BASE/shopper/auth/v1/organizations/$ORG/oauth2/token" \
14    -su "$SLAS_CLIENT_ID:$SLAS_CLIENT_SECRET" \
15    -d 'grant_type=client_credentials')
16
17TOKEN=$(echo $RESPONSE | jq -r '.access_token')
18USID=$(echo $RESPONSE | jq -r '.usid')
19
20# 2. Set Shopper Context
21curl "$BASE/shopper/shopper-context/v1/organizations/$ORG/shopper-context/$USID" \
22    -sX 'PUT' \
23    -H "Authorization: Bearer $TOKEN" \
24    -H 'Content-Type: application/json' \
25    -d '{
26        "customQualifiers": {
27            "deviceType": "mobile"
28        }
29    }'
30
31# 3. Get a Product with a Promotion
32curl "$BASE/product/shopper-products/v1/organizations/$ORG/products/25493613M?siteId=$SITE" \
33    -sH "Authorization: Bearer $TOKEN" \
34    | jq -r '.productPromotions'

例: パーソナライズされた配送と支払方法

たとえば、買い物客のデバイスタイプに基づいて商品ページをパーソナライズするシナリオを考えてみましょう。たとえば、モバイルデバイスを使用している買い物客向けに、10% 割引と送料無料、および Google Pay を使用した支払いオプションを提供するプロモーションを作成できます。

パーソナライズされた買い物客コンテキストデータとターゲティングを示す図

買い物客のコンテキストの設定と取得の手順に従います。
セッションベースの顧客グループを作成します。

Shopper Context API は、セッションベースの顧客グループに使用できます。
セッションベースの顧客グループを作成し、その顧客グループで使用されている属性が買い物客のコンテキスト限定子と一致することを確認します。

買い物客コンテキストのセッションデータ管理と同期を示す図

Business Manager の動的顧客グループに設定されたカスタム属性と API に設定されたカスタム限定子が一致する必要があります。ベストプラクティスとして、動的なセッションベースの顧客グループと割り当てに含まれる限定子のみを使用してください。この例では、deviceType は顧客グループと買い物客のコンテキストで使用される属性です。次に、この買い物客コンテキストデータを使用して、特定の買い物客が属する顧客グループを取得し、特定の顧客グループにマッピングされている体験をアクティブにします。

Note

買い物客コンテキストパラメーターを設定します。

コンテキストを設定するには、PUT https://{shortCode}.api.commercecloud.salesforce.com/shopper/shopper-context/v1/organizations/{organizationId}/shopper-context/{usid} を使用します。

1{
2  "customQualifiers": {
3    "deviceType": "mobile",
4    "countryCode": "EU"
5  }
6}

次のステップ

買い物客のコンテキスト | B2C Commerce API | Salesforce デベロッパー

Shopper Login (SLAS) | B2C Commerce API | Salesforce デベロッパー

Salesforce Commerce Cloud Infocenter