# AppsFlyer ESP 2.0 集成

<Aside type="caution" icon="setting" title="需要开发者协助">
您需要开发团队的帮助来设置此集成。请与他们分享本指南。
</Aside>

[AppsFlyer](https://www.appsflyer.com/) 是一个移动归因和营销分析平台。[AppsFlyer ESP 2.0](https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide) 是 AppsFlyer 为电子邮件服务提供商 (ESP) 提供的集成方案。将 Pushwoosh 与 ESP 2.0 连接，以在电子邮件营销活动中启用链接跟踪。在此集成中，Pushwoosh 会包装 URL，而 ESP 2.0 解决方案则在链接被包装以进行跟踪时，保持 iOS Universal Links 和 Android App Links 的深度链接功能正常工作。

此集成还会将链接点击数据发送到 AppsFlyer，让您全面了解电子邮件的表现以及其他营销渠道的表现，并衡量电子邮件对用户获取和参与度的实际影响。

## 集成概述


### 先决条件

* 已[配置电子邮件发送](/zh/product/first-steps/start-with-your-project/configure-platforms/email-verification/)的 Pushwoosh 应用程序
* 拥有 [AppsFlyer ESP 2.0 集成](https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide)的 AppsFlyer 账户。这是一项高级功能。请联系您的 AppsFlyer CSM 或 AppsFlyer 支持以获取访问权限。



### 同步实体

通过您的点击跟踪域 (Click Tracking Domain) 发生的电子邮件链接点击，在 Pushwoosh 中被记录为点击统计数据，在 AppsFlyer 中则被记录为带有归因数据的点击事件。

### 使用场景

* **电子邮件点击跟踪：** 通过 AppsFlyer 衡量电子邮件链接点击。
* **从电子邮件进行深度链接：** 在电子邮件中的链接被包装时，保持 Universal Links (iOS) 和 App Links (Android) 的正常工作。

### 集成工作原理


集成生效后，每次点击都会经过三个步骤：

1. Pushwoosh 会将您电子邮件中的链接替换为您 CTD 上的跟踪 URL，例如：
   `https://clickpush.yourdomain.com/json/1.3/emailRedirect?d=...`

2. 当用户点击链接时，请求会通过配置的 CNAME 发送到 AppsFlyer。AppsFlyer 会记录归因、处理深度链接，并将用户重定向到最终 URL 或通过 Universal Link / App Link 进入应用程序。它还会向 Pushwoosh 发送一个 GET 请求，在 Host 标头中传递您的 CTD，以便 Pushwoosh 记录点击：
```
   GET https://<Pushwoosh CNAME target>/json/1.3/emailRedirect
   Host: <your CTD>
```

3. Pushwoosh 收到请求并为自己的统计数据记录点击。

## 设置集成

<Aside type="note" title="Pushwoosh 与 AppsFlyer">
Pushwoosh 仅参与初始的 CTD 设置。集成的其余部分在 AppsFlyer 端完成。
</Aside>

### 步骤 1. 创建并激活点击跟踪域

**点击跟踪域 (Click Tracking Domain, CTD)** 是电子邮件中显示的被跟踪链接 URL 的域名部分。它由一个子域名和您的主域名组成，例如 `clickpush.esp-integrations1.com`。子域名是在您的域名提供商的 DNS 设置中创建的，通常通过添加 CNAME 记录来完成。
<Aside type="caution" title="需要新的 CTD">
对于 AppsFlyer ESP 2.0 集成，必须创建一个新的 CTD，即使您已经在使用现有的点击跟踪域。使用新的 CTD 可以避免影响您当前电子邮件营销活动的流量。

有关详细信息，请参阅 AppsFlyer 的指南：[设置您的 ESP 与 AppsFlyer 的集成](https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer#step-1-create-a-onelink-template-for-your-email-campaign)。
</Aside>

1. 确定您将用作 CTD 的子域名（例如 `clickpush.esp-integrations1.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 控制面板：Settings (设置)、Configure Platforms (配置平台)、Email channel configuration (电子邮件渠道配置)、Custom tracking domain (自定义跟踪域) 及 Enable (启用) 按钮。"/>

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

<img src="/integrations-appsflyer-esp2-email-integration-3.webp" alt="启用自定义跟踪域对话框：Domain (域名) 字段、Cancel (取消) 和 Next (下一步) 按钮。"/>

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 步骤：指向 api.pushwoosh.com 的 CNAME、Back (返回)、Verify (验证) 和 Save (保存) 按钮。"/>

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。"/>

要稍后禁用它，请选择您的 CTD 旁边的 `...`，然后选择 **Disable custom tracking domain** (禁用自定义跟踪域)。

<Aside type="tip">
在继续之前，请发送一封测试电子邮件并确认链接使用了您的 CTD。

**跟踪链接示例**

`https://clickpush.example.com/json/1.3/emailRedirect?d=...`
</Aside>

### 步骤 2. 在 AppsFlyer 中开始集成

在 [AppsFlyer 平台](https://hq1.appsflyer.com/)中，开始 ESP 2.0 集成。请遵循 [AppsFlyer 设置 ESP 集成的指南](https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer)。

AppsFlyer 将要求您提供以下详细信息：

* **点击跟踪域：** 您的 CTD (例如 `clickpush.example.com`)
* **ESP 端点：** `api.pushwoosh.com` (在 Pushwoosh 中启用自定义跟踪域时显示的 CNAME 目标)

AppsFlyer 将验证配置。在验证完成之前，请保持 CTD CNAME 指向 **`api.pushwoosh.com`**。

### 步骤 3. 将 CNAME 更新到 AppsFlyer

在 AppsFlyer 验证设置后，它会给您一个路由域（例如 `jyvls.espclicks.appsflyer.com`）。

更新您的 CNAME，使 CTD 指向 AppsFlyer 而不是 Pushwoosh：

**之前：**

`clickpush.example.com` → `api.pushwoosh.com`

**之后：**

`clickpush.example.com` → `jyvls.espclicks.appsflyer.com` (使用 AppsFlyer 提供的域名)

<Aside type="note" title="传播时间">
更新 CNAME 后，集成最多可能需要 24 小时才能开始工作。
</Aside> 

切换 CNAME 后，发送一封测试电子邮件，并验证链接是否能正确打开，以及点击是否出现在 AppsFlyer 中。

## 接下来会发生什么

更改生效后，点击流量将通过 AppsFlyer 的基础架构。AppsFlyer 提供路由层、SSL、AASA (Apple App Site Association) 和 Android App Links。

Pushwoosh 会继续包装链接并记录点击统计数据。在 Pushwoosh 中无需进一步配置。

要了解有关在 AppsFlyer 端进行设置和测试的更多信息，请参阅：

<LinkCard title="设置您的 ESP 与 AppsFlyer 的集成" href="https://support.appsflyer.com/hc/en-us/articles/26967438815377-Set-up-your-ESP-integration-with-AppsFlyer#step-5-test-the-link" />

<LinkCard title="电子邮件服务提供商集成指南" href="https://support.appsflyer.com/hc/en-us/articles/360004556077-Email-service-provider-ESP-integration-guide" />