# 邮件平台配置

<Aside type="note">
 请注意，平台配置是特定于项目的。为您希望用于发送邮件的每个项目配置邮件平台。已验证的邮件和域名可用于您账户中的所有项目。
</Aside>

要开始通过 Pushwoosh 发送邮件，您需要完成设置步骤。这些步骤将验证您的账户、配置发件人详细信息并认证您的域名。此过程可确保安全、合规的邮件投递，并能准确跟踪互动指标。

## 验证您的账户
第一步是验证您的账户。这对于确保邮件的可靠和安全投递至关重要。验证有助于防止平台被滥用于垃圾邮件或恶意活动，并确保符合法规。

请按照以下步骤完成验证过程：

1. 导航至 **设置 > 配置平台**。

2. 找到 **邮件消息** 并点击 **配置**。

<img src="/configure-project-email-verification-1.webp" alt="邮件平台配置界面，显示邮件消息设置的“配置”按钮。"/>

3. 在出现的表单中，在 **贵公司网站 URL 字段** 中提供您公司网站的 URL（例如，https://example.com）。

<img src="/configure-project-email-verification-2.webp" alt="账户验证表单，显示公司网站 URL 和其他必填信息的字段。"/> 

4. 在 **主要技术联系人** 字段中，输入管理您集成技术方面的人员的电子邮件地址。此联系人将用于技术咨询或问题。

5. 在 **告诉我们您将如何使用 Pushwoosh** 字段中，提供有关您打算如何使用 Pushwoosh 进行邮件营销活动的详细信息。包括以下信息：

- 您计划发送的消息类型（例如，新闻通讯、促销优惠等）。

- 您的订阅者如何注册接收这些消息（例如，网站表单、移动应用注册）。


填写完所有信息后，点击 **验证我的账户** 提交您的请求。Pushwoosh 将审核您的详细信息并尽快回复。

您的账户验证通过后，您将收到一封确认邮件。然后您可以继续配置您的邮件发件人设置。

为此： 

1. 前往 **设置**。  
2. 选择 **配置平台**。  
3. 点击邮件平台旁边的 **继续配置**。

<img src="/configure-project-email-verification-3.webp" alt="平台配置界面，显示邮件平台的“继续配置”按钮。"/>

## 配置发件人详细信息

<span id="add-a-domain" />

### 添加域名

要使用 Pushwoosh 发送邮件，请添加并验证一个域名。 

在 **域名** 字段中，输入您希望用于发送邮件的域名（例如，yourcompany.com）。此域名必须在下一步通过 DNS 验证后才能用于您的邮件营销活动。
 
<img src="/configure-project-email-verification-4.webp" alt="域名配置界面，显示用于输入发件人域名的字段。"/>

