> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 集成

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

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

## 安装

### CocoaPods

```ruby Podfile theme={null}
pod 'CloudXAdjustConnector', '~> 5.0.0.0'
```

```bash theme={null}
pod install --repo-update
```

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

### 手动注册

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

<CodeGroup>
  ```objc Objective-C theme={null}
  #import <CloudXAdjustConnector/CloudXAdjustConnector.h>

  CloudXAdjustConnectorRegister();
  ```

  ```swift Swift theme={null}
  CloudXAdjustConnectorRegister()
  ```
</CodeGroup>

## 要求

* 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 收入分组时，两个平台的每种格式都归入同一分组。

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

<Warning>
  如果您的应用已在 CloudX 广告收入委托中自行构建 `ADJAdRevenue` 事件，请在添加本连接器时移除该代码，否则每次展示都会向 Adjust 重复上报两次。
</Warning>

## 兼容性

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

## 自行上报收入

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

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

  CloudXCore.addAdRevenueDelegate(myAdRevenueDelegate)
  ```

  ```objc Objective-C theme={null}
  [CloudXCore addAdRevenueDelegate:myAdRevenueDelegate];
  ```
</CodeGroup>

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

## 支持

如需支持，请联系 [mobile@cloudx.io](mailto:mobile@cloudx.io)