OneTrace.pro 帮助中心

模板与邮件编辑器

模板是针对单个渠道的现成消息:邮件、Telegram 消息、SMS、Web Push、移动推送、应用内消息、Webhook 等。同一个模板可以被旅程、群发以及档案卡片中的手动发送使用。变量会将客户姓名、订单金额等数据填入文本。

在菜单中打开用户互动 → 模板。所有角色都可以查看模板,“经理”及以上角色可以创建和修改模板。

创建模板

  1. 打开模板,点击右上角的新建模板,然后在列表中选择渠道:列表包含项目中启用的所有渠道,例如邮件或 Telegram。
  2. 填写通用字段(见下表)。
  3. 填写内容模块。字段因渠道而异。邮件包括主题、预览文本(邮件列表中显示在主题旁的文字)、邮件编辑器或 HTML,以及纯文本版本。如果不填写纯文本版本,系统会根据 HTML 自动生成。
  4. 点击保存。每次保存后版本号都会递增(“版本 3”)。
字段 含义
名称 仅在界面中显示:模板、旅程和群发的列表中
渠道 在创建时选择,之后无法更改
订阅主题 目录中的主题,例如 marketing 或 news,或者新的键(它会出现在目录中)。客户可以只退订该主题
事务性消息 发送时不检查订阅、频率和免打扰时段,但不会发往收件人已关闭的渠道:邮箱或号码不存在、机器人已被屏蔽。仅用于订单确认、密码重置等类似消息,参见事务性消息与级联发送

模板列表

表格中显示渠道、模板的语言版本(主语言以颜色突出显示)、送达率评级、订阅主题,以及修改时间和版本号。

送达率是邮件模板所有语言版本的送达率检查汇总结果:各版本中最差的评级(“良好”“有待改进”“较差”)以及最高的垃圾邮件过滤器分数(6 分及以上为垃圾邮件)。将鼠标悬停在标记上,提示中会显示每种语言的详情和检查时间。每次修改邮件后,模板都会在后台重新检查,检查期间标记显示“检查中”。仅修改名称或订阅主题不会重新检查。如果评级为“有待改进”或“较差”,请打开模板并在其中运行检查,查看具体问题。

表格上方有按名称搜索,以及按渠道、语言和送达率评级筛选,例如所有评级为“较差”的模板,或所有带有德语版本的模板。点击列标题可对表格排序,再次点击则反转顺序。 筛选和排序会被记住:删除模板或从编辑器返回后,列表保持不变。

带语言和送达率评级的模板列表

要删除模板,请点击列表中该模板所在行的垃圾桶图标。

变量

模板使用 Twig 语言编写。变量放在双大括号中。展开内容下方的变量模块,可以查看带示例的完整列表。

变量 填入的内容
profile.email、profile.phone、profile.user_id 客户的标识符
traits.first_name 及其他 traits.* 档案属性
event.name、event.properties.amount 触发该消息的事件
context.data.*、context.nodes.* 旅程数据:通过 API 进入时传入的数据,以及“Webhook”节点的响应
project.name、unsubscribe_url、preferences_url 项目名称、退订链接和订阅偏好中心链接
project.legal_address 项目设置中的公司注册地址;适合放在邮件页脚。未填写地址时为空
loyalty.points、loyalty.tier、loyalty.expiring、loyalty.expire_at、loyalty.referral_url 会员积分计划中的账户:余额、等级、即将过期的积分及其日期、邀请链接
wallet_url Wallet 会员卡链接:顾客可将会员卡添加到 Apple Wallet 或 Google Wallet。有效期 90 天;未连接 Wallet 卡券时为空
promo_code('welcome') 顾客在优惠码池 welcome 中的优惠码:发送时发放,预览中显示示例
order.number、order.amount、order.tracking_url 商店邮件中的订单:订单号、金额、物流追踪链接;带货币的金额写作 {{ order.amount|money(order.currency) }}
product('SKU-1') 邮件语言的目录商品:name、url、image、price、old_price、currency、available、stock,取发送时的数据(商品价格与库存)
您好,{{ traits.first_name|default('朋友') }}!
{% if event.properties.amount > 5000 %}免运费。{% endif %}

模板在安全沙箱中执行。沙箱支持 if 条件、for 循环、set,date、min、max 函数,以及 default、date、upper、lower、capitalize、number_format、round、join、replace、striptags 等过滤器。如果变量不存在,会填入空字符串,因此请为重要位置设置 default。如果使用了被禁止的结构,保存时会出现“模板使用了被禁止的结构”错误。渲染后的消息不能超过 512 KB。 不支持模板继承(extends、block),循环以及对商品、推荐和优惠码的调用也有上限:执行操作过多的模板无法保存。

