Sign inGet Started

邮件日志

邮件日志记录工作区发送的每条消息。打开 Email > Emails,最新的消息显示在最前面。用它确认消息已被接受、跟踪每个收件人的投递状态,以及在启用内容存储时检查已存储的内容。

邮件日志是聚合指标页面的补充。指标页面显示所有发送的整体比率,而日志显示单条消息。如需仪表板概览,请参阅仪表板导览。

该页面的 Receiving 标签页是接收邮件的同类日志,详见接收邮件。

仪表板中的 Emails 页面:一张已发送消息表格,包含状态、发件人、收件人、主题、类别和发送时间,以及收件人搜索和状态、类别、日期筛选器

消息列表

每行代表一条消息。各列如下:

列显示内容
Status消息当前的投递状态(参见状态说明)
From发件人:显示名称和地址,或仅地址
To主要收件人;多收件人发送时显示数量,悬停可展开
Subject消息主题;选中该行可打开消息
Category消息类别:TXN 代表事务性消息,MKTG 代表营销消息
Sent发送被接受的时间,显示为相对时间(悬停查看精确时间戳)

查看 Bounced、Complained、Rejected 和 Partial failure 结果。Deferred 表示自动重试。列表分页显示;使用 Prev 和 Next 在页面间切换。

搜索和筛选

消息日志增长很快,因此页面顶部提供一个搜索框和三个筛选器。它们可以组合使用:状态筛选加日期范围会缩小到同时满足两者的消息。

按收件人搜索。 搜索框匹配精确的收件人邮箱地址。输入完整的发送地址,例如 jane@example.com。结果包含通过 to、cc 或 bcc 发送到该地址的所有消息。精确匹配不包括部分地址和域名。

状态。 按单个投递状态筛选。可选项即状态说明中列出的状态。

类别。 筛选 Transactional 或 Marketing 消息。

日期。 按消息发送时间筛选:选择预设(Last 3 days、Last 7 days、Last 30 days)或从日历中选择自定义范围。

当筛选条件组合没有匹配结果时,页面显示 No emails match your filters 状态,并提供 Clear filters 操作以重置回完整列表。

状态说明

消息的状态是其所有收件人在投递生命周期中所处位置的汇总。对于单收件人消息,状态直接反映该收件人的状态。对于多收件人发送,状态反映消息整体情况:Partial failure 表示部分收件人成功、部分失败。

状态含义
Scheduled发送设有未来的发送时间,尚未开始。参见定时发送。
Accepted发送已被接受,正在准备投递。
Processed消息已构建并排队等待投递。
Delivered收件人的邮件服务器已接受该消息。
Deferred临时失败。我们会自动重试,最终变为已投递或已退回。
Bounced永久失败。收件人的邮件服务器拒绝了该消息。
Complained收件人将该消息举报为垃圾邮件。
Rejected发送在尝试投递之前被拒绝,最常见的原因是收件人已被屏蔽。
Partial failure多收件人发送中,不同收件人的结果不同。
Canceled定时发送在发出前被取消。

检查消息

选中一行可在侧面板中打开消息。面板包含 Events、Details、HTML 和 Text 标签页。使用箭头可在不关闭面板的情况下切换消息。定时消息会显示其发送时间和取消操作。定时发送涵盖该流程。

仪表板中的邮件详情侧面板,显示 Events 时间线(包含 accepted、processed 和 delivered 条目),以及一行说明此域名未启用跟踪因此不显示打开事件

事件

默认标签页是按收件人排列的时间线,按顺序显示消息发生的所有事件及其时间戳。这与邮件事件参考中描述的事件流相同,此处针对单条消息呈现:Accepted → Processed → Delivered。之后是互动事件(如 Opened 和 Clicked)或失败事件(如 Bounced、Deferred、Complained 和 Rejected)。

  • 对于多收件人发送,All recipients 选择器可用于查看合并时间线或筛选到某个收件人的事件历程。
  • 失败事件会内联显示详情:退回事件显示其描述,拒绝事件显示其原因。
  • 由收件箱隐私代理自动获取的 Opened 事件会被标记为非真实打开,与打开跟踪处理预取的方式一致。
  • 当某个事件自动将收件人添加到你的屏蔽列表(硬退回或投诉)时,时间线会注明并链接到该列表。
  • 当消息仍在投递中时,时间线每隔几秒自动刷新,直到每个收件人都达到最终状态。

如果已投递的消息没有打开或点击事件,时间线会说明原因:最常见的是域名未启用打开和链接跟踪,或发送时未请求跟踪。

详情

Details 标签页显示消息的元数据:

  • Message ID。
  • From、To 以及任何 CC、BCC 或 Reply-To 地址。
  • 发送域名。
  • 类别。
  • 是否启用了 Open tracking 和 Link tracking。
  • Sent 和 Delivered 时间戳。

你在发送时设置的任何标签和元数据也会列在此处,附件会显示其大小、类型和下载操作。大多数字段可一键复制。

HTML 和 Text

HTML 标签页渲染已存储的 HTML。其 Preview 子标签页在沙盒框架中显示消息,Source 显示原始 HTML。Text 标签页显示已存储的纯文本正文。发送后不久,这些标签页可能显示内容仍在存储中。如果消息未启用内容存储,则无正文可用。

通过 API 访问相同的日志

此页面上的所有内容均读取自 GET /v1/email/messages 及其子资源。列表接受页面提供的相同筛选器,以及更多:

  • status。
  • category。
  • tag。
  • 精确的 to 或 from 地址(裸地址,不区分大小写匹配)。
  • 一个 created_after/created_before 时间窗口。

每条消息的详情位于 recipients、events 和 content 子资源上。事件参考介绍了如何以编程方式读取时间线。

后续步骤

  • 邮件指标:所有发送的聚合统计数据,以及打开和点击跟踪的工作方式
  • 邮件事件:时间线所基于的完整的每收件人事件词汇表
  • 屏蔽:收件人被拒绝的原因以及如何管理屏蔽列表
  • 发送邮件:发送载荷,包括标签、类别和跟踪开关
  • API 参考:消息:以编程方式读取消息、收件人和事件