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

安装

无需任何代码改动。连接器不会初始化 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 的通用 publisher_sdk 来源上报——Adjust 已确认,在其未来版本提供专属的 CloudX 来源之前,这是受支持的上报路径。收入照常进入 Adjust 并同样用于 ROAS 衡量,只是显示在通用的 publisher 来源下,而非具名的 CloudX 来源。当具名来源上线后,历史收入仍保留在 publisher_sdk 下,因此跨越切换时点的报表需要合并两个来源的数据。
如果您的应用已在 CloudX 广告收入回调中调用 Adjust.trackAdRevenue,请在添加本连接器时移除该代码,否则每次展示都会向 Adjust 重复上报两次。

兼容性

自行上报收入

如果您希望自行控制上报调用,可以不使用连接器,直接订阅 CloudX 广告收入:
CloudX.addAdRevenueListener() 是稳定的公开接口。请只选择连接器或自行注册监听器其中一种方式,不要同时使用。