Remax SDK · AdRisk

在线参数说明

AdRisk 行为风控字段、模式、阈值与生效边界说明。

远程配置逻辑 Key Ad_Risk_Config

字段总表

字段 默认值 / 合法范围 含义与触发规则 配置范围 计数 / 冷却隔离
behavior_mode 2
只能为 0、1、2
0 关闭;1 执行;2 观察。模式切换会清空全部风控状态。 全局 控制整个 AdRisk 模块
mistake_click_time 20 秒
整数 ≥ 0
点击后 App 进程进入后台并返回,耗时 ≤ 此值算误触。0 不是关闭开关。 全局 每次点击旅程单独判断
mistake_click_count 2
整数 ≥ 0
误触累计第 N 次触发限制;0 不触发限制,但误触事件仍上报。 全局阈值 广告类型 + position
restrict_interval 1800 秒
整数 ≥ 0
执行模式的冷却时长;0 表示冷却立即结束,不关闭阈值事件。 全局时长 广告类型 + position
close_click_count 3
整数 ≥ 0
同一插页会话第 N 次点击触发强关;0 关闭强关。 全局,仅插页 点击按 sessionId
冷却按类型 + position
close_activity_class_names []
非空字符串数组
追加可内置强关的 Activity 完整类名;命中后主线程调用 finish()。 全局,仅插页 无计数;按当前 Activity 类名匹配
limits.<type>.request_limit 0
整数 ≥ 0
最多允许 N 次业务 AdMob 请求,第 N+1 次触发;0 不限制。预加载不计请求。 广告类型级 广告类型 + position
limits.<type>.show_limit 0
整数 ≥ 0
最多允许 N 次实际曝光,第 N+1 次触发;0 不限制。 广告类型级 广告类型 + position
limits.<type>.click_limit 0
整数 ≥ 0
最多允许 N 次点击,第 N+1 次触发;0 不限制。 广告类型级 广告类型 + position
limits.<type>.fill_fail_limit 0
整数 ≥ 0
连续加载失败第 N 次触发;成功即清零;0 不限制。预加载结果也参与。 广告类型级 广告类型 + position
当前没有 position 级配置。同类型的所有 position 共用阈值,但各自计数、各自冷却。 position 缺失时依次尝试会话位置、加载位置、adUnitId,最后使用 unknown。
强关白名单始终附加本地默认 com.google.android.libraries.ads.mobile.sdk.common.AdActivity; 在线数组为空也不会移除默认类名。

模式

behavior_mode = 0
关闭模式

不计数、不上报行为风控、不限制、不强关。

behavior_mode = 1
执行模式

记录并上报;写入冷却;命中插页强关类名时关闭 Activity。

behavior_mode = 2
观察模式

完整计数并在边界上报,但不冷却、不排除 AdMob、不强关。

触发边界

类型语义触发点示例:N = 3
request/show/click limit 最多允许 N 次 第 N+1 次 第 1~3 次允许,第 4 次触发
fill_fail/mistake/close count 累计达到 N 次 第 N 次 第 3 次立即触发

误触与强关

误触

必须先收到 CLICK。进程进入后台后返回,在时间窗口内算误触;未进入后台而收到 CLOSE,按 leave_time=0 算误触。

插页强关

同一 sessionId 达到 close_click_count 后立即冷却当前类型 + position,并检查当前 Activity;未命中时最多监听后续 5 秒内出现的新 Activity。

广告类型 Key

Key类型当前支持
app_open开屏是
interstitial插页是;支持强关
native原生是
bannerBanner是
rewarded激励是
full_screen_native全屏原生当前不处理

行为风控 JSON

展开配置示例
{
  "behavior_mode": 2,
  "mistake_click_time": 20,
  "mistake_click_count": 2,
  "restrict_interval": 1800,
  "close_click_count": 3,
  "close_activity_class_names": [],
  "limits": {
    "app_open":     { "request_limit": 0, "show_limit": 0, "click_limit": 0, "fill_fail_limit": 0 },
    "interstitial": { "request_limit": 0, "show_limit": 0, "click_limit": 0, "fill_fail_limit": 0 },
    "native":       { "request_limit": 0, "show_limit": 0, "click_limit": 0, "fill_fail_limit": 0 },
    "banner":       { "request_limit": 0, "show_limit": 0, "click_limit": 0, "fill_fail_limit": 0 },
    "rewarded":     { "request_limit": 0, "show_limit": 0, "click_limit": 0, "fill_fail_limit": 0 }
  },
  "vpn_ad_config": -1,
  "dns_ad_config": -1,
  "ip_ad_config": -1,
  "simulator_ad_config": -1,
  "adb_ad_config": -1,
  "sim_ad_config": -1,
  "no_gp_ad_config": -1,
  "sys_9_low_ad_config": -1,
  "play_ad_config": -1
}
vpn_ad_config、dns_ad_config、ip_ad_config、 simulator_ad_config、adb_ad_config、sim_ad_config、 no_gp_ad_config、sys_9_low_ad_config、play_ad_config 只能取 -1、0 或 1:-1 表示未配置、不限制, 0 表示限制 AdMob,1 表示限制全部广告平台。

配置来源优先级

有效远程配置 → Ad_Risk_Config 对应的本地缓存 → Assets → 硬编码默认值。

校验

数值必须在合法范围;强关类名元素不能是空字符串;缺失字段使用默认值,未知字段忽略。