SDK 合规配置
升级最新 SDK
请务必确保您已经将基调听云 SDK 升级到满足监管新规的最新版本。
SDK 个人信息收集说明
接入说明：为了更好的协助运维研发人员分析真实用户使用 App 的过程中遇到的崩溃、卡顿、网络异常等影响使用体验的问题，SDK 会在您使用移动 App 的过程中自动收集一些基础信息，具体如下：
| 客户端 SDK | 个人信息类型 | 收集目的 |
| Android SDK | 设备信息：设备型号、设备生产厂商、操作系统名称、操作系统版本、磁盘使用情况、内存使用情况、CPU 信息（型号、架构、使用率）、电池电量、电池温度、是否 Root、网络流量 | 获取应用在终端设备上的性能数据并对其进行统计分析 |
| 应用信息：应用名称、应用包名、应用版本、应用UI朝向、应用渠道ID | ||
| 网络信息：网络类型、网络连接类型、运营商名称、服务器IP地址 | ||
| iOS SDK | 设备信息：设备型号、设备生产厂商、操作系统名称、操作系统版本、磁盘使用情况、内存使用情况、CPU 信息（架构、使用率）、是否 越狱、网络流量 | |
| 应用信息：应用名称、应用包名、应用版本、应用UI朝向、应用渠道ID | ||
| 网络信息 ：网络类型、网络连接类型、运营商名称、服务器IP地址 | ||
| Harmony SDK | 设备信息：设备型号、设备生产厂商、操作系统名称、操作系统版本、磁盘使用情况、内存使用情况、CPU 信息（架构、使用率）、网络流量 | |
| 应用信息：应用名称、应用包名、应用版本、应用UI朝向、应用渠道ID | ||
| 网络信息：网络类型、网络连接类型、运营商名称、服务器IP地址 |
SDK 申请系统权限说明
接入说明：对于基调听云 SDK 可选申请的系统权限，您可以参考如下表格内容，详细了解相关权限与业务功能的关系，因相关权限的不申请将会对其对应功能造成影响，您可以结合实际需求进行合理配置。
| Android 端应用权限列表 | ||
|---|---|---|
| 权限 | 是否可选 | 用途 |
| android.permission.INTERNET | 必选 | 用于 SDK上 报性能数据及数据分析 |
| android.permission.ACCESS_NETWORK_STATE | 可选 | 用以获取当前设备的网络状态和WiFi状态，如：2G、3G、4G、WiFi，建议添加 |
| android.permission.READ_PHONE_STATE | 可选 | 用以获取 targentVersion 29 及以上 Android 10 设备的网络状态 |
| android.permission.SYSTEM_ALERT_WINDOW | 可选 | 用以使用「可视化操作命名功能」 |
| android.permission.SYSTEM_OVERLAY_WINDOW | 可选 | 用以使用「可视化操作命名功能」 |
| android.permission.ACCESS_COARSE_LOCATION | 可选 | 用以获取当前移动网络连接的基站信息 |
| iOS 端应用权限列表 | ||
| 权限 | 是否可选 | 用途 |
| 网络访问权限 | 必选 | 用于 SDK 上报性能数据及数据分析 |
| 本地网络访问权限 | 可选 | 用于 SDK 做 MTR 网络探测任务 |
| Harmony 端应用权限列表 | ||
| 权限 | 是否可选 | 用途 |
| ohos.permission.INTERNET | 必选 | 用于 SDK 上报性能数据及数据分析 |
| ohos.permission.GET_NETWORK_INFO | 可选 | 获取网络连接信息，配置后可以获取网络类型和连接方式信息 |
SDK 隐私政策条款示例
您务必告知用户您选择基调听云 SDK服务，请在隐私政策中增基调听云 SDK隐私政策条款。
基调听云 SDK隐私政策条款示例：
| 参数 | 示例 |
|---|---|
| SDK名称 | 基调听云 SDK |
| 收集个人信息 | 设备信息：设备型号、设备生产厂商、操作系统名称、操作系统版本、磁盘使用情况、内存使用情况、CPU 信息（型号、架构、使用率）、网络流量、是否越狱/root、电池电量 网络信息：网络类型、网络连接类型、运营商名称、服务器IP地址 应用信息：应用名称、应用包名、应用版本、应用UI朝向、应用渠道ID |
| SDK服务商 | 北京基调网络股份有限公司 |
| 使用目的 | 进行 App 性能统计与分析 |
| 隐私政策 | 基调听云 SDK隐私政策 |
最终用户同意方式示例
APP首次运行时应当有隐私弹窗，隐私弹窗中应公示简版隐私政策内容并附完整版隐私政策链接，并明确提示用户阅读并选择是否同意隐私政策；隐私弹窗应提供同意按钮和拒绝同意的按钮，并由最终用户主动选择。
隐私政策授权弹窗示例：
SDK 初始化时机
请务必在用户同意您 APP 中的隐私政策后，再进行基调听云 SDK 的初始化； 用户同意隐私政策之前，避免动态申请涉及用户个人信息的敏感设备权限； 用户同意隐私政策前，您应避免私自采集和上报个人信息。 您可以按如下步骤进行基调听云 SDK初始化：
-
您应确保 App 安装后首次启动时，在用户 同意隐私政策之后，才初始化基调听云 SDK 进行数据采集、上报。反之，如果用户不同意隐私政策，则不初始化基调听云 SDK。具体配置参考如下代码：
- iOS
/** 初始化 SDK
*@param appId 听云平台App唯一标识
*@param channelId 渠道ID，默认为AppStore
*/
+(void)startWithAppID:(NSString *)appId channelId:(NSString *)channelId;- Android
// 初始化 SDK
// "Appkey" 请从基调听云平台获取
// "Host" 为基调听云平台「Redirect」服务器地址，无需添加协议头
// setStartOption(7) 设置首次启动开启网络、用户体验、崩溃采集，仅首次启动生效
NBSAppAgent.setLicenseKey("AppKey").setRedirectHost("Host").setStartOption(7).start(this.getApplicationContext());- Harmony
import tingyun from '@tingyun/sdk-core'
import axios from '@ohos/axios'
export default class EntryAbility extends UIAbility {
onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
//初始化 SDK
tingyun.init({
// redirect服务器地址, 在控制台设置页面获取
redirectHost: '<Redirect服务器地址>',
// appKey, 在控制台设置页面获取
appKey: '<AppKey>',
// 上下文
context: this.context,
// 如果使用axios, 可传入axios对象采集axios发送的网络请求
axios: axios
})
}
// ...
} -
一旦 App 获得隐私政策的授权，后续 App 冷启动开发者应该保证初始化基调听云SDK。
如何联系我们
如果您对基调听云 SDK 数据收集有任何疑问、意见或建议，亦或者需要基调听云协助关闭某项数据收集，请联系我司客服热线400-898-9580。