菜单

SDK接入配置

1. 概述

1.1 简介

复制代码

倍孜 SDK（以后简称为SDK）为app对接我们的服务提供便利，本文档为使用SDK提供指南。

1.2 说明

本文档旨在帮助iOS应用开发者在程序中快速接入 SDK。作为应用开发者，您只需要进行简单配置，就可以在您的应用中显示定制的广告。关于 SDK 的具体使用方法，请仔细阅读下面的文档。

2. 开发环境

2.1 基础配置要求

确保您的开发及部署环境符合以下标准：
开发工具：推荐 Xcode 14.0 及以上版本
部署目标：iOS 11.0及以上版本
SDK版本：官网最新版本

2.2 部署SDK

2.2.1 自动部署

自动部署可以省去您工程配置的时间。iOS SDK会通过CocoaPods进行发布，推荐您使用自动部署。更多详情请访问CocoaPods官网。

Pod常用指令：

pod repo update（如果为查询到最新版本的SDK，更新索引）
pod install（安装SDK）
pod install --repo-update（可以将上述两条合并使用此命令）

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

使用下面的导入方式，其中AMPSAdSDK为必须添加，其他按需导入

objectivec 复制代码

   pod 'AMPSAdSDK', '~> 5.2.0.2'

2.2.2 手动部署

通过 SDK 下载页面可获取到集成需要依赖的库文件压缩包及相关的引入提示，将xcframework文件夹下所有文件导入到相应的工程中（手动拖动时，选择 Copy items if needed ）

注：请在Mac系统下解压生成Framework库，否则可能导致库文件不可用

2.2.3 Other Linker Flags

在Xcode中选择项目的Targets->Build Settings，配置Other Linker Flags 增加 -ObjC。（Pod导入时，可忽略）

注：如果报错找不到扩展类，尝试增加 -all_load

2.2.4 设置允许 http 连接

在工程的 Info.plist 文件中，设置 App Transport Security Settings 选项下 Allow Arbitrary Loads 值为 YES，对应 plist 内容为

objectivec 复制代码

<key>NSAppTransportSecurity</key> 
<dict> 
    <key>NSAllowsArbitraryLoads</key> 
    <true/> 
</dict>

2.2.5 SDK关联方式

手动部署时候，部分渠道为动态库，需要修改关联方式为Embed&Sign

2.2.6 iOS17隐私策略适配说明

适配说明

我们已新增 PrivacyInfo.xcprivacy 文件，在 AMPSAdSDK.xcframework 包中可见 PrivacyInfo.xcprivacy 请注意将PrivacyInfo.xcprivacy 拷贝进您的代码工程里。
如果您的项目同时集成了多个包含 PrivacyInfo.xcprivacy 的 SDK，建议您将所有SDK的条款补充到您自身 App 的 PrivacyInfo.xcprivacy中。在补充时，对于同一个 API 的声明和原因解释，无需重复添加。

objectivec 复制代码

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
        <key>NSPrivacyTrackingDomains</key>
        <array>
            <string>lvjunxue.com</string>
        </array>
        <key>NSPrivacyCollectedDataTypes</key>
        <array>
            <dict>
                <key>NSPrivacyCollectedDataType</key>
                <string>NSPrivacyCollectedDataTypeDeviceID</string>
                <key>NSPrivacyCollectedDataTypeLinked</key>
                <false/>
                <key>NSPrivacyCollectedDataTypeTracking</key>
                <true/>
                <key>NSPrivacyCollectedDataTypePurposes</key>
                <array>
                    <string>NSPrivacyCollectedDataTypePurposeThirdPartyAdvertising</string>
                </array>
            </dict>
        </array>
        <key>NSPrivacyTracking</key>
        <true/>
        <key>NSPrivacyAccessedAPITypes</key>
        <array>
                <dict>
                        <key>NSPrivacyAccessedAPIType</key>
                        <string>NSPrivacyAccessedAPICategoryFileTimestamp</string>
                        <key>NSPrivacyAccessedAPITypeReasons</key>
                        <array>
                                <string>C617.1</string>
                        </array>
                </dict>
                <dict>
                        <key>NSPrivacyAccessedAPIType</key>
                        <string>NSPrivacyAccessedAPICategorySystemBootTime</string>
                        <key>NSPrivacyAccessedAPITypeReasons</key>
                        <array>
                                <string>35F9.1</string>
                        </array>
                </dict>
                <dict>
                        <key>NSPrivacyAccessedAPIType</key>
                        <string>NSPrivacyAccessedAPICategoryDiskSpace</string>
                        <key>NSPrivacyAccessedAPITypeReasons</key>
                        <array>
                                <string>7D9E.1</string>
                                <string>E174.1</string>
                        </array>
                </dict>
                <dict>
                        <key>NSPrivacyAccessedAPIType</key>
                        <string>NSPrivacyAccessedAPICategoryUserDefaults</string>
                        <key>NSPrivacyAccessedAPITypeReasons</key>
                        <array>
                                <string>CA92.1</string>
                        </array>
                </dict>
        </array>
</dict>
</plist>

2.3 AppTrackingTransparency支持说明

iOS 14.5 后，对于用户隐私保护，苹果新政策原因，只有在获得用户明确许可的前提下，应用才可以访问用户的IDFA数据并向用户投放定向广告，开发者需要对14及其以上系统适配。

2.4 添加必要依赖库以及工程配置

在工程 Target Setting -> Build Phases -> Link Binary With Libraries 中进行添加

AppTrackingTransparency.framework（若引用）
Accelerate.framework
AdSupport.framework
AVFoundation.framework
Accelerate.framework
CoreTelephony.framework
Foundation.framework
SystemConfiguration.framework
Security.framework
StoreKit.framework
WebKit.framework
UIKit.framework
SafariServices.framework
libz.dylib/tbd
libc++.dylib/tbd
libsqlite3.dylib/tbd
libc++abi.tbd

3. 权限说明

系统平台	申请权限	调用时机	使用目的
iOS	网络权限	初始化时	检查设备连网络状态，确保SDK与服务端的通讯求
	设备信息(IDFA)（可选）	广告请求	广告投放及广告监测归因、反作弊
	访问粗略位置（可选）	广告请求	广告投放及广告监测归因、反作弊
	访问精准位置（可选）	广告请求	广告投放及广告监测归因、反作弊

上一个

Appstore隐私数据获取说明

下一个

SDK初始化及API说明

最近修改: 2025-06-10

大纲