Adtalos Mediatom iOS 接入文档

1. 集成说明概览

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

2. 环境与工程配置

2.1 Xcode / iOS 要求

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

2.2 源码集成

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

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

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

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

• 初始化：AdtalosMediatomAdapterSupport
• 开屏：AdtalosMediatomSplashAdapter
• 插屏：AdtalosMediatomInterstitialAdapter
• 激励：AdtalosMediatomRewardVideoAdapter
• 横幅：AdtalosMediatomBannerAdapter
• 原生：AdtalosMediatomNativeAdapter

示意图如下：

添加新义互联广告平台配置

在 Mediatom 后台中继续添加新义互联广告平台配置，并按平台要求填写对应的参数。

示意图如下：

2.4 应用维度参数

• token：对应开发者平台 -> 账户 -> 个人信息里面的 token
• appKey：对应开发者平台 -> 应用信息 -> 应用列表中的您所注册应用的 token
• placeId：对应开发者平台 -> 应用信息 -> 广告位中的广告位 ID

Mediatom ext 参数示例：

{
  "token": "媒体 Token",
  "appKey": "应用 Token",
  "placeId": "广告位 ID"
}

示意图如下：

3. Adtalos Mediatom 适配层配置

3.1 设置 CAID（可选但建议）

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

参考代码：

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

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

说明：

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

4. Mediatom SDK 初始化

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

- (void)initSDK {
  [SFAdSDKManager unionAdCallbackLog:YES];
  [SFAdSDKManager checkSdkIntegration];

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

  // 2. 初始化 Mediatom SDK
  [SFAdSDKManager registerAppId:kMediatomAppID];
}

使用方式：

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

[[MediatomAdSDKManager sharedManager] initSDK];

5. 常见问题与注意事项

• 初始化顺序：
  • 必须先设置 AdtalosMediatomAdapterSupport 的 JoinKey，再初始化 Mediatom。
• 应用参数来源：
  • Mediatom 适配层初始化时会读取广告源 ext 中的 token / appKey，并分别作为 Adtalos 的 token / appToken。
• 广告位参数：
  • Mediatom 各广告源 ext 中建议配置 placeId，适配层会优先使用该值作为 Adtalos 广告位 ID。
• 信息流性能：
  • 实际接入时，请务必在信息流广告滑出可见区域或不再使用时及时销毁广告实例、移除监听与视图，避免长时间占用内存和 CPU 资源，造成性能问题和资源浪费。