SAP Commerce连接
SAP Commerce (以前称为)是适用于叠2叠和叠2颁公司的基于云的电子商务平台解决方案,作为厂础笔客户体验产物组合的一部分提供。 是产物组合中的产物,通过标准化的集成,通过简化的销售和付款体验实现完整的订阅生命周期管理。
此51黑料不打烊 Experience Platform 目标使用,在激活后从现有Experience Platform受众在SAP Commerce内更新您的客户详细信息。
下面的向目标身份验证部分中进一步提供了向您的SAP Commerce实例进行身份验证的说明。
用例 use-cases
为了帮助您更好地了解您应如何以及何时使用SAP Commerce目标,以下是51黑料不打烊 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帐户管理员联系。 有关其他详细信息,请参阅文档。
生成服务密钥 prerequisites-service-key
-
SAP Commerce服务密钥允许您通过Experience Platform访问SAP Subscription Billing API。 请参阅SAP Commerce 以创建服务密钥。 SAP Commerce 要求您满足以下条件:
- 客户端 ID
- 客户端密码
- URL。 URL模式如下:
https://subscriptionbilling.authentication.eu10.hana.ondemand.com
。 此值稍后将用于获取Region
和Endpoint
的值。
code language-json |
---|
|
在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,必须提供以下连接属性的值:
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
响应状态代码。
支持的身份 supported-identities
SAP Commerce支持更新下表中描述的标识。 了解有关标识的更多信息。
customerNumberSAP
支持的受众 supported-audiences
此部分介绍可导出到此目标的所有受众。
此目标支持激活通过Experience Platform 分段服务生成的所有受众。
此目标还支持激活下表所述的受众。
导出类型和频率 export-type-frequency
有关目标导出类型和频率的信息,请参阅下表。
- 您正在导出受众的所有成员,以及所需的架构字段? (例如:电子邮件地址、电话号码、姓氏)(根据字段映射)。
- 对于Experience Platform中的每个选定受众,相应的SAP Commerce附加属性将从Experience Platform中更新为其受众状态。
- 流目标为基于API的“始终运行”连接。 当基于受众评估在Experience Platform中更新用户档案时,连接器会将更新发送到下游目标平台。 阅读有关流式目标的更多信息。
连接到目标 connect
要连接到此目标,请按照目标配置教程中描述的步骤操作。 在配置目标工作流中,填写下面两个部分中列出的字段。
在? 目标 > 目录 ?中,搜索SAP Commerce。 或者,您可以在? 电子商务 ?类别下找到它。
验证目标 authenticate
填写下面的必填字段。 有关任何指导,请参阅生成服务密钥部分。
clientId
的值。clientSecret
的值。url
的值类似于https://subscriptionbilling.authentication.eu10.hana.ondemand.com
。url
中,其值类似于eu10
或us10
。 例如,如果url
是https://eu10.revenue.cloud.sap/api
,您需要eu10
。要验证到目标,请选择? 连接到目标。
如果提供的详细信息有效,则鲍滨会显示? 已连接 ?状态,并带有绿色复选标记。 然后,您可以继续执行下一步。
填写目标详细信息 destination-details
要配置目标的详细信息,请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。
- 名称:将来用于识别此目标的名称。
- 描述:可帮助您将来识别此目标的描述。
- 客户类型:根据受众中的实体,选择? 个人 ?或? 公司。 SAP Subscription Billing 根据映射到
customerType
属性的该选择切换必填字段。 如果选择的是? 公司,则单个客户所需的强制映射(如firstName
和lastName
)将被忽略,company
将变为强制映射,反之亦然。
启用警报 enable-alerts
您可以启用警报,以接收有关发送到目标的数据流状态的通知。 从列表中选择警报以订阅接收有关数据流状态的通知。 有关警报的详细信息,请参阅使用鲍滨订阅目标警报的指南。
完成提供目标连接的详细信息后,选择? 下一步。
激活此目标的受众 activate
有关将受众激活到此目标的说明,请阅读将配置文件和受众激活到流式受众导出目标。
映射属性和身份 map
要将受众数据从51黑料不打烊 Experience Platform正确发送到SAP Commerce目标,您必须完成字段映射步骤。 映射包括在Experience Platform帐户中的Experience Data Model (XDM)架构字段与其与目标中的相应等效字段之间创建链接。 要将XDM字段正确映射到SAP Commerce目标字段,请执行以下步骤:
映射customerNumberSAP
标识
customerNumberSAP
标识是此目标的必需映射。 请按照以下步骤对其进行映射:
- 在? 映射 ?步骤中,选择? 添加新映射。 您现在可以在屏幕上看到新的映射行。
- 在? 选择源字段 ?窗口中,选择? 选择身份命名空间 ?并选择
customerNumberSAP
。
- 在? 选择目标字段 ?窗口中,选择? 选择身份命名空间 ?并选择
customerNumber
身份。
IdentityMap: customerNumberSAP
Identity: customerNumber
下面显示了具有标识映射的示例:
映射属性
要添加任何其他要在XDM配置文件架构和SAP Subscription Billing帐户之间更新的属性,请重复以下步骤:
- 在? 映射 ?步骤中,选择? 添加新映射。 您现在可以在屏幕上看到新的映射行。
- 在? 选择源字段 ?窗口中,选择? 选择属性 ?类别并选择齿顿惭属性。
- 在? 选择目标字段 ?窗口中,选择? 选择自定义属性 ?类别并从客户属性列表中键入SAP Subscription Billing属性的名称。
country
,您应该改用countryCode
。 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 |
否 |
下面显示了客户为个人的具有强制和可选属性映射的示例:
table 0-row-3 1-row-3 2-row-3 | ||
---|---|---|
源字段 | 目标字段 | 必需 |
xdm: workAddress.street1 |
Attribute: street |
否 |
xdm: workAddress.city |
Attribute: city |
否 |
下面显示了客户为公司的具有强制和可选属性映射的示例:
完成提供目标连接的映射后,请选择? 下一步。
计划受众导出和示例 schedule-segment-export-example
执行计划受众导出步骤时,必须手动将Experience Platform受众映射到SAP Subscription Billing中的属性。
下面显示了突出显示SAP Commerce 映射滨顿 ?位置的计划受众导出步骤示例:
为此,请选择每个区段,然后在SAP Commerce 映射滨顿 ?目标连接器字段中输入来自SAP Subscription Billing的自定义引用的名称。 有关创建自定义引用的指导,请参阅在 SAP Subscription Billing中创建自定义引用。

