集成

CloudX iOS SDK 的 Adjust 广告收入连接器。无需发布方编写胶水代码即可将 CloudX 广告收入转发至 Adjust。

连接器（Connector）用于在 CloudX SDK 与其他产品之间传递数据。Adjust 连接器会将 CloudX 广告收入转发至您的移动归因合作伙伴（MMP），使广告收入与您在 Adjust 中的其他数据一并呈现，并用于 ROAS 衡量。只需添加依赖，收入上报即自动生效——连接器会在加载时向 CloudX SDK 自行注册，加入与 CloudXCore.addAdRevenueDelegate(_:) 相同的全局广告收入委托列表。

安装

CocoaPods

Podfile

pod 'CloudXAdjustConnector', '~> 5.0.0.0'

pod install --repo-update

无需任何代码改动。连接器不会初始化 Adjust，它使用您现有的 Adjust 配置和 app token。

手动注册

该 pod 会为您的 target 设置 -ObjC，以确保连接器的 +load 在宿主应用中执行并完成自行注册。如果您的构建未使用 -ObjC 链接，请在初始化 CloudX SDK 之前或之后手动注册一次：

#import <CloudXAdjustConnector/CloudXAdjustConnector.h>

CloudXAdjustConnectorRegister();

要求

CloudXCore 3.6.0 或更高版本——这是首个提供连接器所依附的全局广告收入委托 API 的版本。
您的应用已使用自己的 app token 集成并初始化 Adjust SDK。连接器不会打包或初始化 Adjust；CocoaPods 会将该依赖与您应用中已有的 Adjust pod 去重，因此运行时使用的是您的版本。
受支持的 Adjust SDK 版本：Adjust 5.0.0 或更高版本（v5 系列）。没有上限。

上报内容

连接器会为每次 CloudX 竞得的展示创建一个 Adjust ADJAdRevenue 事件，覆盖所有 CloudX 广告格式——banner、MREC、interstitial、rewarded、native 和 app open。每个事件会携带竞得的广告网络、该次展示的 CloudX 收入估算（USD），以及包含 CloudX 广告单元、格式（ad_type）和广告位的回调参数。

ad_type 的格式名称与 CloudX Android 连接器完全一致，因此按 ad_type 对 Adjust 收入分组时，两个平台的每种格式都归入同一分组。

兼容性

连接器版本	Adjust SDK	最低 CloudXCore
`5.0.0.0`	`Adjust` `>= 5.0.0`	`3.6.0`

自行上报收入

如果您希望自行控制上报调用，可以不使用连接器，直接注册自己的广告收入委托：

final class MyAdRevenueDelegate: NSObject, CLXAdRevenueDelegate {
    func didPayRevenue(for ad: CLXAd) {
        // 使用您自己的字段映射转发至 Adjust 或任何其他目标。
    }
}

CloudXCore.addAdRevenueDelegate(myAdRevenueDelegate)

+[CloudXCore addAdRevenueDelegate:] 是稳定的公开接口，removeAdRevenueDelegate: 用于取消注册。请只选择连接器或自行注册委托其中一种方式，不要同时使用。

支持

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