集成

适用于 CloudX iOS SDK 的 AppLovin Auction 适配器。支持插屏广告、激励广告、原生广告和开屏广告。

本页介绍 iOS 集成。已登录的发布商可以从 CloudX 文档控制台打开 AppLovin Auction 设置指南。

iOS 适配器支持插屏广告、激励广告、原生广告和开屏广告。不支持横幅广告和 MREC。

安装

CocoaPods

pod 'CloudXAppLovinAdapter', '~> 13.6.3.0'

pod install --repo-update

手动安装

1. 从 Releases 下载 CloudXAppLovinAdapter.xcframework.zip。
2. 解压并将 CloudXAppLovinAdapter.xcframework 添加到 Xcode 项目。
3. 添加 AppLovinSDK 13.6.3 版本。
4. 在 Other Linker Flags 中添加 -ObjC。

初始化

照常使用 CloudX 应用密钥初始化 CloudX。CloudX 从服务器配置中接收 MAX SDK 密钥和 MAX 广告单元 ID。

当服务器配置包含 AppLovin Auction 广告位时，适配器会初始化 MAX。如果其他组件先初始化 MAX，则必须使用相同的 SDK 密钥。

适配器链接到应用后会自动注册。无需调用 CloudXAppLovinAdapterRegister()。

隐私

尽可能在 CloudX 初始化之前通过 CloudX 隐私 API 设置同意状态。

适配器将明确的 CloudX 同意值转发到 MAX：

• 用户同意映射到 MAX 用户同意设置。
• Do Not Sell 映射到 MAX Do Not Sell 设置。

适配器也会转发后续的明确隐私更新。

对于 CloudX 适配器范围以外的宿主应用要求，请遵循 AppLovin 最新的 iOS 隐私指南和 SKAdNetwork 设置。

缓存广告

适配器为每个已配置广告位保留一个合格的 MAX 填充。

• 竞价失败会保留填充。
• 竞价获胜会消耗准确的填充。
• 消耗后会开始加载替换广告。
• 原生广告在一小时后过期。
• 全屏格式使用 MAX 过期回调。

应用进入后台时，适配器会暂停新的预加载工作。应用恢复活动状态后，适配器会继续工作。

收入

MAX 通过已展示广告的付费事件报告实际收入。CloudX 将该收入附加到 AppLovin Auction 展示，并抑制同一广告位的重复全局 AppLovin ILRD。

如果 MAX 未及时发送付费事件，可能会报告一次不含收入的展示。CloudX 不会使用竞价价格替代缺失的实际收入。

兼容性

支持

如需支持，请联系 support@cloudx.io。