Adtalos ToBid iOS 接入文档

1. 集成说明概览

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

2. 环境与工程配置

2.1 Xcode / iOS 要求

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

2.2 源码集成

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

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

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

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

  • 初始化：AdtalosToBidCustomConfigAdapter
  • 开屏：AdtalosToBidSplashAdapter
  • 插屏：AdtalosToBidInterstitialAdapter
  • 激励：AdtalosToBidRewardVideoAdapter
  • 横幅：AdtalosToBidBannerAdapter
  • 原生：AdtalosToBidNativeAdapter

示意图如下：

ios_sdk_tobid_adapter

2.4 应用维度参数

  • AdtalosToken：对应开发者平台 -> 账户 -> 个人信息里面的 token
  • AdtalosAppToken：对应开发者平台 -> 应用信息 -> 应用列表中的您所注册应用的 token

示意图如下：

ios_sdk_tobid_config

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

ToBid 新建原生广告位时，如添加的新义广告位为自渲染类型，需配置自定义参数

  • isExpress = false

示意图如下：

ios_sdk_tobid_native_self_express_params

3. Adtalos ToBid 适配层配置

3.1 设置 CAID（可选但建议）

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

参考代码：

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

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

说明：

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

4. ToBid SDK 初始化

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

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

  // 2. 初始化 ToBid SDK
  [WindMillAds setupSDKWithAppId:@"ToBid AppID"];

  // 日志开关
  [WindMillAds setDebugEnable:YES];
  [WindMillAds setAdNetworkInitListener:self];
}

使用方式：

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

5. 常见问题与注意事项

  • 初始化顺序：
    • 必须先设置 AdtalosToBidCustomConfigAdapter 的 JoinKey，再初始化 ToBid。
  • 应用参数来源：
    • ToBid 适配层初始化时会读取自定义广告网络 extra 中的 AdtalosToken / AdtalosAppToken，并分别作为 Adtalos 的 token / appToken。
  • 原生自渲染参数：
    • ToBid 原生广告位需要自渲染时，自定义参数中需配置 isExpress = false。
  • 信息流性能：
    • 实际接入时，请务必在信息流广告滑出可见区域或不再使用时及时销毁广告实例、移除监听与视图，避免长时间占用内存和 CPU 资源，造成性能问题和资源浪费。