跳转到内容

打开与点击追踪

追踪按域名配置,默认关闭。

设置 作用 Webhook 事件
open_tracking 在 HTML 正文中插入一个 1x1 的追踪像素。 email.opened
click_tracking 改写 HTML 正文中的链接,以便在重定向之前记录点击。 email.clicked
tracking.ts
import { SpacePost } from "@spacepost/node";
const spacepost = new SpacePost(process.env.SPACEPOST_API_KEY);
const { error } = await spacepost.domains.update({
id: "0192e1c4-0000-7000-8000-000000000001",
openTracking: true,
clickTracking: true,
});
if (error) console.error(error);

该更改仅对之后发送的邮件生效。两个字段都是可选的;只发送你想修改的那个即可。

  • 打开数只是近似值。 Apple Mail 隐私保护和部分安全扫描器会自动加载图片,从而夸大打开数。Gmail 会缓存图片。请把打开数当作粗略的参考信号,绝不能当作有人阅读了邮件的证据。
  • 点击更可靠,但安全扫描器也可能预先点击链接。
  • 隐私。 追踪会在事件载荷中记录 IP 地址和 user agent。请在你的隐私政策中予以披露,并考虑对敏感的事务邮件(重置密码、收据)关闭打开追踪。
  • 纯文本部分不会被追踪。 追踪只作用于 HTML。
  • 送达率。 链接改写会改变收件人看到的 URL。部分垃圾邮件过滤器不喜欢事务邮件这样做;如果你发现送达率下降,请对该域名关闭点击追踪,并为营销邮件使用单独的子域名。

email.opened 或 email.clicked 事件会设置邮件的 last_event,但不会把它从 bounced 等更严重的状态倒退回去。