集成 - CloudX Documentation

连接器（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();

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 的通用 publisher_sdk 来源上报——Adjust 已确认，在其未来版本提供专属的 CloudX 来源之前，这是受支持的上报路径。收入照常进入 Adjust 并同样用于 ROAS 衡量，只是显示在通用的 publisher 来源下，而非具名的 CloudX 来源。当具名来源上线后，历史收入仍保留在 publisher_sdk 下，因此跨越切换时点的报表需要合并两个来源的数据。

如果您的应用已在 CloudX 广告收入委托中自行构建 ADJAdRevenue 事件，请在添加本连接器时移除该代码，否则每次展示都会向 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:myAdRevenueDelegate];

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

支持

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

iOS SDK

适配器

连接器

集成

安装

CocoaPods

手动注册

要求

上报内容

兼容性

自行上报收入

支持

​安装

​CocoaPods

​手动注册

​要求

​上报内容

​兼容性

​自行上报收入

​支持

安装

CocoaPods

手动注册

要求

上报内容

兼容性

自行上报收入

支持