邮件地址验证

邮件地址验证在邮件地址到达您的受众之前检测常见问题。它标记可能增加退信率或损害发件人声誉的拼写错误、无效域名、基于角色的地址和一次性邮件服务。它在 CSV 导入期间自动运行，也可作为对现有受众进行批量验证的工具。

邮件地址验证根据 OneSignal 的验证标准检查地址。这不是实时退信验证检查，也不保证送达率。

验证检查

邮件地址验证针对以下检查评估每个地址：

检查	检测内容
语法验证	缺少必要组件的格式错误地址（例如，缺少 `@`，无效的 TLD）
拼写错误检测	常见域名拼写错误，如 `gnail.com` 或 `gmail.con`
MX 记录检查	没有有效邮件交换记录的域名；发送到此处的邮件无法送达
基于角色的地址	如 `sales@`、`info@`、`admin@` 等不太可能属于个人的地址
一次性邮件	与临时或一次性邮件服务相关的域名

免费计划包含语法验证和拼写错误检测。付费计划包含以上所有功能，以及 MX 记录检查、基于角色的地址检测和一次性邮件过滤。

如果地址未通过某项检查，邮件地址验证将返回解释具体问题的可读错误。如果地址未通过多项检查，所有失败原因将一起返回，以便您一次性处理所有问题。

在 CSV 导入期间验证地址

导入 CSV 时，您可以在确认导入之前在审核步骤中配置邮件地址验证设置。

开始 CSV 导入

前往受众 > 导入并上传您的文件。完成上传和映射字段步骤。如果检测到任何无效邮件地址，映射字段步骤将出现警告。

CSV 导入映射字段步骤显示检测到无效邮件警告 — 映射字段步骤中检测到无效邮件的警告

在审核步骤中配置验证设置

在审核步骤中，展开邮件地址验证设置。以下选项可用：

验证邮件域名（MX 记录）：确认域名可以接收邮件
排除一次性邮件地址：防止可能降低参与度的临时或一次性地址
排除基于角色的邮件地址：防止通常参与度较低的共享地址，如 info@ 或 support@

默认情况下，三项全部启用。取消选中任何您不想应用于此次导入的选项。

如果您需要导入无效邮件地址（例如，更新抑制或订阅状态），请勾选允许无效邮件地址。这将绕过验证并接受任何字符串作为邮件地址。

确认并导入

点击确认并导入。导入完成后，您将收到一封总结结果的邮件：

已添加的订阅
已修改的订阅
未导入的行，附有下载被拒绝行的链接

结果

有效地址将添加到您的受众。导入完成后您会收到邮件。验证失败的地址将被排除，可通过结果邮件中的链接下载。

批量验证现有受众

使用批量验证检查 OneSignal 受众中已有的邮件地址。您将通过邮件以 CSV 导出的形式收到结果。

打开验证邮件地址工具

前往受众 > 订阅（或受众 > 用户），点击更新/导入用户，然后选择验证邮件地址。

更新/导入用户下拉菜单中突出显示验证邮件地址选项 — 更新/导入用户菜单中的验证邮件地址选项

开始验证

在弹窗中，点击开始验证。邮件地址验证将对您的应用中的所有邮件地址运行。

通过邮件接收结果

验证完成后，您将收到来自 OneSignal 的邮件，其中包含下载 CSV 导出链接。该链接在 72 小时内有效。邮件总结了失败地址的数量，按以下分类：

显示验证摘要和下载 CSV 导出按钮的 OneSignal 结果邮件 — 包含分类和下载 CSV 导出链接的 OneSignal 验证结果邮件

拼写错误
基于角色的地址
一次性域名
无效 MX 记录

审查并重新导入

下载 CSV 并审查被标记的地址。

显示 email、reason、suggested_email、created_at、last_opened 和 last_clicked 列的 CSV 导出 — 邮件验证结果的 CSV 导出

要清理您的受众，请创建包含已更正或已处理地址的新 CSV，并使用以下列格式之一重新导入：

目标	必需列	值
重新订阅已更正的地址	`email`、`subscribed`	`subscribed` = `yes`
取消订阅被标记的地址	`email`、`subscribed`	`subscribed` = `no`
抑制被标记的地址	`email`、`suppressed`	`suppressed` = `true`

结果

您将收到一封包含被标记地址 CSV 导出的邮件，以及按错误类型分类的验证结果摘要。

验证错误参考

以下错误可能出现在验证结果中：

错误	含义	处理方式
无效输入	地址格式错误，不满足基本语法要求（例如，缺少 `@`，无效的 TLD）。	更正或删除该地址。
邮件地址中有拼写错误	在域名中检测到可能的拼写错误。相邻列中会显示建议的更正。	应用建议的更正或删除该地址。
未找到 MX 记录	域名没有有效的邮件交换记录。邮件无法送达此地址。	删除或抑制该地址。
基于角色的邮件地址	本地部分（`@` 前面）与已知的基于角色的模式匹配，如 `sales@` 或 `support@`。这些地址不太可能属于个人。	审查该地址是否适合您的用例，然后抑制或删除它。
一次性邮件地址	域名与临时或一次性邮件服务相关。	抑制或删除该地址。

API 错误响应

邮件地址验证也适用于通过 API 提交的地址。以下各节描述您可能遇到的错误响应。

API 验证仅检查邮件地址的格式是否正确。它不检查拼写错误、MX 记录、基于角色的地址或一次性域名。这些检查仅在 CSV 导入和批量验证期间可用。

发送邮件：创建消息

当您通过创建消息端点发送到一个或多个无效地址时，无效地址将被排除在投递之外，并在 invalid_email_tokens 下返回。

{
  "id": "",
  "errors": {
    "invalid_email_tokens": ["invalid@email"]
  }
}

添加用户或订阅：用户模型 API

当您通过创建用户或创建订阅端点使用无效邮件创建用户或订阅时：

{
  "errors": [
    {
      "title": "Invalid `token` format for device type email"
    }
  ]
}

添加设备：旧版 Players API

当您通过旧版 Players API 使用无效邮件添加或编辑播放器记录时：

{
  "success": false,
  "errors": ["[\"Identifier invalid format.\"]"]
}

旧版 Players API 已弃用。请迁移到用户模型 API，以获取更具描述性的验证错误并访问当前功能。

开始使用和设置

消息渠道

旅程

受众和自定义事件

分析和集成

隐私和安全

邮件地址验证

验证检查

在 CSV 导入期间验证地址

结果

批量验证现有受众

结果

验证错误参考

API 错误响应

发送邮件：创建消息

添加用户或订阅：用户模型 API

添加设备：旧版 Players API

​验证检查

​在 CSV 导入期间验证地址

​结果

​批量验证现有受众

​结果

​验证错误参考

​API 错误响应

​发送邮件：创建消息

​添加用户或订阅：用户模型 API

​添加设备：旧版 Players API

验证检查

在 CSV 导入期间验证地址

结果

批量验证现有受众

结果

验证错误参考

API 错误响应

发送邮件：创建消息

添加用户或订阅：用户模型 API

添加设备：旧版 Players API