Branch.io Android端延迟深度链接安装后丢失数据问题求助

解决方案 #

• 首先补充Google Install Referrer依赖，该组件是Android 10及以上版本 deferred deep link 高匹配率的必填依赖，在build.gradle中添加：

  implementation "com.android.installreferrer:installreferrer:2.2"
  

  缺失该依赖会导致Branch无法从Play Store获取安装归因参数，大概率出现首次安装匹配失败、参数丢失的问题。

• 升级Branch SDK版本，你当前使用的5.0.13属于5.x早期版本，存在已知的install请求返回参数缺失的bug，建议升级到5.2.0及以上的稳定版本。

• 调整测试流程，规避匹配失效问题：

  • 每次测试前必须完全卸载目标应用，同时清除点击Branch链接所用的浏览器缓存、Google Play服务缓存，避免SDK判定为非首次会话
  • 点击Branch链接跳转至Play Store页面后，等待15秒以上再安装应用，确保Branch后台完成点击事件的同步
  • 点击链接到首次启动应用的全程不要切换网络、不要开启VPN/代理，保证IP、设备指纹信息一致
  • 确认Branch后台填写的测试设备GAID（广告ID）和测试设备的实际GAID完全一致，测试模式下广告ID是核心匹配字段

• 修正SDK初始化和回调逻辑：

  • 在应用入口Activity的onStart方法中注册onInitFinished回调，不要只在Application中读取参数，避免SDK异步请求还未完成就提前读取空数据
  • 在入口Activity的onNewIntent中添加Branch.getInstance().handleIntent(intent, this)，确保跳转 intent 被正确传递给Branch SDK
  • 不要在onInitFinished回调触发前调用getFirstReferringParams()、getLatestReferringParams()，此时参数还未完成持久化存储

• 检查匹配兜底逻辑，若你测试时是通过Android Studio直接侧载应用而非从Play Store下载安装，默认的Install Referrer匹配会失效，此时需要在Branch后台开启指纹匹配兜底策略，测试阶段可以放宽匹配时效窗口到1小时，提高侧载场景的匹配成功率。

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