集成

CloudX iOS SDK 的 Mintegral 适配器。支持 Banner、MREC、Interstitial、Rewarded、Native 和 App Open。

有关 CloudX 控制台映射和 Mintegral 侧 ID 设置,请参阅 Mintegral 竞价方指南。本页仅说明 iOS 特定的集成细节。

安装

CocoaPods

Podfile
pod 'CloudXMintegralAdapter', '~> 8.1.6.1'
pod install --repo-update

Swift Package Manager

将适配器软件包添加到项目:

  • 软件包 URL:https://github.com/cloudx-io/cloudx-ios-swift-package-adapter-mintegral.git
  • 精确软件包版本:8010601.0.0
  • Product:CloudXMintegralAdapter

该软件包要求 CloudXCore 3.9.1 或更高版本以及 Mintegral Ad SDK 8.1.6。在应用 target 的 Other Linker Flags 中添加 $(inherited) -ObjC。

手动安装

  1. 从 Releases 下载 CloudXMintegralAdapter.xcframework.zip
  2. 解压并将 CloudXMintegralAdapter.xcframework 拖入您的 Xcode 项目
  3. 手动添加 MintegralAdSDK(= 8.1.6),包括 BidBannerAd、BidNewInterstitialAd、BidRewardVideoAd、BidNativeAdvancedAd 和 BidSplashAd 子模块。

Info.plist 配置

SKAdNetwork IDs(iOS 14.5+ 必需)

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

Info.plist
<key>SKAdNetworkItems</key>
<array>
    <dict>
        <key>SKAdNetworkIdentifier</key>
        <string>kbd757ywx3.skadnetwork</string>
    </dict>
</array>

App Tracking Transparency(iOS 14+)

Info.plist
<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(弱链接)

原生广告

适配器不会直接公开主图素材:ad.nativeAd.mainImage 不会被填充。媒体内容(图片或视频)通过适配器提供的媒体视图渲染,CloudX 会将其附加到通过视图绑定器的 mediaContentViewTag 绑定的容器。请按原生广告的说明绑定可见的媒体容器。

兼容性

下表列出 CocoaPods 的依赖要求。Swift Package Manager 要求 CloudXCore 3.9.1 或更高版本。

适配器版本广告网络 SDK最低 CloudXCore
8.1.6.1MintegralAdSDK 8.1.63.5.0
8.1.6.0MintegralAdSDK 8.1.63.5.0
8.1.5.0MintegralAdSDK 8.1.53.5.0
8.1.3.0MintegralAdSDK 8.1.33.5.0
8.0.9.0MintegralAdSDK 8.0.93.5.0
8.0.7.0MintegralAdSDK 8.0.73.5.0
8.0.3.0MintegralAdSDK 8.0.33.5.0

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

支持

如需支持,请联系 support@cloudx.io