如果模板中有平台不认识的变量,例如其他版式留下的占位符 {{ COMPANY_ADDRESS }},或把 {{ traits.first_name }} 误写成 {{ first_name }},内容上方会显示列出这些变量的警告。它们在消息中将为空。您打开、保存、预览模板或发送测试时,警告会随之更新。

预览和测试发送

  1. 在预览面板中输入档案 ID、邮箱或 user_id,然后点击眼睛图标。如果留空,将使用最近活跃的档案数据。
  2. 对于邮件,可以在桌面端、手机、深色模式和不显示图片之间切换。最后一种模式下,图片会被替换为 alt 文字:不加载图片的收件人看到的就是这样的邮件。
  3. 在测试发送面板中选择集成。填写您自己的地址或 chat id,否则消息将发送到档案的地址。点击发送测试:按钮下方会显示消息状态。

“经理”及以上角色可以进行测试发送。测试发送不检查订阅、频率和免打扰时段。预览中没有触发事件,因此 event.* 变量为空。如果您没有查看个人数据的权限,邮箱和电话会被脱敏。

使用档案预览的模板编辑器

预览中邮件下方是在收件箱中模块。它显示发件人、主题和预览文本在 Gmail 电脑端、Outlook 和 iPhone 邮件的邮件列表中的样子。过长的主题和预览文本会被截断,截断方式与这些客户端大致相同。发件人名称取自您在送达率检查模块中选择的集成。

邮件客户端收件箱中的邮件

送达率检查

发送前可以检查邮件模板:邮件会进入收件箱还是垃圾邮件。在送达率检查模块中,选择邮件将通过哪个集成发送,然后点击检查。邮件会按实际发送时的方式生成:包含打开和点击追踪以及退订链接。检查的是当前打开的语言版本,数据取自预览中指定的档案。

检查包括三个方面:

  • 发件人。 使用 OneTrace.pro 的邮件服务时,发件地址的域名必须已在发信域名中添加并通过验证,最好还有 DMARC 记录。使用自有 SMTP 服务器时,会检查域名的 SPF 和 DMARC 记录;DKIM 签名需要在您的邮件服务商处配置,无法在此检查。
  • 内容。 主题(为空、全部大写、含 !! 或 $$、过长)、预览文本、邮件大小(Gmail 会截断超过 102 KB 的 HTML)、只有图片的邮件、没有 alt 的图片、短链接、指向 IP 地址的链接、链接文字是另一个网站地址的链接、营销邮件中可见的退订链接,以及邮件客户端会删除的元素(脚本、表单、框架)。
  • 垃圾邮件过滤器评分。 Rspamd 垃圾邮件过滤器会检查整封邮件。分数低于“可疑”阈值为良好,高于“垃圾邮件”阈值则邮件很可能进入垃圾邮件。影响评分的因素列表显示过滤器的规则及其权重。

结果为下列评级之一:良好(没有明显会进入垃圾邮件的原因)、有待改进(邮件可以送达,但建议您修正这些问题)或较差(垃圾邮件风险较高或发件人有误)。每条问题都会说明哪里不对以及如何修正。

下方是邮件客户端兼容性:在 Windows 版 Outlook、Gmail、Yandex 邮箱或 Mail.ru 中无法使用的排版方式,例如圆角、阴影、媒体查询、自定义字体、SVG 和视频。邮件仍可送达,只是显示效果会有所不同,因此不影响评级。

邮件送达率检查

群发会以同样的方式检查各变体的邮件,参见发送前检查邮件。

语言版本

一个模板可以包含多种语言的版本。每位收件人都会收到其档案语言(language 属性)的版本;如果没有该版本,则收到主要版本。可选的语言在项目设置中设定。

  1. 在内容区块上方点击添加语言并选择语言,然后选择创建版本的方式:

    • 复制当前打开的版本:布局、图片和链接都已就位,只需翻译文本;
    • AI 翻译:主要版本的翻译草稿,详见下文;
    • 用 AI 导入邮件:该语言的现成邮件,详见导入到语言版本。

    选择新版本的创建方式

  2. 使用语言按钮在版本之间切换。主要版本标有"主要"。

  3. 如果希望没有自己版本的收件人收到另一种语言,请打开该语言的版本并点击设为主要。删除版本会移除当前打开的版本。

  4. 点击保存。每个版本都会单独检查;有错误的版本会显示警告图标。

