消息个性化参考
了解如何使用 Klaviyo 的个性化变量或标签来为您的客户定制体验。个性化标签可用于电子邮件（包括电子邮件的主题行）、短信/彩信、推送通知和客户中心。本文概述了某些可用的标签、它们的结构和形式，以及如何自定义它们。要了解如何添加个性化，请参阅我们关于[向您的消息添加个性化]的文章(https://help.klaviyo.com/hc/en-us/articles/18986347580827)。个性化标签以前称为模板标签和变量语法。
关于个性化标签
当您在文本字段中输入标签时，它们看起来就像下表左侧的句子。显示消息后，标签将被收件人个人资料或事件详细信息中的信息替换，并且看起来像右侧的句子。 | | |
| — | — | |
|---|---|---|
嗨{{first_name}} {{last_name}}，您最喜欢的颜色是`{{person | lookup:’最喜欢的颜色’}}` | 嗨乔治·华盛顿，你最喜欢的颜色是绿色 |
个人资料个性化通常以“person”开头，除了“first_name”和“last_name”等一些特殊标签之外。事件变量可在指标触发的流中使用，以“event”开头。组织标签（例如您的公司名称和地址）以“组织”开头。所有个性化标签都区分大小写，并且必须与它们引用的属性名称完全匹配。确保您的标签拼写正确，并使用与您的个人资料中显示的相同大小写。
个人资料个性化
个人资料个性化使您能够在消息中显示特殊的 Klaviyo 属性。下面的列表涵盖了所有配置文件个性化（即内置 Klaviyo 属性）。选择个人资料个性化标签可从电子邮件编辑器中的个性化菜单或短信和推送消息的预览模式中获得。如果您想向消息添加自定义属性，请跳至自定义个性化 部分。 | | |
| — | — | |
|---|---|---|
| 标签 | 配置文件属性 | |
{{ 电子邮件 }} | 电子邮件 | |
{{ 名字 }} | 名字 | |
{{ 姓氏 }} | 姓氏 | |
{{ 人.组织 }} | 接收组织 | |
| `{{ person | lookup:”$address1″ }}` | 地址 1 |
{{ person.id }} | 唯一 ID（$id/外部 ID） | |
| `{{ person | lookup:”$latitude” }}` | 纬度 |
| `{{ person | lookup:”$longitude” }}` | 经度 |
{{ person.KlaviyoID }} | 克拉维约 ID | |
{{ person.full_name }} | 全名 | |
{{ person.title }} | 标题 | |
{{ person.phone_number }} | 电话号码 | |
| `{{ person | lookup:’$address2′ }}` | 地址 2 |
{{ 人.城市 }} | 城市 | |
{{ person.Region }} | 州/地区 | |
{{ 人.国家}} | 国家 | |
{{ person.Zipcode }} | 邮政编码 | |
| `{{ person | lookup:”$source” }}` | 来源 |
| `{{ person | lookup:”$consent” }}` | 同意 |
| `{{ person | lookup:’$consent_form_id’ }}` | $同意\_form\_id |
| `{{ person | lookup:’$consent_form_version’ }}` | $同意\_形式\_版本 |
| `{{ person | lookup:’$consent_method’ }}` | $同意\_方法 |
| `{{ person | lookup:”$timezone” }}` | 收件人时区 |
| `{{ person | lookup:’$consent_timestamp’ }}` | $同意\_时间戳 |
| `{{ person | lookup:’$phone_number_region’ }}` | $电话\_号码\_地区 |
{{ person.ViewedItems }} | 最近查看的项目 | |
| `{{ person | lookup:”下一个订单的预计日期” }}` | 预计下次订单日期 |
自定义对象标签
自定义对象 标签使您能够在流和营销活动发送中使用对象数据。查看标签参考，了解如何使用标签获取对象 ID 或返回计数的具体示例。您必须先创建一个对象，然后才能在模板中使用自定义对象数据。 “{{ object }}”标签仅在对象触发流时才可用。 | | |
| — | — |
|---|---|
| 标签 | 结果 |
{{ object.object_property }} | 返回触发流的对象 |
| `{{ 对象 | 查找：’object_property’ }}` |
{{ object_filter.object_filter_name.object_property}} | 从[对象过滤器]返回单个对象(https://help.klaviyo.com/hc/en-us/articles/35146367972763#h_01JPTH5R8840K0Q3XWH2CFYWRY) |
| `{{object_filter.object_filter_name | 查找：’object_property’ }}` |
| {{ object_filter.object_filter_name }} |从对象过滤器返回计数
{% customobject id={{ event.object_id }} 作为别名 %} | 通过 ID 检索对象 |
|---|---|
{% customobjects object_type_title=“标题”作为别名 %} {% for object_instance in alias %} {{ object_instance.record }} {% endfor %} {% endcustomobjects %} | 从一个配置文件中检索某个对象的所有记录 |
组织标签
组织标签允许您在消息中包含有关您的公司或组织的信息。您可以通过单击左下角的组织名称，然后选择设置 > 组织 > 联系信息来管理此信息。所有组织标签均以“organization”开头。有关组织标签的列表，请参阅下表。 | | |
| — | — |
|---|---|
| 组织标签 | 描述 |
{{ 组织名称 }} | 您的组织名称 |
{{organization.url}} | 您组织的网站 |
{{organization.full_address}} | 您组织的完整地址，包括城市、州/地区和邮政编码 |
{{organization.street_address}} | 您组织的街道地址 |
{{organization.street_address2}} | 贵组织地址的第二部分（例如公寓或单元号码） |
{{organization.city}} | 您组织所在的城市 |
{{ 组织.区域 }} | 您组织所在的州、省或地区 |
{{organization.zip_code}} | 您组织的邮政编码 |
链接和预览标签
链接和预览标签允许收件人管理他们的订阅首选项并在浏览器中查看您的消息。这些包括：
这些标签仅支持电子邮件模板。如果您在预览电子邮件中单击这些链接之一，您将被定向到占位符页面，而不是实时同意页面或预览。
取消订阅
Klaviyo 要求所有电子邮件中都有取消订阅链接。对显示“取消订阅”的链接使用简单的取消订阅标签，或在引号中添加您自己的文本。 | | |
| — | — |
|---|---|
| 标签 | 输出 |
{% 取消订阅 %} | 取消订阅 |
| 如果您不想再接收电子邮件，请“{% unsubscribe ‘click here’ %}”。 | 如果您不想再接收电子邮件， 单击此处。 |
或者，您可以使用“{% unsubscribe_link %}”标签生成取消订阅 URL。此标签仅创建取消订阅 URL，而不是生成完整链接的单词或短语。如果您想为取消订阅链接使用与模板样式中设置的链接颜色不同的颜色，或者使用链接按钮或图像而不是文本链接，请使用此标签。 | | |
| — | — |
|---|---|
| 标签 | 输出 |
这是一个奇特的<a href="{% unsubscribe_link %}" >取消订阅</a>链接。 | 这是一个奇特 取消订阅 链接。 |
当收件人单击取消订阅链接时，他们将进入可自定义的确认页面。
管理偏好设置
首选项页面允许收件人更新他们的首选项，从而使您能够更有效地细分和定位您的消息。要为每个收件人添加指向此页面的链接，请使用管理首选项标签。您可以创建特定列表和常规管理首选项页面。当您仅向一个列表发送消息时，会发送特定于列表的页面。当您发送到分段、列表组合以及非列表触发的流时，将使用常规管理首选项页面。详细了解管理首选项页面。对显示“管理首选项”的链接使用简单的管理首选项标签，或在引号中添加您自己的文本。 | | |
| — | — |
|---|---|
| 标签 | 输出 |
{% manage_preferences %} | 管理首选项 |
想要更新您的偏好设置吗？ {% manage_preferences '点击此处' %}。 | 想要更新您的偏好设置吗？点击这里。 |
或者，您可以使用“{% manage_preferences_link %}”标签生成管理首选项 URL。此标签不生成完整链接的单词或短语，而是仅创建收件人首选项页面的 URL。如果您想为链接使用与模板样式中设置的链接颜色不同的颜色，或者使用链接按钮或图像而不是文本链接，请使用此标签。 | | |
| — | — |
|---|---|
| 标签 | 输出 |
这是一个精美的<a href="{% manage_preferences_link %}" >管理首选项</a>链接。 | 这是一个奇特的 管理首选项 链接。 |
网页视图
要为收件人提供在 Web 浏览器中查看电子邮件的选项，您可以使用 Web 查看标签。 | | |
| — | — |
|---|---|
| 标签 | 输出 |
{% web_view %} | 在浏览器中查看 |
看不到这封电子邮件？ {% web_view '在浏览器中打开' %}。 | 看不到此电子邮件？ 在浏览器中打开。 |
这是一个精美的 <a href="{% web_view_link %}">网络视图</a> 链接。 | 这是一个奇特的 网页视图链接。 |
预览文本
在某些情况下，您可能希望在模板正文中显示预览文本。您可以使用标签“{% render_variable Preview_text %}”引用在电子邮件预览/设置屏幕上设置的任何预览文本。如果您更新电子邮件预览屏幕上的预览文本，此标签将显示您更新的预览文本。
自定义个性化和事件标签
自定义标签引用自定义个人资料属性（即，您收集的有关联系人的任何数据，除了特殊的 Klaviyo 属性和事件），例如某人的生日或联系人首选项。事件标签引用特定事件的数据（例如，下订单事件），并且只能在该事件触发的流程中使用。要添加自定义标签，请单击电子邮件文本字段中的“个性化”并找到该标签。要添加事件标签，请预览消息并从预览数据复制事件变量标签。或者，使用下面列出的格式手动将自定义标签添加到您的模板中。 | | | |
| — | — | — | ||||
|---|---|---|---|---|---|---|
| 标签格式 | 描述 | 示例 | ||||
{{ person.property_name }} | 一个简单的个人资料个性化标签 | {{ 人.生日}} | ||||
| `{{ person | lookup:’属性名称’ }}` | 如果属性名称包含空格或特殊字符，则配置文件个性化标签 | `{{ person | lookup:’最喜欢的颜色’ }}` | ||
{{ event.property_name }} | 一个简单的事件变量标签 | {{ event.URL }} | ||||
| `{{ event | lookup:’属性名称’ }}` | 事件变量标记，如果变量名称包含空格或特殊字符 | `{{ event | lookup:’$value’ }}` | ||
{{ event.property.nested_variable }} | 事件变量标记，如果事件变量嵌套在事件数据中 | {{ event.extra.checkout_url }} | ||||
| `{{ event | lookup:’属性名称’ | lookup:’嵌套变量名称’ }}` | 事件变量标记，如果事件变量嵌套在名称包含空格或特殊字符的另一个变量中 | `{{ event | lookup:’优惠券代码’ | lookup:’0′ }}` |
对不带空格或特殊字符的标签使用点 (.) 表示法。如果您的属性名称包含空格或特殊字符（例如 $），请使用查找符号。请注意，对于嵌套属性，如果一个属性名称使用查找表示法，则后面的所有属性也必须使用查找表示法。这意味着 event|lookup:'Collection Names'|lookup:'0' 是正确的，但 event|lookup:'Collection Names'.0 则不正确。
使用过滤器自定义标签
要自定义标签的显示方式，请应用模板过滤器。过滤器可用于应用标题大小写、设置数字的小数位数等等。两个最常见的过滤器是“default”和“title”。如果消息收件人没有设置该属性，“default”过滤器会设置显示的默认值。在下面的示例中，“朋友”和“美味佳肴”被设置为默认值，以防收件人的姓名或最喜欢的食物未在其 Klaviyo 个人资料中设置。 | | |
| — | — | |||
|---|---|---|---|---|
| 带有个性化标签的文本 | 输出 | |||
| 嘿`{{first_name | default:’朋友’}}，对一些{{person | lookup:’最喜欢的食物’ | default:’美味佳肴’}}`感兴趣吗？ | 嘿朋友，对一些美味佳肴感兴趣吗？ |
“title”过滤器允许您将标题大小写应用于任何文本标签，以确保在消息发送后它显示一致。例如，某些订阅者在填写您的注册表单时可能会使用全部大写或全部小写字母。如果没有过滤器，他们的名字将使用他们最初填写表单时使用的大小写。但是，标题过滤器会更正大小写，以便其名称正确显示。 | | |
| — | — | |
|---|---|---|
| 带有个性化标签的文本 | 输出 | |
| 嘿“{{first_name | title }}”，您看到我们最新推出的产品了吗？ | 嘿，Elise，您看到我们最新的发布了吗？ |
还有许多其他过滤器可用于您的消息。详细了解使用过滤器自定义标签。
日期标签
日期标签为您提供了一种将日期信息插入电子邮件的快速方法。该日期采用您帐户的时区，反映发送消息的日期或时间。 {{ Today }} 标签是最常见的日期标签之一，它在发送消息时填充时间戳。要使用 Today 标签，请将以下代码行粘贴到您的模板中：
{% 今天 "%Y-%m-%d" 作为今天 %} {{ 今天 }}
请注意，使用“{{ Today }}”标签而不使用前面的代码将不会呈现任何内容；完整的代码行是必要的。要了解如何使用或自定义日期标签，请参阅我们关于[模板中的日期标签]的文章(https://help.klaviyo.com/hc/en-us/articles/115005257788-How-to-Format-Date-Variables-in-Templates)。
货币标签
下订单、添加到购物车等事件数据通常具有与其相关的财务价值（例如，产品的价格或客户购物车的价值）。使用 {%currency\_format … %} 标签将您所在国家/地区的货币格式应用于该值。例如，请考虑下面的 Started checkout 指标中的 $value 字段：
仅使用变量 {{ event|lookup:”$value” }}，此属性将仅显示一位小数，且电子邮件中不包含货币符号：
但是，使用货币格式标记 {%currency\_format event|lookup:”$value” %}，数字将显示为货币符号和正确的小数位数：
要使用货币格式标记，请将 {%currency\_format PLACEHOLDER %} 中的占位符文本替换为您的变量。例如，如果您的变量是 {{ event.item.price }}，则完整的货币格式标记将为 {%currency\_format event.item.price %}。如果您的标签包含过滤器（例如，属性为空时的默认值），请将这些过滤器也包含在标签中：{%currency\_format event.item.price|default:”0” %}。
如何选择国家/地区
您可以在 2 个位置设置消息的货币格式：
- 对于您的整个帐户
导航到设置 > 组织 > 组织语言和区域格式，然后选择 组织语言。 – 针对特定消息 从该模板的 货币 部分的 样式** 选项卡中为单条消息选择不同的货币格式。
货币\_format 标签故障排除
此标签仅支持数字变量（例如 10、24.56）。包含货币符号的属性（例如 $40、$76.30）是字符串，currency\_format 标记无法更改它们。
条件语句
条件标签允许您在邮件中为满足特定条件的收件人包含内容，而不为其他收件人包含内容。它们为您提供了强大的控制功能，可以为每个收件人个性化您的消息。
如果语句
If 语句允许您根据个人资料或事件数据控制某人接收的内容。在下面的示例中，如果用户的忠诚度积分超过 150，则会显示第一行文本。如果少于 150 但多于 0，他们将看到第二行。如果他们没有忠诚度积分，他们将看到第三条消息。 ““ {% if person|lookup:’忠诚度积分’ > 150 %} 嘿贵宾！您始终享有免费送货和免费退货服务 {% elif person|lookup:’忠诚度积分’ > 0 %} 您有 {{ person|lookup:’Loyalty Points’ }} 积分，只需 150 点即可成为 VIP！ {%其他%} 您听说过我们的 VIP 计划吗？今天加入我们的网站即可开始赚取奖励。 {% 结束 %}
在 if 语句中，需要初始条件“{% if ... %}”以及结束标记“{% endif %}”。所有其他元素（即“{% elif %}”和“{% else %}”标签）都是可选的。您可以使用无限数量的“{% elif %}”标签，后跟最多一个“{% else %}”标签。每个电子邮件收件人只会看到他们有资格收到的第一封邮件。
### 对于语句
“For”块允许您迭代存储列表的变量中的每个项目并单独渲染它们。下面是一个示例语句：
| | |
| --- | --- |
| `{% for item in event.shopping_cart_items %}{{ item.name }} × {{ item.quantity }} {% endfor %}` | **超大沙滩毯 × 1** **沙滩椅 × 4** **SPF 防晒霜 × 2** **塑料冰柜 × 1** |
每个 **For** 语句必须包含以下内容：
- 一个开放的“{% for ... %}”标签，包含行别名（上例中的**item**）和行集合（上例中的**event.shopping\_cart\_items**）
- 结束`{% endfor %}`标签
在两个必需的标签之间，您可以包含任何您想要的文本。要包含嵌套在行集合中的变量，请将变量名称的开头（行集合加上行集合后面的数字）替换为行别名。例如，变量“{{ event.shopping_cart_items.0.name }}”将变为“{{ item.name }}”。
### 条件语句和内联文本编辑器
当您将某些条件语句添加到文本块时，它们可能会从内联文本编辑器中消失。代码仍然存在；它只是被隐藏了。要查看和编辑条件语句，请打开文本块的 **源代码** 字段。以下标签仅在文本块的 **源代码** 字段中可见：
- {% 为 ... %}
- {% endfor %}
- {% 如果...%}
- {% elif ... %}
- {%其他%}
- {% endif %}
- {% 与 ... %}
- {% 结尾为 %}