文档中心 合规指南 开发者社区
极光文档 > 极光运营增长公共模块 > 客户端 SDK > Android SDK > 合规指南
极光文档 > 极光运营增长公共模块 > 客户端 SDK > Android SDK > 合规指南
合规指引
最近更新：2024-06-17
展开全部

合规指引

升级最新版 SDK

请务必确保您已经将极光运营增长SDK（Android）升级到满足监管新规的 最新版本

SDK业务功能说明

接入说明：极光运营增长SDK包括基本业务功能和扩展业务功能。
基本功能：为开发者提供数据分析和用户画像能力，帮助开发者提供更符合用户偏好的内容和服务，减少非必要信息对用户的打扰。
扩展功能：为提升开发者的服务体验，我们为开发者提供了应用自启动功能。

功能区分 业务功能 功能介绍 相关个人信息及处理目的 配置方式
基本功能 数据分析和用户画像 为开发者提供专业的数据统计分析能力和用户画像能力，帮助开发者提供更符合用户偏好的内容和服务，减少非必要信息对用户的打扰。 必要个人信息：
设备标识符（包括Android ID、GAID、OAID、UAID、Boot ID）：用于生成脱敏的终端用户设备唯一性标识，以确保能准确进行设备统计；
设备硬件信息（包括设备型号、设备屏幕分辨率、设备硬件制造商、设备产品名称、设备存储空间）、操作系统信息（包括操作系统版本、系统名称、系统语言：用于保证服务在不同设备上的兼容性，按设备情况维度提供统计报表，对您终端用户进行精细化行为数据分析以及帮助您生成更丰富的用户画像，便于您进行精准营销；
网络信息（包括网络类型、运营商名称、IP地址、DHCP、SIM卡状态、基站信息：用于判断SDK与服务器的网络连接状态，保证服务的稳定性和连续性，同时进行用户行为分析；
软件列表信息（包括软件列表及软件运行列表信息）：用于数据统计、数据分析及画像生成，帮助您了解用户的兴趣爱好，进行精准营销，避免其他非必要内容对您用户进行打扰。
可选个人信息：
设备标识符（包括 IMEI、MAC、IMSI）：用于对生成终端用户设备唯一标识的补充，提升唯一设备标识的准确性；
网络信息（包括SSID、BSSID、WiFi列表信息、WIFI状态信息）：为判断联网状态，实现网络链路选择，确保不同连网状态下服务稳定提供；
位置相关信息：用于提供基于地理位置的“统计报表”，同时为提升营销效果和节省流量成本，您可以基于位置信息形成用户画像提供不同的营销内容。 		基本业务，可选信息配置详见
”SDK 可选个人信息的配置说明”
扩展功能 应用自启动 用于能更及时的分析用户行为和偏好，以提供精准营销策略，增强用户参与度和转化率，开发者可以按需配 软件列表信息（包括软件列表及软件运行列表信息）：用于能更及时的分析用户行为和偏好，以提供精准营销策略，增强用户参与度和转化率 开启、关闭配置示例：JCollectionAuth.enableAutoWakeup(Context context, boolean enable);
参数：context：应⽤的 Context；
enable：配置是否启用自启动功能
true：开启；
false：关闭，默认 true

SDK可选个人信息的配置说明

接入说明：对于极光运营增长SDK可选收集的个人信息的控制，开发者可以通过SDK 可选个⼈信息的配置示例说明进⾏配置。如您关闭可选信息的采集，因相关信息的不收集将会影响您使用极光运营增长SDK功能的效果，但不会影响基本功能的实现，请开发者结合业务实际需要进行合理配置。

SDK 可选个⼈信息的配置示例

