一、穿山甲SDK下载与接入

请您注册登录穿山甲后台，在后台中接入中心下载穿山甲 SDK并接入，下载具体入口如下：

在开发者平台进入“接入与测试”-“广告变现”，可下载对应SDK并查看接入文档， 点击跳转

二、SDK集成

我们建议您使用 CocoaPods 更轻松地管理 Xcode 项目的库依赖，而不是直接下载并安装 SDK。

1. 方法一：pod集成

在podfile文件中加入以下代码即可

2. 方法二：手动集成

将解压缩后获取 framework 文件 (平台接入模块->SDK下载)拖入工程。依赖的framework说明如下:

• BUAdSDK.framework 抽象的接口逻辑层
• CSJAdSDK.bundle 资源bundle

升级SDK必须同时更新framework和bundle文件，否则可能出现部分页面无法展示的问题。

拖入工程后请确保Copy Bundle Resources中有CSJAdSDK.bundle，否则可能出现icon图片加载不出来的情况。

3. 注意事项

SDK禁止媒体继承抽象接口类，因为继承一个抽象的接口并不能有效进行功能扩展. 反而在业务逻辑和系统稳定性上产生隐患，若存在必要的功能扩展，可通过封装实现；

使用临时变量加载是错误的操作， 在SDK修复了内部内存泄漏后使用临时变量加载样式将不能完成样式加载；

三、工程配置

1. 运行环境配置

• 支持架构： arm64，x86_64
• 支持系统&SDK编译环境：

2. 添加权限与库依赖

• 穿山甲已全部支持HTTPS协议，但客户素材存在非HTTPS情况。为确保这类素材能正常加载和展示，需配置NSAllowsArbitraryLoads权限操作指引：打开项目的Info.plist文件，点击information Property List 右侧的 "+" ，添加 App Transport Security Settings，先点击左侧展开箭头，再点右侧+ 添加Allow Arbitrary Loads ，修改值为 YES。

• 穿山甲SDK本身并不需要配置NSMotionUsageDescription权限，若您的 App 自身使用了访问设备运动数据的 API(如 CMSensorRecorder、CMPedometer、CMMotionActivityManager、CMMovementDisorderManager)，必须在 Info.plist 中配置 NSMotionUsageDescription 权限并设置描述文案，否则 App 在尝试访问运动数据时会崩溃。
• 操作指引：点击右侧information Property List的 "+" 展开添加NSMotionUsageDescription，先点击左侧展开箭头，再点右侧加号，NSMotionUsageDescription添加后，设置value值。
• 崩溃信息：This key is required if your app uses APIs that access the device’s motion data, including CMSensorRecorder, CMPedometer, CMMotionActivityManager, and CMMovementDisorderManager. If you don’t include this key, your app will crash when it attempts to access motion data.详见

• 选中项目，在Build Settings->Other Linker Flags 增加参数-ObjC、 -l"c++"、 -l"c++abi" 、-l"sqlite3"、-l"z" ，SDK同时支持-all_load，具体操作如图

• 添加依赖库：在Xcode中选中工程，在Target->Build Phases->Link Binary With Libraries中点击“+”,点击“Add”依次添加下列依赖库
• CoreML.framework
• CoreHaptics.framework（6.9.0.0及以上版本新增）
• Accelerate.framework
• AdSupport.framework
• AppTrackingTransparency
• AudioToolbox.framework
• AVFoundation.framework
• CoreGraphics.framework
• CoreImage.framework
• CoreLocation.framework
• CoreMedia.framework
• CoreMotion.framework
• CoreTelephony.framework
• CoreText.framework
• ImageIO.framework
• JavaScriptCore.framework
• MapKit.framework
• MediaPlayer.framework
• MobileCoreServices.framework
• QuartzCore.framework
• Security.framework
• StoreKit.framework
• SystemConfiguration.framework
• UIKit.framework
• WebKit.framework
• DeviceCheck.framework依赖
• libbz2.tbd
• libc++.tbd
• libiconv.tbd
• libresolv.9.tbd
• libsqlite3.tbd
• libxml2.tbd
• libz.tbd
• libc++abi.tbd

3. iOS17 隐私策略适配说明

无论您使用cocoapods集成，手动集成或SPM集成穿山甲SDK，都可以在xcode项目CSJAdSDK.bundle目录下找到PrivacyInfo.xcprivacy文件，请将此文件拷贝进您的工程中。如果您的App本身包含PrivacyInfo.xcprivacy文件，请将穿山甲的PrivacyInfo.xcprivacy中的条款合并主文件中，方式如下：

• 使用source code方式添加：使用 Source Code方式打开 app 项目下的 PrivacyInfo.xcprivacy。复制穿山甲SDK的 PrivacyInfo.xcprivacy条目并添加到您的文件中，注意不要重复添加或错行。
• 使用 Property List 的方式添加：双击打开 PrivacyInfo.xcprivacy 文件，点击+，Xcode会提示可选的条款和可设置项，按照需求进行增补即可。
• 如果您的项目同时集成了多个包含PrivacyInfo.xcprivacy的SDK，建议您将所有SDK的条款补充到您自身App的PrivacyInfo.xcprivacy中。在补充时，对于同一个API的声明和原因解释，无需重复添加。

Ads-CN的PrivacyInfo.xcprivacy

4. iOS14 AppTrackingTransparency

• SKAdNetwork（SKAN） 是 Apple提供的归因解决方案，可帮助广告主在保持用户隐私的同时衡量广告变现效果。 使用 Apple 的 SKAdNetwork 后，即使 IDFA 不可用，流量网络仍能准确获得应用安装的归因结果。 更多详情请参考 https://developer.apple.com/documentation/storekit/skadnetwork 。 为了流量转化的归因，所有开发者需设置穿山甲SKAdNetwork id。

• App Tracking Transparency (ATT)是 Apple 推出的用户授权机制，用于请求用户授权，访问与应用相关的数据以跟踪用户或设备。 更多详情请参考 https://developer.apple.com/documentation/apptrackingtransparency。 目前苹果要求在iOS 14.5及以上必须在弹窗取得用户同意后才可以追踪用户，用户授权之前IDFA 将不可用。 如果用户拒绝此请求，应用获取到的 IDFA 将自动清零，可能会导致您的变现收入的降低。
• 要获取 App Tracking Transparency 权限，请更新您的 Info.plist，添加 NSUserTrackingUsageDescription 字段和自定义文案描述。代码示例：

• 向用户申请权限时，请调用 requestTrackingAuthorizationWithCompletionHandler方法。我们建议您申请权限后再请求，以便穿山甲准确的获得用户授权状态。 

  Swift 代码示例

  Objective-C 代码示例

5. iOS本地化 / 国际化配置

开发者必须在这里设置所支持的语言，否则会有语言显示的问题，如 : 支持中文 添加 Chinese