一、接入须知

SDK包体可通过CSJ媒体平台->接入中心->广告变现->->SDK->GroMore聚合变现下载即可。

融合SDK支持多家ADN，开发者可按需接入对应的ADN 的SDK 和 adapter包 ，iOS较Android而言区别在于需单独引入聚合包-CSJMediation；

• configuration.useMediation = YES，并且有引入聚合的"CSJMediation"，才可开启聚合功能，条件缺一不可
• configuration.useMediation = YES仅可设置一次，不支持后续二次修改，默认值为NO。

二、SDK集成

1、方法一：Cocopods引入

在podfile文件中加入以下代码即可接入成功。

2、方法二：本地导入

获取framework库，导入项目工程即可。

SDK的framework库结构：

Adapter：

adapter插件可根据自身项目选择需要接入的ADN，各个adapter对应支持的各家ADN SDK版本可参照【前置说明 -> 支持版本】

三、工程配置

1、运行环境配置

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

2、添加权限与库依赖

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

具体操作如图：

3、Other Linker Flags

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

4、添加依赖库

在Xcode中选中工程，在Target->Build Phases->Link Binary With Libraries中点击“+”,点击“Add”依次添加下列依赖库

具体操作如图所示：

5、三方SDK导入

聚合SDK依赖于被聚合的三方SDK，故在接入本SDK之前请确保项目已经接入了参与聚合的第三方广告联盟SDK。

6、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

7、iOS14 适配说明

以往广告归因依赖于IDFA。从iOS 14开始，只有在获得用户明确许可的前提下，应用才可以访问用户的IDFA数据并向用户投放定向广告。在应用程序调用 App Tracking Transparency 框架向最终用户提出应用程序跟踪授权请求之前，IDFA将不可用。如果某个应用未提出此请求，则读取到的IDFA将返回全为0的字符串，这个可能会导致广告收入降低。

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

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

• 以上配置好之后，在APP启动后会出现如下ATT授权对话框, 点击"允许跟踪"将会使APP正常获取到IDFA；

• SKAdNetwork（SKAN） 是 Apple提供的归因解决方案，当IDFA未获取到时使用Apple的转化跟踪SKAdNetwork来获取归因。可帮助广告主在保持用户隐私的同时衡量广告变现效果。 使用 Apple 的 SKAdNetwork 后，即使 IDFA 不可用，流量网络仍能准确获得应用安装的归因结果。 更多详情请参考 https://developer.apple.com/documentation/storekit/skadnetwork ，开发者需要在info.plist中添加SKAdNetworkItems。

三方ADN

目前SDK支持的的平台已知的SKAdNetwork标识符如下：

注意：三方ADN SKAdNetworkIdentifier请务必以其官方文档为准

当前媒体A使用SDK集成了Admob这家ADN，则需要在info.plst做如下配置：

在Xcode工程配置里则如下: