ae-tracking 0.1.0

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//346/234/215/345/212/241/347/253/257-sdk/lua//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,75 @@
+---
+code: lua_sdk_preset_properties
+name: "预置属性"
+wikiToken: LdPnwbYeni3DD3kxfTScYUOBnih
+parentWikiToken: PKA9w8heciZ4wCkyJoucMeaBnzh
+updateTime: 1745309898000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=lua_sdk_preset_properties
+---
+# 预置属性
+
+以下预置属性，是 Lua SDK 中所有事件都会带有的预置属性。
+
+**属性名**
+
+**中文名**
+
+**属性类型**
+
+**说明**
+
+#ip
+
+IP 地址
+
+文本
+
+用户的 IP 地址，需要进行手动设置，AE 将以此获取用户的地理位置信息
+
+#country
+
+国家
+
+文本
+
+用户所在国家，根据 IP 地址生成
+
+#country_code
+
+国家代码
+
+文本
+
+用户所在国家的国家代码(ISO 3166-1 alpha-2，即两位大写英文字母)，根据 IP 地址生成
+
+#province
+
+省份
+
+文本
+
+用户所在省份，根据 IP 地址生成
+
+#city
+
+城市
+
+文本
+
+用户所在城市，根据 IP 地址生成
+
+#lib
+
+SDK 类型
+
+文本
+
+您接入 SDK 的类型，如 Java 等
+
+#lib_version
+
+SDK 版本
+
+文本
+
+您接入SDK 的版本

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//346/234/215/345/212/241/347/253/257-sdk/lua//350/277/233/351/230/266/346/214/207/345/215/227.md

