菜单

集成与初始化

1. SDK下载

1.1 使用CocoaPods导入（推荐）

在您的项目Podfile文件中添加以下代码：

ruby 复制代码 
pod 'SmartdigimktSDK', '~> 6.5.35'

然后在终端中执行：

bash 复制代码 
pod install

2. 集成配置

2.1 环境要求

  • iOS 10.0及以上版本
  • Xcode 16.0及以上版本
  • 支持armv7、arm64、armv7s和x86_64架构

2.2 Info.plist配置

如果您的应用需要支持HTTP请求，请在Info.plist中添加以下配置：

xml 复制代码 
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

2.3 权限配置

在Info.plist中添加必要的权限配置：

xml 复制代码 
<!-- 网络访问权限 -->
<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

<!-- 广告标识符权限 -->
<key>NSUserTrackingUsageDescription</key>
<string>此标识符将用于向您投放个性化广告</string>

3. 初始化SDK

在AppDelegate.m文件中初始化SDK：

objc 复制代码 
#import <SmartdigimktSDK/SDMAPI.h>
#import <SmartdigimktSDK/SDMSDKGlobalSetting.h>
#import <SmartdigimktSDK/SDMDeviceInfoList.h>

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 设置日志开关
    [SDMAPI setLogEnabled:YES];
    [[SDMSDKGlobalSetting sharedManager] addDeniedUploadDeviceInfo:@[
    kSDMDeviceDataInfoOSVersionNameKey,     // 系统版本名
    kSDMDeviceDataInfoOSVersionCodeKey,     // 系统版本号
    kSDMDeviceDataInfoPackageNameKey,       // 应用包名
    kSDMDeviceDataInfoAppVersionNameKey,    // 应用版本名
    kSDMDeviceDataInfoAppVersionCodeKey,    // 应用版本号
    kSDMDeviceDataInfoBrandKey,             // 设备品牌
    kSDMDeviceDataInfoCPUKey,               // CPU信息
    kSDMDeviceDataInfoModelKey,             // 设备型号
    kSDMDeviceDataInfoScreenKey,            // 屏幕分辨率
    kSDMDeviceDataInfoNetworkTypeKey,       // 网络类型
    kSDMDeviceDataInfoMNCKey,               // 移动网络代码
    kSDMDeviceDataInfoMCCKey,               // 移动国家代码
    kSDMDeviceDataInfoLanguageKey,          // 语言
    kSDMDeviceDataInfoTimeZoneKey,          // 时区
    kSDMDeviceDataInfoUserAgentKey,         // User Agent
    kSDMDeviceDataInfoOrientKey,            // 屏幕方向
    kSDMDeviceDataInfoIDFAKey,              // IDFA
    kSDMDeviceDataInfoIDFVKey,              // IDFV
    kSDMDeviceDataInfoSIMCardStateKey,      // SIM卡状态
    kSDMDeviceDataInfoBatteryKey,           // 电池信息
    kSDMDeviceDataInfoSensorDeny            // 传感器信息
]];

// 设置个性化广告状态
[[SDMAPI sharedInstance] setPersonalizedAdState:SDMPersonalizedAdStateType];

// 关闭摇一摇功能（可选）
[[SDMSDKGlobalSetting sharedManager] setDenySensor:YES];
    // 初始化SDK
    NSError *error;
    [[SDMAPI sharedInstance] startWithAppID:kSDMSDKAppID appKey:kSDMSDKAppKey error:&error];
    if (error) {
        NSLog(@"SDK初始化失败: %@", error.localizedDescription);
    } else {
        NSLog(@"SDK初始化成功");
    }
    // 关闭摇一摇功能（可选）
    // [[SDMSDKGlobalSetting sharedManager] setDenySensor:NO];
    
    // 设置微信相关信息（如需要）
    [[SDMSDKGlobalSetting sharedManager] setWeChatAppID:@"your_wechat_app_id" universalLink:@"your_universal_link"];
    
    return YES;
}

3.1 初始化参数说明

  • kSDMSDKAppID: 您在酷盈平台申请的应用ID
  • kSDMSDKAppKey: 您在酷盈平台申请的应用Key
  • setLogEnabled: 设置是否开启日志输出，建议在调试阶段开启，正式发布时关闭
  • setPersonalizedAdState: 设置个性化广告状态，用于GDPR合规
  • setDenySensor: 设置是否禁用传感器功能（如摇一摇），默认为NO
  • os_vc/os_vn: 用于屏蔽特定系统版本参数的设置
  • setWeChatAppID: 如果您的应用集成了微信分享功能，需要设置微信AppID和Universal Link

3.2 个性化广告状态类型

objc 复制代码 
    SDMPersonalizedAdStateType = 1,        // 个性化广告
    SDMNonpersonalizedAdStateType = 2      // 非个性化广告

3.3 初始化注意事项

  1. SDK初始化应该在应用启动时尽早进行
  2. 确保在主线程中进行初始化
  3. 初始化完成后即可开始加载广告
  4. 请确保AppID和AppKey的正确性，错误的参数会导致初始化失败
  5. 个性化广告设置需要根据您的隐私政策和用户同意情况进行配置
最近修改: 2025-10-11Powered by