个人信息类型 个人信息采集目的 配置方式
设备信息（IMEI） 用于生成脱敏的终端用户设备唯一性标识，提升唯一设备标识的准确性。 开启、关闭配置示例：
JOperateCollectControl.Builder builder = new JOperateCollectControl.Builder();
builder.imei(boolean enable);
JOperateCollectControl jOperateCollectControl = builder.build();
JOperateInterface.getInstance(Context context).setCollectControl(jOperateCollectControl);
参数：
context：应⽤的 Context， enable：true 或 false 是否收集imei，默认为true
设备信息（IMSI） 用于生成脱敏的终端用户设备唯一性标识，提升唯一设备标识的准确性。 开启、关闭配置示例：
JOperateCollectControl.Builder builder = new JOperateCollectControl.Builder();
builder.imsi(boolean enable);
JOperateCollectControl jOperateCollectControl = builder.build();
JOperateInterface.getInstance(Context context).setCollectControl(jOperateCollectControl);
参数：
context：应⽤的 Context， enable：true 或 false 是否收集imsi，默认为true
网络信息（SSID、BSSID、WiFi 列表信息、WIFI状态信息） 为判断联网状态，实现网络链路选择，确保不同连网状态下服务稳定提供。 开启、关闭配置示例：
JOperateCollectControl.Builder builder = new JOperateCollectControl.Builder();
builder.ssid(boolean isSsidEnable);builder.bssid(boolean isBssidEnable);builder.wifi(boolean isWifiEnable);
JOperateCollectControl jOperateCollectControl = builder.build();
JOperateInterface.getInstance(Context context).setCollectControl(jOperateCollectControl);
参数：
context：应⽤的 Context， isSsidEnable：true 或 false 是否收集ssid，默认为true；isBssidEnable：true 或 false 是否收集bssid，默认为true；isWifiEnable：true 或 false 是否收集wifi列表与wifi状态，默认为true.
位置相关信息 用于提供基于地理位置的“统计报表”，同时为提升营销效果和节省流量成本，您可以基于位置信息形成用户画像提供不同的营销内容。 Android 开启、关闭配置示例：
JOperateCollectControl.Builder builder = new JOperateCollectControl.Builder();
builder.gps(boolean enable);
JOperateCollectControl jOperateCollectControl = builder.build();
JOperateInterface.getInstance(Context context).setCollectControl(jOperateCollectControl);
参数：
context：应⽤的 Context， enable：true 或 false 是否收集位置相关信息，默认为true

SDK个人信息收集频次、精度说明

接入说明：我们将根据业务功能实现之最小必要进行用户个人信息的收集。收集频次方面，极光运营增长SDK的数据采集仅在 App调用相关功能时触发，关于频次APP开发者不可自行配置，故我们对频次不对外提供可选择的配置方式、示例；收集精度 方面，主要涉及定位相关功能，主要通过权限进行控制，极光运营增长SDK通过可选权限让App可以控制是否申请精确地理位 置权限或粗略地理位置权限。如果您需要对定位权限进行配置，可参考以下“SDK申请系统权限的说明”进行配置。

SDK申请系统权限的说明

接入说明：对于极光运营增长SDK可选申请的系统权限，您可以参考相关如下表格的内容，详细了解相关权限与各业务功能的 关系及其申请时机，因相关权限的不申请将会对其对应的功能造成影响，您可以结合业务实际需要进行合理配置。

Android 操作系统应用权限列表
权限 是否可选 用途 申请时机
INTERNET 必选 网络权限。用于实现和服务器通信，提供运营增长服务。 启用业务功能读取
ACCESS_NETWORK_STATE 必选 查看网络状态的权限。用于实现网络断开后sdk重新连接。 启用业务功能读取
JOPERATE_MESSAGE 必选 JOperate自定义权限，用于发送接收广播权限校验。 启用业务功能读取
ACCESS_COARSE_LOCATION 可选 允许应用获取粗略位置。用于实现基于粗略位置信息进行ACCESS_COARSE_LOCATION可选的用户分群。 启用业务功能读取
ACCESS_FINE_LOCATION 可选 允许应用获取精准位置。用于实现基于精准位置信息进行ACCESS_FINE_LOCATION可选的用户分群。 启用业务功能读取
ACCESS_BACKGROUND_LOCATION 可选 Android10及以上设备应用后台定位权限。用于实现基于位置信息进行的用户分群。 启用业务功能读取
READ_PHONE_STATE 可选 获取手机状态参数，辅助生成极光唯一设备标识符，用于数据去重和不同维度的数据统计及用户运营。 启用业务功能读取
ACCESS_WIFI_STATE 可选 允许获取程序访问wifi的网络状态信息。检测联网方式，在网络异常状态下避免数据发送，节省流量和电量。 启用业务功能读取

SDK权限控制

必选权限

  • 以下为必选权限，必须配置以下权限才能满足基本的运营能力
<!-- JOperate自定义权限，用于发送接收广播权限校验（必选）--> <permission android:name="${applicationId}.permission.JOPERATE_MESSAGE" android:protectionLevel="signature" /> <uses-permission android:name="${applicationId}.permission.JOPERATE_MESSAGE" /> <!-- 网络权限 （必选）--> <uses-permission android:name="android.permission.INTERNET" /> <!-- 查看网络状态，sdk重连机制等需要使用--> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
          <!-- JOperate自定义权限，用于发送接收广播权限校验（必选）-->
<permission
  android:name="${applicationId}.permission.JOPERATE_MESSAGE"
  android:protectionLevel="signature" />
