SAP Marketing Cloud Restful API SDK 使用案例分享

本文介绍笔者在 SAP Marketing Cloud 工作项目中使用 Restful API SDK 过程中积累的一些使用经验。
成功登录 SAP Marketing Cloud 系统之后,可以在菜单"快速启动"->"Manage Contacts"里找到 Marketing Cloud contact 管理应用。单击:

这里就能看到该系统里所有的 contact 列表了。左边的 1218377 是系统 contact 总个数,正下方 Create 就是新建按钮,可以通过这个按钮打开 contact 创建页面。右边的 search bar 就是一个 Google 风格的模糊搜索入口。

这个界面第一次使用的话需要注意一些小技巧。

上图高亮的四个控件实际上是四个过滤器,例如当前系统里并不存在状态为 For Review 的 contact,数字为 0,因此单击这个过滤器后:

表格会显示 0 条数据。这是用户期望的行为,因此大家如果看到表格是空的,不要觉得奇怪。

当单击某条 contact 数据的超链接后,

会跳转到 contact 明细页面. 下图 url 里高亮的 guid 就是这条 contact 在 SAP 数据库里的主键值。

使用 nodejs 对 Marketing Cloud 的 contact 主数据进行修改操作
假设在 Marketing Cloud 有这样一个 contact 主数据:

现在需求是使用编程语言比如 nodejs 修改这个 contact 实例的高亮属性。代码如下:
我在 nodejs 代码里把需要更改的字段值赋为"Jerry 测试 1”:执行之后这个属性被成功更新了:


使用 postman 修改 SAP Marketing Cloud contact 主数据
Marketing Cloud 里的 contact 主数据,创建成功后也不是所有字段都能够被修改。在 Personal data 区域的字段是可以被修改的。

比如我在“客户属性”字段里维护了一些值:

然后点保存:

其中第二个 batch 操作是通过一个 roundtrip 读取 contact 模型下多个子节点的数据,和我们这个修改的场景没有关联。使用 postman 进行修改:

body 字段维护以下内容:
我想修改的字段的新的值为:Jerry 测试 2
执行 postman 后,发现值已经更新了,修改成功

使用 nodejs 创建 Marketing Cloud 的 contact 数据
源代码如下:
这里我把创建的 contact 的名称字段硬编码成 Jerry4:

使用 nodejs 执行这个 js 文件,输出成功创建的 contact guid:

在 Marketing Cloud UI 上看到这个创建成功的 contact:

总结
本文介绍了 SAP Marketing Cloud 在第一次登陆系统后的初始化方式,以及使用 Node.js 和 Postman 等常用工具,消费 Marketing Cloud Restful API 的具体例子。
版权声明: 本文为 InfoQ 作者【Jerry Wang】的原创文章。
原文链接:【http://xie.infoq.cn/article/5675c67ed6a1512f88a3525bb】。文章转载请联系作者。
评论