邮件变量合并检查器

粘贴你的邮件模板。你将同时看到两份即时预演效果 —— 一份填入了完整的收件人示例数据,另一份所有字段均为空白,因为总会有部分收件人的资料是缺失的。

🔒 你的数据不会离开浏览器。

三种常见事故,且仅有一种属于纯粹的打字失误

未闭合的变量 —— 例如缺少闭合花括号的 {{first_name —— 会原封不动地直接发送给每一位收件人。在编辑器里肉眼扫视时它看似完全正常,而这正是此类错误总能逃过校对的原因。在上方预演中,它会以醒目的红色原样显示,正如收件人实际读到的那样。

单个模板中混用两套语法通常意味着某个段落是从其他平台创建的旧模板中复制过来的。Mailchimp 的 *|FNAME|* 在基于 Klaviyo 或 Liquid 的发送系统里毫无意义,反之亦然,导致其中一套语法会原样暴露。这几乎绝非打字失误 —— 而是复制粘贴造成的疏忽。

缺失兜底默认值根本不是语法层面的错误。您好 {{first_name}}, 语法完全合法,但对任何资料为空的收件人而言,读到的却是尴尬的“您好 ,”。上方的第二份预演展示的正是这种情形,而这类收件人永远都客观存在。

为什么提供两份对比预演而非单一判决

一份报错清单只告诉你违反了某条规则;而亲眼看到“您好 ,”突兀地出现在自己邮件的正文顶端,才能让你切身体会客户收到时的糟糕体验 —— 唯有这才能促使人们自觉为变量加上兜底默认值。

这些规则从何而来

没有任何官方权威出处:没有任何一家邮件服务平台为其合并变量发布过形式文法。这些模式均为业界广泛通行的形态 —— Mailchimp 的 *|FIELD|*、基于 Liquid 平台的 {{ }}、%%FIELD%%、${field}、[FIELD] —— 本工具明确将每条规则如实标为自有工程规则,绝不虚夸为行业标准。

本工具执行的全部检查(共 6 条规则)

TPL-U01 合并变量未闭合

开分隔符没有匹配的闭合分隔符。整个片段会被原样发送出去,每位收件人都会看到未被替换的占位符代码 —— 在编辑器中检查时它看似正常,这也是它往往能躲过人工校对的原因。

修复: 补齐闭合分隔符,确保与开分隔符完全匹配。

来源: 合并变量语法的自有工程规则。分隔符因邮件服务平台而异,而且没有一家发布过形式文法,所以这些模式来自业界通行的写法,而不是来自某份规范。

TPL-X01 单个模板中混用了两种不同的变量语法

模板中混合了不同风格的分隔符 —— 例如同时包含 Mailchimp 的 *|FIELD|* 与 {{field}}。发送邮件的平台仅能识别其中一种,另一种则会被原封不动地直接发送。这几乎总是意味着该段落是从其他平台创建的模板中复制过来的。

修复: 统一将全部变量转换为当前邮件平台所支持的语法。

来源: 合并变量语法的自有工程规则。分隔符因邮件服务平台而异,而且没有一家发布过形式文法,所以这些模式来自业界通行的写法,而不是来自某份规范。

TPL-F01 个性化字段缺少兜底默认值

姓名等字段若未设置默认值,任何资料为空的收件人都会看到形如“您好 ,”的尴尬问候语。这不是语法错误,而是数据问题,也是为什么往往只有邮件发出后才会被人发觉。

修复: 为该字段设置默认兜底值,例如 *|FNAME:朋友|* 或 {{ first_name | default: "客户" }}。

来源: 合并变量语法的自有工程规则。分隔符因邮件服务平台而异,而且没有一家发布过形式文法,所以这些模式来自业界通行的写法,而不是来自某份规范。

TPL-C01 字段名称疑似样例模板遗留的占位文本

在绝大多数平台上,first_name、FNAME 或 customer_name 等名称均属合规字段 —— 但样例模板中常附带 YOUR_COMPANY 或 SAMPLE_TEXT 等占位标识,它们本应由人工替换,而非通过系统动态合并。

来源: 合并变量语法的自有工程规则。分隔符因邮件服务平台而异,而且没有一家发布过形式文法,所以这些模式来自业界通行的写法,而不是来自某份规范。

TPL-S01 分隔符内部包含空格

部分平台允许使用 {{ field }},但有些平台则不允许。在不支持空格的平台上,该字段会被视作未知变量而保持原样不予替换。

来源: 合并变量语法的自有工程规则。分隔符因邮件服务平台而异,而且没有一家发布过形式文法,所以这些模式来自业界通行的写法,而不是来自某份规范。

TPL-V01 合并变量规范且全部正确闭合

语法统一,且所有分隔符均已正确配对闭合。

来源: 合并变量语法的自有工程规则。分隔符因邮件服务平台而异,而且没有一家发布过形式文法,所以这些模式来自业界通行的写法,而不是来自某份规范。

自有工程规则。各邮件服务平台的合并变量分隔符各不相同,且均未发布过正式文法规范,因此本规则集源自行业常见格式习惯。

关于这些规则。 每一条都有编号、严重级别和通俗解释。每个来源链接都已登记在案,并对线上页面实际复验过,而不是凭印象写上去的. 规则如何编写、测试与保持更新 →