（Android）Max接入TopOn Adapter说明

支持的广告格式

• 插屏

• 激励视频

• Banner

• 原生

 

一. 集成Max SDK

请参考 Max

 

二. Max平台配置

1. 配置Custom Adapter

在 MAX后台中，选择 MAX > Mediation > Manage > Networks，然后点击页面底部的Click here to add a Custom Network添加Custom Network，并添加相关信息：

• Network Type: 选择 SDK

• Name: 输入 Taku

• Android Adapter Class Name: 输入 com.applovin.mediation.topon.TakuMediationAdapter

2. 启用Custom Network

在 MAX 后台中打开 MAX > Mediation > Manage > Ad Units，然后选择Custom Network (SDK) - Taku，并设置相应的App ID、App Key、广告位ID。对于Taku来讲，下方的App ID是必填项。

• App ID：输入 Taku的应用ID_Taku的 AppKey（假设在Taku后台创建的应用 ID为"aaa"，App Key为"bbb"，则填入aaa_bbb）

• Placement ID：输入 Taku的广告位 ID

• CPM Price：输入底价（最低输入0.01，Taku 将依据此价格返回广告。如果配置了比较大的底价，可能导致此Taku广告位的填充率降低）

 

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

 

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

 

三. 集成Taku SDK&Adapter

1. 添加依赖

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

Taku v6.2.79及以上版本（建议接入）

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

Taku v6.2.79以下版本

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

 

2. GDPR

请参考 Taku SDK GDPR

 

3. COPPA&CCPA

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

 

四. 测试 Taku Ads

1. 打开Max SDK的日志

AppLovinSdk.getInstance(this).settings.setVerboseLogging(true)

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

（1）可通过以下日志获取设备ID(GAID)

anythink: ********************************** UA_6.2.81 *************************************
anythink: GAID(ADID): ********-****-****-****-************ , AndroidID: ****************
anythink: ********************************** UA_6.2.81 *************************************

2. 打开Taku ADX广告

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

 

3. 开启Taku 测试模式

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

• 设备ID：请使用Google Advertising ID (GAID)，即上方说明中从日志里获取到的GAID(ADID)

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

 

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

 

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

1. 集成版本

建议接入Taku v6.2.81及以上版本，Taku Adapter v1.1.1及以上版本后，再进行底价的设置

注意：从Taku Adapter v1.1.0开始，仅支持在Taku广告位下配置Taku Adx广告，仅会发起Taku Adx的广告请求，配置在广告位下的其他非Taku Adx的广告源将被忽略

 

2. 广告位创建

对于Max中的每种广告格式，只需要在Taku后台中创建一个广告位id

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

 

3. eCPM底价设置

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

注意：

• 使用Taku Adapter，Taku的底价可以直接在Max后台中设置，不需要在Taku后台中设置

• 在集成初期，建议在max只设置一层0.01的底价，并让Takuadx的预算有至少1天的时间对流量价值进行学习。在数据稳定后，再依据Taku后台的数据报表调整max上的分层

• 请确保您的Taku开发者账号币种必须是美元（USD），币种具体见 账号管理

 

（1）在Max后台中的一个Ad Unit下，创建多个Placement ID，所有Placemen都使用相同的Taku广告位ID（假设Taku的广告位ID为“xxx”），如下图中的红框所示

注意：填入Placement ID输入框中的参数，必须包含"_"，且"_"之前必须是Taku的广告位ID，"_"的后面可以添加任意字符串进行区分

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

（3）按照上述进行配置后，Taku Adapter将自动根据上面配置的价格（$1、$0.5、$0.1）进行底价过滤

当Taku广告位（上图中的其中一个Placement）加载成功且满足底价后，将通知Max SDK：广告加载成功，

否则通知Max SDK：广告加载失败