DM Hub表单集成 | DM Hub API 文档

1. DM Hub表单集成

嵌入式表单是 DM Hub 提供的一种表单数据的集成方式。用户可以在自己的网页上自行开发表单，按照嵌入式表单的集成规范进行集成。同微页面中的表单类似，在运行时，客户提交的数据将会提交至DM Hub对应的嵌入式表单中，并按照表单字段创建或更新对应客户的属性。

在开始集成之前，先在 DM Hub 的表单页面中创建一个表单对象。页面路径为“互动” -> “表单”。创建完成后，在表单列表中点击对应表单的“数据对接”列中的链接，即可获取表单对接的技术参数，包括表单中各个字段的技术参数，表单对接的简要步骤等。

为了保证数据安全，只有在域名白名单中的域名下的页面才允许向 DM Hub表单提交数据。设置方法为：到“设置中心” -> “网站”设置页面，在“收集客户信息”部分添加页面所在的域名。

4.1 请确保在页面的</html>标签之前嵌入了DM Hub的js-sdk：

<script src="//cbe.convertlab.com/cbe/collect?tid={YOUR_TID}&at=0&h=web"></script>

其中的 {YOUR_TID} 是您账户的专属ID，请勿随意变更。上述链接可以在步骤2中的“对接技术参数”页面中的对接步骤中获取。

4.2 在页面的<form>标签中增加如下两个data属性：

data-cl-attached="false" data-cl-id="47af0ade38bb4ff6aeb701ccf9907796"

4.3 请确保表单中input标签的name属性与步骤2中创建的表单对象中对应字段的name一致，如果不一致，则需要在提交数据时进行name的转换，确保提交的字段和步骤2中表单模型的字段name一致。

4.4 步骤4.1嵌入的sdk会在表单中增加如下name为cl_context的隐藏字段：

<input type="hidden" name="cl_context" value="utma=xxx.xxx&utmb=xxx.xxx">

在提交表单时，请将该字段中的utma和utmb提取出来，作为表单字段连同表单原有字段一起提交，或者以URL参数格式添加在提交链接后面。

4.5 提交表单之前请确保已获取cltoken (可以在页面加载后即获取)。获取方法为发送如下GET请求：

https://host.convertlab.com/formdata/get/{form uuid}

其中{form uuid}为表单的uuid。上述链接可以在步骤2中的“对接技术参数”页面中的对接步骤中获取。

接口返回结果中的token字段即为cltoken。提交表单时，请将cltoken和表单数据一起提交，字段名为cltoken。

注：一个cltoken只能提交一次，且有效期为30分钟，失效后请重新获取。

4.6 请将表单数据连同前面步骤中的utma, utmb, cltoken一起以form data的形式提交，例如使用jQuery中的serialize方法，提交地址为：

https://host.convertlab.com/form/{form uuid}

如果是在微信环境下，需要和微信粉丝做关联，可在上述提交链接后面加如下参数：channelType=wechat&userId={openid}

注：本接口支持使用ajax异步提交。