ドキュメントExperience Platform宛先ガイド

SAP Commerce 接続

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

作成対象：

  • 管理者
  • ユーザー

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 
{
    "url": "https://eu10.revenue.cloud.sap/api",
    "uaa": {
        "clientid": "XXX",
        "clientsecret": "XXX",
        "url": "https://subscriptionbilling.authentication.eu10.hana.ondemand.com",
        "identityzone": "subscriptionbilling",
        "identityzoneid": "XXX",
        "tenantid": "XXX",
        "tenantmode": "dedicated",
        "sburl": "https://internal-xsuaa.authentication.eu10.hana.ondemand.com",
        "apiurl": "https://api.authentication.eu10.hana.ondemand.com",
        "verificationkey": "XXX",
        "xsappname": "XXX",
        "subaccountid": "XXX",
        "uaadomain": "authentication.eu10.hana.ondemand.com",
        "zoneid": "XXX",
        "credential-type": "binding-secret"
    },
    "vendor": "SAP"
}

SAP Subscription Billing でのカスタム参照の作成 prerequisites-custom-reference

SAP Subscription Billing のExperience Platformオーディエンスステータスを更新するには、Platform で選択した各オーディエンスに対するカスタム参照フィールドが必要です。

カスタム参照を作成するには、SAP Subscription Billing アカウントにログインし、[マスターデータと設定]/[カスタム参照] ページに移動します。 次に、「作成 を選択して、Platform で選択した各オーディエンスに対して新しい参照を追加します。 これらの参照フィールド名は、後続の オーディエンスの書き出しをスケジュールと例手順で必要になります。

SAP Subscription Billing 内にカスタム 参照タイプ を作成する方法の例を次に示します。
SAP サブスクリプション請求でカスタム参照を作成する場所を示す画像。

追加のガイダンスについては、SAP Subscription Billing カスタムリファレンスドキュメントを参照してください。

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

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

資格情報
説明
クライアント ID
サービスキーからの 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 についての詳細情報。

ターゲット ID
説明
注意点
customerNumberSAP
SAP Commerce アカウントに既に存在する個人または法人の顧客の顧客識別子。
必須

サポートされるオーディエンス supported-audiences

この節では、この宛先に書き出しできるすべてのオーディエンスについて説明します。

この宛先では、Experience Platform のセグメント化サービスで生成したすべてのオーディエンスのアクティブ化をサポートします。

この宛先では、以下の表で説明するオーディエンスのアクティブ化もサポートされています。

オーディエンスタイプ
サポートあり
説明
Segmentation Service
✓
Experience Platform セグメント化サービスを通じて生成されたオーディエンス。
カスタムアップロード
✓
CSV ファイルから Experience Platform に読み込まれたオーディエンス。

書き出しのタイプと頻度 export-type-frequency

宛先の書き出しのタイプと頻度について詳しくは、以下の表を参照してください。

項目
タイプ
メモ
書き出しタイプ
プロファイルベース
  • フィールドマッピングに従って、目的のスキーマフィールド （例：メールアドレス、電話番号、姓） と共に、オーディエンスのすべてのメンバーを書き出します。
  • Platform で選択したオーディエンスごとに、対応する SAP Commerce の追加属性が Platform のオーディエンスステータスで更新されます。
書き出し頻度
ストリーミング
  • ストリーミングの宛先は常に、API ベースの接続です。オーディエンスの評価に基づいてExperience Platform内でプロファイルが更新されると、コネクタは更新を宛先プラットフォームに送信します。 詳しくは、ストリーミングの宛先を参照してください。

宛先への接続 connect

IMPORTANT
宛先に接続するには、宛先の管理 アクセス制御権限が必要です。詳しくは、アクセス制御の概要または製品管理者に問い合わせて、必要な権限を取得してください。

この宛先に接続するには、宛先設定のチュートリアルの手順に従ってください。宛先の設定ワークフローで、以下の 2 つのセクションにリストされているフィールドに入力します。

宛先/カタログ 内で、SAP Commerce を検索します。 または、e コマース カテゴリの下に配置することもできます。

宛先に対する認証 authenticate

以下の必須のフィールドに入力します。詳しくは、 サービスキーの生成の節を参照してください。

