OneLink：什么是深层链接技术和安装归因

什么是OneLink？

OneLink是AppsFlyer的智能深层链接创建技术，允许通过链接传递归因参数并将用户操作关联到特定广告来源。它解决了移动营销的关键问题：广告点击与应用安装之间的联系。

普通深层链接可以打开应用并传递基本参数，但在通过应用商店时会丢失流量来源信息。OneLink使用URL参数、设备标识符和指纹识别技术的组合来在安装后恢复归因。这使营销人员能够看到哪个活动、素材和渠道导致了转化——注册、购买或其他目标事件。

OneLink适用于所有平台：iOS（Universal Links）、Android（App Links）、网页浏览器甚至桌面应用。链接通过AppsFlyer控制面板或通过REST API以编程方式生成，允许为每个活动实时动态设置参数。

OneLink如何工作？

OneLink的工作原理基于三个连续阶段：点击链接、安装应用和匹配事件。在每个阶段，OneLink使用组合方法保留和传递归因数据，以精确定位流量来源。

OneLink链接的结构

OneLink链接具有特殊格式，包括AppsFlyer域名、应用标识符和活动参数。标准模板看起来像https://app.onelink.me/{app-id}?pid={source}&c={campaign}&af_dp={deeplink}。参数pid（媒体来源）表示流量来源，c表示活动名称，af_dp表示应用内的深层链接。

https://app.onelink.me/A1b2C3d4?pid=facebook&c=summer_campaign&af_dp=myapp://promo/summer2026&af_click_lookback=7d

af_dp参数设置如果应用已安装用户将前往的深层链接。对于新用户，延迟深层链接机制被激活：安装并首次启动后，SDK确定保存的参数并将用户引导到目标屏幕。af_click_lookback参数定义归因窗口——点击被视为导致安装的期间。

归因机制

点击OneLink链接后，AppsFlyer记录点击并将其与唯一点击标识符关联。当用户安装并打开应用时，AppsFlyer SDK向服务器发送带有设备标识符（iOS上的IDFA，Android上的GAID）的请求。服务器将点击标识符与安装匹配并确定流量来源。

如果未找到基于ID的精确匹配（例如，用户禁用了广告标识符），则使用指纹识别——分析IP地址、设备型号、操作系统版本和时间戳。根据AppsFlyer的数据，即使没有广告ID，指纹识别在iOS上提供92-95%的归因准确率，在Android上提供95-97%。确定性方法（IDFA/GAID）和概率方法（指纹识别）的组合提供了最全面的流量来源画像。

OneLink vs 普通深层链接

OneLink与普通深层链接的关键区别在于在整个用户路径中保留归因的能力。普通深层链接（例如myapp://screen）可以打开应用，但如果用户刚刚从商店安装了应用，则无法确定用户来自哪里。

OneLink使用自己的SDK跟踪应用内事件并自动将其关联到归因数据。这允许在整个漏斗中生成报告：从广告展示到购买、退款或第7天用户留存。普通深层链接不提供这种能力——它们仅作为导航机制运行，没有分析和营销归因层。

OneLink的应用场景

OneLink广泛用于需要将用户操作精确定位到广告来源的各种营销场景。主要应用领域包括吸引新用户、召回现有用户和衡量每个渠道的有效性。

安装广告活动

在启动安装广告（UA活动）时，OneLink链接被放置在Facebook Ads、Google Ads、TikTok、Snapchat和其他平台的广告中。pid参数唯一标识平台，附加参数c（campaign）指定具体活动。AppsFlyer自动将点击与安装匹配，并为每个来源显示CPI（每次安装成本）、CR（转化率）和ROAS（广告支出回报率）报告。

再定位和重新参与

对于已安装应用的用户，OneLink支持再定位活动。当现有用户点击链接时，OneLink打开应用并传递促销参数，如个人折扣或奖励。AppsFlyer通过is_retargeting标志区分新用户和回访用户，并为每种流量类型生成单独报告——这对于正确计算LTV（生命周期价值）很重要。

自然流量的延迟深层链接

OneLink不仅用于付费活动，还用于自然流量：电子邮件简报、短信、二维码和社交媒体中的链接。如果用户未安装应用，OneLink将其引导到App Store或Google Play，安装后则引导到目标页面：产品页面、文章、个人资料或促销优惠。延迟深层链接对转化至关重要，因为它消除了用户执行操作的愿望与手动查找相应部分的必要之间的摩擦。

合作伙伴计划和影响者营销

OneLink支持为每个合作伙伴或影响者生成唯一链接。af_sub1参数可以包含合作伙伴ID，af_sub2可以包含帖子或视频的名称。这使营销人员能够看到哪些内容带来最多的安装和转化，并基于数据而非猜测优化预算。

在项目中设置OneLink

OneLink的正确运行需要在移动应用中集成AppsFlyer SDK。该过程包括安装SDK、配置OneLink域名以及通过平台的系统机制处理传入的深层链接——iOS上的Universal Links和Android上的App Links。

集成AppsFlyer SDK

SDK通过标准依赖管理器安装。在Android上，在Gradle中添加依赖项；在iOS上，通过CocoaPods或Swift Package Manager安装。安装后，SDK使用从AppsFlyer控制面板获取的开发密钥初始化，并自动开始跟踪安装和事件。

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        AppsFlyerLib.getInstance()
            .start(this, "YOUR_DEV_KEY")
    }

    override fun onNewIntent(intent: Intent?) {
        super.onNewIntent(intent)
        AppsFlyerLib.getInstance()
            .onNewIntent(this, intent)
    }
}

在上面的示例中，SDK在主Activity的onCreate方法中使用开发密钥初始化。如果应用已在运行，onNewIntent方法对于处理深层链接是必需的。没有这个调用，来自OneLink链接的重复打开的归因将不会被记录，这会扭曲再定位活动的统计数据。

配置Universal Links（iOS）

对于iOS，需要配置Universal Links：添加包含OneLink域名（app.onelink.me）的entitlements，并将apple-app-site-association文件放在服务器上。在面板中配置OneLink时，AppsFlyer会自动生成此文件，开发人员只需添加entitlement并在AppDelegate中处理传入的链接即可。

import AppsFlyerLib

class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        continue userActivity: NSUserActivity,
        restorationHandler: Any?
    ) -> Bool {
        AppsFlyerLib.shared()
            .continue(userActivity, restorationHandler: nil)
        return true
    }
}

continue userActivity方法在通过Universal Link时由系统调用。在其中，调用AppsFlyerLib.shared().continue方法，该方法从链接中提取归因参数并将其发送到服务器。类似的方法在Android上通过带有auto-verify的Intent Filter用于App Links。

集成完成后，可以通过AppsFlyer面板或API为每个广告活动生成OneLink链接。重要的是在所有平台上测试链接：在新安装的应用中（延迟）、在已安装的应用中（直接）以及在未安装应用的网页上。测试通过AppsFlyer Test Link工具进行，该工具模拟所有平台上的行为，无需在商店发布。

使用OneLink时需要考虑平台限制：在iOS引入App Tracking Transparency（ATT）后，访问IDFA需要用户明确同意，这降低了确定性归因的准确性。Google也在Android 14+及更高版本上限制GAID的使用，需要用户确认。在这种情况下，指纹识别成为主要的归因方法，其准确性直接取决于数据质量——SDK收集的签名越多，点击与安装正确匹配的可能性就越高。