跳到主要内容

IronSource Mediation Integration 1.0.0

适配说明​

  • 支持的广告类型：横幅、插屏、激励视频
  • 支持的广告平台（V1.0.0）：TradPlus Adx
  • 适配 IronSource 版本：V8.1.0+
  • 适配 TradPlus 版本：V14.1.10.1+

IronSource Adapter 接入步骤​

1. IronSource 后台配置​

1.1 添加 Custom Adapter​

登录 IronSource 后台，在左侧菜单选择 Mediation → Setup → SDK networks，选择应用后，在 Manage Networks 中添加 Custom Adapter。

1.2 填写 Network Key​

填入通过 IronSourceCustomAdapter 注册网页生成的 network Key。

方式一：直接填入 15bff7a51​

方式二：Custom Adapter 注册(推荐)​

  • Network name(abbrev.)* 输入：HKWL。（必填）

  • App level 输入：appid。（必填）

  • Instance level 输入：placementid。（必填）

  • 其他根据实际情况填写。

1.3 找到添加的自定义广告源，点击编辑进行设置。​

1.4 在编辑页面中填写：​

  • AppID：TradPlus 后台的 AppID
  • PlacementID：TradPlus 后台的广告位 ID

1.5 点击 Save 保存。​

2. 在 IronSource 中介组启用​

在左侧菜单选择 Mediation → Management → Mediation，并设置中介组。

3. 集成 SDK​

按照正常流程集成 Android TradPlus SDK（打包平台），以 V14.1.10.1 版本为例。

3.1 引入依赖库​

在项目级 build.gradle 文件的 buildscript 和 allprojects 部分中添加 Maven 仓库：

buildscript {
    repositories {
        ...
        mavenCentral()
        // IronSource
        maven { url 'https://android-sdk.is.com/' }
    }
}
allprojects {
    repositories {
        ...
        mavenCentral()
        // IronSource
        maven { url 'https://android-sdk.is.com/' }
    }
}

3.2 添加 custom_mediation_1.0.0.aar​

将 custom_mediation_1.0.0.aar 放到 assets/libs 文件夹中，如下图所示:

下载 custom_mediation_1.0.0.aar

3.3 勾选 mainTemplate.gradle 等文件。​

3.4 添加 SDK 依赖项​

开发者进入 TradPlus SDK 下载平台 ，选择集成的版本，点击生成接入代码。举例使用 V14.1.10.1 版本：

dependencies {
    ...
    
    // TradPlus
    implementation 'com.tradplusad:tradplus:14.1.10.1'
    implementation 'androidx.legacy:legacy-support-v4:1.0.0'
    implementation 'androidx.appcompat:appcompat:1.3.0-alpha02'
    
    // IronSource
    implementation 'com.ironsource.sdk:mediationsdk:8.1.0'
    implementation 'com.tradplusad:tradplus-ironsource:10.14.1.10.1'
    implementation 'com.google.android.gms:play-services-appset:16.0.0'
    implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0'
    implementation 'com.google.android.gms:play-services-basement:17.5.0'
    
    // TP Exchange（请确保版本与主包同步更新）
    implementation 'com.google.code.gson:gson:2.8.6'
    implementation 'com.tradplusad:tp_exchange:40.14.1.10.1'
}

4. 混淆配置​

开启混淆后，在 proguard-rules.pro 文件中添加：

-keep public class com.tradplus.** { *; }
-keep class com.tradplus.ads.** { *; }
-keep class com.ironsource.adapters.custom.hkwl.** {*;}

5. 资源优化​

广告 SDK 资源不能被混淆。如使用第三方资源优化框架，请配置 SDK 资源为白名单：

R.string.tp_*
R.drawable.tp_*
R.layout.tp_*
R.id.tp_*

6. 设置海外隐私政策​

由于 Custom Adapter 无法通过 IronSource 聚合 API 获取 CCPA、COPPA、GDPR 设置状态， 需要在初始化 IronSource SDK 之前，参考海外隐私规范进行设置。

海外隐私政策文档

7. 测试模式​

使用 TradPlus 的测试模式进行测试，测试模式文档