SAP Commerce 接続
SAP Commerce (旧称 Hybris)は、B2B および B2C 企業向けのクラウドベースの e コマースプラットフォームソリューションで、SAP カスタマーエクスペリエンス ポートフォリオの一部として使用できます。 SAP サブスクリプション請求は、ポートフォリオの製品であり、標準化された統合によってシンプルな販売および支払いエクスペリエンスで完全なサブスクリプションライフサイクル管理を可能にします。
この Adobe Experience Platformdestination は、SAP Subscription Billing customer management API を使用して、アクティベーション後に既存のExperience Platformオーディエンスから SAP Commerce 内の顧客の詳細を更新します。
SAP Commerce インスタンスを認証する手順は、さらに下の宛先に対する認証の節にあります。
ユースケース use-cases
SAP Commerce 宛先を使用する方法とタイミングを理解しやすくするために、Adobe Experience Platform のお客様がこの宛先を使用して解決できるユースケースのサンプルを以下に示します。
顧客 SAP Commerce、ビジネスとやり取りする個人または組織単位に関する情報を保存します。 チームは、SAP Commerce に存在するお客様を使用して、Experience Platformオーディエンスを構築します。 これらのオーディエンスを SAP Commerce に送信すると、情報が更新され、各顧客には、顧客が属するオーディエンスを示すオーディエンス名としてその値を持つプロパティが割り当てられます。
前提条件 prerequisites
Experience Platformと SAP Commerce 定で設定する必要のある前提条件と、SAP Commerce の宛先を使用する前に収集する必要のある情報については、以下の節を参照してください。
Experience Platform の前提条件 prerequisites-in-experience-platform
SAP Commerce の宛先へのデータをアクティブ化する前に、 スキーマ、 データセットおよび オーディエンスを Experience Platform で作成する必要があります。
オーディエンスのステータスに関するガイダンスが必要な場合は、 オーディエンスメンバーシップの詳細スキーマフィールドグループに関するExperience Platformドキュメントを参照してください。
SAP Commerce の宛先の前提条件 prerequisites-destination
Platform から SAP Commerce アカウントにデータを書き出すには、次の前提条件に注意してください。
SAP Subscription Billing アカウントが必要です prerequisites-account
Platform から SAP Commerce アカウントにデータを書き出すには、SAP Subscription Billing アカウントが必要です。 有効な請求アカウントがない場合は、SAP アカウントマネージャーにお問い合わせください。 詳しくは、SAP Platform 設定ドキュメントを参照してください。
サービスキーの生成 prerequisites-service-key
-
SAP Commerce サービスキーを使用すると、Experience Platformから SAP Subscription Billing API にアクセスできます。 サービスキーを作成するには、SAP Commerce クライアント ID とクライアント秘密鍵を使用したサービスキーの作成を参照してください。 SAP Commerce には、以下が必要です。
- クライアント ID
- クライアントシークレット
- URL。 URL パターンは次のとおりです。
https://subscriptionbilling.authentication.eu10.hana.ondemand.com
この値は、後でRegion
とEndpoint
の値を取得する際に使用されます。
code language-json |
---|
|
SAP Subscription Billing でのカスタム参照の作成 prerequisites-custom-reference
SAP Subscription Billing のExperience Platformオーディエンスステータスを更新するには、Platform で選択した各オーディエンスに対するカスタム参照フィールドが必要です。
カスタム参照を作成するには、SAP Subscription Billing アカウントにログインし、[マスターデータと設定]/[カスタム参照] ページに移動します。 次に、「作成 を選択して、Platform で選択した各オーディエンスに対して新しい参照を追加します。 これらの参照フィールド名は、後続の オーディエンスの書き出しをスケジュールと例手順で必要になります。
SAP Subscription Billing 内にカスタム 参照タイプ を作成する方法の例を次に示します。
追加のガイダンスについては、SAP Subscription Billing カスタムリファレンスドキュメントを参照してください。
必要な資格情報の収集 gather-credentials
SAP Commerce をExperience Platformに接続するには、次の接続プロパティの値を指定する必要があります。
clientId
の値。clientSecret
の値。url
の値は、https://subscriptionbilling.authentication.eu10.hana.ondemand.com
と同様です。url
内に存在し、値は eu10
または us10
に類似しています。 例えば、url
が https://eu10.revenue.cloud.sap/api
の場合、eu10
が必要です。ガードレール guardrails
SAP Cloud Management service への API リクエストは、 レート制限の対象となります。 レート制限を超えると、HTTP 429 Too Many Requests
応答ステータスコードが表示されます。
サポートされる ID supported-identities
SAP Commerce では、以下の表で説明する ID の更新をサポートしています。ID についての詳細情報。
customerNumberSAP
サポートされるオーディエンス supported-audiences
この節では、この宛先に書き出しできるすべてのオーディエンスについて説明します。
この宛先では、Experience Platform のセグメント化サービスで生成したすべてのオーディエンスのアクティブ化をサポートします。
この宛先では、以下の表で説明するオーディエンスのアクティブ化もサポートされています。
書き出しのタイプと頻度 export-type-frequency
宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。
- フィールドマッピングに従って、目的のスキーマフィールド (例:メールアドレス、電話番号、姓) と共に、オーディエンスのすべてのメンバーを書き出します。
- Platform で選択したオーディエンスごとに、対応する SAP Commerce の追加属性が Platform のオーディエンスステータスで更新されます。
- ストリーミングの宛先は常に、API ベースの接続です。オーディエンスの評価に基づいてExperience Platform内でプロファイルが更新されると、コネクタは更新を宛先プラットフォームに送信します。 詳しくは、ストリーミングの宛先を参照してください。
宛先への接続 connect
この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。
宛先/カタログ 内で、SAP Commerce を検索します。 または、e コマース カテゴリの下に配置することもできます。
宛先に対する認証 authenticate
以下の必須のフィールドに入力します。詳しくは、 サービスキーの生成の節を参照してください。
clientId
の値。clientSecret
の値。url
の値は、https://subscriptionbilling.authentication.eu10.hana.ondemand.com
と同様です。url
内に存在し、値は eu10
または us10
に類似しています。 例えば、url
が https://eu10.revenue.cloud.sap/api
の場合、eu10
が必要です。宛先を認証するには、「 宛先に接続」を選択します。
指定した詳細が有効な場合、UI で 接続済み ステータスに緑色のチェックマークが付きます。その後、次の手順に進むことができます。
宛先の詳細を入力 destination-details
宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横にアスタリスクが表示される場合は、そのフィールドが必須であることを示します。
- 名前:今後この宛先を認識するための名前。
- 説明:今後この宛先を識別するのに役立つ説明。
- 顧客のタイプ:オーディエンス内のエンティティに応じて 個人 または 企業 のいずれかを選択します。 SAP Subscription Billing スキーマは、
customerType
属性にマッピングされる、この選択に応じて必須フィールドを切り替えます。 選択が 企業 の場合、個々の顧客に必要なfirstName
やlastName
などの必須マッピングは無視され、必須マッピングにcompany
ります(その逆も同様です)。
アラートの有効化 enable-alerts
アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。
宛先接続の詳細の入力を終えたら「次へ」を選択します。
この宛先に対してオーディエンスをアクティブ化 activate
この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。
属性と ID のマッピング map
Adobe Experience Platformから SAP Commerce の宛先にオーディエンスデータを正しく送信するには、フィールドマッピングの手順を実行する必要があります。 マッピングは、Platform アカウント内の Experience Data Model(XDM)スキーマフィールドと、ターゲット宛先から対応する同等のスキーマフィールドとの間にリンクを作成して構成されます。 XDM フィールドを SAP Commerce の宛先フィールドに正しくマッピングするには、次の手順に従います。
customerNumberSAP
ID のマッピング
customerNumberSAP
ID は、この宛先に対する必須のマッピングです。 マッピングするには、次の手順に従います。
- マッピング 手順で、「新しいマッピングを追加」を選択します。これで、新しいマッピング行が画面に表示されます。
- ソースフィールドを選択 ウィンドウで、「ID 名前空間を選択 を選択
customerNumberSAP
ます。
- ターゲットフィールドを選択 ウィンドウで、「ID 名前空間を選択 を選択して、
customerNumber
ID を選択します。
IdentityMap: customerNumberSAP
Identity: customerNumber
ID マッピングの例を以下に示します。
属性のマッピング
XDM プロファイルスキーマと SAP Subscription Billing アカウントの間で更新する他の属性を追加するには、次の手順を繰り返します。
- マッピング 手順で、「新しいマッピングを追加」を選択します。これで、新しいマッピング行が画面に表示されます。
- ソースフィールドを選択 ウィンドウで、属性を選択 カテゴリを選択して、XDM 属性を選択します。
- ターゲットフィールドを選択 ウィンドウで、カスタム属性を選択 カテゴリを選択し、顧客 スキーマ属性のリストから SAP Subscription Billing 属性の名前を入力します。
countryCode
を使用する必要がある country
です。 SAP Subscription Billing は alpha-2 (ISO 3166)国コードをサポートしています。 値は大文字と小文字が区別され、0 ~ 3 文字にする必要があるので、定義したとおりに指定してください。指定しないと、エラー「The country code {} does not exist
」または「size must be between 0 and 3
」が発生します。選択 mandatory
た顧客タイプの属性のマッピング
必須の属性マッピングは、選択した 顧客のタイプ によって異なります。 必須属性をマッピングするには、以下から選択します。
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
ソースフィールド | ターゲットフィールド | 必須 |
xdm: person.lastName |
Attribute: lastName |
○ |
xdm: workAddress.countryCode |
Attribute: countryCode |
○ |
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
ソースフィールド | ターゲットフィールド | 必須 |
xdm: b2b.companyName |
Attribute: company |
○ |
xdm: workAddress.countryCode |
Attribute: countryCode |
○ |
追加属性のマッピング
次に、以下に示すように、XDM プロファイルスキーマと顧客の SAP Subscription Billing スキーマ属性の間に追加のマッピングを追加できます。
table 0-row-3 1-row-3 2-row-3 3-row-3 | ||
---|---|---|
ソースフィールド | ターゲットフィールド | 必須 |
xdm: person.name.firstName |
Attribute: firstName |
× |
xdm: workAddress.street1 |
Attribute: street |
× |
xdm: workAddress.city |
Attribute: city |
× |
顧客が個人である、必須の属性マッピングとオプションの属性マッピングの両方の例を次に示します。
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
ソースフィールド | ターゲットフィールド | 必須 |
xdm: workAddress.street1 |
Attribute: street |
× |
xdm: workAddress.city |
Attribute: city |
× |
顧客が企業である、必須の属性マッピングとオプションの属性マッピングの例を次に示します。
宛先接続のマッピングの指定を終えたら「次へ」を選択します。
オーディエンスの書き出しのスケジュールと例 schedule-segment-export-example
オーディエンスの書き出しをスケジュール手順を実行する場合は、Platform オーディエンスを SAP Subscription Billing の 属性に手動でマッピングする必要があります。
SAP Commerce マッピング ID の場所がハイライト表示された、オーディエンスの書き出しをスケジュール手順の例を次に示 ます。
これを行うには、各セグメントを選択し、SAP Subscription Billing のカスタム参照の名前を「SAP Commerce ーザー マッピング ID 宛先コネクタ」フィールドに入力します。 カスタム参照の作成ガイダンスについては、 でのカスタム参照の作成 SAP Subscription Billing の節を参照してください。
![マッピングにカスタム参照ラベル値を使用しないことを示す画像。](./media_1e8ab7aa5d6d02ba2078cebf94a546a4da1b68d4b.png?width=750&format=png&optimize=medium)
例えば、選択したExperience Platformオーディエンスが sap_audience1
で、そのステータスを SAP Subscription Billing カスタム参照 SAP_1
に更新する場合は、「SAP_Commerce マッピング ID」フィールドにこの値を指定します。
SAP Subscription Billing の例 参照タイプ を次に示します。
オーディエンスの書き出しをスケジュール手順の例を次に示します。ここでは、オーディエンスを選択し、対応する SAP Commerce マッピング ID をハイライト表示 ています。
以下に示すように、「マッピング ID」フィールド内の値は、SAP Subscription Billing 参照タイプ の値と完全に一致する必要があります。
アクティブ化された各 Platform オーディエンスに対して、このセクションを繰り返します。
2 つのオーディエンスを選択した場合の上記の画像に基づいて、マッピングは次のようになります。
SAP_1
SAP_1
SAP_2
SAP_2
データの書き出しを検証する exported-data
宛先が正しく設定されていることを検証するには、次の手順に従います。
SAP Subscription Billing アカウントにログインし、連絡先 ページに移動して、オーディエンスのステータスを確認します。 このリストは、カスタム参照の列を表示し、対応するオーディエンスステータスを表示するように設定できます。
データの使用とガバナンス data-usage-governance
Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。Adobe Experience Platform がどのようにデータガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。
エラーとトラブルシューティング errors-and-troubleshooting
使用可能なエラータイプとその応答コードのリストについては、SAP Subscription Billing エラータイプのドキュメントページを参照してください。
その他のリソース additional-resources
SAP ドキュメントからのその他の役に立つ情報は次のとおりです。
変更ログ
この節では、この宛先コネクタに対する機能の概要と重要なドキュメントの更新について説明します。
table 0-row-3 1-row-3 layout-auto | ||
---|---|---|
リリース月 | 更新タイプ | 説明 |
2024年1月 | 初回リリース | 宛先の初回リリースとドキュメントの公開。 |