（Android）ironSource接入TopOn Adapter说明

支持的广告形式

• 插屏

• 激励视频

• Banner (仅支持 ironSource 7.3.0 及以上版本)

 

一. 集成ironSource SDK

请集成ironSource v7.3.0及以上版本，参考 ironSource

 

二. ironSource后台配置

1. 配置Custom Adapter

登陆 ironSource后台，进入 Monetize > Setup > SDK Networks。点击Manage Networks并选择Custom Adapter，输入 TopOn network key: 15bfbe1d1。

点击Save按钮进行保存。

 

2. 配置TopOn广告位ID

在 SDK Networks Setup 页面，选择您要接入 TopOn SDK 的应用， 找到TopOn广告平台，点击 Setup , 输入 TopOn的 应用ID 和 广告位ID（参考下方说明获取）

• app_id：输入 TopOn的 应用 ID

• app_key：输入 TopOn的 应用 Key

• placement_id：输入 TopOn的 广告位 ID

• Rate（Optional）: （可选）输入 底价（默认无底价，如果配置了底价，TopOn 将依据此价格返回广告，可能导致此Instance的填充率降低）

 

您可以在此页面找到TopOn的应用ID & TopOn的广告位ID： TonOn应用

 

您可以在此页面找到TopOn的App Key：TonOn账户信息

 

三. 集成TopOn SDK&Adapter

1. 添加依赖

在build.gradle中添加以下代码，引入TopOn SDK

repositories {
    //Anythink(Core)
    maven {
        url "https://jfrog.anythinktech.com/artifactory/overseas_sdk"
    }
}
​
dependencies {
    //Anythink (Necessary)
    api "com.anythink.sdk:core-tpn:6.4.12"
    api "com.anythink.sdk:banner-tpn:6.4.12"
    api "com.anythink.sdk:interstitial-tpn:6.4.12"
    api "com.anythink.sdk:rewardedvideo-tpn:6.4.12"
​
    //Androidx (Necessary)
    api "androidx.appcompat:appcompat:1.1.0"
    api "androidx.browser:browser:1.4.0"
        
    implementation 'io.github.toponteam:ironsource-mediation-adapter:+'    
}

 

2. GDPR

请参考 TopOn SDK GDPR

 

3. COPPA&CCPA

请登录TopOn后台，进入 应用页面，选择对应的应用，设置COPPA & CCPA

 

四. 测试 TopOn Ads

1. 添加测试设备

(1) 在 ironSource 后台，选择 MONETIZE > Testing，然后选择需要测试的应用，点击 New Test Device

(2）在弹窗中输入 Device Name & Advertising Id(Google Advertising ID (GAID) for Android)，点击 SAVE

请参考 Device Advertising ID(Google Advertising ID (GAID) for Android)

 

2. 配置Mediation Testing

切换至 Mediation Testing，并选择 TopOn，点击 test 

 

3. 打开日志开关

IronSource.setAdaptersDebug(true);

打开后，可在LogCat中过滤此TAG查看相关日志：TopOn|anythink

 

4. 打开TopOn ADX广告

进入聚合管理页面，选择需要测试的应用及广告位，并将下方的TopOn ADX的广告源开关打开

 

5. 开启TopOn 测试模式

进入测试模式页面，点击+测试模式按钮，并输入设备ID、设备名称，并选择要测试的应用及广告平台，点击确定。

• 请使用Google Advertising ID (GAID)，即上方说明中配置在ironSource后台的测试设备ID

• 请等待5~10分钟 配置生效后，卸载重装应用再进行测试

更多信息请参考 如何测试广告

 

五. 建议配置 & eCPM 底价设置

1. 对于ironSource中的每种广告格式，只需要在TopOn后台中创建一个广告位id。

   例如，如果你想创建一个TopOn广告位用于ironSource激励视频广告，你只需要在TopOn后台中创建一个TopOn激励视频广告位。

2. 如果您想为TopOn ADX设置TopOn的eCPM底价，可以参考以下步骤进行配置

   (1) 在ironSource 后台中创建多个Instance，所有Instance都使用相同的TopOn广告位ID（假设TopOn的广告位ID为“xxx”），如下图中的红框所示

   (2) 根据您的瀑布流设置需求，每个Instance设置不同的eCPM价格，如下图中的蓝色框所示

   注意：建议配置不要超过3个Instance，最多设置3个不同的eCPM价格

   

   (3) 在TopOn后台，聚合管理页面，选中需要设置底价的TopOn广告位后并点击高级设置。在竞价底价输入框中，填入最低的价格。例如，上图中设置了$1、$0.5、$0.1，则在输入框中填入0.1