跳转到内容
FlareLane Docs

个性化消息（Liquid）

Liquid 是由 Shopify 开发的开源模板语言。FlareLane 支持使用 Liquid 语法构建的个性化消息。由于 Liquid 可以将数据处理成您想要的任意形式，因此您可以创建更加丰富的个性化消息。

将姓名或会员等级等客户数据附加到您的消息中，即可发送更具个性化的消息。与发送通用消息相比，这有望带来更高的响应率。

个性化消息示例：

  • Hello, {{ name | default: "customer" }}!
  • Your sign-up was completed on {{ tags.signup_date | date: "%Y-%m-%d", "Asia/Seoul" }}.
  • Your order for {{ entry_event.data.product_name | truncate: 20 }} has shipped.
  • Your {{ tags.point | number_with_delimiter}} reward points are about to expire.

工作原理

Section titled “工作原理”

只需点击几下即可设置个性化变量，无需手动输入。

Liquid 语法是用两个花括号括起来的字符串块。

例如，使用客户姓名的个性化消息可以这样构建：

Hello, {{ name | default: "customer" }}!

在实际发送时，如果 用户画像 中包含 name 数据，消息将按如下方式发送：

Hello, Minhyuk Kim!

如果没有 name 数据，则使用默认值，消息将按如下方式发送：

Hello, customer!

可用函数

Section titled “可用函数”

字符串过滤器

Section titled “字符串过滤器”
  • default - 当变量缺失时替换为默认值。
  • truncate - 将较长的变量截断为指定长度。
  • truncatewords - 将较长的变量截断为指定的单词数。
  • replace - 替换变量中某个特定字符串的所有出现。
  • replace_first - 替换变量中某个特定字符串首次出现的位置。
  • date - 将日期字符串转换为您想要的格式。（查看格式）
  • upcase - 将英文字符串全部转换为大写。
  • downcase - 将英文字符串全部转换为小写。
  • capitalize - 将英文字符串的首个单词首字母大写。
  • url_encode - 将字符串编码为 URL 安全格式。
  • url_decode - 解码经过 URL 编码的字符串。
  • strip_html - 移除所有 HTML 标签。

数字过滤器

Section titled “数字过滤器”
  • number_with_delimiter - 将数字转换为带千位逗号分隔符的字符串。
  • plus - 为数字变量加上某个特定值。
  • minus - 从数字变量中减去某个特定值。
  • times - 将数字变量乘以某个特定值。
  • divided_by - 将数字变量除以某个特定值。
  • round - 对数字变量进行四舍五入。
  • floor - 对数字变量向下取整。
  • ceil - 对数字变量向上取整。

数组过滤器

Section titled “数组过滤器”
  • first - 输出数组的第一个值。
  • last - 输出数组的最后一个值。
  • size - 输出数组中元素的数量。
  • join - 将数组的所有值连接成单个字符串。

条件分支

Section titled “条件分支”
{% assign user_name = tags.nickname %}
{% assign last_purchase = tags.last_purchase_category %}


{% if last_purchase == "sneakers" %}
This week only, the new sneakers you love, {{ user_name }}, are 10% off! Don't miss out 👟
{% elsif last_purchase == "outerwear" %}
New outerwear perfect for the cold weather has just arrived! We've also prepared a special offer just for you, {{ user_name }} 🧥
{% else %}
We've prepared new products and discounts just for you, {{ user_name }}. Check them out now!
{% endif %}

可用变量

Section titled “可用变量”

您可以使用各种已关联的客户数据作为变量。

  • 标签：tags.*
    • 自动匹配该设备上设置的 用户画像与标签 中的某个标签。
    • A {{ tags.grade }}-tier coupon has been issued.
      • 在该设备的标签中查找 grade。
  • 事件：entry_event.data.*
    • 在客户旅程自动化中，您可以将附加在进入条件 事件 上的数据用作变量。
    • The {{ entry_event.data.product_name }} in your cart is waiting for you!
      • 在触发事件的子数据中查找 product_name。
  • userId
    • 如果目标设备拥有用户 ID，则传递该用户 ID 的值。这主要用于需要传递用户 ID 的场景，例如 Webhook。
  • 数据
    • 您可以在发送时即时传入外部值，以实现消息个性化。
    • {{ writerName }} liked your post.
      • 您可以通过发送 API 添加 data 参数，或直接在控制台中输入 data 字段。
POST https://api.flarelane.com/v1/projects/<project-id>/notifications
{
  targetType: userId,
  targetIds: "USER_ID",
  body: "{{ writerName }} liked your post."
  data: {
    writerName: "Minhyuk"
  }
}

© 2026 FlareLabs, Inc.