翻译草稿

无需从头手动翻译某个版本:打开该版本并点击翻译草稿。OneTrace.pro 会把主要版本翻译成当前打开标签页的语言,包括主题、预览文本、编辑器各模块的文本、纯文本版本,以及 SMS、推送和即时通讯的文本。{{ traits.first_name }} 之类的变量、链接、图片和排版保持不变。

草稿只会填入表单。请通读并修改措辞,然后点击保存。如果某个字段无法在不丢失变量的情况下翻译,它会保留源语言,OneTrace.pro 会显示这类字段的数量。如果该版本已与主要版本不同,替换前会先询问您。

每月可生成的草稿数量受套餐限制,参见套餐。如果您的安装未启用翻译,则不会显示该按钮。

版本的选择顺序:先是完全匹配的语言,然后是不含地区的语言(使用 pt-BR 的客户会收到 pt 版本),再然后是同一语言的其他变体。预览和测试发送显示当前打开的版本,变量 {{ language }} 包含所发送版本的语言。

邮件编辑器

在邮件模板的“邮件编辑器”字段中点击打开编辑器。如果模板中已有 HTML,编辑器会从头开始创建邮件,旧代码将在保存时被替换。适用于各种邮件客户端(包括 Outlook 和手机)的代码由 OneTrace.pro 在保存时自动生成。

画布右侧有三个选项卡:

  • 添加区块:添加一个区块。它会放在所选区块之后,或放在邮件末尾的页脚之前。
  • 区块设置:画布上所选区块的设置。区块可以上移、下移、拖动、复制和删除。
  • 邮件:背景、邮件背景、文本和链接颜色、字体、邮件宽度(480–800 px)、内边距以及图片显示方式。
区块 用途
标题、文本 带格式和变量的文本,例如 {{ traits.first_name }}
图片 来自媒体库的图片:替代文本、链接、宽度 10–100%
按钮 文字、链接、颜色和圆角
分隔线、间距 线条和空白
分栏 2–3 栏,可包含标题、文本、图片、按钮和间距。在手机上,各栏会垂直堆叠
商品 来自推荐的商品:个性化、热门、“一起浏览”“相似”等。个性化、热门和趋势商品可以按目录的类目限定。来源为所选商品时,会按设定的顺序显示最多 12 个目录商品:按名称查找,邮件中只会包含有库存的商品。可显示 1 到 12 个商品,分 1–4 栏,并可带价格和按钮。有评价的商品会在名称下方显示评分。如果没有匹配的商品,该区块不会出现在邮件中
订单 商店邮件中的订单:商品、金额、包裹物流追踪和地址。在不含订单的邮件中没有该区块
问卷 问卷的主要问题:NPS 0–10 按钮或五颗星。客户直接在邮件中打分,问卷页面会保存评分,并请客户回答其余问题
HTML 原样插入的自定义代码
页脚 文本、退订链接和“管理订阅”链接

选中某个区块的邮件编辑器

“邮件”选项卡中的切换到 HTML 按钮会将邮件转换为普通代码。转换后无法再返回编辑器。

链接还是附件

链接(CDN) 作为邮件附件
邮件大小 较小 增加图片的大小
显示方式 打开邮件时加载图片。如果邮箱屏蔽图片,只显示替代文本 图片立即可见

默认方式在“邮件”选项卡的默认图片投递方式字段中设置。单张图片的方式可以在投递方式字段中更改。一封邮件的所有附件合计不超过 1 MB。如果部署中未配置公开链接,则只能使用附件。

邮件编辑器中的 AI

AI 可以协助处理邮件模板的文本:建议主题、修改区块文本,以及根据描述生成整封邮件。AI 的结果只是草稿:它会进入表单或编辑器,由您来保存模板。AI 了解项目名称、店铺所属行业、货币、当前打开版本的语言以及品牌语气和规则,但不会获得客户的数据。

AI 在付费套餐中可用,并按用量从项目余额中扣费。如果 AI 当前不可用(试用期、余额为零或已达到支出上限),按钮仍会显示,旁边会注明原因。

主题建议

主题建议按钮位于“主题”和“预览文本”字段上方。选择侧重点——多种思路、好奇与清晰、紧迫感、个性化称呼或读者获益——也可以填写要求,例如“不用表情符号”。点击生成建议:AI 会根据当前打开的邮件版本的文本,提出五组“主题 + 预览文本”。