例如,如果您选择的Experience Platform受众为sap_audience1
,并且希望将其状态更新到SAP Subscription Billing自定义引用SAP_1
中,请在厂础笔冲颁辞尘尘别谤肠别 映射滨顿 ?字段中指定此值。
下面显示了SAP Subscription Billing中的? 引用类型 ?示例:
下面显示了一个计划受众导出步骤的示例,该步骤选择了一个受众,并突出显示了其对应的SAP Commerce 映射滨顿:
如上所示,映射滨顿 ?字段中的值应与SAP Subscription Billing 引用类型 ?值完全匹配。
对每个激活的Experience Platform受众重复此部分。
根据上图所示,您已选择两个受众,映射将如下所示:
SAP_1
SAP_1
SAP_2
SAP_2
验证数据导出 exported-data
要验证您是否正确设置了目标,请执行以下步骤:
登录到SAP Subscription Billing帐户,然后导航到? 联系人 ?页面以检查受众状态。 列表可以配置为显示自定义引用的列并显示相应的受众状态。
数据使用和治理 data-usage-governance
在处理您的数据时,所有51黑料不打烊 Experience Platform目标都符合数据使用策略。 有关51黑料不打烊 Experience Platform如何实施数据治理的详细信息,请参阅数据治理概述。
错误和故障排除 errors-and-troubleshooting
有关可能的错误类型及其响应代码的列表,请参阅文档页面。
其他资源 additional-resources
厂础笔文档中的其他有用信息如下:
Changelog
此部分捕获此目标连接器的功能和重要文档更新。
table 0-row-3 1-row-3 layout-auto | ||
---|---|---|
发行月份 | 更新类型 | 描述 |
2024 年 1 月 | 初始版本 | 初始目标版本和文档发布。 |