<uses-permission android:name="${applicationId}.permission.JOPERATE_MESSAGE" />
<!-- 网络权限 （必选）-->
<uses-permission android:name="android.permission.INTERNET" />
<!-- 查看网络状态，sdk重连机制等需要使用-->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
此代码块在浮窗中显示

可选权限

  • 如您需要统计地理位置维度，建议集成以下权限（可选）
<!--允许应用获取粗略位置--> <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" /> <!--允许应用获取精准位置--> <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> <!-- Android Q适配 应用后台定位权限 --> <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" /> 
          <!--允许应用获取粗略位置-->
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!--允许应用获取精准位置-->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <!-- Android Q适配 应用后台定位权限 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
此代码块在浮窗中显示
  • 用于生成准确的极光ID，保证数据的精确性（可选）
<!-- 获取手机状态参数，辅助生成极光唯一ID --> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <!-- 允许程序访问wifi网络状态信息 --> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
          <!-- 获取手机状态参数，辅助生成极光唯一ID -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<!-- 允许程序访问wifi网络状态信息 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
此代码块在浮窗中显示

SDK隐私政策披露要求与示例

接入说明： 开发者在App集成极光运营增长SDK后，极光运营增长SDK的正常运行会收集必要的最终用户信息用于用户行为分析及用户画像功能。 请开发者根据集成极光运营增长SDK的实际情况，在您App的隐私政策中，对极光运营增长SDK名称、公司名称、处理个人信息种类及目的、采集方式、隐私政策链接等内容进行披露。建议：确认您所接入的极光运营增长SDK版本和功能模块，从隐私政策中确定与极光运营增长SDK交互的数据内容；在您App的隐私政策中，以文字或列表的方式向公众披露极光运营增长SDK的相关信息。

披露示例（仅供参考，请以实际合作情况为准）
SDK名称：极光运营增长 SDK
第三方主体：深圳市和讯华谷信息技术有限公司
合作目的：为 APP 提供用户行为分析及用户画像功能
处理个人信息类型及用途：
必要个人信息：
设备标识符（包括Android ID、GAID、OAID、UAID、Boot ID）：用于生成脱敏的终端用户设备唯一性标识，以确保能准确进行设备统计；
设备硬件信息（包括设备型号、设备屏幕分辨率、设备硬件制造商、设备产品名称、设备存储空间）、操作系统信息（包括操作系统版本、系统名称、系统语言：用于保证服务在不同设备上的兼容性，按设备情况维度提供统计报表，对您终端用户进行精细化行为数据分析以及帮助您生成更丰富的用户画像，便于您进行精准营销；网络信息（包括网络类型、运营商名称、IP地址、DHCP、SIM卡状态、基站信息：用于判断SDK与服务器的网络连接状态，保证服务的稳定性和连续性，同时进行用户行为分析；软件列表信息（包括软件列表及软件运行列表信息）：用于实现应用安装、卸载统计分析；同时帮助您了解用户的兴趣爱好，进行精准营销，避免其他非必要内容对您用户进行打扰。
可选个人信息：
设备标识符（包括 IMEI、MAC、IMSI）：用于对生成终端用户设备唯一标识的补充，提升唯一设备标识的准确性；网络信息（包括SSID、BSSID、WiFi列表信息、WIFI状态信息）：为判断联网状态，实现网络链路选择，确保不同连网状态下服务稳定提供；位置相关信息：用于提供基于地理位置的“统计报表”，同时为提升营销效果和节省流量成本，您可以基于位置信息形成用户画像提供不同的营销内容。
数据处理方式：通过去标识化、加密传输及其他安全方式
隐私政策链接：《AURORA 极光隐私政策》
官网链接：https://www.jiguang.cn

最终用户同意方式的说明及示例

接入说明：App首次运行时应当有隐私弹窗，隐私弹窗中应公示简版隐私政策内容并附完整版隐私政策链接，并明确提示最终用户阅读并选择是否同意隐私政策；隐私弹窗应提供同意按钮和拒绝同意的按钮，并由最终用户主动选择。如涉及敏感个人信息，应当取得您最终用户的单独授权同意，您可以通过单独弹窗的形式来实现最终用户的授权，并在您的《隐私政策》中针对敏感个人信息通过字体加粗或其他显著标识显示。

特别提醒：

  • App 开发者上报至极光运营增长平台的数据，如涉及用户个人信息且依据法律规定需要取得用户授权的，您需要向您的终端用户履行告知义务并征得用户书面同意。
  • APP 开发者如使用极光运营增长 SDK 处理其终端用户个人信息形成用户画像用于实现其自动化决策、个性化推荐等相关功能，需取得您终端用户的明确有效同意，且需要向您终端用户提供不针对其个人特征的选项，或者向个人提供便捷的拒绝方式，不得强制您的终端用户必须使用此功能或提供相关信息。
  • APP 开发者使用极光运营增长SDK 需确保其开发或运营的产品中有与用户画像直接相关的功能，且该功能不应作为必要或唯一的功能。

