ae-tracking 0.1.0

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//346/270/270/346/210/217/345/274/225/346/223/216/egret//350/277/233/351/230/266/346/214/207/345/215/227/native/346/224/257/346/214/201.md

@@ -0,0 +1,74 @@
+---
+code: egret_sdk_native
+name: "Native支持"
+wikiToken: UlD5wid9KiaGv6kDOgpcZMXTnzc
+parentWikiToken: KuTnwPRGaiaJSmkuS4Nc5tLunNf
+updateTime: 1745309773000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=egret_sdk_native
+---
+# Native支持
+
+### 一、iOS Native支持
+
+**构建 iOS 平台应用，配置 iOS 工程**
+
+- 添加 iOS 工程依赖文件 
+- `EgretProxyApi.h`
+- `EgretProxyApi.mm`
+- `ThinkingSDK.framework`
+- Build Settings 设置 
+- `Other Linker Flags` 添加 `-ObjC`
+- 注册 Native 代理 
+- 在 `AppDelegate.mm` 的 `application:didFinishLaunchingWithOptions:` 方法中注册 Native 代理，调用代码 `[EgretProxyApi registExternalInterface:_native]`
+### 二、Android Native支持
+
+**构建 Android 平台应用，配置 Android 工程**
+
+- 添加 Adnroid 工程依赖文件 
+- `EgretProxyApi.java`
+- 在 `Project` 级别的 `build.gradle` 文件中添加如下配置依赖
+```
+buildscript {
+    repositories {
+        jcenter()
+        mavenCentral()
+    }
+}
+```
+
+- 在 `Module` 下的 `build.gradle`文件中添加依赖项
+```
+dependencies {
+    implementation 'cn.thinkingdata.android:ThinkingAnalyticsSDK:2.7.6.1'
+}
+```
+
+- 注册 Native 代理 
+- 在 `MainActivity` 的 `onCreate` 方法中注册 Native 代理，调用代码 `EgretProxyApi.registExternalInterface(nativeAndroid,this)`
+### 三、开启 Native 支持
+
+初始化 SDK 时，在 `config` 中加入 `enableNative: true`，即可开启 Native 支持。
+
+```
+// TA SDK 配置对象
+var config = {
+  appId: "YOUR_APPID", // 项目 APP ID
+  serverUrl: "YOUR_SERVER_URL", // 上报地址
+  enableNative: true, // 允许调用 Native 代码
+  autoTrack: {
+    appShow: true, // 自动采集 启动事件
+    appHide: true, // 自动采集 关闭事件
+    appClick: true, // 自动采集 点击事件（仅 native 生效）
+    appView: true, // 自动采集 页面浏览事件（仅 native 生效）
+    appCrash: true, // 自动采集 崩溃事件（仅 native 生效）
+    appInstall: true // 自动采集 安装事件（仅 native 生效）
+  }
+};
+
+// 初始化
+TDAnalytics.init(config);
+// 上报一个简单事件, 事件名为 test_event
+TDAnalytics.track({
+    eventName: 'test_event'
+});
+```

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//346/270/270/346/210/217/345/274/225/346/223/216/egret//350/277/233/351/230/266/346/214/207/345/215/227//345/256/236/346/227/266/350/260/203/350/257/225.md

@@ -0,0 +1,60 @@
+---
+code: egret_sdk_debug
+name: "实时调试"
+wikiToken: MxtIwt034i4gtvkoh75cFITZnnc
+parentWikiToken: KuTnwPRGaiaJSmkuS4Nc5tLunNf
+updateTime: 1745310893000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=egret_sdk_debug
+---
+# 实时调试
+
+ 在SDK接入过程中，您可以通过查看SDK在IDE控制台中的日志或者使用TA的Debug功能，进行实时调试。
+
+#### 一、打印SDK日志
+
+```
+var config = {
+  appid: "YOUR_APPID",
+  server_url: "YOUR_SERVER_URL",
+  enableLog:true//打开日志开关，默认是false
+};
+TDAnalytics.init(config);
+```
+
+<!-- unsupported block: 34 -->
+
+打开日志后，可以在IDE中过滤 ThinkingAnalytics 相关的日志来观察 SDK 的数据上报。
+
+#### 二、开启 Debug 模式
+
+开启Debug模式需要如下两步操作:
+
+1. 客户端开启Debug模式
+以下是客户端开启Debug模式的示例代码:
+
+```
+/*
+设置运行模式为 Debug 模式
+none:数据会存入缓存，并依据一定的缓存策略上报,默认为NORMAL模式；建议在线上环境使用
+debug:数据逐条上报。当出现问题时会以日志和异常的方式提示用户；不建议在线上环境使用
+debugOnly:只对数据做校验，不会入库；不建议在线上环境使用
+ */
+var config = {
+  appid: "YOUR_APPID",
+  server_url: "YOUR_SERVER_URL",
+  debugMode: "debug"
+};
+TDAnalytics.init(config);
+```
+
+1. AE 后台添加Debug设备
+为了避免 Debug 模式在生产环境上线，规定只有指定的设备才能开启 Debug 模式。只有在客户端开启了 Debug 模式，并且设备 ID 在 AE 后台的"埋点管理"页的"Debug 数据"板块中配置了的设备才能开启 Debug 模式。
+
+设备 ID 可以通过以下三种方式获取：
+
+- AE 平台中事件数据中的 #device_id 属性
+- 客户端日志：SDK 初始化完成后会打印设备 DeviceId
+- 通过实例接口调用：获取设备ID
+<!-- unsupported block: 34 -->
+
+Debug 模式可能会影响数据采集质量和 App 的稳定性，只用于集成阶段数据验证，不要在线上环境使用。

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//346/270/270/346/210/217/345/274/225/346/223/216/egret//350/277/233/351/230/266/346/214/207/345/215/227//350/207/252/345/212/250/351/207/207/351/233/206.md

