Reach

Grow

Manage

Automate

Reach

Grow

Manage

Automate

G

G

M

M

Lookup Tables

如何使用查找表

概览

概览

概览

查找表是您存储数据的一种方式,您随后可以在模板流程旅程中使用这些数据。通过仪表板创建查找表,然后动态引用这些表中的数据。

Bird中查找表存储并集中管理数据引用,可以在使用Liquid模板语言创建电子邮件模板时查找这些数据。

例如,每个国家的旗帜、缩写或货币可以作为查找表存储和更新。在构建电子邮件时,每次使用它时都可以从这个查找表中引用。

重要限制:

  • 每个表最多可以存储10个单独的数据项。

  • 每个项目可能包含多达约300kB的数据。

创建一个Lookup Table

前往内容 > 查找表并点击创建。

  • 输入显示名称

  • 输入不含空格的 slug



Slug 用于引用此表,并且只能包含字母数字字符。注意,这个 slug 用于引用电子邮件模板

  • 点击保存



在表中创建项目

点击您已创建的表

从弹出的上下文菜单中选择“查看”



表中的每个项目本质上都是一个 JSON 文档。这意味着您可以构建一个键值对的树结构,其中值可以是文本、数字、布尔值、数组或对象本身。您可以直接输入 JSON 文档,使用 JSON 语法,或者您可以使用 UI 编辑器构造 JSON 文档。

JSON 编辑器

  • 保存后,您将看到一个 JSON 编辑器。您可以根据自己的喜好选择文本或 UI 编辑器。

  • 使用 JSON 结构更新查找表。

添加项目

要在组织中添加 JSON 项目,请在左侧窗格中点击 +Add Item。

  • 在顶部输入名称

  • 点击 Add Item 按钮

  • 创建后,您可以在左侧窗格中看到创建的项目。

编写 JSON

使用 JSON 格式定义任何对象结构和键值对:

例如,一个 JSON 提供基于国家缩写的国家名称和本地货币

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

您还可以使用 UI 编辑器定义 JSON 结构。


前往内容 > 查找表并点击创建。

  • 输入显示名称

  • 输入不含空格的 slug



Slug 用于引用此表,并且只能包含字母数字字符。注意,这个 slug 用于引用电子邮件模板

  • 点击保存



在表中创建项目

点击您已创建的表

从弹出的上下文菜单中选择“查看”



表中的每个项目本质上都是一个 JSON 文档。这意味着您可以构建一个键值对的树结构,其中值可以是文本、数字、布尔值、数组或对象本身。您可以直接输入 JSON 文档,使用 JSON 语法,或者您可以使用 UI 编辑器构造 JSON 文档。

JSON 编辑器

  • 保存后,您将看到一个 JSON 编辑器。您可以根据自己的喜好选择文本或 UI 编辑器。

  • 使用 JSON 结构更新查找表。

添加项目

要在组织中添加 JSON 项目,请在左侧窗格中点击 +Add Item。

  • 在顶部输入名称

  • 点击 Add Item 按钮

  • 创建后,您可以在左侧窗格中看到创建的项目。

编写 JSON

使用 JSON 格式定义任何对象结构和键值对:

例如,一个 JSON 提供基于国家缩写的国家名称和本地货币

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

您还可以使用 UI 编辑器定义 JSON 结构。


前往内容 > 查找表并点击创建。

  • 输入显示名称

  • 输入不含空格的 slug



Slug 用于引用此表,并且只能包含字母数字字符。注意,这个 slug 用于引用电子邮件模板

  • 点击保存



在表中创建项目

点击您已创建的表

从弹出的上下文菜单中选择“查看”



表中的每个项目本质上都是一个 JSON 文档。这意味着您可以构建一个键值对的树结构,其中值可以是文本、数字、布尔值、数组或对象本身。您可以直接输入 JSON 文档,使用 JSON 语法,或者您可以使用 UI 编辑器构造 JSON 文档。

JSON 编辑器

  • 保存后,您将看到一个 JSON 编辑器。您可以根据自己的喜好选择文本或 UI 编辑器。

  • 使用 JSON 结构更新查找表。

添加项目

要在组织中添加 JSON 项目,请在左侧窗格中点击 +Add Item。

  • 在顶部输入名称

  • 点击 Add Item 按钮

  • 创建后,您可以在左侧窗格中看到创建的项目。

