> ## 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 的 Mintegral 适配器。支持 Banner、MREC、Interstitial、Rewarded、Native 和 App Open。

有关 CloudX 控制台映射和 Mintegral 侧 ID 设置，请参阅 [Mintegral 竞价方指南](/zh/networks/mintegral)。本页仅说明 iOS 特定的集成细节。

## 安装

### CocoaPods

```ruby Podfile theme={null}
pod 'CloudXMintegralAdapter', '~> 8.1.5.0'
```

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

### 手动安装

1. 从 [Releases](https://github.com/cloudx-io/cloudx-ios/releases) 下载 `CloudXMintegralAdapter.xcframework.zip`
2. 解压并将 `CloudXMintegralAdapter.xcframework` 拖入您的 Xcode 项目
3. 手动添加 `MintegralAdSDK`（`= 8.1.5`），包括 `BidBannerAd`、`BidNewInterstitialAd`、`BidRewardVideoAd`、`BidNativeAdvancedAd` 和 `BidSplashAd` 子模块。

## Info.plist 配置

### SKAdNetwork IDs（iOS 14.5+ 必需）

需要添加 Mintegral 的主要 SKAdNetwork ID 以进行归因：

```xml Info.plist theme={null}
<key>SKAdNetworkItems</key>
<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>kbd757ywx3.skadnetwork</string>
    </dict>
</array>
```

<Note>
  Mintegral 在 [dev.mintegral.com/skadnetworkids.json](https://dev.mintegral.com/skadnetworkids.json) 发布了完整的合作伙伴 SKAdNetwork ID 列表。添加这些额外的 ID 可以提高 Mintegral 需求合作伙伴的归因准确性。
</Note>

### App Tracking Transparency（iOS 14+）

```xml Info.plist theme={null}
<key>NSUserTrackingUsageDescription</key>
<string>此标识符将用于向您投放个性化广告。</string>
```

## 项目配置

**链接器标志：** 在 Build Settings 的 Other Linker Flags 中添加 `-ObjC`。这是必需的，因为 CloudXCore 是动态框架，Objective-C categories 必须在运行时加载。

**部署目标：** 确保您项目的最低部署目标为 iOS 13.0 或更高版本。

## Mintegral SDK 框架

Mintegral 适配器需要多个系统框架。使用 CocoaPods 时，这些会自动配置。手动集成时，请确保链接以下框架：

* Foundation、UIKit、AdSupport、CoreGraphics、CoreTelephony
* SystemConfiguration、AVFoundation、CoreMedia
* QuartzCore、StoreKit、WebKit
* AppTrackingTransparency（弱链接）

## 兼容性

| 适配器版本     | 广告网络 SDK               | 最低 CloudXCore |
| --------- | ---------------------- | ------------- |
| `8.1.5.0` | MintegralAdSDK `8.1.5` | `3.5.0`       |
| `8.0.9.0` | MintegralAdSDK `8.0.9` | `3.5.0`       |

当服务端下发的 CloudX 配置包含该广告网络需求时，SDK 会自动发现该适配器。无需手动注册适配器。

## 支持

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