AMP

AMP 电子邮件基础知识

Important: this documentation is not applicable to your currently selected format stories!

如果您熟悉 AMP,这再好不过了!AMP 电子邮件只是 AMP HTML 库的一部分。如果您不熟悉 AMP,也是一件好事!本指南将向您介绍在开始编写有效的 AMP 电子邮件时需要知道的所有知识!

所需标记

AMP 电子邮件与传统 HTML 电子邮件看起来很像,但存在几点区别。以下列出了在让电子邮件成为有效的 AMP 电子邮件时所需的最少量标记。

<!DOCTYPE html>
<html 4email data-css-strict>
  <head>
    <meta charset="utf-8" />
    <script async src="https://cdn.ampproject.org/v0.js"></script>
    <style amp4email-boilerplate>
      body {
        visibility: hidden;
      }
    </style>
  </head>
  <body>
    Hello, AMP4EMAIL world.
  </body>
</html>

支持 AMP 电子邮件的电子邮件服务提供商已设置安全检查,旨在确保用户获得安全愉悦的体验。使用 AMP 构建电子邮件必须满足以下所有要求:

  • <!doctype html> 文档类型开头。这也是 HTML 的标准。
  • 包含顶级 <html amp4email> 标记或 <html ⚡4email> 标记(如果电子邮件格外酷)。这可以将文档标识为 AMP 电子邮件,从而以相应方式对待该文档。
  • 定义 <head><body> 标记。这一点在 HTML 中为可选项,但 AMP 保留了原始做法!
  • 包括 <meta charset="utf-8> 标记,作为 <head> 标记的第一个子级。这样可以标识网页的编码。
  • 利用放在 <head> 中的 <script async src="https://cdn.ampproject.org/v0.js"></script> 标记导入 AMP 库。只有包括此标记,才能让通过 AMP 获得的炫酷动态功能起作用!最佳做法是,应该尽早在 <head> 中添加此标记,直接放在 <meta charset="utf-8"> 标记下方。
  • 最初隐藏电子邮件内容,直到在 <head> 中放置 AMP 电子邮件样板来加载 AMP 库。
<head>
  ...
  <style amp4email-boilerplate>
    body {
      visibility: hidden;
    }
  </style>
</head>

AMP 特有的标记替换

由于 AMP 电子邮件库是 AMP HTML 库的一部分,许多相同的规则均适用;AMP 特有的标记会替换占用较多资源的 HTML 标记,并且需要定义的宽度和高度。这样,AMP 样板便可隐藏内容,直到它知道自己在用户设备上的显示情况。

图片

为了有效绘制网页,所有 <img> 标记均会替换为 <amp-img><amp-img> 标记需要定义的宽度和高度,并且支持 AMP 的布局系统

<amp-img src="https://link/to/img.jpg"
    width="100"
    height="100"
    layout="responsive">
</amp-img>

<amp-img> 标记本身可以强有力地控制自适应设计并设置后退。

详细了解 AMP 布局和媒体查询的使用以及如何设置图片后备

GIF

AMP 为 GIF 图片创建了一个特殊标记 <amp-anim>,如果动画离屏,该标记允许 AMP 运行时降低 CPU 占用率。与 <amp-img> 类似,该标记的宽度和高度已定义,该元素必须包括结束标记。

<amp-anim
    width="400"
    height="300"
    src="my-gif.gif">
</amp-anim>

此外,该标记还支持在加载 src 文件时显示可选的 placeholder 子级,并且支持 AMP 布局系统。

<amp-anim width=400 height=300 src="my-gif.gif" layout="responsive">
  <amp-img placeholder width=400 height=300 src="my-gif-screencap.jpg">
  </amp-img>
</amp-anim>

具有样式的电子邮件

与所有电子邮件客户端一样,AMP 支持内嵌 style 属性,此外,也支持将 CSS 放在电子邮件 head 的 <style amp-custom> 标记中。

...
<style amp-custom>
  /* any custom styles go here. */
  body {
    background-color: white;
  }
  amp-img {
    border: 5px solid black;
  }
</style>
...
</head>