@@ -0,0 +1,234 @@
+---
+code: lua_sdk_advanced
+name: "进阶指南"
+wikiToken: PKA9w8heciZ4wCkyJoucMeaBnzh
+parentWikiToken: Bh3HwNcaUingcEkSTX6cwjNOnhu
+updateTime: 1745309895000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=lua_sdk_advanced
+---
+# 进阶指南
+
+### 一、发送事件
+
+在 SDK 初始化完成之后，您就可以进行数据埋点，收集用户的的行为信息。一般情况下普通事件即可满足业务场景需求，您也可以根据自己的实际业务场景使用首次、可更新等事件。
+
+#### 1.1 普通事件
+
+您可以调用 `track` 来上传事件，建议您根据先前梳理的文档来设置事件的属性以及发送事件的条件，此处以用户购买某商品作为范例：
+
+```
+--设置事件属性
+local properties = {}
+--设置事件发生的时间，如果不设置的话，则默认使用为当前时间
+properties["#time"] = os.date("%Y-%m-%d %H:%M:%S")
+
+--设置用户的ip地址，TE系统会根据IP地址解析用户的地理位置信息，如果不设置的话，则默认不上报
+properties["#ip"] = "192.168.1.1"
+
+properties["Product_Name"] = "card"
+properties["Price"] = 30
+properties["OrderId"] = "abc_123"
+--上传事件，包含用户的访客ID与账号ID，请注意账号ID与访客ID的顺序
+sdk:track("accountId", "distinctId", "payment", properties)
+```
+
+#### 1.2 首次事件
+
+首次事件是指针对某个设备或者其他维度的 ID，只会记录一次的事件。例如在一些场景下，您可能希望记录在某个设备上的激活事件，则可以用首次事件来上报数据。
+
+```
+local properties = {}
+--需要设置first_check_id的值
+sdk:trackFirst("accountId", "distinctId", "device_activation", "first_check_id", properties)
+```
+
+<!-- unsupported block: 34 -->
+
+注意：由于在服务端完成对是否首次的校验，首次事件默认会延时 1 小时入库。
+
+#### 1.3 可更新事件
+
+您可以通过可更新事件实现特定场景下需要修改事件数据的需求。可更新事件需要指定标识该事件的 ID，并在创建可更新事件对象时传入。AE 后台将根据事件名和事件 ID 来确定需要更新的数据。
+
+```
+-- "price" is 80, "count" is 3
+local properties = {}
+properties["price"] = 80
+properties["count"] = 3
+sdk:trackUpdate("accountId", "distinctId", "eventName", "eventId", properties)
+
+-- The "price" is still 80, The "count" has changed to 5
+local newProperties = {}
+newProperties["count"] = 5
+sdk:trackUpdate("accountId", "distinctId", "eventName", "eventId", newProperties)
+```
+
+#### 1.4 可重写事件
+
+可重写事件与可更新事件类似，区别在于可重写事件会用最新的数据完全覆盖历史数据，从效果上看相当于删除前一条数据，并入库最新的数据。AE 后台将根据事件名和事件 ID 来确定需要更新的数据。
+
+```
+-- "price" is 80, "count" is 3
+local properties = {}
+properties["price"] = 80
+properties["count"] = 3
+sdk:trackOverwrite("accountId", "distinctId", "eventName", "eventId", properties)
+
+-- The "count" has changed to 5，The "price" will be deleted
+local newProperties = {}
+newProperties["count"] = 5
+sdk:trackOverwrite("accountId", "distinctId", "eventName", "eventId", newProperties)
+```
+
+### 二、用户属性
+
+AE 平台支持的用户属性设置API有: `userSet`、`userSetOnce`、`userAdd`、
+
+`userUnset`、`userDel`、`userAppend`、`userUniqAppend`。
+
+#### 2.1 userSet
+
+对于一般的用户属性，您可以调用 `userSet` 来进行设置。使用该接口上传的属性将会覆盖原有的属性值，如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致，此处以设置用户名为例：
+
+```
+local userSetProperties = {}
+userSetProperties["user_name"] = "ABC"
+userSetProperties["#time"] = os.date("%Y-%m-%d %H:%M:%S")
+--上传用户属性
+sdk:userSet("accountId", "distinctId", userSetProperties)
+
+userSetProperties = {}
+userSetProperties["user_name"] = "abc"
+userSetProperties["#time"] = os.date("%Y-%m-%d %H:%M:%S")
+--再次上传用户属性，此时"user_name"的值会被覆盖为"abc"
+sdk:userSet("accountId", "distinctId", userSetProperties)
+```
+
+#### 2.2 userSetOnce
+
+如果您要上传的用户属性只要设置一次，则可以调用`userSetOnce`来进行设置，当该属性之前已经有值的时候，将会忽略这条信息，再以设置用户名为例：
+
+```
+local userSetOnceProperties = {}
+userSetOnceProperties["user_name"] = "ABC"
+userSetOnceProperties["#time"] = os.date("%Y-%m-%d %H:%M:%S")
+--上传用户属性，新建"user_name"，值为"ABC"
+sdk:userSetOnce("accountId", "distinctId", userSetOnceProperties)
+
+userSetOnceProperties = {}
+userSetOnceProperties["user_name"] = "abc"
+userSetOnceProperties["user_age"] = 18
+userSetOnceProperties["#time"] = os.date("%Y-%m-%d %H:%M:%S")
+--再次上传用户属性，此时"user_name"的值不会被覆盖，仍为"ABC"，"user_age"的值为18
+sdk:userSetOnce("accountId", "distinctId", userSetOnceProperties)
+```
+
+#### 2.3 userAdd
+
+当您要上传数值型的属性时，您可以调用`userAdd`来对该属性进行累加操作，如果该属性还未被设置，则会赋值 0 后再进行计算，可传入负值，等同于相减操作。此处以累计付费金额为例：
+
+```
+local userAddProperties = {}
+userAddProperties["total_revenue"] = 30
+userAddProperties["#time"] = os.date("%Y-%m-%d %H:%M:%S")
+--上传用户属性，此时"total_revenue"的值为30
+sdk:userAdd("accountId", "distinctId", userAddProperties)
+
+userAddProperties = {}
+userAddProperties["total_revenue"] = 60
+userAddProperties["#time"] = os.date("%Y-%m-%d %H:%M:%S")
+--再次上传用户属性，此时"total_revenue"的值会累加为90
+sdk:userAdd("accountId", "distinctId", userAddProperties)
+```
+
+<!-- unsupported block: 34 -->
+
+设置的属性key为字符串，Value 只允许为数值。
+
+#### 2.4 userAppend
+
+您可以调用 `userAppend` 对数组类型的用户属性进行追加操作。
+
+```
+local equips = {}
+equips[1] = "weapon"
+equips[2] = "hat"
+local userAppendProperties = {}
+userAppendProperties["equips"] = equips
+userAppendProperties["#time"] = os.date("%Y-%m-%d %H:%M:%S")
+--上传用户属性，此时"equips"的值为["weapon", "hat"]
+sdk:userAppend("accountId", "distinctId", userAppendProperties)
+
+equips = {}
+equips[1] = "clothes"
+userAppendProperties = {}
+userAppendProperties["equips"] = equips
+userAppendProperties["#time"] = os.date("%Y-%m-%d %H:%M:%S")
+--再次上传用户属性，此时"equips"的值会增加一个"clothes":["weapon", "hat", "clothes"]
+sdk:userAppend("accountId", "distinctId", userAppendProperties)
+```
+
+#### 2.5 userUniqAppend
+
+您可以调用 `userUniqAppend` 对 数组类型的用户属性进行追加操作。调用 `userUniqAppend` 接口会对追加的用户属性进行去重， `userAppend` 接口不做去重，用户属性可存在重复。
+
+```
+local profiles_append = {}
+--执行之后用户属性append为["test_append"]
+profiles_append["append"] = { "test_append" }
+sdk:userAppend("accountId", "distinctId", profiles_append)
+
+local profiles_uniq_append = {}
+--执行之后用户属性append为["test_append", "test_append1"]
+profiles_uniq_append["append"] = {"test_append", "test_append1"}
+sdk:userUniqueAppend("accountId", "distinctId", profiles_uniq_append)
+```
+
+#### 2.6 userUnset
+
+当您要清空用户的用户属性值时，您可以调用`userUnset`来对指定属性进行清空操作，如果该属性还未在集群中被创建，则`userUnset`不会创建该属性
+
+```
+local userUnsetProperties = {}
+userUnsetProperties[1] = "total_revenue"
+userUnsetProperties[2] = "equips"
+--上传用户属性，此时将会重置"total_revenue"和"equips"两个属性
+sdk:userUnset("accountId", "distinctId", userUnsetProperties)
+```
+
+<!-- unsupported block: 34 -->
+
+userUnset: 的传入值为被清空属性的 Key 值。
+
+#### 2.7 userDel
+
+如果您要删除某个用户，可以调用`userDel`将这名用户删除，您将无法再查询该名用户的用户属性，但该用户产生的事件仍然可以被查询到，该操作可能产生不可逆的后果，请慎用
+
+```
+sdk:userDel("accountId", "distinctId")
+```
+
+### 三、其他功能
+
+#### 3.1 TDBatchConsumer
+
+::: warning 注意
+
+当数据量过大或者网络异常时，有数据丢失的风险，不建议在正式环境中使用
+
+:::
+
+批量实时地向 AE 服务器传输数据，不需要搭配传输工具。
+
+```
+local tdAnalytics = require "ThinkingDataSdk"
+local consumer = tdAnalytics.TDBatchConsumer("SERVER_URL", "APP_ID")
+local sdk = tdAnalytics(consumer)
+```
+
+参数说明:
+
+- `APP_ID`: 您的项目的 APP ID，可通过在 AE 后台项目管理页面获取
+- `SERVER_URL`: 数据上传的 URL
+- 如果您对接的是云服务，填入: https://global-receiver-ta.thinkingdata.cn 
+- 如果您使用私有化部署版本，请为数据采集地址绑定域名，并配置 HTTPS 证书：https://数据采集地址绑定域名

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//346/234/215/345/212/241/347/253/257-sdk/lua.md

