---
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，国家城市信息由服务端解析生成，客户端不提供接口获取这些属性