フィールド
説明
クライアント ID
サービスキーからの clientId の値。
クライアント秘密鍵
サービスキーからの clientSecret の値。
エンドポイント
サービスキーからの url の値は、https://subscriptionbilling.authentication.eu10.hana.ondemand.com と同様です。
地域
データセンターの場所。 領域は url 内に存在し、値は eu10 または us10 に類似しています。 例えば、url が https://eu10.revenue.cloud.sap/api の場合、eu10 が必要です。

宛先を認証するには、「 宛先に接続」を選択します。
宛先への認証方法を示す Platform UI からの画像。

指定した詳細が有効な場合、UI で​ 接続済み ​ステータスに緑色のチェックマークが付きます。その後、次の手順に進むことができます。

宛先の詳細を入力 destination-details

宛先の詳細を設定するには、以下の必須フィールドとオプションフィールドに入力します。UI のフィールドの横にアスタリスクが表示される場合は、そのフィールドが必須であることを示します。
認証後に入力する宛先の詳細を示す Platform UI からの画像。

  • 名前：今後この宛先を認識するための名前。
  • 説明：今後この宛先を識別するのに役立つ説明。
  • 顧客のタイプ：オーディエンス内のエンティティに応じて 個人 または 企業 のいずれかを選択します。 SAP Subscription Billing スキーマは、customerType 属性にマッピングされる、この選択に応じて必須フィールドを切り替えます。 選択が 企業 の場合、個々の顧客に必要な firstName や lastName などの必須マッピングは無視され、必須マッピングに company ります（その逆も同様です）。

アラートの有効化 enable-alerts

アラートを有効にすると、宛先へのデータフローのステータスに関する通知を受け取ることができます。リストからアラートを選択して、データフローのステータスに関する通知を受け取るよう登録します。アラートについて詳しくは、UI を使用した宛先アラートの購読についてのガイドを参照してください。

宛先接続の詳細の入力を終えたら「次へ」を選択します。

この宛先に対してオーディエンスをアクティブ化 activate

IMPORTANT
  • データをアクティブ化するには、宛先の表示、宛先のアクティブ化、プロファイルの表示 および セグメントの表示 ​ アクセス制御権限が必要です。 アクセス制御の概要を参照するか、製品管理者に問い合わせて必要な権限を取得してください。
  • ID を書き出すには、ID グラフの表示 ​ アクセス制御権限が必要です。
    宛先に対してオーディエンスをアクティブ化するために、ワークフローでハイライト表示されている ID 名前空間を選択します。 {width="100" modal="regular"}

この宛先にオーディエンスをアクティベートする手順は、ストリーミングオーディエンスの書き出し宛先へのプロファイルとオーディエンスのアクティベートを参照してください。

属性と ID のマッピング map

Adobe Experience Platformから SAP Commerce の宛先にオーディエンスデータを正しく送信するには、フィールドマッピングの手順を実行する必要があります。 マッピングは、Platform アカウント内の Experience Data Model（XDM）スキーマフィールドと、ターゲット宛先から対応する同等のスキーマフィールドとの間にリンクを作成して構成されます。 XDM フィールドを SAP Commerce の宛先フィールドに正しくマッピングするには、次の手順に従います。

customerNumberSAP ID のマッピング

customerNumberSAP ID は、この宛先に対する必須のマッピングです。 マッピングするには、次の手順に従います。

  1. マッピング ​手順で、「新しいマッピングを追加」を選択します。これで、新しいマッピング行が画面に表示されます。
    「新しいマッピングを追加」ボタンがハイライト表示された Platform UI のスクリーンショット。
  2. ソースフィールドを選択 ウィンドウで、「ID 名前空間を選択 を選択 customerNumberSAP ます。
    ID としてマッピングするソース属性としてメールを選択する Platform UI スクリーンショット。
  3. ターゲットフィールドを選択 ウィンドウで、「ID 名前空間を選択 を選択して、customerNumber ID を選択します。
    ID としてマッピングするターゲット属性としてメールを選択する Platform UI スクリーンショット。
ソースフィールド
ターゲットフィールド
必須
IdentityMap: customerNumberSAP
Identity: customerNumber
○

ID マッピングの例を以下に示します。
customerNumber ID マッピングの例を示す Platform UI からの画像。

属性のマッピング