@@ -0,0 +1,165 @@
+---
+code: lua_sdk_installation
+name: "Lua"
+wikiToken: Bh3HwNcaUingcEkSTX6cwjNOnhu
+parentWikiToken: O3YxwgHGiiEnvYkHCcIcX51inkf
+updateTime: 1767869995000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=lua_sdk_installation
+---
+# Lua
+
+本指南将会为您介绍如何使用 Lua SDK 接入您的项目。
+
+**最新版本为：**v2.0.1
+
+**更新时间为：**2026-01-08
+
+**资源下载:** 源代码
+
+::: warning 注意
+
+当前文档适用于 v2.0.0 及以后的版本，历史版本请参考 Lua SDK 接入指南（V1）
+
+::: 
+
+### 一、集成SDK
+
+1. 下载源代码，把下载的ThinkingDataSdk.lua文件放入您的工程目录下
+1. 使用 luarocks 管理工具安装第三方库：
+```
+ luarocks install uuid 0.3-1
+ 
+ # 安装 luasec 库需要指定 OPENSSL_DIR 路径
+ luarocks install luasec OPENSSL_DIR=[PATH]
+ 
+ luarocks install lua-cjson
+```
+
+1. 安装Logbus
+我们推荐使用SDK+LogBus的形式，完成服务端数据的采集上报.您可以参考以下文档完成Logbus的安装:LogBus使用指南
+
+### 二、初始化
+
+以下是SDK初始化的示例代码:
+
+```
+local tdAnalytics = require "ThinkingDataSdk"
+
+local consumer = tdAnalytics.TDLogConsumer("LOG_DIRECTORY", tdAnalytics.LOG_RULE.HOUR, 200, 500)
+local sdk = tdAnalytics(consumer)
+```
+
+`LOG_DIRECTORY`为写入本地的文件夹地址。您只需将 LogBus 的监听文件夹地址设置为此处的地址，即可使用 LogBus 进行数据的监听上传。
+
+### 三、常用功能
+
+为了保证访客 ID 与账号 ID 能够顺利进行绑定，如果您的游戏中会用到访客 ID 与账号 ID，我们极力建议您同时上传这两个 ID，否则将会出现账号无法匹配的情况，导致用户重复计算，具体的 ID 绑定规则可参考用户识别规则一章。
+
+#### 3.1 发送事件
+
+您可以调用`track`来上传事件，建议您根据先前梳理的文档来设置事件的属性以及发送信息的条件，以下是发送事件的示例代码:
+
+```
+--设置访客ID"ABCDEFG123456789"
+local distinctId = "ABCDEFG123456789"
+--设置账号ID"TE_10001"
+local accountId = "TE_10001"
+--设置事件属性
+local properties = {}
+--设置事件发生的时间，如果不设置的话，则默认使用为当前时间
+properties["#time"] = os.date("%Y-%m-%d %H:%M:%S")
+
+--设置用户的ip地址，TE系统会根据IP地址解析用户的地理位置信息，如果不设置的话，则默认不上报
+properties["#ip"] = "192.168.1.1"
+
+properties["Product_Name"] = "card"
+properties["Price"] = 30
+properties["OrderId"] = "abc_123"
+--上传事件，包含用户的访客ID与账号ID，请注意账号ID与访客ID的顺序
+sdk:track(accountId, distinctId, "payment", properties)
+```
+
+- 事件的名称是字符串类型，只能以字母开头，可包含数字，字母和下划线 "_"，长度最大为 50 个字符。
+- Key 为该属性的名称，为字符串类型，规定只能以字母开头，包含数字，字母和下划线 "_"，长度最大为 50 个字符，对字母大小写不敏感,TE会统一转化为小写字母
+- Value 为该属性的值，支持字符串、数字、布尔、时间、对象、对象组、数组
+<!-- unsupported block: 34 -->
+
+**用户属性的要求与事件属性保持一致**
+
+#### 3.2 设置用户属性
+
+对于一般的用户属性，您可以调用`userSet`来进行设置，使用该接口上传的属性将会覆盖原有的属性值，如果之前不存在该用户属性，则会新建该用户属性，类型与传入属性的类型一致，此处以设置用户名为例：
+
+```
+--设置访客ID"ABCDEFG123456789"
+local distinctId = "ABCDEFG123456789"
+--设置账号ID"TE_10001"
+local accountId = "TE_10001"
+
+local userSetProperties = {}
+userSetProperties["user_name"] = "ABC"
+--上传用户属性
+sdk:userSet(accountId, distinctId, userSetProperties)
+userSetProperties = {}
+userSetProperties["user_name"] = "abc"
+--再次上传用户属性，此时"user_name"的值会被覆盖为"abc"
+sdk:userSet(accountId, distinctId, userSetProperties)
+```
+
+#### 3.3 数据上报
+
+使用 TDLogConsumer 时，采集到的事件会添加到缓存数组中。当数组元素个数超出设置的容量时才会将数据写入磁盘。初始化 TDLogConsumer 时需要显式的传入 batchNum 的值。
+
+在某些业务场景下，如果您期望数据立即上报到TE服务器，可以通过调用`flush()`接口完成。需要注意，频繁调用`flush()`会导致服务性能下降。
+
+```
+sdk:flush()
+```
+
+#### 3.4 关闭SDK
+
+```
+sdk:close()
+```
+
+<!-- unsupported block: 34 -->
+
+关闭并退出 SDK，请在关闭服务器前调用本接口，以避免缓存内的数据丢失
+
+### 四、最佳实践
+
+以下示例代码包含以上所有操作，我们推荐按照如下步骤使用:
+
+```
+local tdAnalytics = require "ThinkingDataSdk"
+
+local consumer = tdAnalytics.TDLogConsumer("LOG_DIRECTORY", tdAnalytics.LOG_RULE.HOUR, 200, 500)
+local sdk = tdAnalytics(consumer)
+
+--设置访客ID"ABCDEFG123456789"
+local distinctId = "ABCDEFG123456789"
+--设置账号ID"TE_10001"
+local accountId = "TE_10001"
+--设置事件属性
+local properties = {}
+--设置事件发生的时间，如果不设置的话，则默认使用为当前时间
+properties["#time"] = os.date("%Y-%m-%d %H:%M:%S")
+
+--设置用户的ip地址，TE系统会根据IP地址解析用户的地理位置信息，如果不设置的话，则默认不上报
+properties["#ip"] = "192.168.1.1"
+
+properties["Product_Name"] = "card"
+properties["Price"] = 30
+properties["OrderId"] = "abc_123"
+--上传事件，包含用户的访客ID与账号ID，请注意账号ID与访客ID的顺序
+sdk:track(accountId, distinctId, "payment", properties)
+
+local userSetProperties = {}
+userSetProperties["user_name"] = "ABC"
+--上传用户属性
+sdk:userSet(accountId, distinctId, userSetProperties)
+userSetProperties = {}
+userSetProperties["user_name"] = "abc"
+--再次上传用户属性，此时"user_name"的值会被覆盖为"abc"
+sdk:userSet(accountId, distinctId, userSetProperties)
+```

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//346/234/215/345/212/241/347/253/257-sdk/nodejs//346/233/264/346/226/260/346/227/245/345/277/227.md

