> ## 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.

# 邮件概述

> 使用 OneSignal 通过仪表板、Journeys 或 API 发送营销和事务性邮件——内置个性化、分析和送达率工具。

OneSignal 邮件服务让您能够通过仪表板、Journeys 或 API 发送**营销邮件**和**事务性邮件**。

* **发送营销活动和事务性消息** 通过仪表板或 API
* **构建自动化邮件和多渠道流程** 使用 Journeys
* **设计邮件** 使用拖放编辑器或 HTML
* **个性化内容** 使用动态字段、条件逻辑和语言变体
* **跟踪性能和 A/B 测试** 使用详细的分析功能
* **细分您的受众** 进行精准定位
* **与 CRM 和工具集成** 如 HubSpot、Mixpanel、Amplitude、Zapier 等[更多工具](./integrations)

***

## 邮件设置

在发送邮件之前，请遵循以下设置指南：

<Note>
  在大规模发送之前，请验证您的域名（SPF、DKIM、DMARC）并启用[自动预热](./email-warm-up)，以保护您的发件人声誉和收件箱投放率。
</Note>

<Columns cols={2}>
  <Card title="邮件设置指南" icon="envelope" href="./email-setup">
    验证您的发送域名并在 OneSignal 中启用邮件。
  </Card>

  <Card title="DNS 配置" icon="globe" href="./email-dns-configuration">
    一键自动配置 DNS 或手动完成设置。
  </Card>

  <Card title="发件人" icon="at" href="./senders">
    管理发件人名称、发件地址、回复地址和多个发送域名。
  </Card>

  <Card title="邮件模板转发" icon="forward" href="./email-template-forwarding">
    通过向 OneSignal 直接转发轻松导入现有邮件模板。
  </Card>

  <Card title="事务性邮件设置" icon="bolt" href="./setup-transactional-emails">
    基于用户操作或自定义事件触发邮件。
  </Card>

  <Card title="自定义取消订阅页面" icon="link-slash" href="./create-custom-unsubscribe-page">
    使用 OneSignal API 替换默认取消订阅页面。
  </Card>
</Columns>

***

## 送达率、声誉和分析

送达率决定您的邮件是到达收件箱还是落入垃圾邮件。OneSignal 提供工具和指导来帮助您建立和维护健康的发送声誉。

<Columns cols={3}>
  <Card title="邮件送达率" icon="inbox" href="./email-deliverability">
    了解收件箱投放的工作原理以及 OneSignal 如何支持它。
  </Card>

  <Card title="邮件声誉最佳实践" icon="shield" href="./email-reputation-best-practices">
    预热域名、管理发送量并避免垃圾邮件过滤器。
  </Card>

  <Card title="自动预热" icon="temperature-arrow-up" href="./email-warm-up">
    为新域名自动逐步增加发送量。
  </Card>

  <Card title="Google Postmaster 工具" icon="google" href="./google-postmaster-tools">
    监控 Gmail 声誉和投递信号。
  </Card>

  <Card title="抑制列表" icon="ban" href="./suppressions">
    管理被阻止和被抑制的邮件地址。
  </Card>

  <Card title="邮件消息报告" icon="chart-line" href="./email-message-reports">
    跟踪打开率、点击率和转化率。
  </Card>

  <Card title="邮件故障排除" icon="wrench" href="./email-troubleshooting">
    诊断和解决常见的投递问题。
  </Card>

  <Card title="创建已确认的选择加入旅程" icon="envelope-open" href="./double-opt-in-email">
    使用标签、细分和 Journeys 创建已确认的选择加入旅程。
  </Card>

  <Card title="添加您自己的验证链接" icon="link" href="./example-verification-magic-link-otp">
    了解如何在您的邮件中添加自己的验证链接。
  </Card>
</Columns>

***

## 设计您的邮件

OneSignal 支持可视化和基于代码的邮件创建。使用拖放编辑器快速制作活动，或使用 HTML 编辑器进行完整的设计控制。您也可以从模板开始并进行自定义。

