关于Branch.io深度链接：未安装App时的参数传递问题

嘿，这个问题刚好戳中了Branch最核心的安装归因能力——咱们不用手动折腾Install Referrer的底层细节，SDK已经帮咱们把整个流程封装好了，下面给你一步步拆解具体怎么处理：

当用户点击深度链接但App未安装时，Branch会把这个链接的参数和用户设备的唯一标识绑定起来。等用户从应用商店下载安装并首次启动App时，Branch SDK会通过系统的Install Referrer机制（Android是Google Play Install Referrer，iOS是SKAdNetwork等）拿到安装归因信息，自动拉取之前绑定的深度链接参数，然后通过initSession返回给你。

1. 确保依赖配置正确 #

首先在你的build.gradle（Module级别）里添加必要的依赖，保证SDK能正常获取安装归因：

dependencies {
    // Branch核心SDK
    implementation 'io.branch.sdk.android:library:5.+'
    // 推荐添加Google官方的Install Referrer库，提升归因准确性
    implementation 'com.android.installreferrer:installreferrer:2.2'
}

2. 调整Session初始化代码 #

你现有的initSession代码其实已经包含了处理安装后参数的逻辑，但要注意两个关键细节：

• 必须在App启动的第一个Activity（比如闪屏页SplashActivity或者主页面MainActivity）的onCreate和onNewIntent方法里都调用initSession，确保首次启动和后续跳转都能捕获参数。
• 首次启动App时，referringParams里就会包含原深度链接的参数，不管用户是直接启动还是通过链接唤起。

修改后的完整示例代码：

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        // 启动时初始化Branch Session
        initBranchSession(getIntent());
    }

    @Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);
        setIntent(intent);
        // 处理后续的Intent跳转（比如后台唤起）
        initBranchSession(intent);
    }

    private void initBranchSession(Intent intent) {
        Branch.getInstance().initSession(new Branch.BranchReferralInitListener() {
            @Override
            public void onInitFinished(JSONObject referringParams, BranchError error) {
                if (error == null) {
                    Log.i("BRANCH SDK", "获取到的参数：" + referringParams.toString());
                    // 这里统一处理深度链接参数，不管是已安装唤起还是安装后首次启动
                    handleDeepLinkParams(referringParams);
                } else {
                    Log.e("BRANCH SDK", "Session初始化失败：" + error.getMessage());
                }
            }
        }, intent.getData(), this);
    }

    private void handleDeepLinkParams(JSONObject params) {
        // 这里写你的业务逻辑，比如根据参数跳转对应页面
        String targetPage = params.optString("target_page");
        String productId = params.optString("product_id");
        if (!TextUtils.isEmpty(targetPage) && !TextUtils.isEmpty(productId)) {
            // 跳转到商品详情页，传递productId
            Intent detailIntent = new Intent(this, ProductDetailActivity.class);
            detailIntent.putExtra("product_id", productId);
            startActivity(detailIntent);
        }
    }
}

3. 验证流程是否正常 #

你可以用Branch后台的链接生成工具创建一个带自定义参数的测试链接（比如https://your-app-domain.app.link/test?target_page=product_detail&product_id=123），然后按以下步骤测试：

1. 卸载你的App
2. 用手机浏览器打开这个测试链接，会跳转到应用商店下载页
3. 下载安装完成后，直接点击“打开”启动App
4. 查看Logcat里的BRANCH SDK日志，应该能看到包含target_page和product_id的参数

• 别手动调用Install Referrer API：Branch SDK已经完全封装了这个逻辑，你只需要确保initSession调用正确就行，没必要自己去处理底层的归因请求。
• App签名要和Branch后台一致：如果你的App签名（debug/release）和Branch后台配置的不匹配，Branch无法关联用户的安装行为和原深度链接，就拿不到参数。
• 初始化时机要早：一定要在App启动的第一个Activity里初始化Session，否则可能错过首次启动的归因窗口，导致参数丢失。

这样下来，不管用户是已安装App时点击链接，还是未安装时下载后启动，你都能拿到原深度链接的参数啦！

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