XDM プロファイルスキーマと SAP Subscription Billing アカウントの間で更新する他の属性を追加するには、次の手順を繰り返します。

  1. マッピング ​手順で、「新しいマッピングを追加」を選択します。これで、新しいマッピング行が画面に表示されます。
    「新しいマッピングを追加」ボタンがハイライト表示された Platform UI のスクリーンショット。
  2. ソースフィールドを選択 ウィンドウで、属性を選択 カテゴリを選択して、XDM 属性を選択します。
    姓をソース属性として選択する Platform UI のスクリーンショット。
  3. ターゲットフィールドを選択 ウィンドウで、カスタム属性を選択 カテゴリを選択し、顧客 スキーマ属性のリストから SAP Subscription Billing 属性の名前を入力します。
    lastName がターゲット属性として定義されている Platform UI のスクリーンショット。
IMPORTANT
ターゲットフィールド名では大文字と小文字が区別され、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 ×

顧客が個人である、必須の属性マッピングとオプションの属性マッピングの両方の例を次に示します。
顧客が個人の、必須とオプションの両方の属性マッピングを含む例を示す Platform UI の画像。

法人顧客
table 0-row-3 1-row-3 2-row-3
ソースフィールド ターゲットフィールド 必須
xdm: workAddress.street1 Attribute: street ×
xdm: workAddress.city Attribute: city ×

顧客が企業である、必須の属性マッピングとオプションの属性マッピングの例を次に示します。
顧客が企業である場合の、必須とオプションの属性マッピングの両方を含む例を示す Platform UI からの画像。

宛先接続のマッピングの指定を終えたら「次へ」を選択します。

オーディエンスの書き出しのスケジュールと例 schedule-segment-export-example

オーディエンスの書き出しをスケジュール手順を実行する場合は、Platform オーディエンスを SAP Subscription Billing の 属性に手動でマッピングする必要があります。

SAP Commerce マッピング ID の場所がハイライト表示された、オーディエンスの書き出しをスケジュール手順の例を次に示 ます。
マッピング ID が入力されたスケジュールオーディエンスの書き出しを示す Platform の画像。

これを行うには、各セグメントを選択し、SAP Subscription Billing のカスタム参照の名前を「SAP Commerce ーザー マッピング ID 宛先コネクタ」フィールドに入力します。 カスタム参照の作成ガイダンスについては、 でのカスタム参照の作成 SAP Subscription Billing の節を参照してください。

IMPORTANT
カスタム参照ラベルを値として使用しないでください。
マッピングにカスタム参照ラベル値を使用しないことを示す画像。

例えば、選択したExperience Platformオーディエンスが sap_audience1 で、そのステータスを SAP Subscription Billing カスタム参照 SAP_1 に更新する場合は、「SAP_Commerce マッピング ID」フィールドにこの値を指定します。

SAP Subscription Billing の例 参照タイプ を次に示します。
SAP サブスクリプション請求でカスタム参照を作成する場所を示す画像。

オーディエンスの書き出しをスケジュール手順の例を次に示します。ここでは、オーディエンスを選択し、対応する SAP Commerce マッピング ID をハイライト表示 ています。
マッピング ID が入力されたスケジュールオーディエンスの書き出しを示す Platform の画像。

以下に示すように、「マッピング ID」フィールド内の値は、SAP Subscription Billing 参照タイプ の値と完全に一致する必要があります。

アクティブ化された各 Platform オーディエンスに対して、このセクションを繰り返します。

2 つのオーディエンスを選択した場合の上記の画像に基づいて、マッピングは次のようになります。
| SAP Commerce オーディエンス名 | SAP Subscription Billing 参照タイプ | SAP Commerce マッピング ID 値 |
| — | — | — |
| sap_audience1 | SAP_1 | SAP_1 |
| SAP オーディエンス 2 | SAP_2 | SAP_2 |

データの書き出しを検証する exported-data

宛先が正しく設定されていることを検証するには、次の手順に従います。

SAP Subscription Billing アカウントにログインし、連絡先 ページに移動して、オーディエンスのステータスを確認します。 このリストは、カスタム参照の列を表示し、対応するオーディエンスステータスを表示するように設定できます。
顧客の概要ページを示す SAP 登録請求の画像。オーディエンス名とセルのオーディエンスステータスを示す列ヘッダーが含まれています

データの使用とガバナンス 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月 初回リリース 宛先の初回リリースとドキュメントの公開。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6