深入解析移动端注册归因架构：从动态参数透传到时序数据闭环

text[渠道 A/B/C 专属推广物料]
          │ (携带自定义业务参数: channel_code, activity_id, tracker_id)
          ▼
[用户访问 H5 落地页并触发下载]
          │
          ├─► 1. 注册云端临时会话 (记录网络特征摘要与挂载业务参数)
          │
          ▼
[用户跳转应用商店 / 下载并安装 App]
          │
          ▼
[App 首次冷启动初始化 SDK]
          │
          ├─► 2. 向云端发起握手比对 ──► 匹配成功并解析下发原始渠道参数
          │
          ▼
[用户触发并完成端内注册]
          │
          ├─► 3. 客户端上报注册事件 (Report Register Event)
          │
          ▼
[归因系统计算中枢] ── 绑定渠道参数与真实业务 UID ──► [输出多维渠道转化数据]

javapackage com.tencent.growth.attribution;

import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.text.TextUtils;
import androidx.appcompat.app.AppCompatActivity;

/**
 * 启动页归因与场景还原调度
 */
public class SplashActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        // 1. 隐私合规强前置：必须在用户同意隐私政策后方可初始化数据组件
        if (PrivacyManager.isAgreed(this)) {
            initAttributionPipeline();
        } else {
            showPrivacyConsentDialog(() -> {
                PrivacyManager.setAgreed(this, true);
                initAttributionPipeline();
            });
        }
    }

    @Override
    protected void onNewIntent(Intent intent) {
        super.onNewIntent(intent);
        setIntent(intent);
        // 处理已安装用户被推广短链/Scheme 再次拉起时的唤醒参数
        handleDeepLinkWakeUp(intent);
    }

    private void initAttributionPipeline() {
        // 初始化端侧归因网络中枢
        AttributionClient.init(this);

        handleDeepLinkWakeUp(getIntent());
        fetchInstallChannelContext();
    }

    /**
     * 首次冷启动获取透传渠道与业务载荷
     */
    private void fetchInstallChannelContext() {
        AttributionClient.getInstallContext((channelData, error) -> {
            if (error != null) {
                // 网络异常或握手超时：记录为待补偿状态，不可直接武断标记为自然量
                ChannelStorage.markPendingCompensation();
                return;
            }

            String channelCode = channelData == null ? "" : channelData.getChannelCode();
            String customJson = channelData == null ? "" : channelData.getCustomPayload();

            if (TextUtils.isEmpty(channelCode) && TextUtils.isEmpty(customJson)) {
                // 服务端明确无特征匹配记录：按自然量处理
                ChannelStorage.markOrganic();
                return;
            }

            // 缓存来源上下文
            ChannelStorage.save(channelCode, customJson);

            // 执行端内业务履约：
            // 1. 本地持久化渠道标示，在注册协议与用户中心落库
            // 2. 解析透传参数，执行免填码预绑好友关系或新人券静默发放
            // 3. 路由调度至对应活动承接页 (Deferred DeepLink)
        });
    }

    /**
     * 处理已安装存量用户的热启动拉活
     */
    private void handleDeepLinkWakeUp(Intent intent) {
        AttributionClient.getWakeUpContext(intent, (channelData, error) -> {
            if (error != null || channelData == null) {
                return;
            }
            // 业务处理：解析目标 URL 并触发端内动态路由分发
            String targetRoute = channelData.getTargetRoute();
            if (!TextUtils.isEmpty(targetRoute)) {
                AppRouter.navigate(this, targetRoute);
            }
        });
    }
}