<Aside type="tip">您将在屏幕顶部看到可以添加的剩余域名数量。要增加此限制，请 [联系我们的支持团队](https://help.pushwoosh.com/hc/en-us/)</Aside>

<span id="add-default-sender-details" />

### 添加默认发件人详细信息

<span id="from-address" />

##### 发件人地址

设置一个默认的发件人姓名和电子邮件地址，它们将显示在收件人的收件箱中。这有助于用户识别发件人并建立信任。

* **姓名**：输入发件人姓名（例如，John）。
* **电子邮件**：输入“@”符号前的发件人电子邮件地址。例如，对于 *marketing@yourcompany.com*，输入 *marketing*。

<Aside type="caution" title="在客户旅程和一次性邮件中如何确定发件人详细信息">
当邮件内容或旅程（或一次性邮件）步骤中未设置发件人时，将使用这些默认发件人详细信息。在 [Customer Journey 步骤](/zh/product/customer-journey/journey-elements/channels/email/#define-sender-details-and-reply-address) 或 [一次性邮件表单](/zh/product/messaging-channels/emails/sending-emails/send-one-time-emails/#sender-details) 中设置的发件人将覆盖邮件内容和平台默认设置。在邮件内容中设置的发件人将覆盖平台默认设置。 
</Aside> 

<img src="/configure-project-email-verification-5.webp" alt="默认发件人详细信息配置表单，显示发件人姓名和电子邮件地址的字段。"/>

如果您希望收件人的回复直接发送到发件人的电子邮件地址，请选中 **使用此地址作为回复地址以跟踪回复** 复选框。

##### 回复地址

要使用不同的回复地址，请取消选中该复选框，并指定：

* **回复姓名**：将作为回复联系人显示的姓名。
* **回复电子邮件**：应将回复发送到的电子邮件地址。

<img src="/configure-project-email-verification-6.webp" alt="回复地址配置表单，显示回复姓名和电子邮件地址的字段。"/>

如果两个字段都留空，回复将被发送到 **发件人地址** 部分指定的默认发件人电子邮件。

完成必填字段后，点击 **下一步** 继续进行域名验证。

<span id="configure-dns-records" />

## 配置 DNS 记录

<Aside type="caution" title="可能需要技术协助"> 
****
添加 DNS 记录需要访问您域名的 DNS 设置。如果您不确定如何配置它们，请向您的 IT 团队或域名提供商寻求帮助。 

</Aside>

要认证您的域名并为您的营销活动启用邮件发送，请在您的托管服务提供商的 DNS 设置中配置以下 DNS 记录：

* **DKIM（必需）**。此记录对您的邮件进行数字签名，允许邮件提供商验证邮件是否源自您的域名且在传输过程中未被篡改。
* **SPF（必需）**：此记录指定哪些邮件服务器被允许代表您的域名发送邮件，有助于防止欺骗。
* **DMARC（必需）**：此记录提供处理未经认证邮件的说明并向您报告，增强邮件安全性。

<span id="dkim-records-required" />

### DKIM 记录（必需）

 <details>
  <summary> 什么是 DKIM 记录？ </summary>

DKIM (DomainKeys Identified Mail) 是一种邮件认证方法，它允许接收服务器验证邮件是否由所述域名发送，并且在传输过程中未被篡改。

通过将 DKIM 记录添加到您的 DNS 设置中，您可以为外发邮件应用加密签名。此签名验证邮件内容保持不变，并将其认证为来自您域名的合法邮件。
</details>

复制 CNAME 记录并将其添加到您的 DNS 设置中。 

要设置 DKIM，您需要将 **所有四个 CNAME（规范名称）记录** 添加到您的 DNS 设置中。这些记录对于认证您的域名和确认从您的域名发送的邮件是经过授权的至关重要。

<img src="/configure-project-email-verification-8.webp" alt="DKIM 配置界面，显示需要添加到 DNS 设置中的四个 CNAME 记录。"/>

<Aside type="note">
 DNS 提供商处理记录的方式不同。有些要求您粘贴整个记录（主机名 + 域名），而另一些只需要唯一的密钥部分（不带域名部分的主机名）。请查看您的 DNS 提供商关于如何添加记录的说明。
</Aside>

如果某条记录设置不正确，该记录下方会显示一条说明，解释问题所在，例如：

* 记录缺失。
* 记录指向错误的值。
* 记录中仍被重复追加了您的域名。
* 记录被发布为 TXT 记录，而不是 CNAME 记录。
* DNS 没有响应。请几分钟后再次检查。

添加所需的 DNS 记录后，域名验证过程通常需要大约 5 到 10 分钟，但在某些情况下可能需要长达 24 小时。在此期间，您将无法通过 Pushwoosh 发送邮件，直到验证完成。同时，您可以继续进行其他设置步骤，稍后再回来检查验证状态。

添加 DNS 记录后，点击 **验证 DNS 记录** 以刷新验证状态。验证成功后，域名验证状态将变为 **已验证**。

<img src="/configure-project-email-verification-9.webp" alt="域名验证状态界面，显示“验证 DNS 记录”按钮和验证状态。"/>

<span id="send-a-test-email" />

#### 发送测试邮件

一旦您的域名配置和 DKIM 验证完成，您就可以发送一封测试邮件，以确保您的邮件设置正常工作，并且在您的营销活动上线后邮件能够成功投递给用户。

要发送测试邮件：

1. 在 **邮件渠道配置** 部分，点击 **发送测试邮件**。

<img src="/configure-project-email-verification-10.webp" alt="邮件渠道配置界面，显示“发送测试邮件”按钮。"/>

2. 在打开的表单中，输入发件人和收件人详细信息：
* **发件人**：您配置的发件人电子邮件地址。
* **收件人**：输入您希望发送测试邮件的电子邮件地址。默认情况下，此字段预填充了登录用户的电子邮件，但您可以根据需要进行更改。
3. 从下拉菜单中选择要包含在测试邮件中的邮件内容。
4. 点击 **发送**。

<div style={{ display: "flex", justifyContent: "center" }}>
  <img src="/configure-project-email-verification-11.webp" alt="邮件验证" />
</div>

<Aside type="caution" title="如果域名未经验证，发送将失败">
如果“发件人”或回复域名未完全验证，现在创建测试邮件会立即失败，并显示 **发件人邮件域名未验证** 或 **回复邮件域名未验证** 的错误，而不是创建了测试邮件但在实际发送时被静默丢弃。请在 [您的发件人域名](#your-sender-domains) 中检查域名的状态，完成任何仍标记为 **待处理** 的 DNS 记录，然后重试。
</Aside>

### SPF 记录（必需）

Pushwoosh 要求设置 **发件人策略框架 (SPF) 记录**，以授权其邮件服务器代表您的域名发送邮件。SPF 是一种邮件认证协议，有助于防止欺骗并提高邮件的可送达性。

<Aside type="note">
 在添加新的 SPF 记录之前，请检查您的域名是否已有记录，因为大多数 DNS 提供商每个域名只允许一个 SPF 记录。
</Aside>

#### 添加新的 SPF 记录

如果您的域名没有 SPF 记录，请添加一个具有以下值的新 TXT 记录。

**SPF 值**

```
"v=spf1 include:spf.pushwoosh.io ~all"
```

根据您的 DNS 提供商，记录的名称可以是空白或设置为 @。

#### 添加到现有 SPF 记录

如果您的域名已有 SPF 记录，只需将以下 SPF 机制添加到您现有的记录中以授权 Pushwoosh。

```
include:spf.pushwoosh.io
```

<img src="/configure-project-email-verification-12.webp" alt="SPF 记录配置界面，显示 SPF 值和添加 DNS 记录的说明。"/>

如果您现有的 SPF 记录未包含 Pushwoosh 的服务器，或者该域名有多条 SPF 记录（这会导致接收方忽略所有记录），记录下方的说明会指出发现了其中的哪个问题。

### DMARC 验证（必需）

**DMARC** (Domain-based Message Authentication, Reporting, and Conformance) 是一种邮件认证协议。它有助于保护您的域名免受未经授权的使用，例如邮件欺骗。

Pushwoosh 要求在您的域名上配置 DMARC，以确保安全和经过认证的邮件投递。有关 DMARC 的更多信息，请参阅 [DMARC 协议文档](https://dmarc.org/overview/)。

Pushwoosh 为您生成的 DMARC 记录采用仅监控策略（`p=none`）：未通过认证的邮件仍会被投递并纳入报告，不会被隔离或拒绝。如果您的域名已有采用更严格策略的 DMARC 记录，请保留现有记录，而不要替换它。

要配置 DMARC：

1. 复制此步骤中显示的 DMARC TXT 记录。

<img src="/configure-project-email-verification-13.webp" alt="DMARC 记录卡片，显示已验证的 DMARC TXT 记录，以及要添加到 DNS 设置中的 v=DMARC1; p=none; 值。"/>

2. 转到您的 DNS 提供商的设置，并将 DMARC 记录添加到 DNS 设置中。如果您在添加这些记录时需要帮助，请参考您的 DNS 提供商的文档。
3. 启用报告（可选）。要接收有关邮件认证和安全问题的报告，请在 **值** 参数的 `rua` 字段中添加一个电子邮件地址。

<span id="check-domain-status-and-fix-issues" />

### 检查域名状态并解决问题

添加记录后，请使用 DNS 记录列表上方的按钮：

* **验证 DNS 记录**：在您添加或更改记录后点击，以刷新其状态。
* **发送测试邮件**：域名配置完成后，检查发送是否正常（参见[发送测试邮件](#send-a-test-email)）。
* **复制说明**：将所有必需的 DNS 记录及设置说明复制为纯文本，您可以将其粘贴到任何位置。
* **通过电子邮件发送给您的 IT 团队**：打开您的电子邮件客户端，并预填相同的说明，随时可发送给负责管理您 DNS 的人员。

<img src="/configure-project-email-verification-19.webp" alt="已验证域名的 DNS 记录，在“验证 DNS 记录”“发送测试邮件”“复制说明”和“通过电子邮件发送给您的 IT 团队”按钮上方显示绿色的“所有必需记录均已验证”横幅。"/>

如果有需要您关注的问题，记录上方的横幅会说明问题所在：

* **部分必需的 DNS 记录缺失或有误**：请查看每条记录下的说明，了解具体的修复方法。
* **DNS 记录已就位**：Pushwoosh 已找到您的记录，正在与邮件服务提供商进行确认，这一步独立于 [DKIM 记录](#dkim-records-required)中所述的 DNS 传播。通常最多需要 30 分钟，您无需执行任何操作。
* **验证在添加记录之前已停止**：记录现在已正确，但之前的验证尝试已过期。请点击横幅中的 **重新开始验证**。您的 SPF 和 DMARC 记录保持不变，DKIM 记录通常也保持不变。重新开始后，请检查 [DKIM 记录](#dkim-records-required)，以防它们发生变化。
* **此域名在 DNS 中不存在**：该域名尚未注册或无法找到。请检查拼写，或先注册该域名。

当横幅指明了某个 DNS 提供商时（例如“此域名的 DNS 由 …… 管理”），请在该提供商处添加记录，而不是在您的域名注册商处添加。

### 选择不同的域名

如果您在此步骤意识到需要更改域名，请点击 **选择不同的域名**。然后，您可以添加一个新的发件人域名。

请记住，更改您的域名将生成新的 DNS 记录。这可确保正确跟踪域名限制，并排除您不再需要的任何域名。

<img src="/configure-project-email-verification-14.webp" alt="域名选择界面，显示用于更改发件人域名的“选择不同的域名”按钮。"/>

<span id="configure-link-tracking" />

## 配置链接跟踪

链接跟踪通过添加 **UTM 参数** 帮助您了解受众如何与邮件中的链接互动。使用 UTM 标签，您可以直接在 Google Analytics 或任何其他跟踪 UTM 的分析系统中跟踪邮件互动。

<Aside type="note">
 如果您选择不配置 Google Analytics URL 跟踪，Pushwoosh 仍将跟踪链接点击并提供基本统计信息。只需关闭 **Google Analytics URL 跟踪** 开关，然后点击 **完成设置**。
</Aside>

要启用链接跟踪，请打开 **Google Analytics URL 跟踪** 开关。

以下 UTM 参数将被添加到您的链接中：

- **utm_source**：识别流量来源。

- **utm_medium**：指定营销媒介，默认为“email”。

- **utm_campaign**：添加营销活动代码（例如，营销活动 ID）。这将自动插入。

- **utm_content**：跟踪邮件中的特定内容，例如主题。这将自动插入。

**链接预览** 显示了您的链接在添加所选 UTM 参数后的示例。

<img src="/configure-project-email-verification-15.webp" alt="链接跟踪配置界面，显示 UTM 参数和链接预览示例。"/>

3. 配置完 UTM 参数后，点击 **完成设置** 以保存您的设置。

UTM 标签将自动添加到您邮件中的每个链接，让您可以直接在 Google Analytics 中跟踪来源、媒介、营销活动和内容表现。

## 审查和管理您的邮件渠道设置

一旦您的邮件渠道配置完成，**邮件渠道配置** 仪表板将提供一个概览，并允许您管理发送邮件的关键设置，包括发件人域名、默认发件人详细信息和链接跟踪选项。

### 配置状态

在顶部，您可以查看邮件平台的状态，该状态指示其是否已配置。如果平台未配置，可能是由于以下原因：

* **默认发件人详细信息** 尚未指定。 [了解有关默认发件人详细信息的更多信息](/zh/product/first-steps/start-with-your-project/configure-platforms/email-verification#add-default-sender-details)。
<div style={{ display: "flex", justifyContent: "center" }}>
  <img src="/configure-project-email-verification-16.webp" alt="未指定默认发件人详细信息" />
</div> 

* 一个 **未验证的域名** 被设置为默认发件人。 [了解有关验证您的域名的更多信息](/zh/product/first-steps/start-with-your-project/configure-platforms/email-verification#configure-dns-records)。

<img src="/configure-project-email-verification-17.webp" alt="邮件平台状态显示未验证域名的警告消息。"/>

<span id="your-sender-domains" />

### 您的发件人域名
在 **您的发件人域名** 部分，您可以查看和管理用于发送邮件的域名以及每个域名的状态：

* **就绪**：域名已配置并准备好发送邮件。
* **未就绪**：域名验证未完成，通常是由于待处理的 [DKIM 验证](/zh/product/first-steps/start-with-your-project/configure-platforms/email-verification/#dkim-records-required)，这是必需的。标记为 **未就绪** 的域名在所有必要的验证完成之前无法发送邮件。要完成配置，请点击列表中的域名。

此外，此部分还显示每个验证记录（DKIM、SPF、DMARC）的状态为 **已验证** 或 **待处理**。**待处理** 表示该记录正在等待验证或尚未配置。如果即使您已添加 DNS 记录，域名仍显示 **待处理**，请联系 [Pushwoosh 支持](https://help.pushwoosh.com/hc/en-us/requests/new) 以确认您的账户需要哪些记录。

点击 **更新状态** 以刷新每个域名的验证状态。

##### 添加域名

要添加其他域名，请点击 **添加域名**。要增加此限制，请 [联系支持](https://help.pushwoosh.com/hc/en-us/requests/new)。

<img src="/configure-project-email-verification-18.webp" alt="域名管理界面，显示用于添加其他发件人域名的“添加域名”按钮。"/>

##### 删除域名
<Aside type="danger" title="重要"> 
****
删除域名可能会中断使用该域名作为发件人的活动邮件营销活动。在删除域名之前，请务必检查所有正在进行的营销活动。
</Aside>
要删除域名：

1. 在 **您的发件人域名** 中，找到要删除的域名。
2. 点击域名旁边的 **三点菜单**，然后选择 **删除域名**。
3. 确认删除，或点击 **取消** 以保留域名。

**注意**：如果一个域名在任何项目中被设置为默认的 [“发件人”地址](/zh/product/first-steps/start-with-your-project/configure-platforms/email-verification/#from-address)，则在这些项目中更新发件人信息之前，您无法删除它。将出现一条错误消息，以及使用此域名作为默认发件人的项目列表。在每个项目中将“发件人”地址更新为另一个已验证的域名，然后再次尝试删除该域名。


##### 发送测试邮件

在域名列表中，您也可以发送测试邮件。 

为此，请点击已配置域名旁边的三点菜单，然后选择 **发送测试邮件**。请注意，此选项仅适用于已完全配置的域名。

### 默认发件人详细信息

在此部分，您可以查看和管理默认发件人详细信息，包括：

* **发件人地址**：将作为邮件发件人显示的姓名和电子邮件地址。
* **回复地址**：回复的默认姓名和电子邮件。

要进行更改，请点击 **编辑默认发件人详细信息**。

<Aside type="caution" title="重要"> 
****
如果您未指定 [默认发件人详细信息](/zh/product/first-steps/start-with-your-project/configure-platforms/email-verification/#add-default-sender-details)，邮件渠道将不会被配置，并且会出现一条警告消息。要设置默认发件人详细信息，请点击 **设置发件人详细信息**。
</Aside>

### Google Analytics URL 跟踪

在此部分，您可以管理 [**链接跟踪**](/zh/product/first-steps/start-with-your-project/configure-platforms/email-verification/#configure-link-tracking) 设置。要启用跟踪，请将开关切换到 **启用**。

启用后，UTM 参数会自动添加到邮件链接中，让您可以在 Google Analytics 中跟踪用户互动。您还将看到一个 **链接预览**，显示您的 URL 在添加 UTM 标签后的样子。

## 通过 Pushwoosh API 配置邮件

您也可以使用 Pushwoosh API 设置邮件平台。为此，您需要开发团队的协助。请与他们分享 [本指南](/zh/developer/api-reference/app-configuration#configureapplication-for-email) 以获取详细说明。

## 设置订阅偏好中心

一旦邮件平台配置完成（域名已验证并设置了默认发件人详细信息），您就可以设置 [订阅偏好中心](/zh/product/messaging-channels/emails/email-preferences/)，以便用户可以选择他们接收的邮件类别。



<span id="set-up-a-custom-tracking-domain" />

## 设置自定义跟踪域名


**点击跟踪域名 (CTD)** 是邮件消息中显示的被跟踪链接 URL 的域名部分。它将一个子域名与您的主域名结合起来，例如 `click.yourdomain.com`。该子域名是在您的域名提供商的域名 DNS 设置中创建的，通常通过添加 CNAME 记录来完成。使用 CTD，您可以在自己的子域名上包装邮件链接以进行点击跟踪，并保持可送达性和深层链接正常工作。

CTD 只改变那些被跟踪链接使用的域名。它不改变被跟踪的内容：点击统计数据和 [点击地图](/zh/product/statistics-and-analytics/messaging-statistics/email-statistics/#clicks-tab) 在有无 CTD 的情况下工作方式相同。

要设置自定义跟踪域名：

1. 决定您将使用哪个子域名作为您的 CTD（例如，`click.yourdomain.com`）。
2. 在 Pushwoosh 中，打开 **设置**，然后选择 **配置平台**。
3. 在 **邮件渠道配置** 页面上，滚动到 **自定义跟踪域名** 并选择 **启用**。

<Aside type="note" >
**自定义跟踪域名** 部分仅在为您的应用程序配置了邮件渠道后才会显示。如果您没有看到它，请先完成 [邮件配置](/zh/product/first-steps/start-with-your-project/configure-platforms/email-verification/)。
</Aside>

<img src="/integrations-appsflyer-esp2-email-integration-2.webp" alt="Pushwoosh 控制面板显示设置、配置平台、邮件渠道配置以及带有启用控件的自定义跟踪域名卡片。"/>

4. 在 **域名** 字段中输入您的 CTD，然后选择 **下一步**。

<img src="/integrations-appsflyer-esp2-email-integration-3.webp" alt="启用自定义跟踪域名对话框，其中包含用于输入 CTD 的域名字段以及取消和下一步按钮。"/>

5. 在 Pushwoosh 之外，打开您管理 CTD 域名公共 DNS 的服务（通常是您的域名注册商、DNS 主机或您的托管账户）。在其该域名的 DNS 或区域编辑器中，添加 Pushwoosh 在此步骤中显示的 **CNAME**，以便您的 CTD 指向 `api.pushwoosh.com`。

<Aside type="note" title="DNS 传播">
DNS 更改通常在几分钟内生效，但最多可能需要 48 小时。
</Aside>

6. 在 Pushwoosh 中，选择 **验证**。

<img src="/integrations-appsflyer-esp2-email-integration-4.webp" alt="自定义跟踪域名 DNS 验证步骤，显示 CNAME 目标 api.pushwoosh.com 以及返回、验证和保存控件。"/>

7. 验证成功后，选择 **保存**。
8. 如果您需要更改 **域名** 或 DNS 记录，请选择 **返回** 并调整之前的步骤。

9. 点击 **保存** 后，您的 CTD 将出现在 **邮件渠道配置** 的 **自定义跟踪域名** 列表中。

<img src="/integrations-appsflyer-esp2-email-integration-5.webp" alt="邮件渠道配置中的自定义跟踪域名部分，显示列表中已保存的点击跟踪域名。"/>

要稍后禁用它，请选择您的 CTD 旁边的 `...`，然后选择 **禁用自定义跟踪域名**。