模板变量

模板变量概述

BillionMail 的模板变量系统允许您在邮件模板中动态插入数据。这些变量可以用在：

• 邮件模板的内容中

• 营销任务的邮件主题中

• 发件人名称中

• 其他需要动态内容的地方

变量使用双大括号语法：

{{ .Subscriber.变量名 }}

{{ .Task.变量名 }}

联系人内置变量

联系人变量用于访问收件人的基本信息：

变量	说明	示例值
{{ .Subscriber.Email }}	联系人邮箱地址	[email protected]

任务内置变量

任务变量用于访问当前邮件任务的相关信息：

变量	说明	示例值
{{ .Task.Addresser }}	发件人邮箱	[email protected]
{{ .Task.Subject }}	邮件主题	周年庆活动通知
{{ .Task.FullName }}	发件人显示名称	客户服务部

自定义变量

自定义变量是与联系人关联的额外信息字段，可以根据业务需求灵活定义和使用。

常用自定义变量示例

{
    "name": "张三",              // 姓名
    "nickname": "小张",          // 昵称
    "gender": "男",             // 性别
    "age": "28",               // 年龄
    "birthday": "1996-03-21",  // 生日
    "mobile": "13800138000",   // 手机号
    "company": "科技有限公司",    // 公司名称
    "position": "产品经理",      // 职位
    "industry": "互联网",        // 行业
    "city": "深圳",             // 城市
    "interests": "科技,旅游",    // 兴趣爱好
    "vip_level": "金牌",        // 会员等级
    "register_source": "官网",   // 注册来源
    "last_purchase": "2024-03-01" // 最近购买时间
}

添加自定义变量的方式

1. CSV批量导入：

   格式：email,attributes

   [email protected],"{""age"":""42"",""planet"":""Mars""}"
   [email protected],"{""age"":""42"",""planet"":""Mars""}"
   [email protected],"{""name"":""张三"",""city"":""深圳"",""job"":""工程师""}"

   注意事项：

   • attributes 列的值必须是合法的 JSON 字符串

   • 所有变量值都应该是字符串类型

   • 可以包含多个自定义变量

2. 单个编辑：

   • 进入 联系人 详情页

   • 点击 编辑 按钮

   • 在自定义变量区域添加键值对

   • 保存更改

      {
         "name": "张三",
         "city": "深圳",
         "job": "工程师"
      }

   

在模板中使用自定义变量

1. 基础用法：

   {{ .Subscriber.变量 }}

   • 示例：自定义变量

   年龄：{{ .Subscriber.age }}
   
   星球：{{ .Subscriber.planet }}

   • 显示效果：

     年龄：42

     星球：Mars

自定义变量使用建议

1. 变量命名规范：

   • 使用英文小写字母

   • 避免使用特殊字符

   • 变量名要见名知意

   推荐：

   {"age": "25", "city": "NewYork"}

   不推荐：

   {"年龄": "25", "城市": "纽约"}

2. 数据格式规范：

   • 变量值为普通字符串类型

3. 常见应用场景：

   • 个人信息：姓名、性别、生日、联系方式

   • 会员信息：等级、积分、注册时间

   • 消费信息：购买次数、消费金额、最近购买

   • 偏好设置：兴趣爱好、常用设备、语言偏好

   • 渠道信息：注册来源、推荐人、营销渠道

4. 数据维护建议：

   • 定期更新：确保数据时效性

   • 数据清理：删除无用变量

   • 值格式统一：保持一致的数据格式

   • 定期清理未使用的自定义变量

如何使用变量？

1. 邮件内容模板示例：

邮件营销 --> 模板 --> 添加模板

<div>
    <h1>亲爱的{{ .Subscriber.name }} 先生/女士 </h1>
    
    <p>您好！我们看到您来自 {{ .Subscriber.city }}，</p>
    
    <p>作为一名 {{ .Subscriber.job }}，我们为您准备了特别的职业发展建议。</p>
    
    <p>如有任何问题，请随时与我们联系。</p>
    
    <footer>
        {{ .Task.FullName }}
        <br>
        {{ .Task.Addresser }}
    </footer>
</div>

• 示例变量说明:

变量	说明	效果
{{ .Subscriber.name }}	自定义变量: name	张三
{{ .Subscriber.city }}	自定义变量: city	深圳
{{ .Subscriber.job }}	自定义变量: job	工程师
{{ .Task.FullName }}	内置变量: FullName	发件人名称
{{ .Task.Addresser }}	内置变量: FullName	发件人邮箱

如下图所示：

2. 配置自定义变量

• 导入联系人：

联系人 --> 订阅 --> 导入

[email protected],"{""name"":""张三"",""city"":""深圳"",""job"":""工程师""}"

• 编辑联系人：

联系人 --> 订阅 --> 联系人 --> 编辑

{
  "name": "张三",
  "city": "深圳",
  "job": "工程师"
}

3. 测试模板

邮件营销 --> 任务 --> 添加任务

4. 测试结果

最佳实践

1. 变量命名规范：

   • 避免使用特殊字符

   • 使用有意义的名称

2. 模板测试：

   • 使用测试功能发送测试邮件

   • 检查所有变量是否正确显示

3. 常见用途：

   • 个性化称呼

   • 地区化内容

   • 动态优惠信息

   • 自定义推荐

4. 注意事项：

   • 避免在主题中使用过多变量

   • 确保所有联系人都有必要的变量值

   • 定期清理未使用的自定义变量