列表中的主题会以带示例姓名的形式显示,与收件人看到的一致。标记含收件人姓名表示主题中含有姓名变量。使用按钮会把这一组填入表单。

主题和预览文本建议

修改区块文本

在编辑器画布上选择标题、文本或按钮。在区块设置面板的AI:修改文本部分有缩短、更亲切、更正式、纠正错误和**改写…**按钮,最后一个可按您的要求改写。AI 的建议会显示在按钮下方:替换会把它填入区块,取消则保持原文不变。

AI 不会更改模板变量和链接。如果回复中丢失了变量或修改了链接,文本不会被替换,您会看到原因说明。

用 AI 修改区块文本

根据描述生成邮件

AI 撰写邮件按钮位于编辑器上方,紧挨着“打开编辑器”按钮。请描述邮件的内容以及您希望读者做什么,并给出链接——例如“大衣促销至周日,最高优惠 30%,链接 https://…”。如果邮件中需要商品,请勾选目录中的商品:AI 会查看目录类目,并找出有库存的商品。点击生成邮件——通常不到一分钟。

如果希望新邮件与您的其他邮件风格一致,请选择示例邮件——本项目中用编辑器制作的邮件模板。AI 会沿用它的版式和结构:颜色和字体、徽标及其他图片、按钮、促销码框等 HTML 模块,以及带变量的页脚。文案则根据描述撰写:除非您在描述中写明,示例中的活动、促销码和链接不会带入新邮件。

邮件由编辑器区块组成:标题、文本、按钮、商品,以及带退订链接的页脚。如果编辑器中已有邮件,OneTrace.pro 会询问是否替换。主题和预览文本仅在这两个字段为空时才会填入。如果有需要修改的地方,编辑器上方会显示提示——例如需要填写描述中没有提供的按钮链接。

根据描述用 AI 撰写邮件

邮件的 A/B 测试变体,AI 直接在群发中生成。

导入现成的邮件

如果邮件已在其他服务中设计好,无需重新制作。在 模板 页面点击 导入邮件(AI):

  1. 选择 文件,上传从邮件客户端保存的邮件(.eml)或 .html 页面;或选择 HTML 代码,粘贴邮件代码。
  2. 点击 导入。AI 处理邮件通常需要一分钟左右。
  3. 编辑器会打开一个新的邮件模板:邮件已拆分为编辑器模块,图片已复制到媒体库,收件人姓名替换为变量 {{ traits.first_name }},退订链接移入“页脚”模块。文本和链接保持与原邮件一致。
  4. 检查模板后点击 保存。保存之前模板并不存在。

导入邮件对话框

AI 根据邮件生成的模板

如果邮件的部分内容未能转移,表单上方会显示列表:哪些图片未能复制、哪些模块被跳过。如果邮件无法拆分为模块,将作为单个“HTML”模块导入。跟踪像素和“在浏览器中查看”链接不会导入。

OneTrace.pro 会识别邮件语言:依据 lang 属性和 Content-Language 头;如果它们与正文不符,则依据邮件正文本身。邮件语言会成为新模板的主要语言。

导入到语言版本

如果已有其他语言的邮件,无需翻译:在打开的邮件模板中点击 添加语言,选择语言,再选择 用 AI 导入邮件。邮件的上传方式与创建模板时相同,并进入所选语言的版本,带有自己的模块、图片和主题。检查该版本后点击 保存。

如果邮件语言与所选语言不一致,版本上方会显示提示,例如“这封邮件似乎是法语”,以及 设为“法语”版本 按钮。如果该版本已存在,OneTrace.pro 会询问是否替换。

导入功能适用于“增长版”和“企业版”套餐;每月导入次数(包括新模板和版本)取决于套餐,详见 套餐。在“入门版”套餐中,按钮会显示从哪个套餐起可使用该功能。

媒体库

添加“图片”区块或点击选择图片时会打开媒体库。

  • 上传支持不超过 10 MB 的 JPEG、PNG、GIF、WebP 和 AVIF。较宽的图片会缩小到 1200 px。WebP 和 AVIF 会被重新编码,因为并非所有邮件客户端都能显示这些格式。GIF 保持原样,包括动画。
  • 重复上传同一文件不会产生副本。
  • 模板中正在使用的图片无法删除,除非先将其从模板中移除。
  • 图片占用的空间计入套餐限额。

包含已上传图片的媒体库