<Columns cols={3}>
  <Card title="拖放编辑器" icon="palette" href="./design-emails-with-drag-and-drop">
    无需编写代码即可可视化构建邮件。
  </Card>

  <Card title="HTML 编辑器" icon="code" href="./design-emails-with-html">
    使用 HTML 设计完全自定义的邮件。
  </Card>

  <Card title="模板" icon="copy" href="./templates">
    从预构建模板开始，或创建并保存您自己的布局。
  </Card>

  <Card title="取消订阅链接和标头" icon="link-slash" href="./unsubscribe-links-email-subscriptions">
    控制取消订阅行为、标头和合规性设置。
  </Card>

  <Card title="消息个性化" icon="user-pen" href="./message-personalization">
    使用用户数据和条件逻辑个性化内容。
  </Card>

  <Card title="多语言消息" icon="language" href="./multi-language-messaging">
    以多种语言发送本地化邮件。
  </Card>

  <Card title="邮件模板转发" icon="forward" href="./email-template-forwarding">
    通过向 OneSignal 直接转发导入现有邮件模板。
  </Card>

  <Card title="将模板复制到其他应用 API" icon="clone" href="/reference/copy-template-to-another-app">
    在 OneSignal 应用之间移动模板。
  </Card>
</Columns>

***

## 发送邮件

通过仪表板发送消息、使用 Journeys 自动化，或通过 API 以编程方式触发。

<Columns cols={2}>
  <Card title="仪表板" icon="window-maximize" href="#send-from-the-dashboard">
    在仪表板中快速撰写消息。
  </Card>

  <Card title="通过 API 发送" icon="code" href="/reference/create-message">
    使用 REST API 以编程方式发送消息。
  </Card>

  <Card title="Journeys" icon="route" href="./journeys-overview">
    构建自动化的多步骤和多渠道流程。
  </Card>

  <Card title="A/B 测试" icon="flask" href="./ab-testing">
    测试多达 10 个消息变体以优化性能。
  </Card>
</Columns>

### 从仪表板发送

<Steps>
  <Step title="选择消息渠道" icon="window-maximize">
    选择 **创建...** 然后选择您的消息渠道。您也可以导航到 **消息** 或 **模板** 查看以前的消息。

    <Frame caption="在 OneSignal 仪表板中创建新消息。">
      <img src="https://mintcdn.com/onesignal/UDk6E5NjA3sdGdRN/images/dashboard/create-message.png?fit=max&auto=format&n=UDk6E5NjA3sdGdRN&q=85&s=97504cf71555ac4aeb263a36ad2d28b3" alt="OneSignal dashboard showing create message options" width="2128" height="1374" data-path="images/dashboard/create-message.png" />
    </Frame>
  </Step>

  <Step title="选择编写方法" icon="pencil">
    * 使用[块编辑器](./design-emails-with-drag-and-drop)或 [HTML 编辑器](./design-emails-with-html)从头开始
    * 使用预构建的[模板](./templates)
  </Step>

  <Step title="设置名称和标签" icon="tag">
    添加用于跟踪和报告的内部元数据。API 对应字段：`name`
  </Step>

  <Step title="选择您的受众" icon="users">
    选择哪些用户接收消息。您可以包含和排除[细分](./segmentation)以定位特定群体。如果未设置细分，默认为所有"已订阅用户"。

    <Frame caption="仪表板中的名称、标签和受众细分选择。">
      <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/message-name-label-audience.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=1f41b0e42d31211b1c1badf87ba84056" alt="Dashboard fields for message name, label, and audience segment selection" width="1650" height="518" data-path="images/dashboard/message-name-label-audience.png" />
    </Frame>

    | 定位方法                                        | 仪表板 | API |
    | ------------------------------------------- | :-: | :-: |
    | [**细分**](./segmentation)                    |  是  |  是  |
    | **过滤器**（[仅 API](/reference/create-message)） |  否  |  是  |
    | **别名**（[仅 API](/reference/create-message)）  |  否  |  是  |
  </Step>
</Steps>

#### 发件人

配置此邮件使用的发件人详情：

* 发件人名称
* 发件地址
* 回复地址
* 发送域名

<Note>
  支持多域名发送。请参阅[发件人](./senders)。
</Note>

