中文
登录
后可查看全部文档
GroMore/开发测试/GroMore iOS集成文档/GroMore iOS SDK接入文档/SDK初始化及隐私合规配置
SDK初始化及隐私合规配置
最近更新 2026-03-19 17:04:12

注意事项

  • 使用聚合功能:使用穿山甲SDK聚合功能需将useMediation设置为YES,并确保有正确导入CSJMediation。useMediation仅可设置一次,不支持后续二次修改。
  • 初始化:
    • 要确保在SDK初始化成功后再进行广告请求,否则可能导致广告请求加载失败。默认仅支持初始化SDK一次,避免多次初始化SDK场景。
    • 接入过程中,强烈建议双端分别使用各自的应用ID进行测试,混用可能会影响收益。
    • setIsPaidApp:和setUserKeywords:须征得用户同意才可传入,帮助模型优化投放效果;
  • 其他:所有广告类型统一引用#import <BUAdSDK/BUAdSDK.h>头文件即可调用对应方法进行集成。

一、使用示例

强烈建议在用户同意隐私协议后再进行SDK的初始化操作,其中seAppID设置是必须的。

隐私数据获取说明详见

复制

二、接口说明

  • BUAdSDKConfiguration类

BUAdSDKConfiguration支持个性化及隐私合规配置,需在调用SDK初始化方法前设置,尤其必要的appID等参数。

其中ageGroup、themeStatus、customIdfa、limitPersonalAds、limitProgrammaticAds、forbiddenIDFA、extraDeviceMap、userInfoForSegment、extraData支持中途修改,是否生效也受接入的adn是否支持。

方法

说明

@property (nonatomic, copy) NSString *appID;

应用ID(5开头的7位数字),必选参数

@property (nonatomic, copy) NSString *secretKey;

唯一标识,可选参数

@property (nonatomic, assign) BUAdSDKLogLevel logLevel;

开发者模式,默认为 BUAdSDKLogLevelNone

@property (nonatomic, assign) BUAdSDKAgeGroup ageGroup;

用户年龄设置,成人/未成年

@property (nonatomic, copy) NSString *userExtData;

其他用户信息

@property (nonatomic, assign) BUOfflineType webViewOfflineType;

默认是BUOfflineTypeWebview

@property (nonatomic, strong) NSNumber *debugLog;

打印调试日志,0关闭调试日志; 1打开调试日志

@property (nonatomic, strong) NSNumber *themeStatus;

主题模式0:普通模式 1:暗黑模式

@property (nonatomic, strong) NSArray<NSNumber *> *abvids;

自定义ab实验

@property (atomic, copy) NSString *abSDKVersion;

ab实验SDK版本

@property (nonatomic, copy) NSString *customIdfa;

自定义IDFA

@property (nonatomic, assign) BOOL allowModifyAudioSessionSetting;

是否允许SDK在播放音频时修改AVAudioSession的类别和选项,默认为NO;
SDK默认设置的类别是AVAudioSessionCategoryAmbient,可切换为AVAudioSessionCategoryOptionDuckOthers自行控制音频设置

@property (nonatomic, assign) BUAudioSessionSettingType audioSessionSetType;

BUAudioSessionSettingType_Mix = 3 可以跟其他音乐软件共存声音
BUAudioSessionSettingType_Default = 0 不支持混音

@property (nonatomic, assign) BOOL unityDeveloper;

unity开发者设置为YES,否则为NO

@property (nonatomic, strong) id<BUAdSDKPrivacyProvider> privacyProvider;

设置SDK是否使用某些隐私数据,或者自定义隐私数据如果未设置此属性,SDK将执行默认的隐私数据使用逻辑

@property (nonatomic, strong, nullable) UIImage *appLogoImage;

应用logo

@property (nonatomic, assign) BOOL SDKDEBUG;

SDK是否处于调试模式,默认为NO当设置为YES时,将初始化一些必要的调试信息@warning建议在开发阶段设置为YES,这样可以在开发阶段输出必要的调试信息,方便调试和异常解决。在发布应用程序时,建议将其设置为NO,否则额外的输出将影响性能

