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
相关产品推荐
相关产品推荐

