在 GroMore 聚合中使用酷盈广告

集成准备

预备条件

• 基本的 GroMore 集成条件（穿山甲媒体账号、GroMore App ID、GroMore SDK 等）
• 酷盈广告账号
• GroMore 已开通 自定义 ADN 能力（平台默认关闭，需向 GroMore / 穿山甲申请）

所需材料

• 酷盈广告 SDK
• 酷盈广告 ID（appId、appKey、placementId）
• 酷盈广告 GroMore Adapter

在 GroMore 面板中配置酷盈广告

在 GroMore 中使用酷盈广告，需要完成三项配置：

1. 在 GroMore 面板中创建自定义广告网络，并填写 Adapter 类名
2. 将自定义广告网络添加到应用，并填写酷盈 appId / appKey
3. 在瀑布流中添加酷盈代码位（placementId 写在自定义 JSON 中）

1）创建自定义广告网络并填写 Adapter 类名

登录 穿山甲媒体平台 → 【GroMore】→【应用管理】→【管理广告网络】→【+自定义广告网络】。

若页面上看不到「自定义广告网络」入口，说明当前账号尚未开通该功能，需先向 GroMore 申请。

按实际情况填写：

1. 广告网络名称，例如：酷盈、酷盈-Android、酷盈-iOS。
2. 账号名称。
3. 各广告类型的 Adapter 类名（示例见下表）。除初始化类名外，还须填写所需广告类型的类全路径；未填写的类型无法在瀑布流中添加对应代码位。
4. 保存配置。

Android

iOS

类名须与包内完全一致（区分大小写）。Android 为完整包路径；iOS 为 Objective-C 类名。

2）将酷盈广告网络添加到应用

1. 在【GroMore】→【应用管理】中选择目标应用，点击【添加广告网络】。
2. 选择刚刚创建的酷盈自定义广告网络。
3. 填写 App ID、App Key，值必须与酷盈（Taku ADX）面板中的 appId、appKey 完全一致（区分大小写）。
4. 确认所需广告类型的 Adapter 类名已带入后保存。

这里填写的是 酷盈 的 appId / appKey，不是穿山甲 / GroMore 的 App ID。宿主初始化 GroMore SDK 时仍使用穿山甲媒体 App ID。

3）在瀑布流中添加酷盈代码位

1. 在【GroMore】→【瀑布流管理】中，先选择目标 App 和广告位。
2. 点击【添加代码位】，选择酷盈自定义广告网络。
3. 在 其他自定义参数（平台字段名可能为「自定义 json」/ custom_json）中填写酷盈 placementId：

{"placementId":"b5fdc16exxxxxx"}

4. 信息流代码位须按素材类型选择渲染方式：
   • 酷盈 模板原生：选 ADN 提供渲染
   • 酷盈 自渲染原生：选 开发者自渲染

5. 若该代码位要参与客户端竞价，竞价类型选 客户端竞价；普通瀑布流选 标准。
6. 提交并保存。

placementId 读取规则（务必按此配置）：

两端请统一在自定义 JSON 中填写 {"placementId":"<酷盈广告位 ID>"}，避免 Android 无填充、iOS 却能填充。

客户端竞价（可选）

Adapter 已实现 GroMore 比价结果回传（Android receiveBidResult / iOS didReceiveBidResult），并转发给酷盈 notifyWin / notifyLoss。价格单位为 人民币分（例如 650 表示 eCPM 6.50 元）。

要真正收到比价结果，须同时满足：

1. GroMore 代码位竞价类型为 客户端竞价。
2. 宿主加载广告时打开竞价结果通知（默认关闭）：

// Android
MediationAdSlot mediationAdSlot = new MediationAdSlot.Builder()
        .setBidNotify(true)
        .build();

// iOS
slot.mediation.bidNotify = YES;

未设置时，Adapter 不会收到竞胜 / 竞败通知，酷盈侧也无法上报。

更多参考

• GroMore 自定义广告网络（平台操作）
• GroMore Android 自定义 ADN 接入前准备
• GroMore iOS 自定义 ADN 接入前准备
• GroMore 自定义 ADN 综合比价

酷盈广告 GroMore Adapter 的集成使用

宿主工程需要同时接入：

1. GroMore / 穿山甲融合 SDK（由宿主按 GroMore 官方文档接入，并 useMediation(true)）
2. 酷盈广告 SDK
3. 酷盈 GroMore Adapter

Adapter 不打包 GroMore SDK，也不替代 GroMore 初始化。请先完成 GroMore 初始化，再加载广告。

Android

酷盈广告 Android GroMore Adapter 目前以源码包形式提供，下载入口见 3. 获取酷盈广告 GroMore Adapter。包内含集成说明。

另需注意 ProGuard 配置。正常情况下接入方无需再配；若消费端规则未生效，请手动添加：

-keep class com.bytedance.msdk.adapter.kuying.* {
    public <init>();
}
-keeppackagenames com.bytedance.msdk.adapter.kuying.**

入口类必须保留在 com.bytedance.msdk.adapter.kuying 包下，否则 GroMore 无法按后台填写的类名反射到 Adapter。

信息流模板广告：GroMore 加载时请设置 setExpressViewAcceptedSize，宽高须大于 0（单位 dp），否则模板可能无法渲染。

iOS

酷盈广告 iOS GroMore Adapter 以 XCFramework 形式提供，下载入口见 3. 获取酷盈广告 GroMore Adapter。

Framework 为静态 XCFramework，接入时请：

1. 将 SDMGroMoreAdapter.xcframework 设为 Do Not Embed
2. Other Linker Flags 包含 -ObjC（若已通过 CocoaPods 接入 Ads-CN / 酷盈 SDK，通常会自动带入）
3. 同时接入与 Adapter 发布说明一致版本的 SmartdigimktCNSDK、Ads-CN/BUAdSDK、Ads-CN/CSJMediation

最低系统版本：iOS 12.0。

其他酷盈广告相关资源

1. 酷盈广告 ID 的获取

需要登录 Taku 开发者平台，取得或创建 AppID、PlacementID，并获取 AppKey。

• Taku 开发者平台地址：https://app.takuad.com/m/app
• Taku 开发者平台使用文档：https://help.takuad.com/docs/e5CuVo

2. 酷盈广告 SDK 的获取

酷盈广告 SDK 支持两种集成方式：

1. 从开发者平台下载 AAR 或 Framework：登录 Taku 开发者平台，在左侧【Taku ADX】栏目进入 SDK 下载。
2. 通过 Maven 或 Pod 仓库依赖：可参考 4. 酷盈广告集成文档。

3. 获取酷盈广告 GroMore Adapter

• Android：http://sz-kuying-sdk.oss-cn-shenzhen.aliyuncs.com/pkgs/SDK/AndroidNew/china/v6.5.90/6.5.90.0-kuying-gromore_adapter-sources.zip
• iOS Framework：http://sz-kuying-sdk.oss-cn-shenzhen.aliyuncs.com/pkgs/SDK/iOS_v2/cn/Adapter/Gromore/SDMGroMoreAdapter.xcframework.zip

4. 酷盈广告集成文档

• Android：https://help.takuad.com/docs/kuying-and
• iOS：https://help.takuad.com/docs/kuying-ios