跳转到主要内容
使用本指南识别和解决最常见的 OneSignal 邮件问题,包括设置问题、送达性挑战和设计错误。
在故障排除之前,请查看我们的邮件设置邮件送达性指南。这些涵盖了邮件问题的最常见原因。

设置问题

大多数设置问题来自错误的 DNS 记录或邮件服务提供商 (ESP) 的限制。

验证 DNS 记录

  1. 打开您的 DNS 提供商。
  2. 确认 SPF、DKIM 和 MX 记录与我们的邮件 DNS 配置指南匹配。
  3. 允许 DNS 更改最多 24 小时来传播。
如果 DNS 记录配置错误,邮件可能无法发送、退回或被标记为垃圾邮件。

月度发送限制(非 OneSignal ESP)

如果您直接使用 SendGrid、Mailchimp 或 Mailgun(不通过 OneSignal 邮件),您的发送量受限于您的 ESP 计划。
检查您提供商的日志:

DNS 查找过多

当使用 URI 测试 等工具测试 SPF 记录时,您可能会看到:
DNS 查找过多

DNS 查找过多

如果您使用以下 SPF 记录,这是预期的:
v=spf1 include:spf.onesignal.email include:mailgun.org ~all
OneSignal 在”幕后”使用 Mailgun 作为我们的邮件服务提供商。这意味着 SPF 查找指向相同的 IP 范围,实际上并不添加任何额外的查找。要移除警告,您可以简化为:
v=spf1 include:mailgun.org ~all
这将防止错误,不会影响 OneSignal 邮件发送。

发送域名的多个 TXT 记录

您的发送域名只能有一个 SPF 记录。
使用 WhatsMyDNS TXT 查找 检查以确认您没有多个条目。

送达性问题

送达性问题包括发送缓慢、进入垃圾邮件文件夹和邮件退回。

延迟邮件

如果您的发送域名是新的或声誉较低,ISP(Gmail、Outlook、Yahoo)可能会延迟投递。这被称为速率限制灰名单。查看您的邮件消息报告时,您可以检查我们发送消息所花费的时间详情。
邮件消息报告

从 OneSignal 发送邮件不到 3 秒

在此示例中,我们看到邮件从 OneSignal 发送用时不到 3 秒。我们将其发送到邮件服务提供商,然后再发送到收件人的 ISP。这些邮件服务器可能会将邮件延迟数小时后才投递给收件人。
遵循我们的邮件声誉最佳实践来加快投递速度。

邮件进入垃圾邮件

最常见的原因是发送者声誉不良。请遵循我们的邮件送达性指南。 如果您使用第三方 ESP,请参阅:

从同一域名发送和接收

单个域名不能同时使用相同的 MX 记录进行发送和接收邮件。如果您想从 @yourdomain.com 发送邮件,同时在同一域名上接收邮件:
  • 在 OneSignal 保持您的发送 DNS。
  • 将您的 MX 记录指向您的入站邮件提供商(例如,Google Workspace MX 记录)。

抑制列表

如果某个地址取消订阅或将您标记为垃圾邮件,您的 ESP 将抑制向其发送。
重新订阅的步骤:
  1. 在 OneSignal 中转到受众 > 订阅
  2. 搜索邮件地址。
  3. 点击取消订阅邮件(如果已订阅),然后点击重新订阅邮件
  4. 发送测试邮件以确认。

Apple Private Relay

如果您发送到 @privaterelay.appleid.com 地址,您必须在您的 Apple Developer 账户中验证您的发送域名。
未验证的域名将导致邮件被丢弃。

API 密钥过于限制

如果使用 SendGrid 或 Mailchimp,确保您的 API 密钥具有最低要求的权限

邮件设计

这些是邮件内容本身的问题。

链接不工作

通常由缺失或错误的 CNAME 配置引起。
如果使用第三方 ESP,请遵循他们的跟踪域名设置。

按钮不可点击

  • 确保 URL 正确并以 https:// 开头。
  • 避免从垃圾邮件文件夹测试——某些邮件客户端会阻止那里的链接。

向预览头添加图片

Gmail 支持在预览头中添加促销图片(交易注释、产品轮播)。
请参阅 Gmail 开发者门户了解设置。

邮件服务提供商 (ESP)

与我们与 SendGrid、Mailchimp 或 Mailgun 的集成相关的常见问题或问题。

我必须为邮件付费给另一个提供商吗?

如果您使用 OneSignal 邮件设置,我们将管理您的邮件账户,您不需要使用其他邮件提供商。如果您计划使用 SendGrid、Mailchimp 或 Mailgun,则需要继续直接向您的邮件服务提供商付费。

OneSignal 的邮件吞吐量是多少?

OneSignal 通常以每秒 1,000 到 5,000 封的速度向邮件服务提供商发送消息。由您的 ESP 负责将邮件投递给您的用户。 OneSignal 为 OneSignal 邮件使用 Mailgun,Mailgun 宣传他们可以支持高达每小时 1500 万封邮件
I