4.2 Admob Adapter

注意：由于 Google 广告 sdk 内部逻辑限制，离线场景流量无法通过 adapter 转发到 Hisavana SSP sdk，如果你想使用 Hisavana SSP 的离线能力，建议您直接接入 Hisavana SSP sdk。

4.2.1 版本发布记录

版本	发布时间	更新内容	Min Sdk Version
3.6.6.1.1	2026-07-28	依赖 Hisavana SSP SDK 3.6.6.1 版本；google play-services-ads 25.4.0 版本	23

4.2.2 AdMob 后台配置流程

1. 首页点击进入中介（Mediation），创建或选择对应广告样式的中介组。

   

2. 在“广告来源”中选择瀑布流（Waterfall），添加自定义事件（Custom Event）。

   

3. 新增广告单元映射，并填写：

   • Class Name：com.hisavana.admob.adapter.HisavanaAdapter
   • Parameter：JSON 字符串，appId 填入在 Hisavana SSP 后台申请的应用 ID，codeSeatId 填入在 Hisavana SSP 后台申请的代码位 ID。示例：{"appId":"testsid880","codeSeatId":"splash_1"}
     

4. 在 AdMob 中介组内为该映射配置 CPM。该 CPM 是 AdMob Waterfall 排序价格，不是 Hisavana SSP 实时返回价格。

5. 保存并确认中介组已启用，且广告单元、地域、广告格式、代码位广告样式一致。

4.2.3 在项目中 引入 adapter sdk

首先在项目级build.gradle文件加入maven远程依赖地址，如下：

buildscript {
    repositories {
      maven { url "https://mvn.shalltry.com/repository/maven-public/" }
      maven { url "https://mvn.shalltry.com/repository/ad-releases/" }
    }
}

allprojects {
    repositories {
      maven { url "https://mvn.shalltry.com/repository/maven-public/" }
      maven { url "https://mvn.shalltry.com/repository/ad-releases/" }
    }
}

然后在Module的build.gradle中引入admob adapter的包：

implementation "com.cloud.hisavana.sdk.ssp.adapter:admob:3.6.6.1.1"
implementation "com.google.android.gms:play-services-ads:25.4.0"

4.2.4 SDK 初始化配置

public class MyApplication extends Application {

    @Override
    public void onCreate() {
        super.onCreate();

        // 开启 Hisavana SSP log 输出
        HisavanaAdapterUtil.setAdapterLoggingEnabled(true);
        // 设置 Hisavana SSP Adapter 测试模式，上线前务必将参数改为 false
        HisavanaAdapterUtil.setTestRequestEnable(true);

        // Google 广告初始化
        MobileAds.initialize(this.getApplicationContext(), initializationStatus -> {
            Log.d("MobileAds", "Init status: " + initializationStatus.toString());
        });
    }
}

4.2.5 集成测试说明

Adapter 日志过滤 Tag：HisavanaAdapter

执行以下命令开启 DEBUG 日志：

adb shell setprop log.tag.HisavanaAdapter DEBUG

4.2.6 使用 google 广告 API 请求广告

略