跳到主要内容

Google Mediation V1.0.0

支持的广告格式​

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

一、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()
    }
}

添加 SDK 依赖项​

将 TradPlus SDK & TPMediation SDK 依赖项添加到您的模块的应用级 build.gradle 文件中：

// TradPlus
implementation 'com.tradplusad:tradplus:12.9.0.1'

//noinspection GradleCompatible
implementation 'androidx.legacy:legacy-support-v4:1.0.0'
implementation 'androidx.appcompat:appcompat:1.3.0-alpha02'

// TP Exchange
implementation 'com.google.code.gson:gson:2.8.6'
implementation 'com.tradplusad:tp_exchange:40.12.1.10.1'

implementation(name: "google_mediation_1.0.0", ext: 'aar')

下载 google_mediation_1.0.0.aar

混淆配置​

开启混淆后，在 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 的测试模式进行测试，测试广告样式如下：

原生激励和插屏横幅

测试模式文档