ae-tracking 0.1.0

package/wiki/te-docs/raw//346/216/245/345/205/245/345/211/215/345/207/206/345/244/207/345/267/245/344/275/234.md

@@ -0,0 +1,190 @@
+---
+code: pre_installation_menu
+name: "接入前准备工作"
+wikiToken: Bmhewqk5PiJirhk1GJzcJliqnOh
+parentWikiToken: Iufpwws70iX4tUk5qOOcwG5fnFb
+updateTime: 1768369522000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=pre_installation_menu
+---
+# 接入前准备工作
+
+::: tip 提示
+
+基础知识一节介绍接入前必须了解的 AE 数据规则相关内容。
+
+接入必备信息一节列出了您需要在接入前准备的系统参数。
+
+ :::
+
+AE (AgenticEngine) 系统提供了全端数据接入方案。
+
+通常情况下，接入 AE 需要三个步骤：首先根据业务需求的整理，梳理出数据采集方案，的分析师会协助您完成这一部分工作；然后，由研发人员根据数据采集方案完成数据接入工作；最后是验证数据接入正确性。该接入流程如下图所示：
+
+在数据接入之前，了解 AE 系统的基础知识是非常重要的。本篇文档将会对必要的接入相关知识做一个整体的介绍，同时也会列出当您希望进一步了解相关内容的时候，如何获取帮助。
+
+本文的目标读者是所有与接入相关的同事，包括业务人员、研发人员、测试人员等。
+
+### 一、概述
+
+AE 提供了全端的数据接入方案，主要接入方式包括：
+
+- 客户端 SDK：可以采集到设备信息，以及不与服务器通信的用户行为数据，简单易用
+- 服务端 SDK：采集内容更加精准，适合采集核心业务数据
+- 数据导入工具：通常用于历史数据导入；服务端 SDK 配合 LogBus 也是比较通用的服务端数据采集方案
+针对一般应用和 Web 开发，我们提供了：
+
+- 原生 SDK： Android SDK, iOS SDK
+- 第三方框架: Flutter, Reactive Native
+- H5 开发：JavaScript SDK, H5 与原生 SDK 打通方案
+- 主流小程序、快应用平台：小程序 SDK
+针对小游戏开发，我们提供了：
+
+- 主流游戏引擎的支持： LayaBox, Egret 白鹭引擎, Cocos Creator
+- 主流小游戏、快游戏平台的支持：小游戏 SDK
+针对手游开发，我们提供了：
+
+- Unity SDK
+- 虚幻 4 SDK
+对于服务端采集方案，我们推荐使用服务端 SDK + Logbus 的方案。该方案在数据导入的稳定性、实时性、和效率方面都有比较好的表现。
+
+如果您有一些异构的历史数据需要导入，或者对于部分数据需要补录到 AE 系统中，可以考虑使用 DataX 导入。与 Logbus 方案不同，DataX 不是常驻服务，无法监控新数据的产生并且及时导入，因此不能保证数据的实时性。 DataX 的优势在于支持多种数据源的异构数据导入，操作简单。
+
+如果您使用了 Filebeat 和 Logstash 收集日志，并且希望将日志数据导入到 AE 系统，可以使用 Filebeat +Logstash 方案。
+
+在设计数据采集方案的时候，可以根据您业务的情况，选择适合您产品技术架构和业务需求的解决方案。如果对采集方案有疑问，可以在支持群里咨询我们的分析师或者技术支持同事。
+
+### 二、基础知识
+
+#### 2.1 AE 数据模型
+
+在进行数据接入之前，首先我们需要理解 AE 中的数据是什么。
+
+数据采集方案的设计实际上就是根据业务分析的目标确定采集哪些用户行为事件的过程。例如，如果要分析用户充值情况，要采集的可能是用户支付行为数据。用户行为数据可以分解为：谁 (WHO)，什么时候 (WHEN)，在哪里 (WHERE)，以什么方式 (HOW)，进行了充值行为 (WHAT)，如下图所示：
+
+用户行为数据在 AE 中会被组织成用户相关数据和事件相关数据，并分别存入用户表和事件表中。用户数据主要用于描述用户的状态和不会经常发生变化的属性。事件数据用于描述与具体行为事件相关的信息。
+
+在数据采集方案中，您需要确定在什么时机需要触发用户数据的上报，在什么时机需要触发事件的上报。
+
+在我们的所有数据接入指南中，都会分别介绍上报事件数据和用户数据的方法。
+
+#### 2.2 用户识别规则
+
+对于每一条用户数据或者事件数据，都需要明确该数据是属于哪一个用户。在没有账号体系的场景中，可以使用与设备相关的 ID 来唯一标识用户。但是对于有账号体系中的场景中，一个用户可能在多个设备中产生数据，在分析中有必要将用户在多个端的数据结合起来分析，与设备相关的唯一 ID 就不适用了。
+
+为了处理以上两种场景，在数据接入的过程中，需要结合两个用户 ID 来标识用户：
+
+- 访客 ID (#distinct_id)：默认情况下，客户端会生成随机的访客 ID 来标识用户，也提供了读取和修改默认访客 ID 的接口。
+- 账号 ID (#account_id)：当客户登录的时候，可以设置账号 ID。通过账号 ID 可以将多个设备中的数据关联起来。
+每一条数据中，必须包含访客 ID 或者账号 ID。客户端 SDK 默认情况下会随机生成访客 ID，在您调用 `login` 接口设置账号 ID 之后，所有的数据在上报的时候会同时携带访客 ID 和账号 ID。通过服务端上报的时候，您至少需要传入其中一个 ID。
+
+在 AE 后台，标识一个用户的唯一 ID 为 AE 用户 ID（#user_id 字段）。当接收到数据时，我们会根据指定的用户识别规则，来创建一个新用户，或者将数据绑定到一个已有用户上。
+
+用户识别规则是非常重要的内容，如果没有正确设置用户 ID，可能会造成数据绑定到错误的用户上，影响分析效果。在接入之前请务必仔细了解该规则，并在数据采集方案中明确用户识别方案。
+
+#### 2.3 数据格式
+
+无论通过哪一种方式接入数据，在发送到数据接收端的时候都使用统一的数据格式，和相同的数据限制。数据规则一章对数据格式和对应的数据限制做了详细的描述。
+
+如果您通过 SDK 对接数据，只需要调用对应的接口，SDK 会将数据整理成需要的数据格式进行上报；如果您通过数据导入工具或者Restful API接入数据，则需要根据数据规则中的描述整理好数据格式，然后上报。
+
+关于数据格式，需要特别注意命名规则和数据类型：
+
+- 命名规则：事件名和属性名都只能包含字母、数字、和下划线 _，以字母开头，不能超过 50 个字符 
+<!-- unsupported block: 34 -->
+
+注意：属性名对大小写不敏感；事件名对大小写敏感
+
+- 属性值数据类型：
+**AE 数据类型**
+
+**取值样例**
+
+**取值说明**
+
+**数据类型**
+
+数值
+
+123,1.23
+
+数据范围是-9E15 至 9E15
+
+Number
+
+文本
+
+"ABC","上海"
+
+字符的默认上限是 2KB
+
+String
+
+时间
+
+"2019-01-01 00:00:00","2019-01-01 00:00:00.000"
+
+"yyyy-MM-dd HH:mm:ss.SSS"或"yyyy-MM-dd HH:mm:ss"，如需表示日期，可使用"yyyy-MM-dd 00:00:00"
+
+String
+
+布尔
+
+true,false
+
+-
+
+Boolean
+
+列表
+
+["a","1","true"]
+
+列表中的元素都会转变为字符串类型
+
+列表内最多500个元素
+
+Array(String)
+
+对象
+
+{hero_name:"刘备",hero_level:22,hero_equipment: ["雌雄双股剑","的卢"],hero_if_support:False}
+
+对象内的每个子属性(Key)都有自己的数据类型，取值说明请参考上面对应类型的普通属性·
+
+对象内最多100个子属性
+
+Object
+
+对象组
+
+[{hero_name:"刘备",hero_level:22,hero_equipment: ["雌雄双股剑","的卢"],hero_if_support:False}, {hero_name:"刘备",hero_level:22,hero_equipment: ["雌雄双股剑","的卢"],hero_if_support:False}]
+
+对象组内的每个子属性(Key)都有自己的数据类型，取值说明请参考上面对应类型的普通属性
+
+对象组内最多500个对象
+
+Array(Object)
+
+<!-- unsupported block: 34 -->
+
+注意：在 AE 后台，属性值的类型会根据第一次收到该属性值的类型确定，后续如果数据中某个属性的值的类型与此前确定的类型不符，该属性将被丢弃。
+
+在 AE 后台，您可能会注意到某些属性名是以 # 开头的，此类属性为预置属性。预置属性不需要特别设置，SDK 会默认采集。具体可以参考：预置属性与系统字段。
+
+您需要特别注意的是，当数据格式或者数据类型没有正确设置的时候，数据无法入库。因此在接入阶段和接入之后，你可能需要通过埋点方案模块来检验或者观察数据上报的正确性，并对出现的问题及时修正。
+
+请注意，单条数据的大小不能超过1MB，否则会导致该条数据无法入库。
+
+### 三、接入必备信息
+
+在正式由研发进行数据接入之前，需要确保以下信息已经准备好：
+
+1. 项目 APP ID：在 AE 后台创建项目的时候会生成项目的 APP ID，也可以在项目管理页面查看
+1. 确定数据接收端地址 
+- 如果使用云服务, 接收端地址为: https://global-receiver-ta.thinkingdata.cn
+- 对于私有化部署的情况，需要在私有集群（或者接入点）绑定域名，并配置 SSL 证书
+1. 验证接收端地址：浏览器访问 https://YOUR_RECEIVER_URL/health-check，页面返回 ok 表示正确
+1. 数据采集方案，要包括： 
+- 数据接入的方式：客户端 SDK、服务端 SDK、数据导入工具、或者几种方案结合的方式
+- 待接入数据的内容和触发时机
+恭喜您完成了接入前准备文档的阅读。接下来，您就可以根据选定的接入方式，参考对应的接入指南文档，开始进行数据接入了。

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227/restful-api-/344/275/277/347/224/250/346/214/207/345/215/227.md

@@ -0,0 +1,195 @@
+---
+code: restful_api
+name: "Restful API 使用指南"
+wikiToken: TvNDwhyoxi2x6qkGGhfc42u0n4e
+parentWikiToken: GkqjwwBediy6Jzk35GAcAVNpncg
+updateTime: 1769406874000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=restful_api
+---
+# Restful API 使用指南
+
+本指南将会为您介绍如何使用数据接入 API，通过使用数据接入 API，可以在不依赖传输工具与 SDK 的情况下，使用 HTTP 的 POST 方法直接向 ThinkingAnalytics 后台传输数据。
+
+**在开始对接前，您需要先阅读****数据规则****，在熟悉 AE 的数据格式与数据规则后，再阅读本指南进行对接。**
+
+**POST 方法上传的数据必须遵循 ****TE**** 的****数据格式**
+
+### 一、数据格式转换
+
+在上传数据之前，首先需要将数据的格式转换成 AE 的数据格式，AE 的每一条数据都是一个 JSON，数据样例如下（为了方便阅读，数据已经过排版）：
+
+```
+{
+  "#account_id": "ABCDEFG-123-abc",
+  "#distinct_id": "F53A58ED-E5DA-4F18-B082-7E1228746E88",
+  "#type": "track",
+  "#ip": "192.168.171.111",
+  "#time": "2017-12-18 14:37:28.527",
+  "#event_name": "test",
+  "properties": {
+    "#lib": "LogBus",
+    "#lib_version": "1.0.0",
+    "#screen_height": 1920,
+    "#screen_width": 1080,
+    "argString": "abc",
+    "argNum": 123,
+    "argBool": true
+  }
+}
+```
+
+具体的数据格式规范，请参考数据格式一节。
+
+### 二、数据上报
+
+当您准备好 JSON 数据后，即可进行数据上报，AE 后台接受 HTTP 标准 POST 方式的调用请求，所有接口数据字符集编码均采用 UTF-8 方式，具体的调用方式如下：
+
+#### 2.1 数据接收接口（提交方式为 form-data）
+
+如果您使用的是云服务，请输入以下 URL:
+
+https://global-receiver-ta.thinkingdata.cn/sync_data
+
+如果您使用的是私有化部署的版本，请输入以下 URL:
+
+http://数据采集地址/sync_data
+
+##### 2.1.1 接收参数（写在 requestBody 中）
+
+- 如果是一条 json 数据：
+- 参数 1：appid=您项目的 APPID
+- 参数 2：data=JSON 数据，UTF-8 编码，需要 urlencode 编码
+- 参数 3：client=0，默认为0，设置为1时取上报端ip作为#ip字段（强制替换）
+- 如果是多条数据：
+- 参数 1：appid=您项目的 APPID
+- 参数 2：data_list=JSONArray 格式的数据，包含多条 JSON 数据，UTF-8 编码，需要 urlencode 编码
+- 参数 3：client=0，默认为0，设置为1时取上报端ip作为#ip字段（强制替换）
+**注意 :** 不同语言的库有可能自带 urlencode, 这时候不需要再次 urlencode了, 例如 Python3 的 requests 库，postman 的请求测试等
+
+以下通过`curl`演示如何调用 RESTful API，下列数据为源数据
+
+```
+{
+  "#account_id": "testing",
+  "#time": "2019-01-01 10:00:00.000",
+  "#type": "track",
+  "#event_name": "testing",
+  "properties": {
+    "test": "test"
+  }
+}
+```
+
+对以上数据需要先进行 urlencode
+
+```
+%7b%22%23account_id%22%3a%22testing%22%2c%22%23time%22%3a%222019-01-01+10%3a00%3a00.000%22%2c%22%23type%22%3a%22track%22%2c%22%23event_name%22%3a%22testing%22%2c%22properties%22%3a%7b%22test%22%3a%22test%22%7d%7d
+```
+
+加入参数，上报数据
+
+```
+curl "http://receiver:9080/sync_data" --data "appid=test-sdk-appid&data=%7b%22%23account_id%22%3a%22testing%22%2c%22%23time%22%3a%222019-01-01+10%3a00%3a00.000%22%2c%22%23type%22%3a%22track%22%2c%22%23event_name%22%3a%22testing%22%2c%22properties%22%3a%7b%22test%22%3a%22test%22%7d%7d"
+```
+
+##### 2.1.2 返回参数
+
+如果收到返回参数，code: 0，则代表数据传输成功
+
+##### 2.1.3 Debug 模式
+
+在上传参数中，可加入 debug 参数（即有三个上传参数，appid，data\data_list，debug），可不传，默认为关闭状态
+
+仅适用于上传少量测试数据时开启 Debug 模式，请不要在生产环境中开启 Debug 模式
+
+当`debug=1`时，返回结果会展示详细的错误原因，比如：
+
+`{"code":-1,"msg":"#time字段格式不对,需传递[yyyy-MM-dd HH:mm:ss]或者[yyyy-MM-dd HH:mm:ss.SSS]格式"}`
+
+#### 2.2 数据接收接口（提交方式为 raw）
+
+如果使用的是云服务，请输入一下 URL：
+
+```
+https://global-receiver-ta.thinkingdata.cn/sync_json
+```
+
+如果您使用的是私有化部署的版本，请输入以下 URL:
+
+```
+http://数据采集地址/sync_json
+```
+
+##### 2.2.1 接收参数（写在 requestBody 中）
+
+- 如果是一条 json 数据:
+```
+{
+  "appid": "debug-appid",
+  "debug": 0,
+  "data": {
+    "#type": "track",
+    "#event_name": "test",
+    "#time": "2019-11-15 11:35:53.648",
+    "properties": { "a": "123", "b": 2 },
+    "#distinct_id": "1111"
+  }
+}
+```
+
+- 如果是多条数据：
+```
+[
+    {
+        "appid": "debug-appid",
+        "data": {
+          "#type": "track",
+          "#event_name": "test",
+          "#time": "2019-11-15 11:35:53.648",
+          "properties": { "a": "123", "b": 2 },
+          "#distinct_id": "1111"
+        }
+    },
+    {
+        "appid": "debug-appid",
+        "data": {
+          "#type": "track",
+          "#event_name": "test",
+          "#time": "2019-11-15 11:35:53.648",
+          "properties": { "a": "123", "b": 2 },
+          "#distinct_id": "1111"
+        }
+    }
+]
+```
+
+##### 2.2.2 返回参数：
+
+如果收到返回参数，code: 0，则代表数据传输成功
+
+##### 2.2.3 Debug 模式
+
+在上传参数中，可加入 debug 参数（即有 json 中添加 debug 参数，目前仅单条数据上传支持 debug ），可不传，默认为关闭状态
+
+**仅适用于上传少量测试数据时开启 Debug 模式，请不要在生产环境中开启 Debug 模式**
+
+当 debug=1 时，返回结果会展示详细的错误原因，比如：
+
+```
+{
+  "code": -1,
+  "msg": "#time字段格式不对,需传递[yyyy-MM-dd HH:mm:ss]或者[yyyy-MM-dd HH:mm:ss.SSS]格式"
+}
+```
+
+##### 2.2.4 数据压缩
+
+在RequestHeader中增加compress字段可以上传压缩数据，例如传compress=gzip，服务端会使用gzip解压数据，目前支持的压缩方式有：gzip、lzo、lz4和snappy，默认为不压缩。
+
+##### 2.2.5 获取上报端ip
+
+在RequestHeader中增加client=1，服务端会取上报端ip作为#ip字段（强制替换），默认值为0，即不取上报端ip替换
+
+### 三、常见问题
+
+请参考数据规则常见问题，排查由于数据格式问题而产生的数据传输异常。

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227/sdk-information-collection-rules.md

@@ -0,0 +1,63 @@
+---
+code: privacy
+name: "SDK Information Collection Rules"
+wikiToken: PVWqweybdiBg8lkg6Dnc3PcOnpd
+parentWikiToken: GkqjwwBediy6Jzk35GAcAVNpncg
+updateTime: 1745309943000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=privacy
+---
+# SDK Information Collection Rules
+
+ThinkingData operates the www.thinkingdata.cn website, which provides the SERVICE.
+
+ This page is used to inform website visitors regarding our policies with the collection, use, and disclosure of Personal Information if anyone decided to use our Service, the www.thinkingdata.cn website.
+
+If you choose to use our Service, then you agree to the collection and use of information in relation with this policy. The Personal Information that we collect are used for providing and improving the Service. We will not use or share your information with anyone except as described in this Privacy Policy.
+
+The terms used in this Privacy Policy have the same meanings as in our Terms and Conditions, which is accessible at www.thinkingdata.cn, unless otherwise defined in this Privacy Policy. Our Privacy Policy was created with the help of the Privacy Policy Template and the Disclaimer Generator.
+
+### Information Collection and Use
+
+For a better experience while using our Service, we may require you to provide us with certain personally identifiable information, including but not limited to your name, phone number, and postal address. The information that we collect will be used to contact or identify you.
+
+### Log Data
+
+We want to inform you that whenever you visit our Service, we collect information that your browser sends to us that is called Log Data. This Log Data may include information such as your computer’s Internet Protocol ("IP") address, browser version, pages of our Service that you visit, the time and date of your visit, the time spent on those pages, and other statistics.
+
+### Cookies
+
+Cookies are files with small amount of data that is commonly used an anonymous unique identifier. These are sent to your browser from the website that you visit and are stored on your computer’s hard drive.
+
+Our website uses these "cookies" to collection information and to improve our Service. You have the option to either accept or refuse these cookies, and know when a cookie is being sent to your computer. If you choose to refuse our cookies, you may not be able to use some portions of our Service.
+
+For more general information on cookies, please read "What Are Cookies".
+
+### Service Providers
+
+We may employ third-party companies and individuals due to the following reasons:
+
+- To facilitate our Service;
+- To provide the Service on our behalf;
+- To perform Service-related services; or
+- To assist us in analyzing how our Service is used.
+We want to inform our Service users that these third parties have access to your Personal Information. The reason is to perform the tasks assigned to them on our behalf. However, they are obligated not to disclose or use the information for any other purpose.
+
+### Security
+
+We value your trust in providing us your Personal Information, thus we are striving to use commercially acceptable means of protecting it. But remember that no method of transmission over the internet, or method of electronic storage is 100% secure and reliable, and we cannot guarantee its absolute security.
+
+### Links to Other Sites
+
+Our Service may contain links to other sites. If you click on a third-party link, you will be directed to that site. Note that these external sites are not operated by us. Therefore, we strongly advise you to review the Privacy Policy of these websites. We have no control over, and assume no responsibility for the content, privacy policies, or practices of any third-party sites or services.
+
+### Children's Privacy
+
+Our Services do not address anyone under the age of 13. We do not knowingly collect personal identifiable information from children under 13. In the case we discover that a child under 13 has provided us with personal information, we immediately delete this from our servers. If you are a parent or guardian and you are aware that your child has provided us with personal information, please contact us so that we will be able to do necessary actions.
+
+### Changes to This Privacy Policy
+
+We may update our Privacy Policy from time to time. Thus, we advise you to review this page periodically for any changes. We will notify you of any changes by posting the new Privacy Policy on this page. These changes are effective immediately, after they are posted on this page.
+
+### Contact Us
+
+If you have any questions or suggestions about our Privacy Policy, do not hesitate to contact us.

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/205/263/344/272/216-gdpr.md

@@ -0,0 +1,81 @@
+---
+code: about_gdpr
+name: "关于 GDPR"
+wikiToken: HlBuwC1fAiz0ONkslCMcfSSsneg
+parentWikiToken: GkqjwwBediy6Jzk35GAcAVNpncg
+updateTime: 1745310937000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=about_gdpr
+---
+# 关于 GDPR
+
+### GDPR 简介
+
+<!-- unsupported block: 34 -->
+
+2018 年 5 月 25 日，欧盟出台《通用数据保护条例》（GDPR，General Data Protection Regulation ），GDPR 堪称是史上最严厉、最翔实的一部保护用户数据安全的法律。
+
+在出海需求日益旺盛的当下，中国企业出海过程中，在数据采集、处理、应用等方面都将直面 GDPR 的监管。
+
+GDPR 主要保护欧盟用户的个人数据，对于面向欧盟提供服务的 APP 或游戏，都应当遵守 GDPR。
+
+GDPR 定义了两类角色，数据控制者（Controller）和数据处理者（Processor）。作为数据处理工具（ AgenticEngine 简称 AE 系统）的提供方，并不接触客户及用户的数据。我们的客户在使用TE系统的场景下既属于数据处理者，也属于数据控制者。这两类角色都会受到 GDPR 的约束。在使用我们产品时，我们将全力帮助客户实现 GDPR 合规，规避潜在风险。
+
+作为数据控制者，有责任遵守 GDPR 给出的六项原则，不遵守以下原则将会受到追责：
+
+- 合法、公平与透明 (lawfulness, fairness and transparency)：需要以合法、公平、透明的方式处理个人数据
+- 目的限制 (purpose limitation)：采集的数据只能用于限定的目的
+- 数据最简 (data minimisation)：仅采集必要且有意义的数据
+- 数据准确 (accuracy)：数据需要保证准确并及时，并且能采取方法更新、删除不准确的信息
+- 存储限制 (storage limitation)：数据在处理目的完成后，需要及时清理
+- 数据完整与保密 (integrity and confidentiality)：需要保证数据的存储安全，阻止未经授权的数据访问，防止数据被破坏或丢失
+除此之外，还需保障用户的以下权利：
+
+- 知情权 (Right to be Informed)：数据控制者需要为用户提供其数据控制者信息、个人数据的种类、处理数据的目的以及法律依据等等
+- 访问权 (Right of access)：用户可以获取个人的数据，可以进行个人数据的处理
+- 更正权 (Right to rectification)：用户有更正不正确的个人数据的权利
+- 删除权 (Right to erasure)：用户有删除个人数据的权利
+- 限制处理权 (Right to restriction of processing)：在特定情况下（如数据不准确时），用户可以限制其个人数据被处理
+- 转移权 (Right to data portability)：用户可以将个人数据转移至其他数据控制者
+- 否决权 (Right to object)：用户可以撤销之前对处理个人数据的同意
+- 不受制于自动化决策（含画像）(Right not to be subject to a decision based solely on automated processing, including profiling)：用户需要被告知个人数据是否会被自动化决策（包括用户画像）采用，并有权拒绝数据被这些系统采用
+还需注意，数据采集需要获得用户的同意，同意需要是明确的、显性的，并且用户可以基于“否决权”，撤回先前的同意。
+
+作为专业的服务提供商，致力于提供高效合规的解决方案，助力中国企业出海业务的增长，以下为针对 GDPR 的核心内容的相关合规措施及建议：
+
+### GDPR 合规措施
+
+#### 完全支持自定义采集，保证数据采集合规性
+
+AE 系统在数据采集端提供的是完全自定义的采集方案，即客户可以根据实际需要及业务范畴决定用户信息以及行为数据的采集。并且 AE 系统提供的所有数据采集方案，包括但不限于客户端 SDK、服务端 SDK、数据对接工具 Logbus 等，都完全支持上述原则，不会强制采集任何与用户隐私相关的数据。当开发者出于业务需要，需采集用户客户端相关数据时，用户的客户端也会有相关提示，进而保证用户的知情权。具体的数据采集相关方案，可详见接入指南。
+
+另外，我们也建议客户在采集目标明确的情况下，仅通过 AE 系统提供的自定义采集功能，采集满足需求的最小数据集合，以符合“数据最简”原则。
+
+#### 支持用户数据更新、删除、转移
+
+AE 系统在数据采集端，支持以`user_set`及`user_del`等方法，对指定的用户数据进行更新及删除。同时，我们也提供了`setTrackStatus`方法，可暂停某个客户端的所有数据上报，在用户不同意数据采集时可以调用该接口。
+
+对于已经被 AE 系统接收并存储的数据，可以通过 AE 系统提供的数据删除工具，将特定用户的用户数据及相关事件数据进行删除，具体操作可参考数据删除工具。
+
+对于入库数据，AE 系统提供了多种导出方式，比如通过API 导出数据。
+
+综上，在前文自定义采集的基础上，随着开发者采集需要以及用户实际需求变化的情况下，AE 系统都能够支持相关用户数据的更新、删除、转移，从而为用户提供 GDPR 中规定的“更正权”、“删除权”以及“转移权”。
+
+#### 数据全生命周期透明可审计、高可用、高可靠
+
+AE 系统是一款集数据采集、接收、处理、存储、计算、应用于一体的用户行为分析工具，数据在全生命周期的每一个环节，均是透明可审计的。AE 系统支持对环节中的所有数据组件进行访问及操作，进而保证任何一条数据从生成到应用的每个过程都是可追踪的。
+
+如果在实际数据应用过程中，出于特定原因，需要对系统内的某个环节进行审计，将尽可能提供相关技术支持，保证整个过程的透明度。
+
+同时 AE 系统已实现全组件的高可用、高可靠，确保数据服务以及数据的存储完整，符合“数据完整与保密”原则。
+
+### 其它建议
+
+从产品层面始终致力于帮助客户完成 GDPR 合规，同时，也建议我们的客户一同提升对于用户隐私的关注度，以下为一些从开发者层面的建议措施
+
+A.撰写并完成隐私政策
+
+强烈建议您撰写产品的隐私政策，并在其中加入关于 GDPR 合规的标准条款，这有助于您的用户进一步了解产品的隐私保护策略。
+
+B.保护用户的知情权
+
+在您的产品中，需要提供明确的数据采集同意申请，且只有用户同意时才允许进行数据采集，保证用户数据被采集时，用户是知情的，而不是默认被采集的。

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//345/256/242/346/210/267/347/253/257-sdk/android//345/220/210/350/247/204/346/214/207/345/215/227.md

@@ -0,0 +1,34 @@
+---
+code: android_sdk_compliance
+name: "合规指南"
+wikiToken: ED3bwKFlBiQQ0ikK6tUcd6LNnmh
+parentWikiToken: EnSPwbQvsi8Vm4km9JqcbhQ6nv2
+updateTime: 1745309649000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=android_sdk_compliance
+---
+# 合规指南
+
+### 一. 隐私政策中填写 SDK 相关内容
+
+#### 1.1 收集和获取
+
+在《隐私政策》中收集和获得您的个人信息栏目中根据实际情况填写以下内容。
+
+当您在激活使用时，我们会通过ThinkingAnalytics-SDK收集您的设备信息（IDFV、AndroidID、OAID、操作系统、屏幕分辨率、系统语言、设备型号、网络类型、SIM卡运营商、设备制造商、系统版本、应用进程信息等）用于统计分析您在 App 内的使用效果。
+
+#### 1.2 与授权合作伙伴共享
+
+在《隐私政策》中的与授权合作伙伴共享栏目中根据实际情况填写以下内容。
+
+ThinkingAnalytics-SDK：收集您的设备信息（IDFV、AndroidID、OAID、操作系统、屏幕分辨率、系统语言、设备型号、网络类型、SIM卡运营商、设备制造商、系统版本、应用进程信息等）、联网信息用于数据分析，从而改进我们的产品和服务。
+
+### 二. SDK合规步骤
+
+ThinkingData SDK需要在用户同意 《隐私政策》后初始化
+
+```
+// 根据隐私协议判断是否开启数据采集
+if (授权隐私政策) {
+    TDAnalytics.init(this, TA_APP_ID, TA_SERVER_URL);
+}
+```