SAP Commerce连接

SAP Commerce （以前称为Hybris）是适用于B2B和B2C企业的基于云的电子商务平台解决方案，作为SAP客户体验产品组合的一部分提供。 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帐户并导航到​[主数据和配置] > [自定义引用]​页面。 接下来，选择​ 创建 ​以为Experience Platform中选择的每个受众添加新引用。 在随后的计划受众导出和示例步骤中，您将需要这些参考字段名称。

下面显示了如何在SAP Subscription Billing中创建自定义​ 引用类型 ​的示例：

有关其他指导，请参阅SAP Subscription Billing 自定义引用文档。

收集所需的凭据 gather-credentials

要将SAP Commerce连接到Experience Platform，必须提供以下连接属性的值：

护栏 guardrails

对SAP Cloud Management service的API请求遵循速率限制。 如果超过速率限制，您将遇到HTTP 429 Too Many Requests响应状态代码。

支持的身份 supported-identities

SAP Commerce支持更新下表中描述的标识。 了解有关标识的更多信息。

支持的受众 supported-audiences

此部分介绍可导出到此目标的所有受众。

此目标支持激活通过Experience Platform 分段服务生成的所有受众。

此目标还支持激活下表所述的受众。

导出类型和频率 export-type-frequency

有关目标导出类型和频率的信息，请参阅下表。

连接到目标 connect

要连接到此目标，请按照目标配置教程中描述的步骤操作。 在配置目标工作流中，填写下面两个部分中列出的字段。

在​目标 > 目录​中，搜索SAP Commerce。 或者，您可以在​ 电子商务 ​类别下找到它。

验证目标 authenticate

填写下面的必填字段。 有关任何指导，请参阅生成服务密钥部分。

要验证到目标，请选择​连接到目标。

如果提供的详细信息有效，则UI会显示​ 已连接 ​状态，并带有绿色复选标记。 然后，您可以继续执行下一步。

填写目标详细信息 destination-details

要配置目标的详细信息，请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。

启用警报 enable-alerts

您可以启用警报，以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息，请参阅使用UI订阅目标警报的指南。

完成提供目标连接的详细信息后，选择​下一步。

激活此目标的受众 activate

有关将受众激活到此目标的说明，请阅读将配置文件和受众激活到流式受众导出目标。

映射属性和身份 map

要将受众数据从Adobe Experience Platform正确发送到SAP Commerce目标，您必须完成字段映射步骤。 映射包括在Experience Platform帐户中的Experience Data Model (XDM)架构字段与其与目标中的相应等效字段之间创建链接。 要将XDM字段正确映射到SAP Commerce目标字段，请执行以下步骤：

映射customerNumberSAP标识

customerNumberSAP标识是此目标的必需映射。 请按照以下步骤对其进行映射：

下面显示了具有标识映射的示例：

映射属性

要添加任何其他要在XDM配置文件架构和SAP Subscription Billing帐户之间更新的属性，请重复以下步骤：

映射所选客户类型的mandatory属性

必需的属性映射取决于您选择的​客户类型。 要映射必需属性，请从下面选择：

映射其他属性

然后，您可以在XDM配置文件架构与客户的SAP Subscription Billing 架构属性之间添加任何其他映射，如下所示：

完成提供目标连接的映射后，请选择​下一步。

计划受众导出和示例 schedule-segment-export-example

执行计划受众导出步骤时，必须手动将Experience Platform受众映射到SAP Subscription Billing中的属性。

下面显示了突出显示SAP Commerce 映射ID​位置的计划受众导出步骤示例：

为此，请选择每个区段，然后在SAP Commerce 映射ID​目标连接器字段中输入来自SAP Subscription Billing的自定义引用的名称。 有关创建自定义引用的指导，请参阅在 SAP Subscription Billing中创建自定义引用。

IMPORTANT

请勿使用自定义引用标签作为值。

例如，如果您选择的Experience Platform受众为sap_audience1，并且希望将其状态更新到SAP Subscription Billing自定义引用SAP_1中，请在SAP_Commerce 映射ID​字段中指定此值。

下面显示了SAP Subscription Billing中的​ 引用类型 ​示例：

下面显示了一个计划受众导出步骤的示例，该步骤选择了一个受众，并突出显示了其对应的SAP Commerce 映射ID：

如上所示，映射ID​字段中的值应与SAP Subscription Billing 引用类型​值完全匹配。

对每个激活的Experience Platform受众重复此部分。

根据上图所示，您已选择两个受众，映射将如下所示：

验证数据导出 exported-data

要验证您是否正确设置了目标，请执行以下步骤：

登录到SAP Subscription Billing帐户，然后导航到​ 联系人 ​页面以检查受众状态。 列表可以配置为显示自定义引用的列并显示相应的受众状态。

数据使用和治理 data-usage-governance

在处理您的数据时，所有Adobe Experience Platform目标都符合数据使用策略。 有关Adobe Experience Platform如何实施数据治理的详细信息，请参阅数据治理概述。

错误和故障排除 errors-and-troubleshooting

有关可能的错误类型及其响应代码的列表，请参阅SAP Subscription Billing 错误类型文档页面。

其他资源 additional-resources

SAP文档中的其他有用信息如下：

Changelog

此部分捕获此目标连接器的功能和重要文档更新。