与 HTML 电子邮件一样,AMP 电子邮件支持一组有限的 CSS 选择器和属性。

有关支持 AMP 且允许在所有电子邮件客户端上使用的完整 CSS 列表,请参阅 AMP 电子邮件支持的 CSS

AMP 要求样式的最大大小为 75,000 字节。

允许使用的 AMP 组件

AMP 组件的动态性、生动性和互动性是 AMP 电子邮件对未来电子邮件的展望。

AMP 电子邮件中支持的完整组件列表作为 AMP 电子邮件规范的一部分提供 。

身份验证请求

动态的个性化电子邮件内容通常要求对用户进行身份验证。但是,为了保护用户数据,在 AMP 电子邮件中发出的所有 HTTP 请求均可进行代理并移除 Cookie。

为了对 AMP 电子邮件发出的请求进行身份验证,可以使用访问令牌。

访问令牌

您可以使用访问令牌来验证用户身份。访问令牌由电子邮件发件人提供和检查。发件人使用令牌来确保只有有权访问 AMP 电子邮件的用户才能发出该电子邮件中包含的请求。访问令牌必须受密码保护,并且使用时间和范围受限。这些令牌包括在请求网址中。

以下示例阐述了使用 <amp-list> 来显示经过身份验证的数据:

<amp-list
  src="https://example.com/endpoint?token=REPLACE_WITH_YOUR_ACCESS_TOKEN"
  height="300"
>
  <template type="amp-mustache"> ... </template>
</amp-list>

同样,在使用 <amp-form> 时,需要将访问令牌放在 action-xhr 网址中。

<form
  action-xhr="https://example.com/endpoint?token=REPLACE_WITH_YOUR_ACCESS_TOKEN"
  method="post"
>
  <input type="text" name="data" />
  <input type="submit" value="Send" />
</form>

示例

以下示例假设有一项假想的记事服务,用于让登录用户在其帐户中添加备注并在以后查看这些备注。该服务想要向用户 jane@example.com 发送电子邮件,其中包括她以前添加的备注列表。当前用户的备注列表可以在端点 https://example.com/personal-notes 上以 JSON 格式提供。

在发送电子邮件之前,该服务为 jane@example.com: A3a4roX9x 生成一个受密码保护且使用受限的访问令牌。该访问令牌位于网址查询的字段名 exampletoken 中:

<amp-list
  src="https://example.com/personal-notes?exampletoken=A3a4roX9x"
  height="300"
>
  <template type="amp-mustache">
    <p></p>
  </template>
</amp-list>

端点 https://example.com/personal-notes 负责验证 exampletoken 参数并查找与令牌关联的用户。

使用受限的访问令牌

借助使用受限的访问令牌,可以防止请求仿冒和重放攻击,确保操作是由收到邮件的用户执行的。此保护的实现方式是,将唯一的令牌参数添加到请求参数,并在调用操作时对该令牌参数进行验证。

令牌参数应当作为密钥生成,该密钥只能用于特定操作和特定用户。在执行所请求的操作之前,您应当检查以确认该令牌有效并与您为用户生成的令牌一致。如果令牌一致,则可执行操作并且该令牌不适用于以后的请求。

访问令牌应当放在 HttpActionHandler 的网址属性中发送给用户。例如,如果您的应用在 http://www.example.com/approve?requestId=123 上处理审批请求,您应当考虑在其中另外添加 accessToken 参数,并侦听发送到 http://www.example.com/approve?requestId=123&accessToken=xyz 的请求。

您必须提前生成 requestId=123accessToken=xyz 的组合,确保无法从 requestId 推导出 accessToken。只要审批请求具有 requestId=123,但没有 accessToken 或者 accessToken 不等于 xyz,都应该遭到拒绝。此请求通过后,以后具有相同 ID 和访问令牌的请求也应该遭到拒绝。

在不同的电子邮件客户端上进行测试

支持 AMP 电子邮件的电子邮件客户端本身会提供文档和测试工具,帮助您进行集成。

有关详细信息以及电子邮件客户端特定的文档链接,请参阅测试 AMP 电子邮件