集成

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

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

安装

CocoaPods

Podfile

pod 'CloudXSingularConnector', '~> 12.6.0.0'

pod install --repo-update

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

手动注册

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

#import <CloudXSingularConnector/CloudXSingularConnector.h>

CloudXSingularConnectorRegister();

要求

CloudXCore 3.6.0 或更高版本——这是首个提供连接器所依附的全局广告收入委托 API 的版本。
您的应用已使用自己的 SDK key 和 secret 集成并初始化 Singular SDK。连接器不会打包或初始化 Singular；CocoaPods 会将该依赖与您应用中已有的 Singular-SDK pod 去重，因此运行时使用的是您的版本。
受支持的 Singular SDK 版本：Singular-SDK 12.6.0 或更高版本。没有上限。之所以以 12.6.0 为下限，是因为该版本才引入了连接器所调用的、拼写正确的广告收入初始化方法。

上报内容

连接器会为每次 CloudX 竞得的展示发送一个 [Singular adRevenue:] 事件，覆盖所有 CloudX 广告格式——banner、MREC、interstitial、rewarded、native 和 app open。每个事件会携带：

Singular 字段	取值
广告平台（Ad platform）	`CloudX`
币种（Currency）	`USD`
收入（Revenue）	该次展示的 CloudX 收入估算
收入精度（Revenue precision）	`estimated`
广告网络名称（Network name）	竞得的广告网络；若未上报网络则为 `CloudX`
广告单元 ID（Ad unit id）	CloudX 广告单元 ID
广告类型（Ad type）	`BANNER`、`MREC`、`INTERSTITIAL`、`REWARDED`、`NATIVE` 或 `APP_OPEN`
广告位名称（Ad placement name）	CloudX 广告位
广告单元名称（Ad unit name）	广告网络侧的广告位

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

当 CloudX 上报的可选字段为空时，连接器会将其省略，因此某个事件可能不包含广告单元 ID、广告位名称或广告单元名称。Android 连接器始终会发送广告单元 ID，因此若报表按该字段关联两个平台的数据，缺口只会出现在 iOS 一侧。

兼容性

连接器版本	Singular SDK	最低 CloudXCore
`12.6.0.0`	`Singular-SDK` `>= 12.6.0`	`3.6.0`

自行上报收入

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

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

CloudXCore.addAdRevenueDelegate(myAdRevenueDelegate)

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

支持

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