Admob插屏广告频率上限设置未生效及程序化查询需求

一、频率上限未生效的解决办法 #

• 核对关联关系：确认设置频率上限的广告系列确实绑定了目标Android广告单元，避免选错广告系列或输错广告单元ID。
• 检查规则细节：确认频率上限是设置在广告单元层级还是广告系列层级，若为广告系列层级，需保证该系列的投放优先级未被其他设置覆盖；同时确认规则受众范围是用户级还是设备级，避免与预期不符。
• 手动同步+清缓存：在AdMob后台触发“同步广告数据”操作；同时在测试设备上清除应用缓存和数据，避免本地旧缓存阻碍新配置生效。
• 排查测试环境干扰：若使用AdMob测试广告ID，部分频率规则可能不生效，切换到正式流量测试；另外检查是否存在第三方广告中介或自定义广告加载逻辑，绕过了AdMob的频率控制。
• 联系官方支持：上述步骤无效时，直接向AdMob提交工单，提供广告单元ID、广告系列ID、测试设备的AAID/IDFA及广告展示日志，让官方排查后台配置问题。

二、程序化查询频率上限的相关问题 #

目前Google Mobile Ads SDK未提供直接查询后台频率上限设置的API，无法在应用内直接获取该配置信息。

你可以自行在应用内实现本地频率控制逻辑，结合AdMob的广告展示回调统计次数，自主判断是否加载广告，示例代码如下（Kotlin）：

// 本地频率控制工具类示例
private val impressionRecords = mutableMapOf<String, MutableList<Long>>()
private const val TIME_WINDOW = 60 * 1000 // 1分钟时间窗口
private const val MAX_IMPRESSIONS = 3 // 最大展示次数

// 判断是否允许加载广告
fun isAdLoadAllowed(adUnitId: String): Boolean {
    val now = System.currentTimeMillis()
    val records = impressionRecords.getOrPut(adUnitId) { mutableListOf() }
    // 移除时间窗口外的旧记录
    records.removeIf { now - it > TIME_WINDOW }
    return records.size < MAX_IMPRESSIONS
}

// 广告展示时记录时间戳
fun recordAdImpression(adUnitId: String) {
    val records = impressionRecords.getOrPut(adUnitId) { mutableListOf() }
    records.add(System.currentTimeMillis())
    // 持久化记录，避免应用重启丢失数据
    saveRecordsToSharedPrefs(adUnitId, records)
}

// 持久化到SharedPreferences的方法
private fun saveRecordsToSharedPrefs(adUnitId: String, records: List<Long>) {
    val prefs = context.getSharedPreferences("AdFrequencyPrefs", Context.MODE_PRIVATE)
    prefs.edit().putString(adUnitId, records.joinToString(",")).apply()
}

// 从SharedPreferences恢复记录的方法
private fun loadRecordsFromSharedPrefs(adUnitId: String): List<Long> {
    val prefs = context.getSharedPreferences("AdFrequencyPrefs", Context.MODE_PRIVATE)
    val recordStr = prefs.getString(adUnitId, "") ?: ""
    return if (recordStr.isEmpty()) emptyList() else recordStr.split(",").map { it.toLong() }
}

注意需处理应用重启后的记录持久化，同时要考虑多线程环境下的线程安全问题，比如使用同步锁或线程安全集合类。

内容的提问来源于stack exchange，提问作者Amir Dora.