@@ -0,0 +1,74 @@
+---
+code: egret_sdk_autotrack
+name: "自动采集"
+wikiToken: NcAmw0WdqinGEvk6NpQcxPIDnfb
+parentWikiToken: KuTnwPRGaiaJSmkuS4Nc5tLunNf
+updateTime: 1751966159000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=egret_sdk_autotrack
+---
+# 自动采集
+
+在创建实例的 config 中开启您需要自动采集的事件，SDK 将会自动采集小游戏的一些行为，现在主要有以下几种事件支持自动采集：
+
+现在支持的自动化收集数据有：
+
+1. 小游戏回到前台的事件
+1. 小游戏调入后台，并记录本次访问（启动至调入后台）的时间
+接下来将会详细介绍每种数据的采集方法
+
+### 一、 开启自动采集事件
+
+在 config 中，参数 `autoTrack` 中的元素表示每个自动采集事件的开关，设置为 `true` 为开启自动采集：
+
+```
+var config = {
+    appid: "YOUR_APPID",
+    server_url: "YOUR_SERVER_URL",
+    autoTrack: {
+         appLaunch: true, // 自动采集 ta_mg_launch
+         appShow: true, // 自动采集 ta_mg_show
+         appHide: true, // 自动采集 ta_mg_hide
+         properties: { // 自动采集自定义属性staticKey: 'staticValue'},
+         callback: (eventType:any) =>{ // 自动采集回调
+           if (eventType === 'appShow')
+           {
+            return { appShowKey: 'appShowValue' };
+           } 
+           else if (eventType === 'appHide')
+           {
+            return { appHideKey: 'appHideValue' };
+           } 
+           else {
+             return {};
+           }
+         }
+     }
+};
+```
+
+- appLaunch：自动采集小程序初始化
+- appShow：自动采集小游戏启动，或从后台进入前台
+- appHide：自动采集小游戏从前台进入后台
+- properties：自动采集自定义属性（支持appShow/appHide）
+- callback：自动采集回调（支持appShow/appHide）
+### 二、 自动采集事件详解
+
+#### 2.1 小游戏启动
+
+小游戏启动将会在小游戏被启动、或小游戏被从后台调回前台时触发，详细的事件介绍如下：
+
+- 事件名：ta_mg_show
+- 自动采集属性：
+- `#scene`，场景值，取自微信提供的场景值
+- `#start_reason`，应用启动来源，是从`getLaunchOptionsSync`接口获取的参数
+小游戏启动由于会受到调出前后台的影响（条数较多），因此不太适合直接进行分析，但是可以在行为路径中标识用户的一次使用，可以作为用户行为路径的初始行为
+
+#### 2.2 小游戏隐藏
+
+小游戏隐藏将会在小游戏被调入后台时触发，并记录本次使用的时长，详细的事件介绍如下：
+
+- 事件名：ta_mg_hide
+- 自动采集属性：
+- `#scene`，场景值，取自微信提供的场景值
+- `#duration`，数值型，表示本次启动（ta_mg_show）到隐藏的持续时长
+小游戏隐藏事件会记录使用时长（单位为秒），因此可以直接计算用户使用总时长以及人均时长，也可以除以初始化次数计算单次使用时长。

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//346/270/270/346/210/217/345/274/225/346/223/216/egret//350/277/233/351/230/266/346/214/207/345/215/227//351/242/204/347/275/256/345/261/236/346/200/247.md