编写 JSON

使用 JSON 格式定义任何对象结构和键值对:

例如,一个 JSON 提供基于国家缩写的国家名称和本地货币

{

 "NL": {

   "countryname": "Netherlands",

   "local_currency": "EUR"

 },

 "US": {

   "countryname": "United States",

   "local_currency": "USD"

 }

}

您还可以使用 UI 编辑器定义 JSON 结构。


在电子邮件模板中使用 Lookup Table


要在电子邮件模板中使用查找表,可以将以下 liquid 语法添加到您的 HTML 模板或拖放生成器中使用的 HTML 元素中:

{% assign variable_name = "lookup-table-slug" | lookup: "item-name", "object-value" %}

{{variable_name.key_name}}

在这里,

  • variable_name 是您可以定义的任何名称

  • lookup-table-slug 是您在创建查找表时指定的 slug

  • item-name 是您创建的项目的名称

  • object-value 是您为 JSON 项目指定的值

  • key_name 是在 item-value 下定义的键值对中的键的名称

例如,

要呈现已定义国家的本地货币,我们可以使用以下语法

  • variable_name 在这里被定义为 currency(用户可以定义的任何名称)

  • lookup-table-slug 在这里是 country-flags,这是创建查找表时定义的

  • item-namecountry,如先前创建并在左侧窗格中显示

  • object-value AD, 这是在 JSON 中定义的值 请注意,这也可以是变量

  • key_name 是定义在 JSON 中的 local_currency

{% assign currency = "country-flags" | lookup: "country", "AD" %}

{{currency.local_currency}}

当在电子邮件模板生成器中的 HTML 块中使用时,上述语法将呈现查找表 country-flags 中 country 项下 AD 对象中存储的 local_currency 的值

您可以切换到预览部分,以动态查看电子邮件模板中显示的输出值。下方显示的是从查找表中获取的 EUR 值。

在Flows中使用查找表

您可以在Flows中读取查找表,以重用集中定义的数据。

要使用查找表,请先如上所述创建一个。

  1. 导航到Workflows > Flows

  2. 使用您选择的触发类型创建初始流。

向您的流中添加一个新的执行查找步骤。单击添加新操作,然后从查找表组中选择它,或使用右侧的搜索功能搜索它:



系统将显示一个配置屏幕,您可以在其中选择要读取的表并配置确切的查找执行方式:



您将看到可以配置的三个组件:

  1. 查找表 Slug 指示您要查看哪张表。点击此字段,Flows将显示可用的查找表:

  1. 查找 让您决定检索什么,并可以使用可用的各种变量来构建此查找键。默认操作是返回您的查找指向的值作为根级值,但如果您想创建一个数据对象,可以使用As功能将其加载到特定属性中:

  1. 替换 使您可以用静态值或在查找表的某处定义的值替换返回的查找结果中的变量。以下示例将用在键 replacements.<locale>.MyVariableName下找到的值替换任何通过查找操作返回的项目中的文本{{ MyVariableName }}

然后点击测试按钮可以让您查看结果数据:


配置要读取的表是必需的,您必须添加至少一个查找操作。不需要添加任何替换操作。


让我们为您联系Bird专家。
在30分钟内见证Bird的全部威力。

通过提交,您同意 Bird 可能会就我们的产品和服务与您联系。

您可以随时取消订阅。查看Bird的隐私声明以获取有关数据处理的详细信息。

Newsletter

通过每周更新到您的收件箱,随时了解 Bird 的最新动态。

让我们为您联系Bird专家。
在30分钟内见证Bird的全部威力。

通过提交,您同意 Bird 可能会就我们的产品和服务与您联系。

您可以随时取消订阅。查看Bird的隐私声明以获取有关数据处理的详细信息。

Newsletter

通过每周更新到您的收件箱,随时了解 Bird 的最新动态。

让我们为您联系Bird专家。
在30分钟内见证Bird的全部威力。

通过提交,您同意 Bird 可能会就我们的产品和服务与您联系。

您可以随时取消订阅。查看Bird的隐私声明以获取有关数据处理的详细信息。

R

Reach

G

Grow

M

Manage

A

Automate

Newsletter

通过每周更新到您的收件箱,随时了解 Bird 的最新动态。