Liquid 模板

YouTube 视频：了解如何在 Customer Journey 中使用内容模板

除了常规的动态内容用法外，Liquid 模板通过实施复杂的逻辑，极大地扩展了 Pushwoosh 的个性化功能。

Pushwoosh 中的消息个性化基于标签（用户数据）。Pushwoosh 提供了多种默认标签和自定义标签。使用它们，您可以指定用户的名字、城市、购买历史等，以发送更具个性化的消息。例如：Hi {{First_name}}, thanks for ordering {{item}}。

Liquid 模板为动态内容增加了更多逻辑。例如，如果用户的订阅标签包含 “free”，您可以向他们发送一条消息：“领取您的 10% 折扣。”

根据用户的 ID、行为和偏好修改消息内容，是提高相关性并从营销活动中获得更佳效果的最有效方法。

语法

基于 Shopify 的 Liquid 的内容模板使用标签、对象和筛选器的组合来加载动态内容。内容模板允许您从模板内部访问某些变量并输出其数据，而无需了解数据本身的任何信息。

注意

要了解有关语法的更多信息，请参阅 Liquid 文档。

对象

对象 定义了将向用户显示的内容。对象 应包含在双花括号中：{{ }}

例如，在个性化消息时，在其正文中发送 {{Name}}，以将用户的姓名添加到消息内容中。用户的姓名（Name 标签值）将替换用户将看到的消息中的 Liquid 对象。

输入

Hi {{Name}}! We're glad you're back!

输出

Hi Anna! We’re glad you’re back!

标签

标签 为模板创建逻辑和控制流。花括号百分比分隔符 {% 和 %} 及其包围的文本在模板呈现时不会产生任何可见输出。这使您可以分配变量并创建条件或循环，而无需向用户显示任何 Liquid 逻辑。

例如，使用 if 标签，您可以根据用户设备上设置的语言来改变消息的语言：

输入

{% if Language == 'fr' %}
Salut!
{% else %}
Hello!
{% endif %}

输出 (fr)

Salut!

输出 (es)

Hello!

标签运算符

运算符	描述
==	等于
!=	不等于
>	大于
<	小于
>=	大于或等于
<=	小于或等于
or	逻辑或
and	逻辑与
contains	检查字符串或字符串数组中是否存在子字符串

注意

在具有多个 and 或 or 运算符的标签中，运算符的检查顺序是_从右到左_。您不能使用括号更改运算顺序——括号在 Liquid 中是无效字符，会导致您的标签无法工作。

筛选器

筛选器 修改 Liquid 对象或变量的输出。它们在双花括号 {{ }} 和变量赋值中使用，并由管道字符 | 分隔。一个输出可以使用多个筛选器，并从左到右应用。

输入

{{ Name | capitalize | prepend:"Hello " }}

输出

Hello Anna

Liquid 模板用法

Liquid 模板可用于从控制面板发送的消息和 API 请求。

在 Pushwoosh 中，Liquid 模板适用于任何渠道消息的所有内容字段：

• 推送通知
• 邮件

要将 Liquid 模板添加到您的消息中，请将其插入消息正文。您可以在处理推送或邮件元素时，直接从 Customer Journey Builder 界面执行此操作。

前往 Customer Journey Builder > 创建营销活动 > 将以下元素拖放到您的画布上：基于受众的入口、推送（或邮件）和退出。连接这些元素。然后单击推送图标，选择自定义内容，并插入您的文案。

要添加 Liquid 逻辑，请使用以下语法的标签值：

{% if TagName == 'value' %}
  在此场景下发送的内容
{% else %}
  否则发送的内容
{% endif %}

然后单击应用。

模板变量（Pushwoosh 标签）不应包含任何空格，并且只能包含字母数字值和下划线，例如 my_tag 或 myTag，而不是 My Tag。

了解更多关于 Journey 中的 Liquid 模板

提示

您还可以在 /createMessage 请求中使用 Liquid 语法来实现 Liquid 模板。为此，您需要开发团队的协助。请与他们分享 Liquid 模板指南以获取详细指导。

关联内容

关联内容是 Liquid 模板中的一项功能，允许您直接在邮件或推送通知消息中动态检索和使用来自外部来源（例如 Web 服务）的数据。此功能通过从指定 URL 获取 JSON 数据并将其保存到可在内容中使用的变量中，从而实现实时个性化。

主要用例

• 产品推荐：显示为每个用户量身定制的个性化产品列表。

• 促销代码：插入由后端服务生成的唯一促销代码。

前提条件

• 要使用关联内容，您必须拥有自己的后端服务，该服务根据 User ID、HWID 或自定义标签生成并提供所需的数据（例如，促销代码、产品推荐）。然后，Pushwoosh 在发送消息之前获取这些数据。

分步实施指南

需要开发者协助

您需要开发团队的帮助才能使用关联内容。请与他们分享本指南以开始使用。

第 1 步：设置后端服务

后端服务应：

• 接受包含用户特定参数（例如 userId）的请求。关联内容支持 UserID、HWID 或您在项目中设置的任何自定义标签。
• 返回包含所需数据的 JSON 响应。然后可以将此内容动态插入到消息中。

工作原理

后端服务充当数据提供者，通过用户特定的信息响应 HTTP 请求。

1. Pushwoosh 向您的后端发送请求，将用户特定的标识符作为查询参数传递。
2. 您的后端处理请求并检索所请求的数据。
3. 您的后端返回一个 JSON 响应。
4. 在发送消息之前，Pushwoosh 从后端服务获取 JSON 响应，并在消息内容中动态使用返回的值（例如 code）。

响应示例

{ "code": "SPECIALOFFERFORUSER12345" }

第 2 步：在 Pushwoosh 中创建包含关联内容的预设

1. 在推送或邮件内容编辑器中，将关联内容语法插入到消息字段中。

示例

{% connected_content http://your-backend-url.com?userId={{ ${userid} }} :save result %}

语法分解

connected_content	从指定的后端 URL 获取 JSON 数据。
http://your-backend-url.com	以 JSON 格式返回所需数据的后端端点。
userId={{ ${userid} }}	一个动态查询参数，将用户 ID 传递给后端。
:save result	将获取的 JSON 响应存储在 result 变量中，以供在 Liquid 模板中使用。

身份验证（可选）

如果您的后端服务需要身份验证，您可以在关联内容请求中包含 API 密钥或令牌，以确保安全访问。

{% connected_content http://your-backend-url.com?userId={{ ${userid} }}&auth=YOUR_API_KEY :save result %}

在关联内容中使用标签

要包含自定义标签，请将它们作为查询参数插入到关联内容请求中 ({{ tag_name }})。

{% connected_content http://your-backend-url.com?userId={{ ${userid} }}{{ Language }} :save result %}

2. 接下来，添加包含检索到的数据的消息文本，如下所示：

Hey, {{userid}}, grab your personal promo code - {{result.code}}

3. 在最终确定消息内容并配置预设设置后，保存它以便在营销活动中重复使用。

第 3 步：使用配置好的预设发送消息

使用一次性推送或邮件表单或 Customer Journey 发送包含此预设的消息。

重要提示

如果服务返回的状态不是 HTTP 200 OK，则不会发送邮件或推送通知。这确保了您的通信仅在成功检索到必要数据时才会发出。