SAP Commerce 接続

SAP Commerce （旧称：Hybris）は、B2BおよびB2C企業向けのクラウドベースのe コマースプラットフォームソリューションで、SAP Customer Experience ポートフォリオの一部として利用できます。 SAP サブスクリプション請求は、ポートフォリオの下にある製品であり、標準化された統合を通じて、販売と支払い体験を簡素化することで、完全なサブスクリプションライフサイクル管理を可能にします。

このAdobe Experience Platform 宛先では、SAP Subscription Billing 顧客管理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

Experience PlatformからSAP Commerce アカウントにデータをエクスポートするには、次の前提条件に注意してください。

SAP Subscription Billing アカウントが必要です prerequisites-account

Experience PlatformからSAP Commerce アカウントにデータをエクスポートするには、SAP Subscription Billing アカウントが必要です。 有効な請求先アカウントがない場合は、SAP アカウント マネージャーにお問い合わせください。 詳細については、SAP プラットフォーム設定 ドキュメントを参照してください。

サービスキーの生成 prerequisites-service-key

{
    "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 オーディエンスのステータスを更新するには、Experience Platformで選択した各オーディエンスのカスタム参照フィールドが必要です。

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

Reference Type​内にカスタム SAP Subscription Billingを作成する方法の例を次に示します。

詳しくは、SAP Subscription Billing ​ カスタム参照 ドキュメントを参照してください。

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

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

ガードレール guardrails

SAP Cloud Management serviceへのAPI リクエストには、​ レート制限が適用されます。 レート制限を超えると、HTTP 429 Too Many Requests応答ステータスコードが表示されます。

サポートされる ID supported-identities

SAP Commerce では、以下の表で説明する ID の更新をサポートしています。ID についての詳細情報。

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

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

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

この宛先は、次の表に記載されているオーディエンスのアクティブ化もサポートしています。

オーディエンスのデータタイプ別にサポートされるオーディエンス：

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

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

宛先への接続 connect

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

Destinations > Catalog​内で、SAP Commerceを検索します。 または、eCommerce カテゴリの下に配置することもできます。

宛先に対する認証 authenticate

以下の必須のフィールドに入力します。ガイダンスについては、「​ サービスキーを生成」の節を参照してください。

宛先に対する認証を行うには、Connect to destination​を選択します。

指定された詳細が有効な場合、UIには緑色のチェックマークが付いた​Connected ステータスが表示されます。 その後、次の手順に進むことができます。

宛先の詳細を入力 destination-details

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

アラートの有効化 enable-alerts

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

宛先接続の詳細の提供が完了したら、Next​を選択します。

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

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

属性と ID のマッピング map

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

customerNumberSAP IDのマッピング map-customer-number-sap

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

ID マッピングの例を次に示します。

マッピング属性 mapping-attributes

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

選択した顧客タイプのmandatory属性をマッピング map-mandatory-attributes

必須の属性マッピングは、選択した​ Type of Customer ​によって異なります。 必須の属性をマッピングするには、以下から選択します。

追加属性のマッピング mapping-additional-attributes

次に、次に示すように、XDM プロファイルスキーマと顧客のSAP Subscription Billing ​ スキーマ ​属性の間に追加のマッピングを追加できます。

宛先接続のマッピングの提供が完了したら、Next​を選択します。

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

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

SAP Commerce Mapping ID​の場所が強調表示されたオーディエンス書き出しスケジュール手順の例を次に示します。

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

IMPORTANT

値としてカスタム参照ラベルを使用しないでください。

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

Reference Type​のSAP Subscription Billingの例を次に示します。

オーディエンスを選択し、対応するSAP Commerce Mapping ID​を強調表示したオーディエンスの書き出しスケジュール手順の例を次に示します。

Mapping ID フィールド内の値は、SAP Subscription Billing Reference Type​値と完全に一致する必要があります。

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

2つのオーディエンスを選択した上記の画像に基づいて、マッピングは次のようになります。

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

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

SAP Subscription Billing アカウントに移動し、Contacts ページに移動して、オーディエンスのステータスを確認します。 リストは、カスタム参照の列を表示したり、対応するオーディエンスのステータスを表示したりするように設定できます。

データの使用とガバナンス data-usage-governance

Adobe Experience Platform のすべての宛先は、データを処理する際のデータ使用ポリシーに準拠しています。Adobe Experience Platform がどのようにデータガバナンスを実施するかについて詳しくは、データガバナンスの概要を参照してください。

エラーとトラブルシューティング errors-and-troubleshooting

考えられるエラータイプとその応答コードのリストについては、SAP Subscription Billing エラータイプ ​のドキュメントページを参照してください。

その他のリソース additional-resources

SAP ドキュメントのその他の有用な情報は次のとおりです。

変更ログ changelog

この節では、この宛先コネクタに対する機能の概要と重要なドキュメントの更新について説明します。