[TOC] ***** # 事件属性 【事件属性】是描述某一事件具体细节的字段，与事件关联，可以作为分析事件的指标、维度、筛选条件。 ## 事件属性类型 [**系统预置属性**](https://help.linkflowtech.com/lfcs/2177470#_9) 【系统预置属性】是在创建租户时就已经存在的属性，如，第三方应用预置事件上的属性以及SDK预置属性 **自定义属性** 如果在创建自定义事件（[事件元数据](https://help.linkflowtech.com/lfcs/2177470)）时，【系统预置属性】无法描述特定的行为追踪所需的信息，管理员可创建自定义属性，并与自定义事件进行关联，需要注意的是，系统会提供SDK预置属性，使用系统的 SDK会自动采集SDK预置属性，无需重复在自定义事件[事件元数据](../../%E4%BA%8B%E4%BB%B6%E5%85%83%E6%95%B0%E6%8D%AE.md)元数据）上关联类似属性。 ## SDK 预置属性 使用系统的 SDK会自动采集SDK预置属性，详情见下图。不提供自动采集的，需要您手动在sendEvent方法中，传参数值（后期系统会逐步增加各SDK对系统字段的自动采集能力）。 | 字段名称 | 类型 | 说明 | JS SDK 自动采集 | iOS SDK 自动采集 | Android SDK 自动采集 | 小程序 SDK 自动采集 | 服务端 SDK 自动采集 | | --- | --- | --- | --- | --- | --- | --- | --- | | $sdk_version | 字符串 | SDK的版本 | Y | Y | Y | N | N | | $sdk_type | 字符串 | 记录此事件的SDK | Y | Y | Y | N | N | | $platform | 字符串 | 应用平台 | N | Y | Y | Y | N | | $screen_width | 数值 | 屏幕宽度 | N | Y | Y | N | N | | $screen_height | 数值 | 屏幕高度 | N | Y | Y | N | N | | $app_version | 字符串 | 应用版本 | N | Y | Y | N | N | | $bundle_key | 字符串 | 应用包名 | N | Y | Y | N | N | | $os | 字符串 | 操作系统 | Y | Y | Y | Y | N | | $os_version | 字符串 | 操作系统版本，例如8.1.1 | Y | Y | Y | Y | N | | $browser | 字符串 | 浏览器名称 | Y | N | N | N | N | | $browser_version | 字符串 | 浏览器版本 | Y | N | N | N | N | | $country | 字符串 | 国家 | Y | Y | Y | Y | N | | $province | 字符串 | 省份 | Y | Y | Y | Y | N | | $city | 字符串 | 城市 | Y | Y | Y | Y | N | | $network_type | 字符串 | 网络类型 | N | Y | Y | Y | N | | $manufacturer | 字符串 | 设备供应商 | Y | Y | Y | Y | N | | $device_model | 字符串 | 设备类型 | Y | Y | N | Y | N | | $operator | 字符串 | 运营商 | N | Y | Y | N | N | | $debug_mode | 布尔值 | 是否是测试数据 | Y | Y | Y | Y | Y | | $imei | 字符串 | IMEI | N | N | Y | N | N | | $ip | 字符串 | ip地址 | Y | Y | Y | Y | N | | $latitude | 数值 | 纬度 | N | N | N | N | N | | $longitude | 数值 | 经度 | N | N | N | N | N | | $utm_source | 字符串 | 最近广告来源 | Y | N | N | Y | N | | $utm_medium | 字符串 | 最近广告媒介 | Y | N | N | Y | N | | $utm_campaign | 字符串 | 最近广告活动 | Y | N | N | Y | N | | $utm_content | 字符串 | 最近广告内容 | Y | N | N | Y | N | | $utm_term | 字符串 | 最近广告关键词 | Y | N | N | Y | N | ***** ## 自定义属性管理 ### 添加自定义属性 添加自定义属性有两种方式： * 在属性列表页新增属性 * 在添加自定义事件（[事件元数据](https://help.linkflowtech.com/lfcs/2177470)）扩展属性时自动创建 创建自定义属性，需要填写以下信息： **属性ID**：编写埋点代码用到的属性ID，需全局唯一（大小写敏感），且为合法的变量名，只包含：大小写字母、数字、下划线，并且不可以"s_"开头；一旦保存，不可编辑。 **属性显示名**：期望在报表、动态组、客户旅程查看到的属性显示名 **数据类型**：目前只支持数字、整数、字符串、布尔型、日期这5种数据类型，如属性orderAmount的类型如果设置为整数，在埋点代码中，orderAmount的值应该保证为整数类型的值。日期型属性格式为“2020-01-01 00:00:00” ### 更改自定义属性 点击属性编辑按钮： **属性ID**：不可编辑 **属性显示名**：可编辑 **数据类型**：不可编辑 ### 删除自定义属性 只可删除尚未回数的自定义属性，即尚未有关联此属性的事件的行为数据进入到系统