@property (nonatomic, assign) BOOL useMediation;

是否使用聚合功能,默认为NO;设置为YES时,需确保正确导入CSJMediation.frameworkuseMediation仅可设置一次,不支持后续二次修改

@property (nonatomic, strong, readonly) BUAdSDKConfigurationMediation *mediation;

调用该接口,用于继续设置聚合维度相关属性

@property (nonatomic, strong) BUMUserInfoForSegment *userInfoForSegment;

配置用户分组信息,可随时更新,但用户分组信息更新将触发配置重新加载,请谨慎使用

@property (nonatomic, strong) NSNumber *limitPersonalAds;

是否限制个性化广告: 0-不限制,1-限制,默认为0。官方维护版本中只适用于CSJ,Ks、Sigmob、百度、GDT

@property (nonatomic, strong) NSNumber *limitProgrammaticAds;

是否限制程序化广告: 0-不限制,1-限制,默认为0。官方维护版本中只适用于Ks

@property (nonatomic, strong) NSNumber *forbiddenCAID;

是否禁止CAID:0-不禁止,1-禁止,默认为0。官方维护版本中只适用于百度

@property (nonatomic, copy, nullable) NSString *advanceSDKConfigPath;

设置预先从平台下载的SDKConfig文件路径,当首次安装网络请求SDKConfig失败时会使用,需在SDK初始化前设置

@property (nonatomic, copy) NSDictionary *extraDeviceMap;

设置扩展设备信息,如不了解该功能,请勿使用。 如@"[{\"device_id\":\"62271333038\"}]"

@property (nonatomic, strong) NSNumber *limitPersonalAds;

个性化广告推荐
是否限制个性化广告: 0-不限制,1-限制,默认为0。官方维护版本中只适用于CSJ,Ks、Sigmob、百度、GDT

@property (nonatomic, strong) NSNumber *limitProgrammaticAds;

程序化广告推荐
是否限制程序化广告: 0-不限制,1-限制,默认为0。官方维护版本中只适用于Ks

@property (nonatomic, strong) NSNumber *forbiddenCAID;

CAID权限
是否禁止CAID:0-不禁止,1-禁止,默认为0。官方维护版本中只适用于百度

@property (nonatomic, strong) id<BUAdSDKPrivacyProvider> privacyProvider;

定位使用权限及经纬度
设置SDK是否可以使用某些隐私数据,或者自己传递这些隐私数据。如果未设置此属性,SDK将执行默认的隐私数据使用逻辑。

@property (nonatomic, assign) BUAdSDKAgeGroup ageGroup;

未成年人设置
成人/未成年

@property (nonatomic, strong) id<BUAdSDKPrivacyProvider> privacyProvider;

地理位置控制设置

  • BUAdSDKManager类

该类是整个 SDK 设置的入口和接口,可以设置 SDK 的一些全局信息,提供类方法获取设置结果。

方法

说明

@property (nonatomic, copy, readonly, class) NSString *SDKVersion;

SDK版本号

@property (nonatomic, assign, readonly, class) BUAdSDKState state;

判断SDK的start状态;

+ (void)startWithAsyncCompletionHandler:(BUCompletionHandler)completionHandler;

异步初始化

@property (class) BUAdSDKManagerMediation mediation;

SDK初始化后可调用该接口,用于继续调用聚合维度相关方法

+ (NSDictionary * _Nullable)getGMSDKExtraInfo;

获取各类补充信息

+ (void)preloadAdsWithInfos:(NSArray *)infos andInterval:(NSInteger)interval andConcurrent:(NSInteger)concurrent;

触发首次预缓存,针对特定广告位infos 广告对象interval 指定每轮请求的时间间隔, 允许时间范围:1-10、concurrent:并发请求的广告数、允许个数范围:1-20

+ (void)configAdapterWithKey:(NSString *)key andBlock:(void(^)(void))block;

个性化配置类

三、完整接入示例

复制


本篇目录
联系我们