一、接入须知

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

融合SDK支持接入多家ADN，开发者可参考[二、工程配置]按需添加对应的ADN的SDK和adapter，iOS需单独引入聚合基础库-CSJMediation；

注意事项：

1. SDK和adapter版本：以平台实际下载或上述[2.1 SDK版本适配说明]为准，三方adn和adapter版本不匹配可能会导致功能异常，若三方adn版本不在上述范围内，开发者需和三方adn确认改动范围，自行测试功能是否异常；
2. 聚合能力开启：
1. 若使用聚合能力，必须引入CSJMediation为基础库，并在初始化SDK时开启聚合开关 configuration.useMediation = YES即可，二者缺一不可；
2. configuration.useMediation = YES仅可设置一次，不支持后续二次修改，默认值为NO。

二、SDK集成

1. 方法一：Cocopods引入

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

注意事项：

1. SDK和adapter版本：以平台实际下载或前置说明为准，三方adn和adapter版本不匹配可能会导致功能异常，若三方adn版本不在上述范围内，开发者需和三方adn确认改动范围，自行测试功能是否异常；
2. 若需接入其他三方ADN预算(非穿山甲支持的通用ADN），请查看自定义ADN的方式进行接入

2. 方法二：本地导入

注意事项：

1. SDK和adapter版本：以平台实际下载或前置说明为准，三方adn和adapter版本不匹配可能会导致功能异常，若三方adn版本不在上述范围内，开发者需和三方adn确认改动范围，自行测试功能是否异常；
2. 若需接入其他三方ADN预算(非穿山甲支持的通用ADN），请查看自定义ADN的方式进行接入

• SDK的framework库

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

三方SDK获取方式

注意事项：

1. 若需接入其他三方ADN预算(非穿山甲支持的通用ADN），请查看自定义ADN的方式进行接入
2. 若接入三方SDK，需要导入对应的SDK和adapter，否则可能导致初始化和广告请求失败；

• Adapter适配器：

开发者可根据实际情况导入要接入的ADN对应的adaper，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. 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的声明和原因解释，无需重复添加。

6. iOS14 适配说明

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

6.1 ATT配置

App Tracking Transparency (ATT)： Apple 推出的用户授权机制，用于请求用户授权，访问与应用相关的数据以跟踪用户或设备。 目前苹果要求在iOS 14.5及以上必须在弹窗取得用户同意后才可以追踪用户，用户授权之前IDFA 将不可用。 如果用户拒绝此请求，应用获取到的 IDFA 将自动清零，可能会导致您的变现收入的降低。更多详情请参考>>>。

• 要获取 App Tracking Transparency 权限，请更新您的 Info.plist，添加 NSUserTrackingUsageDescription 字段和自定义文案描述。代码示例：

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

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

6.2 SKAdNetwork配置

SKAdNetwork（SKAN）： Apple提供的归因解决方案，当IDFA未获取到时使用Apple的转化跟踪SKAdNetwork来获取归因。可帮助广告主在保持用户隐私的同时衡量广告变现效果。 使用 Apple 的 SKAdNetwork 后，即使 IDFA 不可用，流量网络仍能准确获得应用安装的归因结果。 更多详情请参考>>>

• 开发者需要在info.plist中添加SKAdNetworkItems。

• 三方ADN

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

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