UI での SAP Commerce ソース接続の作成
次のチュートリアルでは、Adobe Experience Platform ユーザーインターフェイスを使用してSAP サブスクリプション請求の連絡先と顧客データを取り込むためのSAP Commerce ソース接続を作成する手順について説明します。
はじめに getting-started
このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。
-
Experience Data Model (XDM) システム:Experience Platform が顧客体験データの整理に使用する標準化されたフレームワーク。
- スキーマ構成の基本:スキーマ構成の主要な原則やベストプラクティスなど、XDM スキーマの基本的な構成要素について学びます。
- スキーマエディターのチュートリアル:スキーマエディター UI を使用してカスタムスキーマを作成する方法を説明します。
-
Real-Time Customer Profile:複数のソースからの集計データに基づいて、統合されたリアルタイムの顧客プロファイルを提供します。
有効な SAP Commerce アカウントを既にお持ちの場合は、このドキュメントの残りの部分をスキップし、データフローの設定に関するチュートリアルに進んでください。
必要な資格情報の収集 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が必要です。詳しくは、SAP Commerce ドキュメント を参照してください。
Experience Platform スキーマの作成 create-platform-schema
SAP Commerce ソース接続を作成する前に、まずソースに使用するExperience Platform スキーマを作成する必要があります。 スキーマの作成方法の包括的な手順については、Experience Platform スキーマの作成に関するチュートリアルを参照してください。
次の節を展開して、スキーマの例を表示します。
| code language-none |
|---|
|
SAP Commerce アカウントを接続 connect-account
Experience Platform UIで、左側のナビゲーションバーから「ソース」を選択して、 ソース ワークスペースにアクセスします。 カタログ 画面には、アカウントを作成するための様々なソースが表示されます。
画面の左側にあるカタログから適切なカテゴリを選択することができます。 または、使用する特定のソースを検索オプションを使用して探すこともできます。
e コマース カテゴリで、SAP Commerceを選択し、データを追加を選択します。
「SAP Commerce アカウントの接続」ページが表示されます。 このページでは、新しい資格情報または既存の資格情報を使用できます。
既存のアカウント existing-account
既存のアカウントを使用するには、新しいデータフローを作成するSAP Commerce アカウントを選択し、次へを選択して続行します。
新規アカウント new-account
新しいアカウントを作成する場合は、新しいアカウントを選択し、名前、オプションの説明、および資格情報を指定します。 完了したら、「ソースに接続」を選択し、新しい接続が確立されるまでしばらく時間を空けます。
データの選択 select-data
最後に、Experience Platformに取り込むオブジェクトタイプを選択する必要があります。
CustomersContacts顧客データを取り込むには、Customersをオブジェクトタイプとして選択し、Nextを選択します。
連絡先データを取り込むには、オブジェクトタイプとして Contacts を選択し、Nextを選択します。
次の手順 next-steps
このチュートリアルでは、SAP Commerce アカウントとの接続を確立しました。 次のチュートリアルに進み、 データフローを設定してExperience Platformにデータを取り込むことができます。
その他のリソース additional-resources
以下の節では、SAP Commerce ソースを使用する際に参照できる追加のリソースについて説明します。
マッピング mapping
Experience Platformでは、選択したターゲットスキーマまたはデータセットに基づいて、自動マッピングされたフィールドに関するインテリジェントな推奨事項が提供されます。 マッピングルールは、ユースケースに合わせて手動で調整できます。 必要に応じて、フィールドを直接マッピングするか、データ準備機能を使用してソースデータを変換して計算値を導き出すかを選択できます。 マッパーインターフェイスと計算フィールドの使用に関する包括的な手順については、 データ準備UI ガイド を参照してください。
データフローのマッピング設定は、スキーマと取り込むオブジェクトタイプによって異なります。
顧客データの場合、SAP CommerceはSAP Business Partners APIの顧客と顧客 – 取引先関係 エンドポイントを使用してデータを取得します
顧客データのSAP Commerce データフローのマッピング設定の例を次に示します。
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 | |
|---|---|
| ターゲットフィールド | 説明 |
customerNumber |
顧客の番号。 |
corporateInfo |
顧客の番号。 |
customerType |
顧客タイプ: |
createdAt |
顧客がいつ作成されたかを示すタイムスタンプ。 |
changedAt |
顧客が最後に更新された日時を示すタイムスタンプ。 |
markets[*].country |
配列オブジェクトとして取得された顧客マーケット。 |
addresses[*].email |
顧客の複数のアドレスに関連付けられたメール。配列オブジェクトとして取得されます。 |
addresses[*].city |
顧客の複数のアドレスに関連付けられた都市を配列オブジェクトとして取得します。 |
addresses[*].addressUUID |
IDは、顧客の複数のアドレスに関連付けられ、配列オブジェクトとして取得されます。 |
externalObjectReferences[*].externalSystemId |
配列オブジェクトとして取得された追加データ。 |
externalObjectReferences[*].externalId |
配列オブジェクトとして取得された追加データ。 |
customReferences[*].id |
配列オブジェクトとして取得された追加データ。 |
customReferences[*].typeCode |
配列オブジェクトとして取得された追加データ。 |
連絡先データの場合、SAP CommerceはSAP Business Partners APIのcontacts エンドポイントを使用してデータを取得します。
次に、連絡先データのSAP Commerce データフローのマッピング設定の例を示します。
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 | |
|---|---|
| ターゲットフィールド | 説明 |
contactNumber |
連絡先の番号。 |
createdAt |
連絡先がいつ作成されたかを示すタイムスタンプ。 |
changedAt |
連絡先が最後に更新された日時を示すタイムスタンプ。 |
personalInfo.lastName |
連絡先の姓。 |
personalInfo.firstName |
連絡先の名前。 |
externalObjectReferences[*].externalSystemId |
配列オブジェクトとして取得された追加データ。 |
externalObjectReferences[*].externalId |
配列オブジェクトとして取得された追加データ。 |
externalObjectReferences[*].externalIdTypeCode |
配列オブジェクトとして取得された追加データ。 |