SDK合规使用指南

【基础信息】设备制造商、设备名称、屏幕方向、屏幕分辨率、屏幕像素密度、蓝牙名称、代理状态、设备品牌、设备生产商、设备型号、软件系统版本、网络类型（例:Wifi/2G/3G/4G/5G）、sim卡信息（mcc&mnc）、sim卡状态、user_agent信息、操作系统名称、设备语言、CPU信息、手机存储空间大小、磁盘总空间、磁盘剩余空间、系统内存空间、运营商信息、IP地址、设备时区、系统更新时间、访问钥匙串、国家代码、系统重启时间、设备初始化时间、系统更新标识、系统启动时间、系统启动标识；

【设备标识】设备标识符（如IMEI、IMSI、AndroidID、OAID、ICCID、MEID、GAID（仅GMS服务））、设备序列号build_serial、MAC地址、IDFA、IDFV，具体字段因软硬件版本不同而存在差异；

【位置信息】精确位置信息（GPS）、粗略位置信息（WiFi信息、WLAN接入点（如SSID、BSSID）、基站信息）；

【应用信息】宿主应用的版本号、包名、应用名、运行中的进程信息、当前应用前台后台状态、应用安装列表；

【广告信息】操作记录、点击、展示、转化等交互数据；

【性能数据】崩溃数据、性能数据；

【传感器信息】重力传感器、方向传感器、旋转矢量传感器、压力传感器、线性加速度传感器、磁场传感器、陀螺仪传感器

设备信息:
必选信息：设备品牌、型号、软件系统版本、分辨率、网络信号强度、 屏幕宽高，屏幕像素密度，系统版本号，设备厂商，设备型号，手机运营商、SIM卡信息、手机重启信息、 手机系统更新时间、手机系统创建时间、IDFA（仅iOS端采集）、OAID等基础信息
可选信息：传感器信息（使用摇一摇等创新交互广告）；网络状态（判断网络状态、 提供不同类型广告）；可用存储空间大小、系统总内存空间（仅iOS端采集）

开发者应用信息：
必选信息：应用包名、应用签名、应用前后台状态、运行进程信息

位置信息:
可选信息：位置

广告信息：
必选信息：操作记录、点击、展示、转化等交互数据

性能数据：
必选信息：崩溃数据、性能数据

Android系统版本：
读取、写入外部存储卡
位置
读取电话状态（部分机型也称为“设备信息”）

IOS系统版本：
位置
广告标识符(IDFA)

存储下载类内容素材

帮助开发者进行精细化推送，以便向最终用户提供更符合最终用户需要的内容，减少无用推广/信息对最终用户的打扰。

向最终用户提供或推荐相关程度更高（而非普遍推送）的搜索结果、信息流内容或者推广等信息，提升信息触达最终用户的效率 以及准确率，同时避免虚假点击、违规推广、流量劫持等违法违规行为对最终用户体验及联盟市场合作秩序造成损害；评估信息触 达最终用户的效率以及准确率，优化信息提供及推广的服务体验，以便提供更符合最终用户需求的信息。

帮助开发者进行精细化推送，以便向最终用户提供更符合最终用户需要的内容，减少无用推广/信息对最终用户的打扰。

为了向最终用户提供或推荐相关程度更高（而非普遍推送）的搜索结果、信息流内容或者推广等信息，提升信息触达最终 用户的效率以及准确率

必选信息：
【双端】设备品牌、设备型号、设备时区、设备语言、系统版本、UserAgent信息、屏幕高宽、屏幕方向、屏幕DPI信息、系统更新时间、磁盘空间、物理内存、网络类型、运营商、开发者应用名、应用版本号、应用包名、交互数据、广告数据(展示、点击、转化)、崩溃数据、性能数据
【iOS】开机时间、设备名称
【Android】OAID、sim卡状态、cpu、运行状态

可选信息：
【双端】精确位置信息、粗略位置信息、重力传感器、加速度传感器、方向传感器、陀螺仪、压力传感器、线性加速度传感器
【iOS】IDFA、IDFV、磁力传感器

必选信息：
(1) 设备信息（必要信息）
【Android+iOS+HarmonyOS】设备生产商，设备型号，设备的操作系统信息（版本名、版本号），设备类型，设备语言，设备屏幕信息（方向、分辨率），设备网络类型，手机开机时间，设备存储容量信息

(2) 应用信息（必要信息）
【Android，iOS和HarmonyOS】美数合作方的应用包名，应用版本号和特性，SDK版本

(3) 网络信息（必要）
网络访问

(4) 广告数据/使用数据（必要）
【Android，iOS和HarmonyOS】用户与广告交互的行为数据，例如对广告的展示、点击及转化等交互数据

