---
title: 邮件追踪
description: 统计邮件的打开和点击，添加 UTM 参数，并用你自己的域名提供追踪链接。
seo:
  title: 邮件追踪（打开与点击）
ai:
  exclude: true
---

BillionSend 可以记录收件人何时打开了邮件，或点击了邮件中的链接。邮件追踪按 [域名](/docs/zh-hans/concepts/domains) 设置，默认关闭：关闭时，你的链接和 HTML 会原样发出。

## 开启邮件追踪

在控制台中，打开域名并进入它的 **链接** 标签页：

- **追踪点击** 会改写每个链接，让它经过追踪主机，由追踪主机记录点击，再把收件人送到你的原始 URL。对应的事件是 `email.clicked`。
- **追踪打开** 会在 HTML 中加入一张 1×1 的透明图片。图片加载时，对应的事件是 `email.opened`。
- **改写纯文本部分的链接** 也会追踪纯文本版本中的链接。它需要先开启点击追踪。

通过 API，在域名上使用 `click_tracking` 和 `open_tracking`：

```bash
curl -X PATCH https://api.billionsend.com/domains/$DOMAIN_ID \
  -H "Authorization: Bearer $BILLIONSEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "click_tracking": true, "open_tracking": true }'
```

说明：

- 只有 `http` 和 `https` 链接会被追踪。`mailto:` 和 `tel:` 链接以及退订链接不会被改动。
- 每个事件都会显示在邮件的时间线上，也可以发送到 [Webhook](/docs/zh-hans/concepts/webhooks)。
- 从面向真人的 [收件箱](/docs/zh-hans/inboxes) 发出的邮件永远不会被追踪。

## UTM 参数

在 **链接** 标签页中设置 `utm_source`、`utm_medium` 和 `utm_campaign`，BillionSend 会把它们加到每个尚未带有这些参数的追踪链接上。值中的 `{{broadcast_name}}` 代表群发的名称。事务邮件没有群发，所以使用它的值会被省略。UTM 参数作用于被追踪的链接，所以必须开启点击追踪。

## 打开数据有多可靠

打开只是一个参考信号，不是精确的计数。

- **预取不是打开。** Apple Mail 会在后台下载所有图片，Gmail 会在收件箱打开时加载图片，安全扫描器会在邮件送达后几秒内获取图片。这些都记录为 **预取**。它们会显示在时间线上，并在打开率下方单独一行显示，但永远不会计为打开，也不会发送 `email.opened`。Webhook 可以选择订阅 `email.prefetched`。
- **点击算作打开。** 如果有人点击了链接，他一定看过这封邮件。点击到达时如果还没有打开记录，BillionSend 会同时记录一次打开。对 Apple Mail 上的收件人来说，这往往是你能看到的唯一一次打开。
- **机器点击不算点击。** 扫描器会在邮件送达后立刻访问其中的每个链接。BillionSend 能识别它们，并且不计入。
- **打开数会偏低**，当收件人屏蔽图片、邮件没有 HTML 部分，或 Gmail 截断了超过约 102 KB 的邮件时。

点击是更可靠的信号。对收据、密码重置这类纯事务邮件，可以考虑关闭打开追踪。

## 追踪主机

追踪链接和打开图片由追踪主机提供：

- **共享主机。** 默认是 `t.billiondns.com`，所有团队共用。所有套餐都可使用，Free 套餐只能用它。
- **你自己的子域名。** 用 `links.example.com` 或你域名下的任意名称来提供。这样链接与你的发信域名一致，有助于建立信任。需要付费套餐。

### 设置自己的子域名

1. 在域名的 **链接** 标签页中，输入一个标签，例如 `links`。使用 API 时，在 `POST /domains` 或 `PATCH /domains/{id}` 上发送 `tracking_subdomain`。空字符串会清除它。
2. 添加 **DNS** 标签页中显示的 CNAME：`links.example.com` 指向 `cname.billiondns.com`。在 Cloudflare 上，要保持 **仅 DNS**（灰色云朵），否则无法验证。
3. 等待几分钟。CNAME 解析生效后，会自动签发 HTTPS 证书。如果你的域名有 CAA 记录，它们必须允许 Let's Encrypt 和 Google Trust Services。

子域名的状态会从 **待处理** 变为 **已启用**（域名上的 `tracking_status`）。在此之前，链接使用共享主机，域名显示为 **部分完成**：发送已验证，自有主机尚未生效。如果 72 小时内仍未激活，它会显示 **失败**，原因在 `tracking_error` 中。修正 CNAME 后点击 **重试**，或重新发送同一个标签。

需要了解：

- 标签不能与域名的 return-path 子域名相同。
- 广告拦截器会拦截追踪主机名。请给 [退订](/docs/zh-hans/concepts/unsubscribes) 子域名使用不同的标签，这样退订链接不会一并被拦截。使用相同的标签也可以，此时一条 CNAME 同时服务两者。
- 你的主机只提供你域名的链接。如果你更改子域名或删除域名，已经通过旧主机发出的链接会失效。
- Free 团队不能设置新的自有子域名：返回 `403 plan_limit_reached`。已经设置的子域名在降级后仍然有效。

使用你自己追踪主机的邮件，在 [送达率洞察](/docs/zh-hans/concepts/deliverability-insights) 中的得分也更高。

## 套餐

| | Free | Starter、Pro 和 Scale |
| --- | --- | --- |
| 打开与点击追踪 | 支持 | 支持 |
| UTM 参数 | 支持 | 支持 |
| 追踪主机 | 仅共享主机 | 共享主机，或你自己的子域名 |
