跳到主要内容

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 文件的 buildscriptallprojects 部分中添加 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 的测试模式进行测试,测试模式文档