菜单

快速集成

SDK 基本信息

SDK名称:热力引擎 MacOS SDK v1.3.0.0

开发者名称:汇量云(北京)科技有限公司

SDK版本号:1.3.0.0

支持Xcode版本:14.0或更高

主要功能:热力引擎是一站式增长分析与发行决策平台,致力于帮助开发者搭建便捷、高效的数据管理中台,洞察业务运营全链路数据,制定更优增长决策。热力引擎支持全球全渠道数据管理,帮助开发者实现归因分析、用户粒度 ROI 分析,能有效衡量渠道价值,为投放和变现策略调优提供全方位数据支持。同时,提供应用内埋点及参数管理,配合多种分析模型与 AB 测试功能,全面还原用户全生命周期旅程,挖掘用户需求及业务增长点,快速验证并推行产品迭代优化,为开发者提升业务运营效率,实现规模化增长赋能。

适用范围:适用于 MacOS 11.0 及以上的操作系统

隐私政策链接: https://www.solar-engine.com/privacyPolicy.html

合规指南:详见本页面底部合规指南内容。

第一步:获取 Appkey

Appkey 查询路径:资产管理-应用管理-16位 Appkey(即应用 ID)。

文章图片

 

第二步:获取 SDK

如果您创建的产品数据存储区域是中国大陆,请下载

https://solar-sdk.oss-cn-beijing.aliyuncs.com/iOS/SolarEngine-iOSSDK-CN-v1.3.0.0.zip

如果您创建的产品数据存储区域是非中国大陆,请下载

https://solar-sdk.oss-cn-beijing.aliyuncs.com/iOS/SolarEngine-iOSSDK-US-v1.3.0.0.zip

 

第三步:SDK 集成

手动集成:添加 SDK 所需依赖框架

使用 libsqlite3.tbd 用来存储数据

添加方法:

在工程目录中,选择 TARGETS-->Build Phases-->Link Binary With Libraries-->+ -->选择 libsqlite3.tbd 等库文件。

如上动态库请全部配置,避免报错。

添加-ObjC参数

在工程的 TARGETS -> Build Settings -> Linking -> Other Linker Flags 中添加 -ObjC

第四步:预初始化 SDK

在应用安装后首次冷启动时,需要先预初始化 SDK,预初始化时 SDK 不采集任何个人信息也不会向热力引擎上报数据,

请请确保用户同意《隐私政策》并且 SDK 预初始化成功后,再调用初始化函数正式初始化 SDK

- (void)preInitWithAppKey:(nonnull NSString *)appKey;

参数说明:

参数 类型 是否必填 说明
appKey NSString 获取的 appKey

预初始化调用示例:

// 导入头文件
#import 


[[SolarEngineSDK sharedInstance] preInitWithAppKey:your_appKey];

 

第五步:初始化配置(可选)

此方法返回的 config 配置作为初始化方法的一个可选参数,如未设置则为默认值

初始化配置说明:

属性 类型 是否必填 说明
logEnabled BOOL 是否开启本地调试日志(不设置时默认不开启)
isDebugModel BOOL 是否开启 Debug 模式,YES 表示开启 Debug 模式,开启后能在后台实时查看数据校验结果,Debug模式数据不入库,不要把Debug模式发布到线上。(不设置时默认不开启 Debug 模式)

 

第六步:初始化 SDK

在正式初始化前,您应确保用户同意《隐私政策》并且 SDK 预初始化成功,再调用正式初始化函数初始化热力引擎 SDK

- (void)startWithAppKey:(nonnull NSString *)appKey config:(SEConfig *)config;

参数说明:

参数 类型 是否必填 说明
appKey NSString 获取的 appKey
config SEConfig 初始化配置,如果为空则为默认值


正式初始化调用示例:

SEConfig *config = [[SEConfig alloc] init];
config.logEnabled = YES; //开启本地调试日志
[[SolarEngineSDK sharedInstance] startWithAppKey:your_appKey config:config];

监听初始化回调

code 说明
0 初始化成功
101 初始化失败,没调用预初始化
102 初始化失败,appkey不符合规范
 [[SolarEngineSDK sharedInstance] setInitCompletedCallback:^(int code) {
      if (code == 0) {
            // 初始化成功
            NSLog(@"InitCompletedCallback success");
       } else {
            // 初始化失败
            NSLog(@"InitCompletedCallback code = %d",code);
       }
 }];
 
 
 
 
最近修改: 2025-05-20Powered by