概览：按照我们的分步指南，从 Firebase Dynamic Links 迁移到 AppsFlyer OneLink。
关于迁移
Google 的 Firebase Dynamic Links 将于 2025 年 8月 25 日弃用。自该日起，Firebase Dynamic Links 提供的所有链接（包括托管在自定义域名和 page.link 子域名下的链接）都将失效，且无法创建新链接。如果您使用 Firebase Dynamic Links，请尽快采取措施，将链接迁移到其他服务，以免广告系列的用户路径中断。
借助 AppsFlyer OneLink，您可以轻松为自有媒体或付费媒体创建具备归因、跳转和深度链接功能的链接，不受设备、操作系统、渠道或平台限制。与 AppsFlyer 合作，创建个性化、场景化的用户路径，引导用户进入您的应用，最大限度提高转化率和收入。按照以下说明，即可将 Firebase Dynamic Links 迁移到 AppsFlyer。
从 Firebase 迁移到 AppsFlyer
本节介绍如何将 Firebase 动态链接迁移到 AppsFlyer OneLink。
迁移到 AppsFlyer：
前期准备
开始之前，您需要准备：
- Firebase 中的动态链接
- 应用开发人员
第 1 步。创建 AppsFlyer 账户
第 2 步。添加您的应用
- 在 AppsFlyer 中添加您的 App 。
- 【可选】 再归因窗口期 <0>默认为90天，您可以根据自己对活跃用户的定义来调整该窗口。
第 3 步。创建 OneLink 模板（需与应用开发人员协作）
此步骤需要您和应用开发人员共同参与.
创建链接和终端用户体验前，必须先创建 OneLink 模板。您为各个广告系列创建的所有 OneLink 链接，其跳转逻辑均以该模板为基础。
-
创建 OneLink 模板
- 您必须是 AppsFlyer 管理员用户，或拥有 添加或编辑 OneLink 模板的权限
第 4 步。配置 AppsFlyer SDK（由应用开发人员完成）
此步骤需要应用开发人员参与。
接入应用的 AppsFlyer SDK 负责连接应用与 AppsFlyer 平台。实现以下功能：
- 深度链接 - SDK 支持实现统一深度链接（UDL）
- 归因 — SDK 上报应用激活、应用打开、应用内事件等。
按照以下步骤将 AppsFlyer SDK 接入您的应用。
AppsFlyer SDK 对接步骤
- 将 AppsFlyer SDK 接入应用。
请参阅 Android 和 iOS 的 SDK 对接指南。 - 使用 AppsFlyer 的事件定义，映射您希望记录的应用内事件。
您可以通过 SDK 或 S2S 完成此操作。 -
处理 Firebase 的 SDK。
您可以删除其他SDK，直接切换到AppsFlyer，或将其他SDK保留数周，在过渡期间同时使用两个SDK。下表对这两种方案进行了分析对比。
操作 发布更新版应用后
的情况影响 移除 Firebase 的 SDK（推荐） 只有 AppsFlyer 会记录新安装和更新应用的用户。
在用户也更新其应用之前，Firebase 仍会显示用户执行的事件。- 快速过渡
- 无重复归因
- 您可以查看是否仍有应用版本保留 Firebase SDK
在过渡期内保留 Firebase 的 SDK AppsFlyer 和 Firebase 都会对新安装进行归因并报告事件。在稍后的某个时间，移除 Firebase 的 SDK。 - 可以进行数据验证。也就是说，您可以比较 AppsFlyer 和 Firebase 提供的数据
- 重复归因，可能导致广告平台重复收费
- 工作量更大
- 完成工作范围内的所有其他任务后，将包含 AppsFlyer SDK 的应用版本更新到市场中。新用户由 AppsFlyer 进行归因。
注意：- 请确保在 iOS、Google Play 以及所有相关的 Android 非官方应用市场中更新应用。
- 安卓应用可能会有非官方的 APK 下载渠道（请使用您的应用包名进行搜索，检查是否存在这种情况）。 APK 网站更新到最新应用版本需要一些时间，因此自然用户仍可能通过这些网站安装不包含 AppsFlyer SDK 的旧版本。
- 应用商店可能需要几天时间才能完成应用更新的全面发布。在此期间安装应用的用户仍可能获得旧版本。
第 5 步。了解参数映射（应用开发人员的任务）
此步骤需要应用开发人员参与.
了解 Firebase Dynamic Links 参数如何映射到 AppsFlyer 的相应参数。
正确映射并理解相应参数将确保您的链接获得相同的结果。
下表列出了 Firebase 的所有参数及对应的 AppsFlyer 参数。
迁移至 AppsFlyer 时，请参考此表，查找您目前使用的所有参数所对应的 AppsFlyer 参数。
注意
如果表中没有列出某个 Firebase 参数，是因为 AppsFlyer 已在 OneLink 模板设置中涵盖了该参数，您无需在链接中添加该参数。
| 分组 | Firebase | AppsFlyer | 描述 |
|---|---|---|---|
| 移动端参数 | 链接 |
|
|
|
安卓参数 |
afl | af_android_url | 可将 Android 用户引导至自定义网页（该网页的域名必须列入跳转允许列表） |
| iOS 参数 |
ifl | af_ios_url | 可将 iOS 用户引导至自定义网页（该网页的域名必须列入跳转允许列表） |
| efr | af_force_deeplink | 用于通过 af_dp URI scheme 强制打开 iOS 应用。若不添加此参数，系统不会使用 URI scheme 打开应用 | |
| 其他平台的 URL | ofl | af_web_dp | 将桌面端用户跳转至自定义网页 |
|
社交媒体标签 |
st | af_og_title | 用于自定义社交媒体上分享内容的标题 |
| sd | af_og_description | 用于自定义社交媒体上分享内容的描述 | |
| si | af_og_image | 用于自定义社交媒体上分享内容的图片 | |
|
分析参数 |
utm_source | pid | 媒体渠道 |
| utm_medium | af_channel | 用于标识分发广告的媒体渠道 | |
| utm_campaign | c | 投放活动名称 | |
| utm_term | af_keywords | 文本定向投放广告系列的关键词列表 | |
| utm_content | af_adset | 与某个广告系列关联的一组广告 |
第 6 步。使用已映射的参数创建 OneLink 链接
您可以使用已映射的参数，在您的 OneLink 模板中创建 OneLink 链接。
您可以通过 CSV 文件批量创建链接，使用 OneLink API 以编程方式创建链接，使用 AppsFlyer 数据面板 逐个创建链接，在 SDK 中创建链接，或手动构建 长链接。
请参考下表，选择最适合您需求的方式。
| Firebase | AppsFlyer | 适用场景 | 注意事项 |
|---|---|---|---|
| Firebase 控制台 | OneLink 管理页面 | 您希望逐个创建 OneLink 链接。通过这种方式，您可以充分利用 OneLink 的全部功能和可能性 | |
| Dynamic Link Builder API | SDK | 您希望在应用内以编程方式生成链接，用于用户邀请和推荐等场景 |
|
| Firebase REST API | OneLink API | 您希望在移动应用之外以编程方式创建链接 |
|
| 手动创建链接 | 长链接 | 您希望使用查询参数手动创建链接。适用于不需要短链的场景，例如链接位于按钮或横幅后方 | |
| 批量链接 |
您希望将所有 Firebase 动态链接批量迁移到 AppsFlyer。 建议您使用这种方式，以快速无误地迁移所有链接 |
|
|
| 智能横幅 | 您希望在移动网页端创建横幅，通过深度链接将用户引导至应用 | ||
| 智能脚本 | 如果您希望在网页中动态创建长链，用于网页到应用的体验 |