基本信息

SDK名称：热力引擎 Corona SDK v1.0.1

开发者名称：汇量云（北京）科技有限公司

SDK版本号：1.0.1

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

适用范围：适用于Android5.0（APILevel21）及以上的操作系统。

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

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

第一步：获取 Appkey

Appkey 查询路径：资产管理-应用管理-16位 Appkey（即应用 ID）。

第二步：获取 SDK

如果您创建的产品数据存储区域是中国大陆，请下载:  solarengine_corona_sdk_cn_v1.0.1.zip

如果您创建的产品数据存储区域是非中国大陆，请下载: solarengine_corona_sdk_us_v1.0.1.zip

第三步：集成 SDK

下载好的SolarEngineSDK 有三部分：Android、iOS、Corona

• Android:  
  • SEPluginProxy.java
  • SELuaLoader.java
• iOS
  • SEPluginLibrary.h
  • SEPluginLibrary.mm
  • SolarEngineSDK.xcframework
• Corona
  
  • SolarEngineSDK.lua

3.1 添加 Corona 配置

将SolarEngineSDK.lua 复制到 Corona 目录

3.2 添加 Android配置

复制 android/SEPluginProxy.java 到 android/plugin/src/main/java/plugin/library 目录

复制 android/SELuaLoader.java 到 android/plugin/src/main/java/plugin/library 目录

3.2.1 添加代码

android/plugin/src/main/java/plugin/library/LuaLoader.jave 

invoke方法中添加代码

SELuaLoader selLoader = new SELuaLoader();
selLoader.invoke(L);

3.2.2 添加SolarEngine Android SDK 依赖

maven 仓库配置

allprojects {
    repositories {
        google()
        jcenter()

        // SolarEngine SDK仓库地址
        maven { url "https://maven-android.solar-engine.com/repository/se_sdk_for_android/" }
        maven { url "https://developer.huawei.com/repo/" }
        maven { url "https://developer.hihonor.com/repo/" }
    }
}

需要注意的是，根目录的 build.gradle 中  buildscript 和 allprojects 下的 repositories 都需要配置 Maven 仓库地址。

请将下方代码添加到 plugin 的 build.gradle 中

 中国大陆，请使用大陆版SDK

implementation 'com.reyun.solar.engine.china:solar-engine-core:1.3.1.1'
implementation 'com.reyun.solar.engine.china:solar-remote-config:1.3.1.1'

 非中国大陆，请使用海外版SDK

implementation 'com.reyun.solar.engine.oversea:solar-engine-core:1.3.1.1'
implementation 'com.reyun.solar.engine.oversea:solar-remote-config:1.3.1.1'

如果打包时需要增加混淆，请将下方代码增加到混淆配置文件中

-keep class com.reyun.** {*; }
-keep class route.**{*;}
-keep interface com.reyun.** {*; }
-keep interface route.**{*;}
-dontwarn com.reyun.**
-dontwarn org.json.**
-keep class org.json.**{*;}
# Google lib库
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient {
    com.google.android.gms.ads.identifier.AdvertisingIdClient$Info getAdvertisingIdInfo(android.content.Context);
}
-keep class com.google.android.gms.ads.identifier.AdvertisingIdClient$Info {
    java.lang.String getId();
    boolean isLimitAdTrackingEnabled();
}
-keep public class com.android.installreferrer.** { *; }
# 如果使用到了获取oaid插件，请添加以下混淆策略
-keep class com.huawei.hms.**{*;}
-keep class com.hihonor.**{*;}

3.3 添加 iOS 配置

用 Xcode 打开 ios 项目，添加SEPluginLibrary.h、SEPluginLibrary.mm、SolarEngineSDK.xcframework文件到ios项目中

• 支持Xcode版本：14.0或更高
• 适用范围：适用于 iOS 11.0 及以上的操作系统。

第四步：预初始化

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

local SolarEngineSDK = require("SolarEngineSDK")

SolarEngineSDK.preInit(seAppKey)

第五步：初始化配置（可选）

本配置类用于初始化 SDK 时，对服务能力与数据采集行为进行精细化控制，分为核心功能开关、辅助功能开关、数据采集开关三类参数。

此方法返回的 config 配置作为可选参数，如未设置则为默认值

local config = {}
config.logEnabled=true

一、核心功能开关配置

二、辅助功能开关

控制 SDK 的运行模式、调试日志、网络策略、授权等待、辅助功能（如延迟 Deeplink）等非核心业务的运行行为。

remoteConfig参数说明（在线参数功能）

三、数据采集开关

控制ipv6、OAID、UA等参数等数据是否采集。注：关闭对应数据采集参数后，将会影响归因、分析模块的数据能力，您将无法在热力引擎后台正常使用相关功能

第六步：初始化

SDK初始化参数

初始化示例

local SolarEngineSDK = require("SolarEngineSDK")


-- 设置 SolarEngine 初始化回调
SolarEngineSDK.setInitCallback(function(code)
    if code == 0 then
        print("[SolarEngineSDK] 初始化成功")
    else
        print("[SolarEngineSDK] 初始化失败，错误码:", code)
    end
end)


SolarEngineSDK.initWithConfig({
    appKey = "您的 AppKey",
    logEnabled = true 
})

初始化回调 code 码：

获取归因回调信息

初始化时获取归因结果

SDK提供获取归因结果信息接口，开发者可使用归因信息做埋点等逻辑处理

SDK提供两种方式获取归因结果信息

1、设置归因结果回调：当SDK获取归因结果成功或者失败时会给出回调（此接口为异步回调）

2、直接获取归因结果：直接从SDK缓存中获取归因结果，SDK还没归因结果时直接返回nil（此接口为同步返回）

监听归因结果示例代码：

SolarEngineSDK.setAttributionCallback(function(code, data)
     print("attributionCallback called")
     print("[SolarEngineSDK]code:" .. code)
     print("[SolarEngineSDK]data:" .. data)
    end )
SolarEngineSDK.initWithConfig({
    appKey = "your se AppKey",
    logEnabled = true
})

local SolarEngineSDK = require("SolarEngineSDK")
local attributionData = SolarEngineSDK.getAttributionData()
print("归因数据:", attributionData)

  归因errorCode 描述及 归因结果详情见：归因结果详情