In-App 中的 Liquid
在 In-App 的内容中编写 Liquid,即可向每位用户显示其自己的数据:其 Tag 值、触发该 In-App 的事件的属性以及其 User ID。例如,按姓名问候用户,并显示事件中传递的促销码。
Liquid 在 In-App 中的生效范围
Anchor link toLiquid 仅在 Journey 通过 In-App 元素显示的 In-App 中生效。两种 显示应用内消息 模式均可使用:下次启动应用时 和 发生事件时。
请在以下任一位置编写 Liquid:
向 In-App 添加 Liquid
Anchor link to要添加 Liquid,请在 In-App 编辑器中编写,然后在 Journey 中选择该 In-App。
-
在内置编辑器中打开 In-App。
-
添加一个 HTML 块,或选择现有的 HTML 块。
-
在 HTML 字段中手动输入 Liquid 代码。

-
点击 Save。
-
在 Journey 的 In-App 元素中,于 Media Source 中选择该 In-App。
-
如果 In-App 使用事件属性,请在 显示应用内消息 中选择 发生事件时 并选择事件。
编辑器预览会显示原样的 Liquid 代码。每位用户看到的是自己的值。
在此示例中,firstName 和 loyalty_tier 是 Tag,promo_code 是显示该 In-App 的事件的属性:
<h2>Hi, {{ firstName | default: "there" }}!</h2><p>Your {{ loyalty_tier | upcase }} code:<b>{{ promo_code }}</b></p>{% if loyalty_tier == "gold" %}<p>Shipping is on us today.</p>{% endif %}Hi, Anna!
Your GOLD code: AUTUMN-42
Shipping is on us today.
可用数据
Anchor link to在 In-App 的 Liquid 中可以使用以下值:
| 值 | 说明 | 写法 |
|---|---|---|
| Tag | 存储在 Pushwoosh 中的一项用户数据,例如用户姓名。In-App 显示的是显示时的 Tag 值。 | {{ loyalty_tier }} |
| 事件属性 | 在 In-App 元素的 发生事件时 模式中所选事件的属性。如果属性与 Tag 同名,则使用属性值。 | {{ promo_code }} |
| User ID | 您的应用分配给用户的 ID。 | {{ userid }}, 需小写 |
| HWID | 用户设备在 Pushwoosh 中的硬件 ID。 | {{ hwid }}, 需小写 |
编写变量名
Anchor link to输入变量名时请遵循以下规则:
- 名称须与 Pushwoosh 中的写法完全一致,包括大小写。不匹配的名称(例如将 Tag
firstName写成{{ firstname }})会显示为空文本。 - Tag 和属性名称中不要包含空格:名为
Loyalty Tier的 Tag 写作{{ LoyaltyTier }}。 - 要显示备用值而不是空文本,请添加
default过滤器:{{ firstName | default: "there" }}。
更改值的显示方式
Anchor link to要更改值的显示方式,请添加 Liquid 过滤器。所有标准过滤器均可使用,例如 upcase、capitalize、date 和 truncate,Pushwoosh 的 timezone 过滤器也可使用。
In-App 中 Liquid 的限制
Anchor link to在 In-App 中,Liquid 有以下限制: