通过弹窗表单收集邮箱
让弹窗收集字段、加入客户列表并发送 lead 事件，无需自行编写提交处理程序。
在 Zalify 弹窗中添加表单后，像素会负责收集字段、提交到 Zalify、按配置加入列表，并发送 lead 转化事件，无需自行编写提交代码。
开始前
- 准备一个弹窗，见创建第一个弹窗。
- 准备接收新订阅者的客户列表。
配置表单
指定目标列表
在弹窗文档设置 form: { list_id }，填入新订阅者应加入的列表 ID。
添加表单 HTML
在弹窗中加入包含输入项的 <form data-zalify-form>。像素会自动接管提交，无需另加处理函数。
设置输入项名称
输入项 name 与字段一一对应，支持 email、phone、firstName、lastName、language、emailMarketingConsent、smsMarketingConsent。标准字段映射会忽略其他输入项；自定义数据的保存方式请按具体提交接口配置。
发布
发布弹窗后，访客即可提交。
提交时发生什么
运行时依次执行：
收集表单数据。
触发 form_submitted。
POST 到提交接口。
收到成功的 2xx 响应后触发 lead。
更新 data-zalify-form-state：idle → submitting → success | error。
你可以仅用 CSS 根据状态显示加载提示、成功消息或错误信息。
两种事件的区别
| 事件 | 时机 | 载荷 |
|---|---|---|
form_submitted | 网络请求前同步触发 | form_id、list_id 和字段；即使之后请求失败，也能记录提交尝试 |
lead | 订阅接口返回 2xx 后 | 精简为 { email }，对应广告平台的线索转化语义 |
不使用弹窗也可以收集
- 托管内嵌表单：将 Zalify 设计的表单放在页脚或落地页。
- 连接已有表单，例如页脚订阅框：
window.zalify('wire_form', {
selector: '#newsletter',
list_id: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
form_id: 'footer_signup',
});
wire_form 使用与弹窗相同的提交路径、事件和状态机制，可用于不同框架。像素未完成启动时调用也会进入队列。完整说明见表单指南。
提交内容保存在哪里
包含表单提交数据的请求会保存为 Submission，保留原始字段，即使不加入列表也可用于问卷与线索收集。启用订阅时，联系人还会加入目标列表，并按规则参与分群计算。
从订阅开始持续跟进
加入列表可作为欢迎邮件等自动化流程的入口。配置后，所有向该列表提交的弹窗或连接表单都可为流程提供新联系人。