English
Log In
You can then view all documents
Installation/iOS/初始化配置
初始化配置
Last updated 2026-03-31 16:09:51

一、注意事项

  1. BUAdSDKManager 类是整个 SDK 设置的入口和接口,可以设置 SDK 的一些全局信息,提供类方法获取设置结果。
  2. 任意广告类型均不支持中途更改代理,中途更改代理会导致接收不到广告相关回调,如若存在中途更改代理场景,需自行处理相关逻辑,确保广告相关回调正常执行。
  3. 接入过程中,强烈建议双端分别使用各自的应用ID进行测试,不要混用,否则可能会影响收益。

二、使用示例

强烈建议在用户同意隐私协议后再进行SDK的初始化操作,其中seAppID(5开头的7位数字)设置是必须的,更多使用方式可以参见 SDK Demo 工程

复制

三、接口说明

复制

1. 日志输出说明

使用示例

复制

接口说明

复制

2. 传感器&IDFA使用说明

复制

自定义IDFA

复制

3. 广告跳过设置

广告接口中的所有rootViewController均为必传项,用来处理广告跳转。SDK里所有的跳转均采用present的方式,请确保传入的rootViewController不能为空且没有present其他的控制器,否则会出现presentedViewController已经存在而导致present失败。

4. 隐私协议

  • BUAdSDKConfiguration 新增 privacyProvider 参数,用来让开发者控制隐私字段的启用或传值。
复制

5. 广告配置

5.1 个性化广告设置

开发者可以调用接口,向用户提供退出个性化广告的能力。退出后看到的广告相关度会降低,详细使用请参考个性化广告设置

5.2 屏蔽未成年广告限制

开发者通过穿山甲提供的接口回传的用户年龄设置需配合穿山甲媒体平台配置使用,两者缺一不可,否则无法生效。详细使用请参考屏蔽未成年广告限制

6. 夜间模式

穿山甲支持开发者在使用模板信息流&插屏&Banner广告时设置夜间模式的功能

复制

7. 混音设置

复制

8. 隐私数据获取说明

以下用户数据由穿山甲 iOS SDK收集,开发者在回答app Store Connect上的应用隐私问题时可以参考此图表。

访问https://developer.apple.com/app-store/app-privacy-details/了解更多信息。

8.1 收集的数据类型

数据类型

穿山甲收集情况

备注

联系信息 Contact Info 姓名 Name 电子邮件地址 Email Address 电话号码 Phone Number 实际地址 Physical Address 其他用户联系信息 Other User Contact Info

不收集


健康与健身 Health and Fitness 健康 Health 健身 Fitness

不收集


财务信息 Financial Info 付款信息 Payment Info 信用信息 Credit Info 其他财务信息 Other Financial Info

不收集


位置 Location 精确位置
Precise Location 粗略位置 Coarse Location

精确位置-可选收集
粗略位置-不收集

穿山甲会获取地理位置信息用于广告投放与反作弊。应用被用户授予地理位置权限时,穿山甲会获取地理位置信息,用于广告定向与反作弊;当应用不获取地理位置权限时,穿山甲不会主动获取地理位置权限及地理位置信息。

敏感信息 Sensitive Info

不收集


联系人 Contacts

不收集


用户内容 User Content 电子邮件或短信内容 Emails or Text Messages 照片或视频 Photos or Videos 音频数据 Audio Data 游戏内容 Gameplay Content 客户支持 Customer Support 其他用户内容 Other User Content

不收集


浏览历史记录 Browsing History

不收集


搜索历史记录 Search History

不收集


标识符 Identifiers 用户ID User ID 设备ID Device ID

可选收集

用户ID仅用于功能-奖励视频服务器端验证回调。开发者在广告请求期间向穿山甲发送他们的用户名(基本上是一系列数字,穿山甲不知道它与该应用内的内部用户id或内部用户名的关系。穿山甲只接收这些数据,不检查、不验证、不存储、不使用)。当用户完全观看奖励视频时,穿山甲将把这个用户id发送回开发者的服务器。如果开发者不使用此功能,则开发者不需要传递此类数据。设备ID 当应用被用户授予广告追踪权限时,穿山甲将获取idfa用于广告归因与追踪。

购买项目 Purchases 购物历史 Purchase History

不收集


使用数据 Usage Data 产品交互 Product Interaction
广告数据 Advertising Data
其他使用数据 Other Usage Data

Usage Data-不收集
广告数据-收集
其他使用数据- 不收集

穿山甲广告将统计下列广告数据,以用于广告主统计投放结果。展示 、点击 、转化

诊断 Diagnostics 崩溃数据
Crash Data 性能数据
Performance Data 其他诊断数据 Other Diagnostic Data

崩溃数据-收集
性能数据-收集
其他诊断数据-不收集

崩溃数据 穿山甲将收集穿山甲SDK带来的崩溃信息,以此来优化代码缺陷。 性能数据 穿山甲将收集SDK运行过程中性能数据,以优化穿山甲SDK的性能。

其他数据 Other Data 其他数据类型 Other Data Types

收集

技术上我们还会收集一些设备信息(例如,设备型号、操作系统及版本、时区、网络类型等)

8.2 数据使用目的

苹果明示了一系列的数据使用目的,需要开发者根据App中数据的使用情况进行披露。基于媒体与穿山甲的合作目的,穿山甲收集数据的主要目的是用于“第三方广告”、“APP功能”(如流量变现的功能);其他使用目的基于媒体自己的使用情况而定。

使用目的

基于接入穿山甲的功能,选择数据的使用目的

第三方广告Third-Party Advertising

开发者广告或营销内容Developer’s Advertising or Marketing

如您的App使用数据用于显示应用中的第一方广告(包括与第三方共享以显示广告)或其他营销目的是,请选择 是

分析Analytics

广告数据会用于分析,请选择 是

产品个性化 Product Personalization

如您的App将数据用于任何产品个性化功能,请选择 是

App 功能App Functionality

其他用途 Other Purposes

如您的App出于其他目的使用数据,请选择 是

8.3 与用户身份的关联性

通过穿山甲收集的数据类型通常连接到诸如设备ID(如果可用)之类的标识符,或者与其他标识符(如配置时由客户发布的ID)相连。因此,在询问数据是否链接到身份时,应用程序开发人员应选择

8.4 关于用户追踪

根据苹果对追踪的定义,当应用被用户授予广告追踪权限时,穿山甲将获取IDFA用于广告归因与追踪。


Contents
Contact us