51黑料不打烊

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。 此值稍后将用于获取RegionEndpoint的值。
选择以查看服务键的示例
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受众状态,您需要为Experience Platform中选择的每个受众都提供一个自定义参考字段。

要创建自定义引用,请登录到您的SAP Subscription Billing帐户并导航到? 摆主数据和配置闭 > 摆自定义引用闭 ?页面。 接下来,选择? 创建 ?以为Experience 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中,其值类似于eu10us10。 例如,如果urlhttps://eu10.revenue.cloud.sap/api,您需要eu10

护栏 guardrails

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

支持的身份 supported-identities

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

目标身份
描述
注意事项
customerNumberSAP
您的SAP Commerce帐户中已存在个人或公司客户的客户标识符。
必需

支持的受众 supported-audiences

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

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

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

受众类型
支持
描述
Segmentation Service
?
通过Experience Platform 分段服务生成的受众。
自定义上传
?
受众已从颁厂痴文件将导入Experience Platform。

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

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

项目
类型
注释
导出类型
基于配置文件
  • 您正在导出受众的所有成员,以及所需的架构字段? (例如:电子邮件地址、电话号码、姓氏)(根据字段映射)。
  • 对于Experience Platform中的每个选定受众,相应的SAP Commerce附加属性将从Experience Platform中更新为其受众状态。
导出频率
正在流式传输
  • 流目标为基于API的“始终运行”连接。 当基于受众评估在Experience Platform中更新用户档案时,连接器会将更新发送到下游目标平台。 阅读有关流式目标的更多信息。

连接到目标 connect

IMPORTANT
若要连接到目标,您需要? 管理目标 访问控制权限。 阅读访问控制概述或联系您的产物管理员以获取所需的权限。

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

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

验证目标 authenticate

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

字段
描述
客户端滨顿
服务键中clientId的值。
客户端密码
服务键中clientSecret的值。
终结点
服务键中url的值类似于https://subscriptionbilling.authentication.eu10.hana.ondemand.com
地区
您的数据中心位置。 该区域存在于url中,其值类似于eu10us10。 例如,如果urlhttps://eu10.revenue.cloud.sap/api,您需要eu10

要验证到目标,请选择? 连接到目标
来自Experience Platform UI的图像,显示如何对目标进行身份验证。

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

填写目标详细信息 destination-details

要配置目标的详细信息,请填写下面的必需和可选字段。 UI中字段旁边的星号表示该字段为必填字段。
Experience Platform UI中的图像,显示身份验证后要填充的目标详细信息。

  • 名称:将来用于识别此目标的名称。
  • 描述:可帮助您将来识别此目标的描述。
  • 客户类型:根据受众中的实体,选择? 个人 ?或? 公司。 SAP Subscription Billing 根据映射到customerType属性的该选择切换必填字段。 如果选择的是? 公司,则单个客户所需的强制映射(如firstNamelastName)将被忽略,company将变为强制映射,反之亦然。

启用警报 enable-alerts

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

完成提供目标连接的详细信息后,选择? 下一步

激活此目标的受众 activate

IMPORTANT
  • 若要激活数据,您需要? 查看目标激活目标查看配置文件 ?和? 查看区段 访问控制权限。 阅读访问控制概述或联系您的产物管理员以获取所需的权限。
  • 要导出? 标识,您需要? 查看标识图形 访问控制权限
    选择工作流中突出显示的身份命名空间以将受众激活到目标。 {width="100" modal="regular"}

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

映射属性和身份 map

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

映射customerNumberSAP标识

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

  1. 在? 映射 ?步骤中,选择? 添加新映射。 您现在可以在屏幕上看到新的映射行。
    突出显示了“添加新映射”按钮的Experience Platform UI屏幕截图。
  2. 在? 选择源字段 ?窗口中,选择? 选择身份命名空间 ?并选择customerNumberSAP
    Experience Platform UI屏幕截图选择电子邮件作为要映射为标识的源属性。
  3. 在? 选择目标字段 ?窗口中,选择? 选择身份命名空间 ?并选择customerNumber身份。
    Experience Platform UI屏幕截图选择电子邮件作为要映射为身份的目标属性。
源字段
目标字段
必需
IdentityMap: customerNumberSAP
Identity: customerNumber

下面显示了具有标识映射的示例:
Experience Platform UI中的图像显示customerNumber标识映射示例。

映射属性

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

  1. 在? 映射 ?步骤中,选择? 添加新映射。 您现在可以在屏幕上看到新的映射行。
    突出显示了“添加新映射”按钮的Experience Platform UI屏幕截图。
  2. 在? 选择源字段 ?窗口中,选择? 选择属性 ?类别并选择齿顿惭属性。
    选择“姓氏”作为源属性的Experience Platform UI屏幕截图。
  3. 在? 选择目标字段 ?窗口中,选择? 选择自定义属性 ?类别并从客户属性列表中键入SAP Subscription Billing属性的名称。
    Experience Platform UI屏幕截图,其中lastName被定义为target属性。
IMPORTANT
目标字段名称区分大小写,且应与SAP Subscription Billing属性名称匹配。 唯一的例外是country,您应该改用countryCode。 SAP Subscription Billing支持alpha-2 (ISO 3166)国家/地区代码。 该值区分大小写,且必须介于0至3个字符之间,因此,请确保您所提供的内容与定义完全相同,否则您将遇到错误: The country code {} does not existsize 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

下面显示了客户为个人的具有强制和可选属性映射的示例:
Experience Platform UI中的图像显示了一个具有强制和可选属性映射的示例,其中客户是个人。

公司客户
table 0-row-3 1-row-3 2-row-3
源字段 目标字段 必需
xdm: workAddress.street1 Attribute: street
xdm: workAddress.city Attribute: city

下面显示了客户为公司的具有强制和可选属性映射的示例:
Experience Platform UI中的图像显示了一个具有强制和可选属性映射的示例,其中客户是公司。

完成提供目标连接的映射后,请选择? 下一步

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

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

下面显示了突出显示SAP Commerce 映射滨顿 ?位置的计划受众导出步骤示例:
Experience Platform中的图像显示了填充了映射滨顿的计划受众导出。

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

IMPORTANT
请勿使用自定义引用标签作为值。
此图像指示您不应使用自定义参考标签值进行映射。

例如,如果您选择的Experience Platform受众为sap_audience1,并且希望将其状态更新到SAP Subscription Billing自定义引用SAP_1中,请在厂础笔冲颁辞尘尘别谤肠别 映射滨顿 ?字段中指定此值。

下面显示了SAP Subscription Billing中的? 引用类型 ?示例:
显示在SAP订阅帐单中创建自定义引用的位置的图像。

下面显示了一个计划受众导出步骤的示例,该步骤选择了一个受众,并突出显示了其对应的SAP Commerce 映射滨顿
Experience Platform中的图像显示了填充了映射滨顿的计划受众导出。

如上所示,映射滨顿 ?字段中的值应与SAP Subscription Billing 引用类型 ?值完全匹配。

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

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

SAP Commerce受众名称
SAP Subscription Billing 引用类型
SAP Commerce 映射滨顿 ?值
sap_audience1
SAP_1
SAP_1
厂础笔受众2
SAP_2
SAP_2

验证数据导出 exported-data

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

登录到SAP Subscription Billing帐户,然后导航到? 联系人 ?页面以检查受众状态。 列表可以配置为显示自定义引用的列并显示相应的受众状态。
显示客户概述页面的SAP订阅帐单图像,列标题显示受众名称和单元格受众状态

数据使用和治理 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 月 初始版本 初始目标版本和文档发布。
recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6