Reach

Grow

Manage

Automate

Reach

Grow

Manage

Automate

G

G

M

M

外部 Data Sources

将外部动态数据引入html

概览

概览

概览

将外部数据源集成到电子邮件模板中可以实现高度个性化和动态的内容,从而提高参与度和相关性。本指南将引导您设置外部数据源并在您的电子邮件模板中使用它们。

外部数据源通过从外部API提取信息为您的电子邮件模板提供动态内容。这对于以下情况很有用:

  • 基于外部源个性化内容

  • 显示实时数据,例如从API获取的航班状态

  • 通过传递参数并通过外部工具获取最终链接来自定义链接

创建一个外部数据源

  • 导航至Marketing应用并点击Content

  • 在Content下,点击External data sources > Create External Data Source


  • 您可以为其命名。这个名称应该是一个没有空格的连续字符串

  • 提供您的API链接

  • 定义您是希望内容动态更新还是在添加到电子邮件后手动刷新并且不希望其更新。

  • 您可以选择不使用身份验证或定义身份验证类型,还可以添加任何标头


  • 一旦点击Save Configuration,外部数据源就会被创建

  • 创建后,您可以通过点击下面所示的Test Config来测试您的配置以查看获得的输出。

  • 导航至Marketing应用并点击Content

  • 在Content下,点击External data sources > Create External Data Source


  • 您可以为其命名。这个名称应该是一个没有空格的连续字符串

  • 提供您的API链接

  • 定义您是希望内容动态更新还是在添加到电子邮件后手动刷新并且不希望其更新。

  • 您可以选择不使用身份验证或定义身份验证类型,还可以添加任何标头


  • 一旦点击Save Configuration,外部数据源就会被创建

  • 创建后,您可以通过点击下面所示的Test Config来测试您的配置以查看获得的输出。

  • 导航至Marketing应用并点击Content

  • 在Content下,点击External data sources > Create External Data Source


  • 您可以为其命名。这个名称应该是一个没有空格的连续字符串

  • 提供您的API链接

  • 定义您是希望内容动态更新还是在添加到电子邮件后手动刷新并且不希望其更新。

  • 您可以选择不使用身份验证或定义身份验证类型,还可以添加任何标头


  • 一旦点击Save Configuration,外部数据源就会被创建

  • 创建后,您可以通过点击下面所示的Test Config来测试您的配置以查看获得的输出。

在电子邮件中使用外部数据源


一旦正确设置了外部数据源,您可以使用其输出在电子邮件模板中使用液态模板语言。

使用外部数据源来获取内容

为了显示内容提要,您可以创建一个API,它以json格式提供多个内容提要项。示例如下:

{
  "feed": {
    "version": "1.0",
    "title": "sample-data-feed",
    "items": [
      {
        "title": "Meet the Full Cast",
        "link": "https://bird.com/article",
        "description": "See who's joining previously announced stars Katie Brayben and Christian Borle in the Elton John-Jake Shears-James Graham musical.",
        "thumbnail": "https://assets.bird.com.jpg",
        "date": "2024-08-28T11:21:00",
        "creator": "Joe Black"
      },
      {
        "title": "Stars in ASL American",
        "link": "https://bird.com/article",
        "description": "Center Theatre Group is teaming up with Deaf West Theatre to reopen the Mark Taper Forum with a new production of the Green Day musical after bringing revivals of Big River and Spring Awakening to Broadway.",
        "thumbnail": "https://assets.bird.com.jpg",
        "date": "2024-08-28T11:59:00",
        "creator": "Joe Black"
      }
    ]
  }
}

上面的json提要可以在创建外部数据源时用作API URL。

创建后,您可以在电子邮件模板中引用它,如下所示:

  1. 首先添加一个html元素,并添加以下代码以通过名称获取外部数据源,即 {% datafetch "external-data-source-name" %}

  2. 在液态语言中使用for函数获取提要中的所有项目及其路径,即{% for <your-item> in dataFetchResponse.<your-json-path> %}。

如果您只有一个项目,则可能不需要这样做

假设sample-data-feed是外部数据源的名称,feed.items是在json提要中获取项目的路径,它看起来如下:

{% datafetch "sample-data-feed" %}
{% for item in dataFetchResponse.feed.items %}



  • 添加此项后,您可以添加任何图像、文本、按钮元素,并假设sample-data-feed结构如下来引用外部数据源:

{{item.title}} - 在文本元素中显示标题

{{item.description}} - 在文本元素中显示描述

{{item.link}} - 在按钮元素中添加链接

{{item.thumbnail}} - 在图像元素中添加图像URL源

  • 现在添加另一个html块以结束外部数据源的获取和for 函数,示例如下

{% endfor %}
{% enddatafetch %}

要预览您的电子邮件,您可以切换到预览,查看内容提要的外观

注意:如果您有一个静态提要,可以在此手动刷新,通过在刷新外部数据源下拉菜单中选择外部数据源来进行。

使用外部数据源以自定义URLs

您还可以在API URL中使用外部数据源和变量。这有助于向外部API传递任何参数,并返回响应以添加到电子邮件模板中

例如,您可以使用如下所示的API URL传递变量

https://api.bird.com/workspaces/?email={{email}}&referenceId={{referenceId}}&locale={{locale}}&name={{name}}

要在电子邮件模板中使用此外部数据源,您必须在liquid标签中提供变量的值:

  • 将第一个html元素添加为 {% datafetch "name", "variable1", "variable1 value", "variable2, "variable2 value" %}

在下面的示例中,第一行避免了当电子邮件地址中有+号时引发的问题。第二行实际上启动了含变量的外部数据流。您可以给出静态值如 "value",或者可以提供变量引用如contact.attributes.userId。

{%- assign email_for_datafetch = contact.attributes.email_address | url_encode -%}
{% datafetch "GenerateLink","email", email_for_datafetch,"referenceId", contact.attributes.userId, "locale", contact.attributes.locales[0],"name", contact.attributes.name %}

GenerateLink是上述外部数据源的名称。

  • 要渲染定制化链接,您可以使用一个按钮元素,链接定义为{{dataFetchResponse.url}},其中url包含来自您的API的响应


之后,添加如下的结束html元素:

{% enddatafetch %}

让我们为您联系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 的最新动态。