TopOn聚合

TopOn 聚合文档

本文说明如何在 TopOn（ThinkUp）中介平台添加 HeheSDK 提供的自定义广告平台 Adapter，以便通过 TopOn 瀑布流请求到 HeheSDK 的广告。

TopOn 文档：

自定义广告平台

自定义广告平台（SDK ≥ 6.4.94）

支持的广告类型

广告类型	是否支持
Banner	是
Interstitial	是
Native	是
Reward	是

设置步骤

1. 创建自定义广告平台

在 TopOn 后台进入 Network（广告平台），点击 + Custom Network Firm，新增自定义广告平台。

填写平台信息（如 Network Firm Name 填 HeheSDK），并按系统分别填写 Adapter 类名后提交。

Android

TopOn 广告格式	Adapter 类名
Banner	com.hehessp.sdk.topon.banner.HeheTopOnBannerAdapter
Interstitial	com.hehessp.sdk.topon.interstitial.HeheTopOnInterstitialAdapter
Rewarded	com.hehessp.sdk.topon.rewarded.HeheTopOnRewardedAdapter
Native	com.hehessp.sdk.topon.nativead.HeheTopOnNativeAdapter

iOS

用途	类名
Banner	HeheTopOnBannerAdapter
Interstitial	HeheTopOnInterstitialAdapter
Rewarded	HeheTopOnRewardedAdapter
Native	HeheTopOnNativeAdapter

建议为 Banner / Interstitial / Rewarded / Native 分别配置对应格式的 Hehe 广告位，不要跨格式复用。

2. 配置广告源参数

在 Mediation（聚合管理） 中选中应用与广告位，点击 Add AD Source 添加广告源。

在添加广告源弹窗中：

1. Network Firm：选择上一步创建的 HeheSDK
2. Slot ID：填入 HeheBid / HeheSSP 平台的 Placement ID
   TopOn 自定义广告源默认参数「代码位 id」对应 key 为 slot_id
3. 其余字段按业务填写后提交

Android 集成

依赖走公开仓 hehesdk/android-release + JitPack（版本号替换为已发布 tag，当前最新 0.2.6）。
Adapter 为薄包：不内嵌 Hehe SDK，也不内嵌 TopOn / ThinkUp SDK。宿主需自行初始化 TopOn SDK。

dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven("https://jitpack.io")
        // TopOn / ThinkUp SDK
        maven("https://jfrog.anythinktech.com/artifactory/overseas_sdk")
    }
}

dependencies {
    // 核心 SDK（必选）
    implementation("com.github.hehesdk.android-release:hehesdk:0.2.6")

    // TopOn Adapter
    implementation("com.github.hehesdk.android-release:adapter-topon:0.2.6")

    // ThinkUp / TopOn（已核验版本；不要再额外加 banner-tpn / interstitial-tpn 等分格式 SDK）
    implementation("com.thinkup.sdk:core-tpn:6.5.73")

    // 宿主需显式引入（AAR 不传递）
    implementation("androidx.media3:media3-exoplayer:1.10.1")
}

core-tpn:6.5.73 已包含各广告格式自定义 Adapter API。若瀑布流中还有其他三方广告网络，请按 TopOn 官方清单另行引入对应 adapter-tpn-*。

HeheSDK App Key 设置

通过 TopOn 中介接入时，在 AndroidManifest.xml 配置 App Key；Adapter 会自动初始化 Hehe，宿主不要再调 AdSDK.init()。宿主仍需自行初始化 TopOn SDK。

<meta-data
    android:name="com.hehessp.sdk.APP_KEY"
    android:value="YOUR_HEHE_APP_KEY" />

iOS 集成

CocoaPods

platform :ios, '13.0'
use_frameworks! :linkage => :static

source 'https://cdn.cocoapods.org/'
source 'https://github.com/hehesdk/ios-sdk-specs.git'

target 'YourApp' do
  pod 'HeheTopOnAdapter', '0.2.10'
end

HeheTopOnAdapter 会依赖同版本 HeheSDK，以及 TPNiOS/TPNSDK（≥ 6.4.94）。宿主需自行完成 TopOn SDK 初始化。

Info.plist

在 Info.plist 中配置 HeheSSPAppKey：

<key>HeheSSPAppKey</key>
<string>YOUR_HEHE_APP_KEY</string>

Adapter 会读取该 Key 自动初始化 HeheSDK；宿主不要再重复调用 initSDK（除非业务需要提前初始化）。

FAQ

Android

• 类名必须使用上文完整包名；旧 AnyThink / com.secmtp.sdk.* 包名不可混用。
• 未配置 com.hehessp.sdk.APP_KEY 或自动初始化失败时，加载失败错误码为 SDK_NOT_READY。
• slot_id 缺失或空白时错误码为 INVALID_PLACEMENT；banner_size 非法时为 INVALID_BANNER_SIZE。

iOS

如果提示 HeheTopOnAdapter 找不到，可执行 pod repo update hehesdk-ios-sdk-specs 后重新 pod install。