# 邮件平台配置

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

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

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

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

1. 导航至 **Settings > Configure platforms**。

2. 找到 **Email message** 并点击 **Configure**。

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

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

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

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

5. 在 **Tell us about how you’ll be using Pushwoosh** 字段中，提供您打算如何使用 Pushwoosh 进行邮件营销的详细信息。包括以下信息：

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

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


填写完所有信息后，点击 **Verify my account** 提交您的请求。Pushwoosh 将审核您的详细信息并尽快回复。

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

为此：

1. 前往 **Settings**。
2. 选择 **Configure platforms**。
3. 点击邮件平台旁边的 **Continue configuration**。

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

## 配置发件人详细信息

### 添加域名

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

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

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

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

##### 发件人地址

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

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

<Aside type="caution" title="在客户旅程和一次性邮件中如何确定发件人详细信息">
当[邮件内容](/zh/product/content/email-content/set-up-your-email-in-the-editor/#configure-the-sender-settings)或旅程（或一次性邮件）步骤中未设置发件人时，将使用这些默认发件人详细信息。在[客户旅程步骤](/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)中设置的发件人会覆盖邮件内容和平台默认设置。在[邮件内容](/zh/product/content/email-content/set-up-your-email-in-the-editor/#configure-the-sender-settings)中设置的发件人会覆盖平台默认设置。
</Aside> 

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

如果您希望收件人的回复直接发送到发件人的电子邮件地址，请选中 **Use this as reply-to address to track replies** 复选框。

##### 回复地址

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

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

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

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

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

## 配置 DNS 记录

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

</Aside>

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

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


### DKIM 记录（必需）

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

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

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

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

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

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

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

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

添加 DNS 记录后，点击 **Check DNS Records** 刷新验证状态。一旦验证成功，域名验证状态将变为 **Verified**。

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

#### 发送测试邮件

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

要发送测试邮件：

1. 在 **Email Channel Configuration** 部分，点击 **Send test email**。

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

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

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

### SPF 记录（必需）

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

<Aside type="note">
 在添加新的 SPF 记录之前，请检查您的域名是否已有 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 记录的说明。"/>

### DMARC 验证（必需）

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

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

要配置 DMARC：

1. 复制 DMARC TXT 记录

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


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

### 选择不同的域名

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

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

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

## 配置链接跟踪

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

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

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

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

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

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

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

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

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

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

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

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

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

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

### 配置状态

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

*   未指定**默认发件人详细信息**。[了解更多关于默认发件人详细信息的信息](/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="邮件平台状态显示未验证域名警告消息。"/>

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

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

此外，此部分还显示每个验证记录（DKIM、SPF、DMARC）的状态为 **Verified** 或 **Pending**。**Pending** 表示该记录正在等待验证或尚未配置。

点击 **Update status** 刷新每个域名的验证状态。

##### 添加域名

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

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

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

1. 在 **Your Sender Domains** 中，找到要删除的域名。
2. 点击域名旁边的**三点菜单**，然后选择 **Delete domain**。
3. 确认删除，或点击 **Cancel** 保留该域名。

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


##### 发送测试邮件

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

为此，请点击已配置域名旁边的三点菜单，然后选择 **Send Test Email**。请注意，此选项仅适用于已完全配置的域名。

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

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

*   **From Address**：将作为发件人显示在邮件中的姓名和电子邮件地址。
*   **Reply-To Address**：回复的默认姓名和电子邮件。

要进行更改，请点击 **Edit default sender details**。

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

### Google Analytics URL 跟踪

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

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

## 通过 Pushwoosh API 配置邮件

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

## 设置订阅偏好中心

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



## 设置自定义跟踪域名


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

要设置自定义跟踪域名：

1. 决定您将使用哪个子域名作为您的 CTD（例如，`click.yourdomain.com`）。
2. 在 Pushwoosh 中，打开 **Settings**，然后选择 **Configure Platforms**。
3. 在 **Email channel configuration** 页面上，滚动到 **Custom tracking domain** 并选择 **Enable**。

<Aside type="note" >
**Custom tracking domain** 部分仅在为您的应用程序配置了邮件渠道后才会显示。如果您没有看到它，请先完成[邮件配置](/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. 在 **Domain** 字段中输入您的 CTD，然后选择 **Next**。

<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 中，选择 **Verify**。

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

7. 当验证成功时，选择 **Save**。
8. 如果您需要更改 **Domain** 或 DNS 记录，请选择 **Back** 并调整之前的步骤。

9. 点击 **Save** 后，您的 CTD 会出现在 **Email channel configuration** 的 **Custom tracking domain** 列表中。

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

要稍后禁用它，请选择您的 CTD 旁边的 `...`，然后选择 **Disable custom tracking domain**。