菜单

酷盈 iOS 测试与验证广告

酷盈 iOS 测试与验证广告

测试模式用于接入阶段验证广告。开启后,当前测试设备会请求 ADX 测试广告。Debug 日志用于排查请求、展示等流程。

注意: 应用上线前需要关闭测试模式与 Debug 日志,并删除 setDebuggerConfig 相关代码。设备 IDFA 需要静态写死,不要在运行时读取当前设备 IDFA 后传入,避免影响线上用户。

1. 测试模式

1.1 获取测试设备 IDFA

酷盈 SDK 用传入的 deviceIdfaStr 比对当前设备的 IDFA。只有二者一致时,测试模式才会生效。

iOS 14+ 需先获得 ATT 授权,否则 IDFA 可能为全 0,测试模式无法匹配。

开发阶段读取一次 IDFA,确认后静态写入配置。不要把这段读取代码留在线上包里动态传入。

objc 复制代码
#import <AdSupport/AdSupport.h>

NSString *idfa = [ASIdentifierManager sharedManager].advertisingIdentifier.UUIDString;

也可先开启 Debug 日志,再调用 [SDMAPI testModeInfo],在控制台查看当前 IDFA / IDFV。

1.2 开启测试模式

在 SDK startWithAppID:appKey:error: 之前,通过 SDMSDKGlobalSetting 的 setDebuggerConfig: 配置。需同时设置:

  • deviceIdfaStr:静态写死的当前测试机 IDFA
  • netWorkType:SDMAdNetWorkAdxType(ADX)

不额外指定广告样式时,默认请求 ADX 测试广告,插屏为全屏。

objc 复制代码
#import <SmartdigimktSDK/SDMSDKGlobalSetting.h>
#import <SmartdigimktSDK/SDMDebuggerConfig.h>
#import <SmartdigimktSDK/SDMDebuggerConfigDefine.h>

NSString *testDeviceIdfa = @"静态写死的 IDFA";

[[SDMSDKGlobalSetting sharedManager] setDebuggerConfig:^(SDMDebuggerConfig * _Nullable debuggerConfig) {
    debuggerConfig.deviceIdfaStr = testDeviceIdfa;
    debuggerConfig.netWorkType = SDMAdNetWorkAdxType;
}];

传入的 IDFA 必须和当前手机的 IDFA 一致,否则测试模式不会生效。

1.3 关闭测试模式

应用上线前:

  • 删除 setDebuggerConfig: 相关代码
  • 关闭 Debug 日志: [SDMAPI setLogEnabled:NO];

2. SDK Debug 日志

2.1 日志开关

注意: 应用上线前需要关闭 Debug 日志

要开启 debug log,需要在 SDK init 之前调用 SDMAPI 进行设置。

快捷代码:

objc 复制代码
[SDMAPI setLogEnabled:YES];
上一个
隐私设置
下一个
iOS SDK 6.5.91 迁移说明
最近修改: 2026-11-19Powered by