@@ -0,0 +1,89 @@
+---
+code: nodejs_sdk_release_note
+name: "更新日志"
+wikiToken: K2M1wlcxoiYRk8kKK8Nc0udTnaf
+parentWikiToken: EfbBwX7fOiKXBvkOzGDcHKK8nBc
+updateTime: 1745309907000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=nodejs_sdk_release_note
+---
+# 更新日志
+
+### v1.5.0
+
+**更新时间：2024-03-26**
+
+**更新内容：**
+
+- 替换 log4js 库为 winston
+### v1.4.1
+
+**更新时间：2023-10-27**
+
+**更新内容：**
+
+- 兼容低版本 node.js SDK
+### v1.4.0
+
+**更新时间：2023-10-08**
+
+**更新内容：**
+
+- 新增打印日志开关
+- 完善方法参数类型定义
+### v1.3.9
+
+**更新时间：2023-08-02**
+
+**更新内容：**
+
+- logConsumer 新增 disableClustering 参数
+### v1.3.8
+
+**更新时间：2023-03-24**
+
+**更新内容：**
+
+- 修改 pm2 环境下的初始化方式
+### v1.3.6
+
+**更新时间：2022-11-10**
+
+**更新内容：**
+
+- 支持在TE后台实时调试
+### v1.3.5
+
+**更新时间：2022-10-20**
+
+**更新内容：**
+
+- 添加 .d.ts 头文件
+### v1.3.4
+
+**更新时间：2022-10-13**
+
+**更新内容：**
+
+- 兼容log4js库
+### v1.3.1
+
+**更新时间：2022-09-16**
+
+**更新内容：**
+
+- 支持复杂数据类型
+### v1.2.2
+
+**更新时间****：****2021/10/14**
+
+**更新内容：**
+
+- 可以上传预置属性 
+- 取消字段名长度限制 
+### v1.2.1** **
+
+**更新时间: 2021/08/31**
+
+**更新内容：**
+
+- LoggingConsumer 优化: 支持指定文件前缀

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//346/234/215/345/212/241/347/253/257-sdk/nodejs//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,65 @@
+---
+code: nodejs_sdk_debug
+name: "实时调试"
+wikiToken: XtB1wkMx6iHOljkmn70cqRuin5g
+parentWikiToken: OFCMwMXkFiF39KkPZPAcUPx0nLc
+updateTime: 1745309904000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=nodejs_sdk_debug
+---
+# 实时调试
+
+::: warning 注意
+
+SDK Debug 模式仅供接入调试时使用，严禁应用在生产环境。
+
+:::
+
+在SDK接入过程中，您可以通过查看SDK在IDE控制台中的日志或者使用TE的Debug功能，进行实时调试。
+
+### 一、打印SDK日志
+
+```
+ThinkingData.enableLog(true);
+```
+
+### 二、开启 Debug 模式
+
+开启Debug模式需要如下两步操作:
+
+1. 使用DebugMode
+以下使用DebugMode的示例代码:
+
+```
+/*
+DebugMode:数据逐条上报。当出现问题时会以日志和异常的方式提示用户；不建议在线上环境使用
+ */
+let teSDK = ThinkingData.initWithDebugMode('appId', 'serverUrl', {
+    dryRun: false, // report data to AE or not
+    deviceId: "123456789"
+});
+
+let trackEvent = {
+    accountId: '2222',
+    distinctId: '1111',
+    event: 'test_event',
+    time: new ***Date***(),
+    ip: '202.38.64.1',
+    properties: {
+        prop_double: 134.1,
+    },
+    callback(e) {
+        if (e) {
+            ***console***.log(e);
+        }
+    }
+};
+
+teSDK.track(trackEvent)
+```
+
+1. TE后台添加Debug设备
+为了避免 Debug 模式在生产环境上线，规定只有指定的设备才能开启 Debug 模式。只有在客户端开启了 Debug 模式，并且设备 ID 在 AE 后台的"埋点管理"页的"Debug 数据"板块中配置了的设备才能开启 Debug 模式。
+
+<!-- unsupported block: 34 -->
+
+Debug 模式可能会影响数据采集质量和 App 的稳定性，只用于集成阶段数据验证，不要在线上环境使用。

