AppsFlyer ESP 2.0 集成

需要开发者协助

您需要开发团队的帮助来设置此集成。请与他们分享本指南。

AppsFlyer 是一个移动归因和营销分析平台。AppsFlyer ESP 2.0 是 AppsFlyer 为电子邮件服务提供商 (ESP) 提供的集成方案。将 Pushwoosh 与 ESP 2.0 连接，以在电子邮件营销活动中启用链接跟踪。在此集成中，Pushwoosh 会包装 URL，而 ESP 2.0 解决方案则在链接被包装以进行跟踪时，保持 iOS Universal Links 和 Android App Links 的深度链接功能正常工作。

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

集成概述

先决条件

• 已配置电子邮件发送的 Pushwoosh 应用程序
• 拥有 AppsFlyer ESP 2.0 集成的 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 收到请求并为自己的统计数据记录点击。

设置集成

Pushwoosh 与 AppsFlyer

Pushwoosh 仅参与初始的 CTD 设置。集成的其余部分在 AppsFlyer 端完成。

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

点击跟踪域 (Click Tracking Domain, CTD) 是电子邮件中显示的被跟踪链接 URL 的域名部分。它由一个子域名和您的主域名组成，例如 clickpush.esp-integrations1.com。子域名是在您的域名提供商的 DNS 设置中创建的，通常通过添加 CNAME 记录来完成。

需要新的 CTD

对于 AppsFlyer ESP 2.0 集成，必须创建一个新的 CTD，即使您已经在使用现有的点击跟踪域。使用新的 CTD 可以避免影响您当前电子邮件营销活动的流量。

有关详细信息，请参阅 AppsFlyer 的指南：设置您的 ESP 与 AppsFlyer 的集成。

1. 确定您将用作 CTD 的子域名（例如 clickpush.esp-integrations1.com）。
2. 在 Pushwoosh 中，打开 Settings (设置)，然后选择 Configure Platforms (配置平台)。
3. 在 Email channel configuration (电子邮件渠道配置) 页面上，滚动到 Custom tracking domain (自定义跟踪域) 并选择 Enable (启用)。

注意

Custom tracking domain (自定义跟踪域) 部分仅在为您的应用程序配置了电子邮件渠道后才会显示。如果您没有看到它，请先完成电子邮件配置。

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

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

DNS 传播

DNS 更改通常在几分钟内生效，但最多可能需要 48 小时。

6. 在 Pushwoosh 中，选择 Verify (验证)。

7. 验证成功后，选择 Save (保存)。

8. 如果您需要更改 Domain (域名) 或 DNS 记录，请选择 Back (返回) 并调整之前的步骤。

9. 点击 Save (保存) 后，您的 CTD 会出现在 Email channel configuration (电子邮件渠道配置) 的 Custom tracking domain (自定义跟踪域) 列表中。

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

提示

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

跟踪链接示例

https://clickpush.example.com/json/1.3/emailRedirect?d=...

步骤 2. 在 AppsFlyer 中开始集成

在 AppsFlyer 平台中，开始 ESP 2.0 集成。请遵循 AppsFlyer 设置 ESP 集成的指南。

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 提供的域名)

传播时间

更新 CNAME 后，集成最多可能需要 24 小时才能开始工作。

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

接下来会发生什么

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

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

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

设置您的 ESP 与 AppsFlyer 的集成

电子邮件服务提供商集成指南