@@ -0,0 +1,228 @@
+---
+code: egret_sdk_preset_properties
+name: "预置属性"
+wikiToken: PrXQwple0imrmokYqw7c6q50nlf
+parentWikiToken: KuTnwPRGaiaJSmkuS4Nc5tLunNf
+updateTime: 1745310894000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=egret_sdk_preset_properties
+---
+# 预置属性
+
+#### 一、所有事件带有的预置属性
+
+<!-- unsupported block: 34 -->
+
+各个平台采集的预置属性会有一定的差异，具体可以参考如下文档: Android平台 、 iOS平台  
+
+**小游戏平台所有事件都会带有的预置属性:**
+
+**属性名**
+
+**中文名**
+
+**属性类型**
+
+**说明**
+
+#ip
+
+IP 地址
+
+文本
+
+用户的 IP 地址，AE 将以此获取用户的地理位置信息
+
+#country
+
+国家
+
+文本
+
+用户所在国家，根据 IP 地址生成
+
+#country_code
+
+国家代码
+
+文本
+
+用户所在国家的国家代码(ISO 3166-1 alpha-2，即两位大写英文字母)，根据 IP 地址生成
+
+#province
+
+省份
+
+文本
+
+用户所在省份，根据 IP 地址生成
+
+#city
+
+城市
+
+文本
+
+用户所在城市，根据 IP 地址生成
+
+#device_model
+
+设备型号
+
+文本
+
+用户设备的型号，如 iPhone 8 等
+
+#device_id
+
+设备 ID
+
+文本
+
+用户的设备 ID，取初始化时生成的 UUID
+
+#screen_height
+
+屏幕高度
+
+数值
+
+用户设备的屏幕高度，如 1920 等
+
+#screen_width
+
+屏幕宽度
+
+数值
+
+用户设备的屏幕高度，如 1080 等
+
+#manufacturer
+
+设备制造商
+
+文本
+
+用户设备的制造商，如 Apple，vivo 等
+
+#os_version
+
+操作系统版本
+
+文本
+
+iOS 11.2.2、Android 8.0.0 等
+
+#os
+
+操作系统
+
+文本
+
+如 Android、iOS 等
+
+#network_type
+
+网络状态
+
+文本
+
+上传事件时的网络状态，如 WIFI、3G、4G 等
+
+#lib
+
+SDK 类型
+
+文本
+
+您接入 SDK 的类型，如 MG（小游戏）
+
+#lib_version
+
+SDK 版本
+
+文本
+
+您接入 SDK 的版本
+
+#scene
+
+场景值
+
+数值
+
+微信小游戏启动时传入的场景值
+
+#mp_platform
+
+小游戏平台
+
+文本
+
+标识应用所在的平台
+
+#zone_offset
+
+时区偏移
+
+数值
+
+数据时间相对 UTC 时间的偏移小时数
+
+#### 二、自动采集事件的预置属性
+
+以下预置属性，是各个自动采集事件中所特有的预置属性
+
+- 小游戏隐藏（ta_mg_hide）的预置属性
+**属性名**
+
+**中文名**
+
+**属性类型**
+
+**说明**
+
+#duration
+
+事件时长
+
+数值
+
+表示本次启动 `ta_mg_show` 到隐藏 `ta_mg_hide` 的持续时长，单位是秒
+
+#### 三、获取预置属性
+
+服务端埋点需要 App 端的一些预置属性时，可以通过此方法获取 客户端 端的预置属性，再传给服务端。
+
+```
+//获取属性对象
+var presetProperties = TDAnalytics.getPresetProperties();
+//生成事件预置属性
+var properties = presetProperties.toEventPresetProperties();
+/*
+      {
+         "#device_model":"iPhone 5",
+         "#device_id":"3204487163-1624513721217",
+         "#screen_width":320,
+         "#screen_height":568,
+         "#os":"iOS",
+         "#os_version":"10.0.1",
+         "#network_type":"wifi",
+         "#zone_offset":8,
+         "#manufacturer":"Apple"
+       }
+ */
+//获取某个预置属性
+var os=presetProperties.os;//os类型，如Android
+var osVersion=presetProperties.osVersion;//系统版本号
+var networkType=presetProperties.networkType;//网络类型
+var manufacture=presetProperties.manufacturer;//设备制造商
+var deviceModel=presetProperties.deviceModel;//设备型号
+var screenWidth=presetProperties.screenWidth;//屏幕宽度
+var screenHeight=presetProperties.screenHeight;//屏幕高度
+var deviceId=presetProperties.deviceId;//设备ID
+var zoneOffset=presetProperties.zoneOffset;//时区偏移值
+```
+
+<!-- unsupported block: 34 -->
+
+IP，国家城市信息由服务端解析生成，客户端不提供接口获取这些属性