Skip to content

Android — Adjust 事件追踪 ​

模块:tracking-adjust;实际状态:源码已合并到 roandroid-sdk/main,JUnit/AAR/MavenLocal/POM/独立消费工程构建通过,尚未发布到远程 Reposilite、未接正式游戏。

候选 Maven 坐标:com.ronpad.sdk:ro-tracking-adjust:0.1.0。只有正式发布和版本锁定后才可作为稳定依赖;源码 Gradle 模块可独立构建。

原生 Application 初始化示例 ​

java
Map<String, ROTrackingAdjust.Rule> rules = new HashMap<>();
rules.put("login_success", new ROTrackingAdjust.Rule(
    registeredEventToken, ROTrackingAdjust.Policy.ONCE_PER_ACCOUNT,
    Collections.singleton("channel")));

ROTrackingAdjust.Configuration config = new ROTrackingAdjust.Configuration(
    nativeAppToken, true, "events-v1", "game.company.example", rules);
ROTrackingAdjust.initialize(getApplicationContext(), config);

在已有游戏宿主的原 doTracking 内调用:

java
ROTrackingAdjust.track("login_success",
    Collections.singletonMap("channel", "android"),
    new ROTrackingAdjust.Scope(nativeAccountId, null, null),
    result -> { /* 仅表示客户端提交尝试 */ });

包含 ALWAYS、安装/账号/角色/交易一次五种策略,未注册丢弃、参数白名单、本地文件持久化和线程内锁;noBackupFilesDir 避免标准 Auto Backup 恢复去重状态。注意进程间共享、重装、设备和网络层仍需真实测试;没有 Adjust 服务端 exactly-once 承诺。

宿主配置:依赖官方 Adjust Android 5.8.0 + Install Referrer 2.2,来自 Maven 传递依赖;不要把厂商 AAR 二次打包。固定 Egret 工程 AGP/Gradle 较旧,必须以真实游戏构建结果判定兼容性。

每个能力独立发布与接入;正式项目验收必须使用真实游戏环境。