隐私政策授权弹窗示例：


敏感个人信息授权弹窗示例：

敏感个人信息隐私政策披露示例：“精确位置信息：用于提供基于地理位置的“统计报表”，同时为提升营销效果和节省流量成本，您可以基于位置信息形成用户画像提供不同的营销内容。”

最终用户行使权利说明

接入说明：开发者在其App中集成极光运营增长SDK后，极光运营增长SDK的正常运行会收集必要的最终用户信息用于用户行为分析、用户画像或扩展功能目的。开发者应根据相关法律法规为最终用户提供行使个人信息主体权利的路径或功能， 需极光运营增长SDK配合的，请与极光公司及时进行联系，我们将与开发者协同妥善解决最终用户的诉求。

SDK初始化及业务功能调用时机

接入说明：请务必在用户同意您App中的隐私政策后，再进行极光运营增长SDK的初始化。用户同意隐私政策之前，避免动态申请涉及用户个人信息的敏感设备权限；用户同意隐私政策前，您应避免私自采集和上报个人信息。

SDK初始化

接口说明
开发者需确保 App 首次启动时，在用户阅读您的《隐私政策》并取得用户授权之后，才调用初始化函数 JOperateInterface.getInstance(getApplicationContext()).initialize()。若用户未授权或未同意您的《隐私政策》，则调用初始化方法 JOperateInterface.getInstance(getApplicationContext()).initialize()失败。若用户未同意隐私协议即初始化 SDK，则可能导致应用市场上架失败。请注意调用初始化之前，不要调用SDK的任何API方法。

SDK 业务功能接口调用

您在进行极光运营增长SDK 初始化后，如调用operationStart 接口（具体参见调用接口文档说明《SDK API 指南》）则视为您启用用户行为分析及用户画像功能，此时我们会开始收集上报极光运营增长SDK 业务功能对应的用户个人信息；如您拒绝调用，则可能会影响您使用极光运营增长SDK 相关业务功能的效果。

合规授权相关接口的调用

  • 在初始化之前，如果用户尚未同意隐私条款，须调用 JCollectionAuth.setAuth(context,false)，以告知 SDK 不进行初始化。
  • 如果用户已同意过隐私条款或者用户触发了同意隐私条款，再调用 JCollectionAuth.setAuth(context,true)。
  • 在用户同意隐私条款之前，不要调用极光 SDK 的任何接口。包括 JCoreInterface、JOperateInterface类的相关接口。

代码样例如下：

// 调整点一：调用初始化代码前增加setAuth调用 boolean isPrivacyReady; // app根据是否已弹窗获取隐私授权来赋值 if(!isPrivacyReady){ JCollectionAuth.setAuth(context, false); // 后续初始化逻辑将被拦截 } // 初始化运营增长 JOperateInterface.getInstance(getApplicationContext()).initialize(); // 调整点二：隐私政策授权获取成功后调用 JCollectionAuth.setAuth(context, true); //如初始化被拦截过，将重试初始化过程 
          // 调整点一：调用初始化代码前增加setAuth调用
boolean isPrivacyReady; // app根据是否已弹窗获取隐私授权来赋值
if(!isPrivacyReady){
    JCollectionAuth.setAuth(context, false); // 后续初始化逻辑将被拦截
}
// 初始化运营增长
JOperateInterface.getInstance(getApplicationContext()).initialize();
  
  
// 调整点二：隐私政策授权获取成功后调用
JCollectionAuth.setAuth(context, true); //如初始化被拦截过，将重试初始化过程
此代码块在浮窗中显示

隐私保护机制

如果您对极光运营增长 SDK 权限有任何疑问、意见和建议，或者因为需要极光协助关闭某项权限采集能力，可通过以下联系方式与我们联系：

  • 电子邮件：support@jiguang.cn
  • 电 话：400-888-2376
  • 联系地址：深圳市南山区粤海街道高新南区白石路与沙河西路交汇处深圳湾科技生态园12栋A座31层

您还可以随时通过访问极光官网在线客服系统与我们联系，我们将及时为您提供咨询和服务，确保隐私保护机制的落实和执行。

文档内容是否对您有帮助？

Copyright 2011-2025, jiguang.cn, All Rights Reserved. 粤ICP备12056275号-13 深圳市和讯华谷信息技术有限公司

在文档中心打开