You need to enable JavaScript to run this app. iOS端Branch链接直接点击打开App无法捕获参数 仅Safari跳转正常
优惠活动
大模型
产品
解决方案
定价
更多

iOS端Branch链接直接点击打开App无法捕获参数 仅Safari跳转正常

跨应用直接点击Branch链接时参数获取异常说明

现有SDK集成代码

let branch = Branch.getInstance()
branch.initSession(launchOptions: launchOptions) { params, error in
            
    guard error == nil else { return }
    guard let userDidClick = params?["+clicked_branch_link"] as? Bool else { return }
            
     if userDidClick {
         guard let params = params as?  [String: AnyObject] else { return }
         print("deep link data: ", params)
         guard let type = params[kType] as? String else { return }
                
        }
}

分场景返回表现

  • 直接在WhatsApp、Slack、Skype内点击Branch链接唤起App,回调返回的参数为:[AnyHashable("+clicked_branch_link"): 0, AnyHashable("+is_first_session"): 0],无法读取到预设的自定义深度链接参数
  • 同一条Branch链接先在Safari中打开,再跳转唤起App时,回调可正常返回完整的深度链接参数,包含自定义业务字段:
    [AnyHashable("~creation_source"): 0, AnyHashable("+click_timestamp"): 1618546463, AnyHashable("~id"): 900551511xxx37328, AnyHashable("+match_guaranteed"): 0, AnyHashable("$one_time_use"): 0, AnyHashable("+clicked_branch_link"): 1, AnyHashable("region"): XX, AnyHashable("$ios_passive_deepview"): branch_passive_default, AnyHashable("+is_first_session"): 0, AnyHashable("type"): wallet, AnyHashable("$matching_ttl_s"): 7200, AnyHashable("~referring_link"): https://xxxxxx.app.link/8KxKoxmHGeb]

参数差异的核心原因

  • WhatsApp、Slack、Skype这类应用的内置WebView会默认拦截系统通用链接(Universal Link)的跳转流程,不会将完整的链接点击上下文透传给iOS系统。Branch SDK无法拿到对应的溯源信息完成服务端匹配,最终返回无匹配的默认参数
  • Safari作为系统级浏览器,可完整触发通用链接的跳转逻辑,将链接点击的时间戳、设备信息、来源等上下文透传给系统,Branch SDK可结合这些信息和服务端存储的历史点击记录完成匹配,正常返回对应链接的深度参数
  • Branch的点击匹配逻辑不会在客户端提前缓存链接参数:App唤起后,SDK才会结合系统透传的各类信息,和服务端的点击日志做匹配;一旦上游应用拦截了系统级的信息透传流程,就会直接匹配失败,对应+clicked_branch_link参数值为0

常见排查方向

  • 确认第三方应用的链接打开逻辑:如果WhatsApp、Slack、Skype将点击的链接强制走内置浏览器打开、或通过自定义URL Scheme跳转,会完全绕过通用链接的系统透传机制,直接导致匹配失败
  • 校验域名关联配置:确认Branch的关联域名没有被第三方应用的内置规则拦截,导致没有触发系统级的通用链接跳转流程

内容的提问来源于stack exchange,提问作者Usama Sadiq

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.25 00:36:08