(5) 性能数据（必要）
【Android+IOS+HarmonyOS】设备事件信息（如系统崩溃，系统活动），时间戳，您提出请求的日期和时间以及来源网址，用户代理

可选信息：
(1)设备信息/广告ID
【Android】Android ID，OAID，国际移动用户识别码（IMSI）
【仅HarmonyOs】ODID
【仅IOS】IDFA，IDFV
(2)应用信息（根据包名查询指定应用是否安装）
(3)网络信息（运营商信息、网络类型、Wi-Fi状态）
(4)设备传感器信息（加速传感器、陀螺仪传感器、重力加速度传感器）
(5)位置信息（精确位置信息、粗略位置信息）

设备信息
必要信息：
【Android+iOS】设备品牌、型号、软件系统版本、屏幕密度、屏幕分辨率、设备语言、设备时区、sim卡信息（mcc&mnc）、限制广告追踪（LAT）状态、CPU信息等基础信息
【Android】Android ID、OAID
【iOS】：手机系统重启时间、磁盘总空间、系统总内存空间、IDFV
可选信息：
【Android+iOS】CPU类型、设备电池电量信息、设备音量及字体大小、是否为模拟器、是否usb链接、是否开发者模式、系统启动程序版本号、硬件名称，主机地址，系统开发代号、系统源码控制版本号、设备显示的版本号、设备基板名称
【Android】：国际移动设备识别码（IMEI）、MAC地址、国际移动用户识别码（IMSI）、可用存储空间大小
【Android】硬件序列号build_serial，具体字段因软硬件版本不同而存在差异）
【iOS】：设备标识符（如IDFA，具体字段因软硬件版本不同而存在差异）
注：如您依据本政策第7条限制了您的设备或应用软件获取您的设备/广告ID，则我们将不会收集相应的信息；

网络信息
必要信息：
【Android+iOS】运营商信息、Wi-Fi状态、网络信号强度、IP 地址

应用信息
必要信息：
【Android】酷盈 合作方的应用包名、运行中的进程信息、版本号、应用前后台状态、SDK 版本号
可选信息：
【Android】软件列表信息，是否为应用商店下载
特别说明：针对中国大陆地区的安卓系统用户，对于下载类广告，会在展示之前判断您是否已安装该广告所推广的产品，如已安装，我们将不会展示该广告（我们称其为展示过滤），并在下次您的设备请求广告时通知服务端不再返回对应的广告，进而提高用户体验。酷盈仅在此场景下会将被“展示过滤”的广告的相关信息进行上报，不会收集除此之外的其他已安装应用的信息。

传感器信息
可选信息：
【Android+iOS】加速度、陀螺仪传感器

广告信息
必选信息：
【Android+iOS】对广告的展示、点击及转化等交互数据

位置信息
可选信息：
【Android】粗略位置信息（WLAN接入点（如SSID,BSSID））

性能数据
必选信息：
【Android+iOS】如崩溃数据、性能数据

在初始化前调用 ZjCustomController.getInstance().setCustomController(ZjCustomController.Controller controller) 传入自定义的Controller对象，并重写 boolean canUsePhoneState() 方法
返回 true 表示允许采集， 返回 false 表示禁止采集

在初始化前调用 ZjCustomController.getInstance().setCustomController(ZjCustomController.Controller controller) 传入自定义的Controller对象，并重写 boolean canUseAndroidId() 方法
返回 true 表示允许采集， 返回 false 表示禁止采集

在初始化前调用 ZjCustomController.getInstance().setCustomController(ZjCustomController.Controller controller) 传入自定义的Controller对象，并重写 boolean canUseOaid() 方法
返回 true 表示允许采集， 返回 false 表示禁止采集

在初始化前调用 ZjCustomController.getInstance().setCustomController(ZjCustomController.Controller controller) 传入自定义的Controller对象，并重写 boolean canReadLocation() 方法
返回 true 表示允许采集， 返回 false 表示禁止采集

在初始化前调用 ZjCustomController.getInstance().setCustomController(ZjCustomController.Controller controller) 传入自定义的Controller对象，并重写 boolean canUseSensor() 方法
返回 true 表示允许采集， 返回 false 表示禁止采集

