UI での SAP Commerce ソース接続の作成

次のチュートリアルでは、Adobe Experience Platform ユーザーインターフェイスを使用してSAP サブスクリプション請求の連絡先と顧客データを取り込むためのSAP Commerce ソース接続を作成する手順について説明します。

はじめに getting-started

このチュートリアルは、 Experience Platform の次のコンポーネントを実際に利用および理解しているユーザーを対象としています。

有効な SAP Commerce アカウントを既にお持ちの場合は、このドキュメントの残りの部分をスキップし、データフローの設定に関するチュートリアルに進んでください。

必要な資格情報の収集 gather-credentials

SAP CommerceをExperience Platformに接続するには、次の接続プロパティの値を指定する必要があります。

資格情報
説明
クライアント ID
サービス キーからのclientIdの値。
クライアントシークレット
サービス キーからのclientSecretの値。
トークン エンドポイント
サービス キーのurlの値は、https://subscriptionbilling.authentication.eu10.hana.ondemand.comと似ています。
領域
データセンターの場所: この領域はurlに存在し、eu10またはus10と同様の値を持ちます。 例えば、urlhttps://eu10.revenue.cloud.sap/apiの場合、eu10が必要です。

詳しくは、SAP Commerce ドキュメント ​を参照してください。

Experience Platform スキーマの作成 create-platform-schema

SAP Commerce ソース接続を作成する前に、まずソースに使用するExperience Platform スキーマを作成する必要があります。 スキーマの作成方法の包括的な手順については、Experience Platform スキーマの作成に関するチュートリアルを参照してください。

次の節を展開して、スキーマの例を表示します。

スキーマの例を表示
code language-none
{
  "_extconndev": {
    "addresses": [
      {
        "addressUUID": "{ADDRESS_UUID}",
        "city": "Burnaby",
        "country": "Canada",
        "email": "chandni@acme.com",
        "houseNumber": "27",
        "isDefault": false,
        "phone": "123-456-7890",
        "postalCode": "V3J 1X9",
        "state": "British Columbia",
        "street": "Beresford"
      }
    ],
    "changedAt": "1687204041",
    "changedBy": "vero@acme.com",
    "contactNumber": "123-456-7980",
    "corporateInfo": {
      "company": "acme"
    },
    "createAt": "1687204041",
    "createdBy": "vero@acme.com",
    "customReferences": [
      {
        "id": "Sample value",
        "typeCode": "Sample value"
      }
    ],
    "customerNumber": "Sample value",
    "customerType": "Sample value",
    "defaultAddress": {
      "addressUUID": "Sample value",
      "city": "North Vancouver",
      "country": "Canada",
      "email": "chandni@acme.come",
      "houseNumber": "34",
      "isDefault": false,
      "phone": "123-456-7890",
      "postalCode": "V7H 2P1",
      "state": "British Columbia",
      "street": "Maple"
    },
    "externalObjectReferences": [
      {
        "externalId": "{EXTERNAL_ID}",
        "externalIdTypeCode": "{EXTERNAL_ID_TYPE_CODE}",
        "externalSystemId": "{EXTERNAL_SYSTEM_ID}"
      }
    ],
    "markets": [
      {
        "active": false,
        "country": "USA",
        "currency": "USD",
        "marketId": "Sample value",
        "priceinfo": {
          "incoterms": "{INCO_TERMS}",
          "incotermsLocation": "{INCO_TERMS_LOCATION}",
          "priceGroup": "{PRICE_GROUP}",
          "priceListType": "{PRICE_LIST_TYPE}"
        },
        "salesArea": {
          "distributionChannel": "{DISTRIBUTION_CHANNEL}",
          "division": "{DIVISION}",
          "salesOrganization": "{SALES_ORGANIZATION}"
        }
      }
    ],
    "personalInfo": {
      "firstName": "Chandni",
      "lastName": "Kaur"
    }
  },
  "_id": "/uri-reference",
  "_repo": {
    "createDate": "2004-10-23T12:00:00-06:00",
    "modifyDate": "2004-10-23T12:00:00-06:00"
  },
  "createdByBatchID": "/uri-reference",
  "modifiedByBatchID": "/uri-reference",
  "personID": "{PERSON_ID}",
  "repositoryCreatedBy": "kevin@acme.com",
  "repositoryLastModifiedBy": "kevin@acme.com"
}

SAP Commerce アカウントを接続 connect-account

Experience Platform UIで、左側のナビゲーションバーから「ソース」を選択して、​ ソース ​ ワークスペースにアクセスします。 ​ カタログ ​画面には、アカウントを作成するための様々なソースが表示されます。

画面の左側にあるカタログから適切なカテゴリを選択することができます。 または、使用する特定のソースを検索オプションを使用して探すこともできます。

e コマース カテゴリで、SAP Commerce​を選択し、データを追加​を選択します。

SAP Commerce カードを使用したカタログのExperience Platform UIのスクリーンショット ​

SAP Commerce アカウントの接続」ページが表示されます。 このページでは、新しい資格情報または既存の資格情報を使用できます。

既存のアカウント existing-account

既存のアカウントを使用するには、新しいデータフローを作成するSAP Commerce アカウントを選択し、次へ​を選択して続行します。

SAP Commerce アカウントを既存のアカウントに接続するExperience Platform UIのスクリーンショット ​

新規アカウント new-account

新しいアカウントを作成する場合は、新しいアカウント​を選択し、名前、オプションの説明、および資格情報を指定します。 完了したら、「ソースに接続」を選択し、新しい接続が確立されるまでしばらく時間を空けます。

SAP Commerce アカウントを新しいアカウントに接続するためのExperience Platform UIのスクリーンショット ​

データの選択 select-data

最後に、Experience Platformに取り込むオブジェクトタイプを選択する必要があります。

オブジェクトタイプ
説明
Customers
購読があるエンティティ。
Contacts
顧客の連絡先情報。
お客様

顧客データを取り込むには、Customers​をオブジェクトタイプとして選択し、Next​を選択します。

お客様オプションを選択した設定を示すSAP CommerceのExperience Platform UIのスクリーンショット ​

連絡先

連絡先データを取り込むには、オブジェクトタイプとして​ Contacts ​を選択し、Next​を選択します。

連絡先オプションを選択した設定を示すSAP CommerceのExperience Platform UIのスクリーンショット ​

次の手順 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 配列オブジェクトとして取得された追加データ。

​ ソースワークフローのマッピングステップ。

recommendation-more-help
experience-platform-help-sources