API 字段：`email_from_address`、`email_sender_domain`、`email_reply_to_address`

#### 主题和预览文本

设置必需的主题行和可选的预览文本。预览文本的显示因收件箱提供商而异——并非所有收件箱都会显示。

* API 字段：`email_subject` 和 `email_preheader`
* 支持[消息个性化](./message-personalization)和[多语言消息](./multi-language-messaging)

#### 跟踪和合规

**链接跟踪** — 默认启用。支持多链接跟踪。详情请参阅[链接](./links#email)和[深度链接](./deep-linking)。

* API 字段：`disable_email_click_tracking`

**发送给未订阅用户** — 仅为合规或非营销消息启用。

* API 字段：`include_unsubscribed`

<Frame caption="撰写邮件时的跟踪和合规选项。">
  <img src="https://mintcdn.com/onesignal/6tscVAtiSqz353kV/images/docs/Screenshot2025-06-09at4.15.02PM.png?fit=max&auto=format&n=6tscVAtiSqz353kV&q=85&s=b4496406dae7c2a7a9dd07cf35cf1069" alt="Email composition panel showing link tracking and unsubscribe send options" width="1127" height="427" data-path="images/docs/Screenshot2025-06-09at4.15.02PM.png" />
</Frame>

#### 投递时间安排和优化

选择消息开始发送的时间。

| 选项                          | 描述                 | API 字段       |
| --------------------------- | ------------------ | ------------ |
| **立即发送**                    | 立即投递给所有收件人。        | —            |
| **定时发送**                    | 在特定时间发送，最多提前 30 天。 | `send_after` |
| **[自动预热](./email-warm-up)** | 为新域名或冷域名逐步增加发送量。   | —            |

**按用户优化：**

设置用户何时接收消息。

| 选项           | 描述                            | API 字段                                            |
| ------------ | ----------------------------- | ------------------------------------------------- |
| **同时发送给所有人** | 所有收件人同时收到邮件。最适合紧急消息。          | —                                                 |
| **智能投递**     | 根据用户的打开和点击活动（排除机器人活动）在最佳时间发送。 | `delayed_option: last-active`                     |
| **按时区自定义时间** | 在每个用户时区的设定本地时间发送。             | `delayed_option: timezone`、`delivery_time_of_day` |

<Info>
  "开始发送"时间决定受众截止点。OneSignal 在该时刻评估细分成员资格——受众中的任何人都会收到消息，无论按用户优化设置如何。
</Info>

点击**审核并发送**立即发送或按计划发送，或点击**保存**为草稿以便稍后编辑。发送开始后，在**消息 > 邮件**或**投递 > 已发送消息**中监控性能。详情请参阅[邮件消息报告](./email-message-reports)。

***

## FAQ

### 营销邮件和事务性邮件有什么区别？

营销邮件是发送给一组用户的活动，例如促销或通讯。事务性邮件由用户操作或事件触发，例如密码重置或订单确认。配置详情请参阅[事务性邮件设置](./setup-transactional-emails)。

### 为什么我的邮件进入垃圾邮件？

常见原因包括缺少 DNS 验证（SPF、DKIM、DMARC）、向不活跃用户发送，或在新域名上增加发送量过快。请参阅[邮件送达率](./email-deliverability)和[邮件声誉最佳实践](./email-reputation-best-practices)获取指导。

### 我可以向取消订阅的用户发送邮件吗？

仅限合规或非营销消息，例如法律通知。在撰写邮件时启用**发送给未订阅用户**选项，或通过 API 设置 `include_unsubscribed`。将此用于营销邮件违反反垃圾邮件法规。

### 如何跟踪邮件性能？

OneSignal 自动跟踪投递、打开、点击、退信和取消订阅。在仪表板的**消息 > 邮件**下查看结果，或使用[查看消息 API](/reference/view-messages) 以编程方式提取数据。详情请参阅[邮件消息报告](./email-message-reports)。

### OneSignal 支持邮件 A/B 测试吗？

是的。您可以直接在仪表板中测试多达 10 个邮件变体——包括主题行、内容和发送时间。请参阅 [A/B 测试](./ab-testing)。
