iOS通过Dynamic Link从App Store安装应用无法获取推荐码问题

问题根因 #

• 延迟深度链接匹配逻辑限制：Dynamic Link（以下简称FDL）的首次安装参数传递依赖模糊指纹匹配，后台通过用户点击链接时的IP、设备型号、系统版本、时间窗口等特征，和用户首次打开App时上报的特征做匹配，正式环境下如果用户点击链接后切换网络（比如WiFi切蜂窝）、安装等待时间超过1小时、IP地址发生变化，都会导致匹配失败，返回空参数。而已安装用户点击链接唤起App走的是系统Universal Link回调，参数由系统直接传递，不需要后台匹配，所以不会触发该问题。
• 正式包配置缺失：Debug开发环境的配置没有同步到Release正式打包环境，常见情况包括正式包未正确配置Associated Domains、FDL域名未加入Universal Link信任列表、打包用的Bundle ID/Team ID和FDL后台绑定的正式包信息不匹配，导致FDL SDK无法合法请求归因参数。
• 代码逻辑时序错误：首次启动时过早调用FDL参数获取接口，SDK未完成初始化和后台归因请求就返回了空值；或者仅实现了Universal Link唤起的参数接收逻辑，没有兼容冷启动场景下的延迟深度拉取逻辑。
• 隐私权限限制：iOS 14.5+系统下用户拒绝IDFA授权后，FDL的精确匹配能力下降，模糊匹配的准确率通常仅为60%~80%，会出现一定比例的首次安装参数获取失败。

解决方案 #

1. 新增兜底逻辑提升匹配成功率 #

不要完全依赖FDL的原生匹配能力，新增剪贴板兜底方案：用户点击FDL跳转App Store前的中转页，自动将推荐码写入系统剪贴板，用户首次打开App进入注册/登录环节时，优先读取剪贴板的推荐码，读取不到再取FDL返回的参数，该方案可将参数获取成功率提升至95%以上。注意适配iOS 16+的剪贴板权限弹窗，避免刚打开App就触发权限申请引起用户反感。

2. 修正正式环境配置 #

• 检查Xcode中Release模式下的Signing & Capabilities配置，确保Associated Domains中已添加applinks:开头的FDL域名，格式为applinks:xxx.page.link
• 确认FDL后台绑定的iOS应用信息和正式上架包完全一致，包括Bundle ID、Team ID、App Store ID，且正式打包用的GoogleService-Info.plist是从FDL后台正式应用配置项下导出的
• 确保FDL SDK的初始化逻辑放在didFinishLaunchingWithOptions方法最前端，参数获取逻辑在SDK初始化完成后触发

3. 补全参数获取代码逻辑 #

同时实现Universal Link唤起和冷启动延迟深度链接两种场景的参数接收逻辑，示例代码（Swift）：

// 处理已安装用户Universal Link唤起场景
func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
    if let webpageURL = userActivity.webpageURL {
        DynamicLinks.dynamicLinks().handleUniversalLink(webpageURL) { [weak self] dynamicLink, error in
            guard let dynamicLink = dynamicLink, let deeplinkUrl = dynamicLink.url else {
                // 匹配失败，走剪贴板兜底
                return
            }
            self?.handleDeeplinkUrl(deeplinkUrl)
        }
    }
    return true
}

// 处理首次安装冷启动场景
func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    if let dynamicLink = DynamicLinks.dynamicLinks().dynamicLink(fromCustomSchemeURL: url) {
        guard let deeplinkUrl = dynamicLink.url else {
            // 匹配失败，走剪贴板兜底
            return false
        }
        handleDeeplinkUrl(deeplinkUrl)
        return true
    }
    return false
}

4. 适配隐私权限提升匹配率 #

如果你的应用符合苹果广告追踪规范，可在用户首次打开App时先申请IDFA权限，再触发FDL参数获取逻辑，可大幅提升正式环境的匹配准确率。

内容的提问来源于stack exchange，提问作者Pradeep Mithna