集成

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

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

安装

dependencies {
    implementation("io.cloudx:connector-adjust:5.0.0.0")
}

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

要求

CloudX Android SDK 4.3.0 或更高版本。
您的应用已使用自己的 app token 集成并初始化 Adjust SDK。连接器仅在编译期依赖 Adjust SDK，因此您的应用需自行声明 com.adjust.sdk:adjust-android，运行时使用的是您的版本。
受支持的 Adjust SDK 版本：5.0.0 或更高版本（v5 系列）。

上报内容

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

在 Adjust UI 中查看 CloudX 收入

Adjust 目前还没有专属的 CloudX 广告收入来源，因此无需在 Adjust 后台进行任何 CloudX 专属配置。只要连接器已包含在您的构建中，CloudX 广告收入就会自动上报。

查看方式：打开 Adjust 的广告收入（ad revenue）指标，并将广告收入来源（Ad Revenue Sources）筛选器留空，以显示所有来源。目前 CloudX 收入已包含在这些汇总数据中，计入通用来源，而非独立的 CloudX 标签。

在 CloudX 竞价中由 AppLovin MAX 或 Google 瀑布流赢得的展示不会被转发，因为这些 SDK 已自行向 Adjust 上报该部分收入。

如果 Adjust 中完全看不到广告收入（无论来自 CloudX 还是其他来源），请在排查连接器之前先确认以下几点：

连接器依赖确实包含在您所衡量的那个构建中，而不仅仅存在于本地工程里。
您的 Adjust 账户已启用广告收入上报，可向您的 Adjust 客户经理确认。
如果您测试的构建以 sandbox 模式初始化 Adjust，请在 Datascape 中切换到 sandbox 数据查看。

兼容性

连接器版本	Adjust SDK	最低 CloudX SDK
`5.0.0.0`	Adjust Android SDK `>= 5.0.0`	`4.3.0`

自行上报收入

如果您希望自行控制上报调用，可以不使用连接器，直接订阅 CloudX 广告收入：

CloudX.addAdRevenueListener(object : CloudXAdRevenueListener {
    override fun onAdRevenuePaid(cloudXAd: CloudXAd) {
        // 使用您自己的字段映射转发至 Adjust 或任何其他目标。
    }
})

CloudX.addAdRevenueListener() 是稳定的公开接口。请只选择连接器或自行注册监听器其中一种方式，不要同时使用。