package/wiki/te-docs/raw//346/216/245/345/205/245/346/214/207/345/215/227//346/234/215/345/212/241/347/253/257-sdk/nodejs//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,75 @@
+---
+code: nodejs_sdk_preset_properties
+name: "预置属性"
+wikiToken: ZsjEwGmbnicxzdkcyErcsZMonJX
+parentWikiToken: OFCMwMXkFiF39KkPZPAcUPx0nLc
+updateTime: 1745309905000
+sourceUrl: https://docs-v2.thinkingdata.cn/?version=v5.0&lan=zh-CN&code=nodejs_sdk_preset_properties
+---
+# 预置属性
+
+以下预置属性，是 Node SDK 中所有事件都会带有的预置属性。
+
+**属性名**
+
+**中文名**
+
+**属性类型**
+
+**说明**
+
+#ip
+
+IP 地址
+
+文本
+
+用户的 IP 地址，需要进行手动设置，AE 将以此获取用户的地理位置信息
+
+#country
+
+国家
+
+文本
+
+用户所在国家，根据 IP 地址生成
+
+#country_code
+
+国家代码
+
+文本
+
+用户所在国家的国家代码(ISO 3166-1 alpha-2，即两位大写英文字母)，根据 IP 地址生成
+
+#province
+
+省份
+
+文本
+
+用户所在省份，根据 IP 地址生成
+
+#city
+
+城市
+
+文本
+
+用户所在城市，根据 IP 地址生成
+
+#lib
+
+SDK 类型
+
+文本
+
+您接入 SDK 的类型，如 Java 等
+
+#lib_version
+
+SDK 版本
+
+文本
+
+您接入 SDK 的版本