为了确保传输进出 Emarsys 的数据与正确的联系人匹配并以正确的格式存储,您需要正确设置数据库字段。
除此之外,您可以根据您的资源和业务需求,从多个可用的传输协议中进行选择。
Emarsys 数据字段
所有进出 Emarsys 的数据传输均通过 Emarsys 数据字段进行。 利用系统提供的多个可用选项,您可以进行手动以及完全自动化的导入和导出。
无论使用哪种方法,务必要确保导入的字段是 Emarsys 应用程序中存在的字段,并且具有正确的名称和字段类型,这样才可以正确传输数据。 还要指定一个字段作为唯一标识符,这可以确保正确的数据与正确的人匹配。 在许多情况下,电子邮件地址字段可以充当唯一标识符。 但是,由于 Emarsys Predict 和许多第三方应用程序都会寻找 externalId 字段,我们建议您使用此名称创建一个简短的文本字段,并在所有数据传输中使用它。
当您在 Emarsys 应用程序中更新联系人属性时,需要遵循以下规则:
- 包含值的单选和自由文本字段将覆盖现有的值。
- 多选字段每次都会覆盖所有值。 换句话说,如果每次更新中不包含现有的值,系统将把它删除。
- 没有值的字段不受影响。
- 如果您想用空字符串覆盖某个值,则必须为该字段明确定义 NULL 值。
您也可以在 联系人属性 页面手动编辑所有联系人字段。 有关更多信息,请参见:
无论何时,将数据导入 Emarsys 后,新的值总是会替换现有的值。 如果您用不止一种方法来更新联系人数据,记住这一点很重要,因为自动更新可能覆盖手动更新。
传输协议
使用 Emarsys API 传输数据
为了实现最佳性能和大容量数据传输,我们推荐使用 Emarsys API。不过它需要您具备一些技术资源,以便与应用程序集成。
您能够单独或批量(通过 API 创建 10,000 个新联系人的一般批量调用需要大约一分钟)创建新联系人以及更新现有联系人的属性。 也可以通过 API 以及在数据导入之后触发的事务性或批处理电子邮件管理联系人列表。
API 导入不涉及文件,不需要外部存储,因为数据以 JSON (JavaScript Object Notation) 的形式存储在 API 调用中。
API 还可以从 Emarsys 应用程序导出新注册以及整个联系人列表或给定时间内发生的联系人属性变更。 这些内容以 CSV 格式交付到指定外部存储(比如 SFTP、WebDAV)中。
对于电子邮件响应,可以调用电子邮件营销任务的整个响应摘要(并且可以执行其他操作,比如插入到另一应用程序的表中)。 此外,可以导出一个包含在给定时间内响应了电子邮件的所有联系人(和已定义的属性)的文件。
有关更多信息,请参阅 Emarsys API 文档。
通过 WebDAV 传输数据
我们将 WebDAV 存储视为最不安全、最不理想的传输协议,但我们知道不是所有公司都拥有实施 API 所需的技术资源。因此,我们设置了一个 WebDAV 文件夹,使您能够自动完成数据导入和导出。
WebDAV 使用 HTTPS 协议,这意味着无需在防火墙中添加例外情况,您可以更快地开始使用它。
要设置 WebDAV,请前往管理菜单的安全设置页面(此功能仅适用于帐户所有者)。 请按以下步骤操作:
- 创建 WebDAV 用户,为它命名。
- 在确认对话框中,您将看到 WebDAV 密钥(密码),复制它。
- 关闭对话框后,您将看到存储目录。

如果密钥丢了,您可以创建新用户并使用它。
利用上述详细信息,您只需将该目录映射为共享文件夹或使用 www.bitkinex.com 或 www.cyberduck.ch 等客户端,然后就可以开始传输文件了。
如果您有 SFTP 服务器,我们可以为您将它链接到 WebDAV。
通过 SFTP/FTPS 传输数据
如果您目前使用的是 SFTP/FTPS 服务器,我们可以把链接它,这样您就可以将文件传输进出 Emarsys 了。 要使用 SFTP/FTPS 服务器,您只需向 Emarsys 支持团队提供以下详细信息,他们会安排为您配置相应设施:
- 服务器名称
- 登录名
- 密码
- 要使用的目录
通过 Web 表单传输数据
Emarsys 表单模块提供了简单的功能,用于创建各种不同的表单来收集联系人数据。 这些表单可用在电子邮件中、可通过链接访问或直接嵌入网页。 表单包括:
一般注册表用于收集采用一般订阅设置的新联系人详细信息。
电子报注册表仅用于收集对特定电子报的订阅。 此表上登记的联系人不会自动接收您发送的任何电子邮件。
- 资料变更表允许现有联系人在您的 Emarsys 数据库中更改其属性。