Android
1. 开屏广告：
应实现 com.zj.zjsdk.api.v2.splash.ZJSplashAdInteractionListener#onSplashAdClose() 的回调，当用户点击跳过按钮时此方法被调用，需要在布局中移除本条广告。
2. 模板信息流广告：
应实现 com.zj.zjsdk.api.v2.express.ZJNativeExpressAdInteractionListener#onNativeExpressAdClose() 的回调，当用户点击关闭按钮时此方法被调用，需要在布局中移除本条广告。
3. 视频贴片广告：
应实现 com.zj.zjsdk.api.v2.movie.ZJMovieInteractionListener#onMovieAdClose() 的回调，当用户点击关闭或跳过按钮时此方法被调用，需要在布局中移除本条广告。
4. 自渲染广告：
需要开发者自行渲染关闭按钮，当关闭点击发生时，将本条广告在布局中移除。
5. 其它广告样式：
其他广告样式均已由 SDK 实现广告一键关闭功能，不需要开发者实现。

iOS
1. 开屏广告：
应实现ZJSplashAd#zj_splashAdClosed的回调，当用户点击跳过按钮时此方法被调用，需要在布局中移除本条广告。
2. 模板信息流广告：
应实现ZJNativeExpressFeedAdManager#ZJ_nativeExpressFeedAdDislike的回调，当用户点击关闭按钮时此方法被调用，需要在布局中移除本条广告。
3. 自渲染广告：
需要开发者自行渲染关闭按钮，当关闭点击发生时，将本条广告在布局中移除。
4. 其它广告样式：
其他广告样式均已由 SDK 实现广告一键关闭功能，不需要开发者实现。

Android
1. SDK所有广告形态均自带广告标识，开发者无需额外操作，请勿使用任何技术手段修改、删除广告标识，包括但不限于广告标识的大小、位置、颜色等，否则由此带来的后果，由开发者自己负责。
2. 开发者不得自行更改、调整SDK提供的广告内容和广告样式，包括但不限于重叠展示广告、更改广告元素、调整点击热区范围、配置虚假按钮等可能影响用户体验、诱导用户点击的所有违规行为，否则由此带来的后果，由开发者自己负责。
3. 自渲染广告提供获取来源信息的文案、标识接口，开发者可以在获取成功时自行渲染，详见自渲染广告-来源信息说明

iOS
1. SDK所有广告形态均自带广告标识，开发者无需额外操作，请勿使用任何技术手段修改、删除广告标识，包括但不限于广告标识的大小、位置、颜色等，否则由此带来的后果，由开发者自己负责。
2. 开发者不得自行更改、调整SDK提供的广告内容和广告样式，包括但不限于重叠展示广告、更改广告元素、调整点击热区范围、配置虚假按钮等可能影响用户体验、诱导用户点击的所有违规行为，否则由此带来的后果，由开发者自己负责。
3. 自渲染广告提供获取来源信息的文案、标识接口，开发者可以在获取成功时自行渲染，详见自渲染广告-来源信息说明

1. 合规要素说明：
iOS端不涉及
Android端请升级 SDK 至最新版本，其中自渲染广告，请在用户下载应用之前，向用户明示待下载应用的名称、开发者、应用包大小、隐私政策、权限列表、版本等信息，获取方式为：
应用名称：ZJNativeAd#getComplianceInfo()#getAppName()
开发者：ZJNativeAd#getComplianceInfo()getAppDeveloperName()
应用包大小：ZJNativeAd#getComplianceInfo()#getPackageSizeBytes()
权限列表：ZJNativeAd#getComplianceInfo()#getAppPermissionsUrl()
隐私协议：ZJNativeAd#getComplianceInfo()#getAppPrivacyUrl()
版本：ZJNativeAd#getComplianceInfo()#getAppVersion()
其他合规信息详见自渲染广告-下载六要素说明

2. 若开发者展示SDK提供的广告内容，应合规展示SDK提供的应用下载广告、开屏广告的广告内容、样式等合规配置，或按照SDK不时通知或更新的平台规则进行广告合规配置，开发者不应自行更改、调整SDK的合规配置，否则由此带来的后果，由开发者自己负责。

Android
ZjSdk.setPersonalizedState(int state);
SDK获取用户设备是否关闭个性化推荐广告信息的接口，如传入值为1，则在后续的程序化广告推荐策略中将关闭个性化推荐能力。
1: 屏蔽个性化推荐广告
0和所有非1的值:不屏蔽个性化推荐广告

iOS
ZJAdSDK#+ (void)persionalizedState:(ZJSDKPersionalizedState)persionalizedState;
SDK获取用户设备是否关闭个性化推荐广告信息的接口，在SDK初始化方法之前调用，如传入值为ZJSDKProgrammaticRecommend_OFF，则在后续的程序化广告推荐策略中将关闭个性化推荐能力。
ZJSDKProgrammaticRecommend_OFF: 屏蔽个性化推荐广告
ZJSDKProgrammaticRecommend_ON:不屏蔽个性化推荐广告