跳到主要内容

Google Mediation V1.0.0

支持的广告格式​

  • 横幅
  • 原生
    • 注意：TradPlus 后台只支持配置自渲染，展示时需要先添加 NativeAdView 到父容器，再渲染展示。
  • 插屏
  • 激励视频

SDK 版本​

  • AdMob SDK 版本: v23.5.0+
  • TradPlus SDK 版本: v14.1.10.1+

一、Google 后台配置​

配置前提​

Google AdMob 后台已经添加好 APP，并创建完成所需广告位。

Mediation Page​

选择 Waterfall Sources 标签，在使用的 APP 应用中点击 Manage mappings。

选择广告位 ID，添加对应的自定义平台类型。 例如，选择 Banner 类型，点击 Add mapping 添加参数，添加完成后点击 Save 保存。

配置参数：

  • Mapping name: TPMediation（可自定义广告平台名称）
  • Class Name: com.google.ads.mediation.customevent.AdNetworkCustomEvent（不可更改）
  • Parameter: { "appid": "您在 TradPlus 后台创建的应用 ID", "pid": "您在 TradPlus 后台创建的广告位 ID" }（Google 服务器下发参数）

选择 Mediation groups 标签，点击 Create mediation group。

Edit mediation group Page​

选择对应的 Ad format 和 Platform，点击 Continue，填写 name（上面创建时填写的 Mapping name）。

点击 Ad units 标签，点击 add ad units，选择您创建的广告位 ID。

在 Waterfall 中点击 Add Custom event，在 Label 中填写 TPMediation，

  • 设置好千次展示费用（eCPM），点击 Continue。
  • 测试时可以将 TPMediation 的 eCPM 设置高价，而 AdMob Network 设置低价，确保优先展示 TPMediation，测试结束后正常设置价格。

二、SDK 集成​

引入依赖库​

在您的项目级 build.gradle 文件中，同时在 buildscript 和 allprojects 两个部分中添加 Maven 中央代码库

buildscript {
    repositories {
        ...
        mavenCentral()
    }
}

allprojects {
    repositories {
        ...
        mavenCentral()
    }
}

添加 google_mediation_1.0.0.aar​

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

下载 google_mediation_1.0.0.aar

勾选 mainTemplate.gradle 等文件。​

添加 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'
}

混淆配置​

开启混淆后，在 proguard-rules.pro 中添加以下混淆规则：

-keep public class com.tradplus.** { *; }
-keep class com.tradplus.ads.** { *; }
-keep class com.google.ads.mediation.customevent.** {*;}

资源优化​

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

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

三、广告初始化​

AdMob 支持自动初始化其他广告 SDK，无需客户端单独初始化。

四、广告加载与渲染​

广告请求和展示可参考 AdMob 官方文档

五、测试与验证​

使用 TradPlus 的测试模式进行测试，测试广告样式如下：

原生激励和插屏横幅

六、测试模式​

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