Adtalos GroMore iOS 接入文档

1. 集成说明概览

  • 聚合 SDK：GroMore iOS（Ads-CN）
  • Adtalos 基础 SDK：AdtalosAdKit.xcframework（动态库）
  • Adtalos GroMore 适配器源码：AdtalosAdKitGromoreAdapter
  • 主要广告形式：
    • 开屏广告
    • 插屏（半屏 / 全屏）
    • 激励视频
    • 横幅 Banner
    • 信息流（模版/自渲染）

2. 环境与工程配置

2.1 Xcode / iOS 要求

  • Xcode：建议使用最新稳定版
  • iOS 最低支持版本：根据 GroMore / AdtalosAdKit 官方要求配置（一般为 iOS 12+）

2.2 源码集成

  1. 下载并接入 AdtalosAdKit.xcframework
  2. 将 AdtalosAdKitGromoreAdapter 的源码文件加入 Xcode 项目
  3. 按工程实际情况完成对应的编译与依赖配置

说明：AdtalosAdKit 以 xcframework 动态库形式接入，GroMore 适配器采用源码集成，不需要下载或拖入 xcframework。

2.3 GroMore 后台添加自定义广告平台配置

在 GroMore 后台中需要为 GroMore 添加自定义广告网络，并配置对应的 Adapter 类名：

  • 初始化：AdtalosGromoreCustomConfigAdapter
  • 开屏：AdtalosGromoreSplashAdapter
  • 插屏：AdtalosGromoreInterstitialAdapter
  • 激励：AdtalosGromoreRewardVideoAdapter
  • 横幅：AdtalosGromoreBannerAdapter
  • 原生：AdtalosGromoreNativeAdapter

示意图如下：

ios_sdk_gromore_adapter

2.4 应用维度参数

  • token：对应开发者平台 -> 账户 -> 个人信息里面的 token，配置到 GroMore 自定义广告网络的 AppId
  • appToken：对应开发者平台 -> 应用信息 -> 应用列表中的您所注册应用的 token，配置到 GroMore 自定义广告网络的 AppKey

示意图如下：

ios_sdk_gromore_config

2.5 广告位配置

示意图如下：

ios_sdk_gromore_params

2.6 原生自渲染类型参数配置

GroMore 信息流广告位支持模版渲染与自渲染，新义 adapter 会根据 GroMore 下发的 BUMAdLoadingParamExpressAdType 区分渲染类型

  • 模版渲染：BUMAdLoadingParamExpressAdType = 1
  • 自渲染：BUMAdLoadingParamExpressAdType != 1

示意图如下：

ios_sdk_gromore_native_self_express_params

3. Adtalos GroMore 适配层配置

3.1 设置 CAID（可选但建议）

AdtalosGromoreCustomConfigAdapter 支持在 SDK 初始化前设置 CAID 列表，用于广告归因。 CAID 类型为 AdtalosAdKit 中的 JoinKey（或在 OC 中为 AdtalosJoinKey）。

参考代码：

AdtalosJoinKey *joinKey = [[AdtalosJoinKey alloc] initWithJoinKey:@"Caid" version:@"version"];
AdtalosJoinKey *joinKey2 = [[AdtalosJoinKey alloc] initWithJoinKey:@"Caid" version:@"version"];

// 必须在 GroMore SDK 初始化之前调用
[AdtalosGromoreCustomConfigAdapter setJoinKey:joinKey];
[AdtalosGromoreCustomConfigAdapter setJoinKey2:joinKey2];

说明：

  • 调用时机：必须在 GroMore startWithAsyncCompletionHandler 初始化之前调用。
  • 多条 CAID：可以分别通过 setJoinKey: 和 setJoinKey2: 传入，适配层会在初始化时一起传递给 Adtalos SDK。

4. GroMore SDK 初始化

建议在 App 启动时（如 AppDelegate 或统一的广告管理类中）进行初始化。 参考代码如下：

- (void)initSDK {
  if ([BUAdSDKManager state] == BUAdSDKStateStart) {
    return;
  }

  // 1. 在初始化 SDK 之前，设置 Adtalos 的 joinKey / joinKey2 参数（可选但推荐）
  AdtalosJoinKey *joinKey = [[AdtalosJoinKey alloc] initWithJoinKey:@"Caid" version:@"version"];
  AdtalosJoinKey *joinKey2 = [[AdtalosJoinKey alloc] initWithJoinKey:@"Caid" version:@"version"];
  [AdtalosGromoreCustomConfigAdapter setJoinKey:joinKey];
  [AdtalosGromoreCustomConfigAdapter setJoinKey2:joinKey2];

  // 2. 初始化 GroMore SDK
  BUAdSDKConfiguration *configuration = [BUAdSDKConfiguration configuration];
  configuration.appID = kGromoreBUAppID;
  configuration.debugLog = @(1);
  configuration.useMediation = YES;
  configuration.SDKDEBUG = YES;

  [BUAdSDKManager startWithAsyncCompletionHandler:^(BOOL success, NSError *_Nullable error) {
    if (!success) {
      NSLog(@"[GromoreAdSDKManager] BUAdSDK start failed: %@", error);
    }
  }];
}

使用方式：

  • 建议封装一个单例管理类（如 Demo 中的 GromoreAdSDKManager），在 App 启动或进入广告相关页面前调用一次：
[[GromoreAdSDKManager sharedManager] initSDK];

5. 常见问题与注意事项

  • 初始化顺序：
    • 必须先设置 AdtalosGromoreCustomConfigAdapter 的 JoinKey，再初始化 GroMore。
  • 应用参数来源：
    • GroMore 适配层初始化时会读取 GroMore 自定义广告网络中的 AppID / AppKey，并分别作为 Adtalos 的 token / appToken。
  • 信息流（模版）高度获取：
    • 建议使用 GroMore 返回的模版广告视图实际高度更新容器高度，避免列表中出现高度闪烁。
  • 信息流性能：
    • 实际接入时，请务必在信息流广告滑出可见区域或不再使用时及时销毁广告实例、移除监听与视图，避免长时间占用内存和 CPU 资源，造成性能问题和资源浪费。