使用本指南识别和解决最常见的 OneSignal 邮件问题，包括设置问题、送达性挑战和设计错误。Documentation Index
Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
Use this file to discover all available pages before exploring further.
设置问题
大多数设置问题来自错误的 DNS 记录或邮件服务提供商 (ESP) 的限制。验证 DNS 记录
- 打开您的 DNS 提供商。
- 确认 SPF、DKIM 和 MX 记录与我们的邮件 DNS 配置指南匹配。
- 允许 DNS 更改最多 24 小时来传播。
月度发送限制（非 OneSignal ESP）
如果您直接使用 SendGrid、Mailchimp 或 Mailgun（不通过 OneSignal 邮件），您的发送量受限于您的 ESP 计划。检查您提供商的日志：
DNS 查找过多
当使用 URI 测试 等工具测试 SPF 记录时，您可能会看到：
发送域名的多个 TXT 记录
您的发送域名只能有一个 SPF 记录。使用 WhatsMyDNS TXT 查找 检查以确认您没有多个条目。
送达性问题
送达性问题包括发送缓慢、进入垃圾邮件文件夹和邮件退回。延迟邮件
如果您的发送域名是新的或声誉较低，ISP（Gmail、Outlook、Yahoo）可能会延迟投递。这被称为速率限制或灰名单。查看您的邮件消息报告时，您可以检查我们发送消息所花费的时间详情。
遵循我们的邮件声誉最佳实践来加快投递速度。
邮件进入垃圾邮件
最常见的原因是发送者声誉不良。请遵循我们的邮件送达性指南。 如果您使用第三方 ESP，请参阅：从同一域名发送和接收
单个域名不能同时使用相同的 MX 记录进行发送和接收邮件。如果您想从@yourdomain.com 发送邮件，同时在同一域名上接收邮件：
- 在 OneSignal 保持您的发送 DNS。
- 将您的 MX 记录指向您的入站邮件提供商（例如，Google Workspace MX 记录）。
抑制列表
如果某个地址取消订阅或将您标记为垃圾邮件，您的 ESP 将抑制向其发送。重新订阅的步骤：
- 在 OneSignal 中转到受众 > 订阅。
- 搜索邮件地址。
- 点击取消订阅邮件（如果已订阅），然后点击重新订阅邮件。
- 发送测试邮件以确认。
Apple Private Relay
如果您发送到@privaterelay.appleid.com 地址，您必须在您的 Apple Developer 账户中验证您的发送域名。未验证的域名将导致邮件被丢弃。
API 密钥过于限制
如果使用 SendGrid 或 Mailchimp，确保您的 API 密钥具有最低要求的权限。邮件设计
这些是邮件内容本身的问题。链接不工作
通常由缺失或错误的 CNAME 配置引起。如果使用第三方 ESP，请遵循他们的跟踪域名设置。
按钮不可点击
- 确保 URL 正确并以
https://开头。 - 避免从垃圾邮件文件夹测试——某些邮件客户端会阻止那里的链接。
向预览头添加图片
Gmail 支持在预览头中添加促销图片（交易注释、产品轮播）。请参阅 Gmail 开发者门户了解设置。