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

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

## 安装

### CocoaPods

```ruby Podfile theme={null}
pod 'CloudXVungleAdapter', '~> 7.7.4.0'
```

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

### 手动安装

1. 从 [Releases](https://github.com/cloudx-io/cloudx-ios/releases) 下载 `CloudXVungleAdapter.xcframework.zip`
2. 解压并将 `CloudXVungleAdapter.xcframework` 拖入您的 Xcode 项目
3. 手动添加 `VungleAds`（`= 7.7.4`）。

## Info.plist 配置

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

<Accordion title="点击展开 Vungle SKAdNetwork IDs">
  ```xml Info.plist theme={null}
  <key>SKAdNetworkItems</key>
  <array>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>cstr6suwn9.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>4fzdc2evr5.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>v72qych5uu.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>ludvb6z3bs.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>wg4vff78zm.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>737z793b9f.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>yclnxrl5pm.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>t38b2kh725.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>7ug5zh24hu.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>9rd848q2bz.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>n6fk4nfna4.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>kbd757ywx3.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>9t245vhmpl.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>4468km3ulz.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>2u9pt9hc89.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>m8dbw4sv7c.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>c6k4g5qg8m.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>mlmmfzh3r3.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>578prtvx9j.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>4dzt52r2t5.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>e5fvkxwrpn.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>8s468mfl3y.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>av6w8kgt66.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>klf5c3l5u5.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>ppxm28t8ap.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>424m5254lk.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>uw77j35x4d.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>4pfyvq9l8r.skadnetwork</string>
      </dict>
      <dict>
          <key>SKAdNetworkIdentifier</key>
          <string>zmvfpc5aq8.skadnetwork</string>
      </dict>
  </array>
  ```
</Accordion>

### 应用追踪透明度（iOS 14+）

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

## 项目配置

**链接器标志：** 在 Build Settings 中将 `-ObjC` 添加到 Other Linker Flags。

**Bitcode：** Vungle SDK 不支持 Bitcode。将 Enable Bitcode 设置为 `NO`。

## 兼容性

| 适配器版本     | 广告网络 SDK          | 最低 CloudXCore |
| --------- | ----------------- | ------------- |
| `7.7.4.0` | VungleAds `7.7.4` | `3.5.0`       |
| `7.6.2.0` | VungleAds `7.6.2` | `3.5.0`       |

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

## 支持

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