概述
事件属性通常是指在追踪和记录特定事件时所收集的相关信息和数据字段。这些属性可以为分析、报告和了解用户行为提供关键信息。用户可以通过事件属性和用户数属性共同组织起事件的关键结构,在EDT中,预置了部分关键的事件属性,当用户选择确定的平台,和确定的终 端后,系统会自动的帮助用户选取默认选取的预制属性。管理事件属性
预置事件属性
预制事件属性1
英文名称 | 属性名称 | 数据类型: | 备注 | 二级分类 | 相关终端备注 |
---|---|---|---|---|---|
ts | 事件触发时间 | time stamp | 事件的实际发生时间,由SDK记录 | 保留属性 | IOS ANDROID 小程序 WEB 业务事件 |
Apex_id | 创略唯一ID | string | 系统赋予的识别 用户的唯一id。 | 保留属性 | IOS ANDROID 小程序 WEB 业务事件 |
platform | 上报平台 | string | 事件上报的平台信息, 根据后台配置 和后台配置的平台相同 | 基础预制属性 | IOS ANDROID 小程序 业务事件 |
message_id | 消息类型编号 | string | 通过ME触发的消息,对应的消息ID | 基础预制属性 | IOS ANDROID 小程序 |
project_id | 项目id | string | 创建项目的时候,赋予该上报项目项目ID,用于识别唯一项目。 | 基础预制属性 | IOS ANDROID 小程序 |
app_id | 产品id | string | 对于产品的唯一id,识别上报的唯一产品 | 基础预制属性 | IOS ANDROID 小程序 业务事件 |
tenant_id | 租户id | string | 对于租户的唯一标识,不同的租户id,不共享同一张事件表。 | 基础预制属性 | IOS ANDROID 小程序 业务事件 |
event_code | 事件唯一代码 | string | 事件唯一的编码,只有用户定义的事件,或代码埋点事件/ 业务事件才有事件编码。用于识别唯一事件。 | 事件信息 | IOS ANDROID 小程序 业务事件 |
event_name | 事件名称 | string | 事件名称 | 事件信息 | IOS ANDROID 小程序 业务事件 |
event_type | 事件类型 | string | 事件所属卡类型, | 事件信息 | IOS ANDROID 小程序 业务事件 |
send_type | 事件上报方式 | string | 实时触点或离线上报(当选择实时上报时,事件会进行插队,保证上报的效率,用于实时营销) | 事件信息 | IOS ANDROID 小程序 业务事件 |
event_code_md5 | event_code的md5值 | string | 前后端加密用于通信的事件编码 | 事件信息 | IOS ANDROID 小程序 |
event_duration | 单次使用时长 | time stamp | 使用结束的时候上传,整个使用时长(ms) | 事件信息 | Android SDK iOS SDK SDK小程序 SDK |
browse_time | 事件浏览时长 | long | 浏览事件的时长,仅有浏览类的事件才有 | 事件信息 | Android SDK iOS SDK SDK小程序 SDK WEB SDK |
device_id | 设备id | string | Android:AndroidID iOS:IDFA 广告标识 或 IDFV 应用开发商标识 -- 根据情况判断 | 设备信息 | Android SDK iOS SDK |
设备唯一ID | 设备信息 | ||||
device_model | 设备机型 | string | 设备型号 | 设备信息 | Android SDK iOS SDK SDK小程序 SDK WEB SDK |
device_brand | 设备品牌 | string | 设备品牌 | 设备信息 | Android SDK iOS SDKWeb SDK小程序 SDK |
device_type | 设备类型 | string | 设备类型,pc,mobile 等 | 设备信息 | Android SDK iOS SDK |
device_uuid | 通用唯一识别码 | 设备唯一编码,可以和divice_id 两者选传 | 设备信息 | Android SDK iOS SDK |
预制事件属性2
英文名称 | 属性名称 | 数据类型: | 备注 | 二级分类 | 相关终端备注 |
---|---|---|---|---|---|
carriers | 网络运营商 | string | 手机网络运营商 | 设备信息 | IOS ANDROID |
network_type | 联网络类别 | string | 手机运营商网络类型 3G 4G 5G | 设备信息 | Android SDK iOS SDK 小程序 SDK |
android_id | 安卓设备标识-安卓 | string | 安卓标识 | 设备信息 | ANDROID |
imei | 国际移动设备识别码- 安卓 | string | 安卓下载的渠道信息 | 设备信息 | ANDROID |
mac | 设备mac地址 | string | 仅有APP可以获取,一般不是用 | 设备信息 | IOS ANDROID |
user_agent | 浏览器代理 (User Agent) | string | UserAgent,服务端解析获取, 客户端不上报。客户端为空。 | 设备信息 | WEB |
os | 操作系统 | string | 操作系统 | 设备信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
oaid | 信通院统一的第三方设备标识 | string | 设备信息 | Android SDK iOS SDK | |
latitude | 纬度 | string | 来自于收集经纬度授权, 安卓需要手动打开 | 设备信息 | IOS ANDROID 小程序 |
longitude | 经度 | string | 来自于收集经纬度授权,安卓需要手动打开 | 设备信息 | IOS ANDROID 小程序 |
wechat_open_id | 微信普通用户的标识 | string | 微信唯一用户标识 (对当前开发者帐号唯一,一个openid对应一个公众号) | 微信唯一标识 | 小程序 |
wechat_union_id | 微信用户统一标识 | string | 微信公共用户表示 (针对一个微信开放平台帐号下的应用,同一用户的unionid是唯一的) | 微信唯一标识 | 小程序 |
预制事件属性3
英文名称 | 属性名称 | 数据类型: | 备注 | 二级分类 | 相关终端备注 |
---|---|---|---|---|---|
screen_width | 可视窗口的宽度 | string | 可视窗口的宽度,像素 | 屏幕信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
screen_height | 可视窗口的高度 | string | 可视窗口的高度,像素 | 屏幕信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
page_height | 可视窗口中页面的高度 | string | 可视窗口中页面的高度 | 屏幕信息 | Web SDK |
page_width | 可视窗口中页面的宽度 | string | 可视窗口中页面的宽度 | 屏幕信息 | Web SDK |
browser_version | 浏览 器版本 | string | 浏览器类型,版本,如chrome1.1 | 浏览器信息 | WEB SDK 小程序 |
session_id | 同一次会话ID | string | 仅在web端会话中的浏览器sessionid,仅有web端 | 浏览器信息 | WEB SDK |
sdk_version | sdk版本号 | string | SDK自带版本号信息 | SDK信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
sdk_type | sdk类型 | string | IOS/安卓 | SDK信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
app_version | app版本号 | string | app的版本号 | SDK信息 | Android SDK iOS SDK |
app_package_id | app包名 | string | 来源应用的包名 | SDK信息 | Android SDK iOS SDK |
mini_program_scene | 小程序启动场景 | string | 打开小程序时的场景信息 | SDK信息 | 小程序 |
market_name | APP下载渠道 | string | 下载APP 驱动 | SDK信息 | Android SDK iOS SDK |
referrer_url | 站外地址 | string | web SDK获取的站外地址,DC独特 | 广告信息 | Web SDK |
referrer_host | 站外域名 | string | $referrer 中 host 部分 | 广告信息 | Web SDK |
utm_matching_type | 广告渠道追踪匹配模式 | string | 模糊匹配、精准匹配 | 广告信息 | Android SDK iOS SDK |
utm_source | 广告系列来源 | string | 最近一次广告系列来源 | 广告信息 | Web SDK |
utm_medium | 广告系列媒介 | string | 最近一次广告系列媒介 | 广告信息 | Web SDK |
utm_term | 广告系列字词 | string | 最近一 次广告系列字词 | 广告信息 | Web SDK |
utm_content | 广告系列内容 | string | 最近一次广告系列内容 | 广告信息 | Web SDK |
utm_campaign | 广告系列名称 | string | 最近一次广告系列名称 | 广告信息 | Web SDK |
预制事件属性4
英文名称 | 属性名称 | 数据类型: | 备注 | 二级分类 | 相关终端备注 |
---|---|---|---|---|---|
ip | ip地址 | string | Nginx 解析的IP位置 | IP地理位置信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
province | 省 | string | 根据 IP 解析 | IP地理位置信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
city | 市 | string | 根据 IP 解析 | IP地理位置信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
county | 县区 | string | 根据 IP 解析 | IP地理位置信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
country | 国家 | string | 根据 IP 解析 | IP地理位置信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
page_type | 页面类型 | string | APP WEB ANDORID IOS | 当前页面信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
current_page_id | 当前页面page_id | string | 用户自己定义的页面id,如:"source_page_id": "productDetail", | 当前页面信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
current_page_name | 当前页面名称 | string | 用户自定义的页面名称,如: "current_page_name": "商品详情页" | 当前页面信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
current_page_url | 当前页面完整链接 | string | 当前页面完整链接 | 当前页面信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
time_since_last_operation | 距离上次操作的时间 | long | 距离上次操作的时间 | 页面信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
current_page_host | 当前页面主机域名 | string | 域名中的主机域名部分 | 页面信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
current_page_query | 当前页面参数 | string | 域名中的参数部分 “?” | 页面信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
current_page_path | 当前页面路径 | string | 例如:"current_page_path": "subpackage/pages/shopping/product/productDetail", | 页面信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
source_page_id | 上级来源页面page_id | string | 上级页面的id | 页面信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
source_page_name | 来源页面名称 | string | 上级页面的名称 | 页面信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
source_page_url | 上级来源页面完整链接 | string | 上级页面的链接 | 页面信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
source_page_host | 上级来源页面主机域名 | string | 上级来源页面主机域名 | 页面信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
source_page_query | 上级来源页面参数 | string | 上级来源页面参数 | 页面信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
source_page_path | 上级来源页面路径 | string | 上级来源页面路径 | 页面信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
page_X | 鼠标所处绝对坐标的X值 | string | 用于web端圈选,app端圈选热力图 | 点击和元素信息 | Android SDK iOS SDK Web SDK |
page_Y | 鼠标所处绝对坐标的Y值 | string | 用于web端圈选,app端圈选热力图 | 点击和元素信息 | Android SDK iOS SDK Web SDK |
client_X | 鼠标所处相对坐标的X值 | string | 用于web端圈选,app端圈选热力图 | 点击和元素信息 | Android SDK iOS SDK Web SDK |
client_Y | 鼠标所处相对坐标的Y值 | string | 用于web端圈选,app端圈选热力图 | 点击和元素信息 | Android SDK iOS SDK Web SDK |
预制事件属性5
英文名称 | 属性名称 | 数据类型: | 备注 | 二级分类 | 相关终端备注 |
---|---|---|---|---|---|
element_id | 元素ID | string | Android:控件 android:id | 点击和元素信息 | Android:控件 android:id |
element_name | 元素名称 | string | 元素名称 | 点击和元素信息 | Android SDKiOS SDK Web SDK |
element_target_url | 元素链接地址 | string | 元素链接地址 | 点击和元素信息 | Web SDK |
element_type | 元素类型 | string | 控 件的类型 | 点击和元素信息 | Android SDKiOS SDKWeb SDK |
element_content | 元素内容 | string | 元素内容 | 点击和元素信息 | Android SDKiOS SDKWeb SDK |
element_selector | 元素选择器 | string | 元素的路径信息App 热力分析使用此属性进行匹配 | 点击和元素信息 | Android SDKiOS SDKWeb SDK |
element_position | 元素位置 | string | 全埋,被点击元素在列表控件内的位置 | 点击和元素信息 | Android SDKiOS SDKWeb SDK |
element_index | 元素所在位置索引 | string | ? | 点击和元素信息 | Android SDKiOS SDKWeb SDK |
element_tag_name | 元素标签名 | string | 赋予元素的标签名称(人工定义) | 点击和元素信息 | Android SDKiOS SDKWeb SDK |
element_class | 元素样式名 | string | 元素样式名 | 点击和元素信息 | Android SDKiOS SDKWeb SDK |
element_path | 元素路径 | string | 元素链接地址 | 点击和元素信息 | Web SDK |
upload_time | 事件上报时间, 接收到埋点事件上报数据的时间 | datetime | 接收到埋点事件上报数据的时间 | 上报信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
write_log_time | 埋点事件数据写入到日志的时间 | long | 埋点事件数据写入到日志的时间 | 上报信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
insert_db_time | 埋点事件数据写入到数据库的时间 | long | 埋点事件数据写入到数据库的时间 | 上报信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
extensions | 扩展字段key和value,使用json格式存储. | json串 | 扩展字段key和value, 使用json格式存储 | 附加信息 | Android SDK iOS SDK Web SDK 小程序 SDK |
track_signup_original_id | 关联原始id | string | 上报关联的原始用户user_ID 用于结合匿名数据 | 保留属性 | Android SDK iOS SDK Web SDK 小程序 SDK |
last_visit_time | 未次访问时间 | string | 末次用户访问时间,上报无需体现,系统自动计算。 | 访问信息 | |
last_visit_time | 未次访问时间 | string | 首次用户访问时间,上报无需体现,系统自动计算。 | 访问信息 | |
is_first_time | 是否首次使用应用 | 布尔值 | 在应用启动时,进行判定,后需要后端给到前端响应接口。历史上是否有此id。 | Android SDK iOS SDK 小程序 SDK |
自定义拓展事件属性
当用户希望设置预制事件属性中没有的属性,用来描述事件,这时候需要用到事件的拓展属性,用户只要遵循事件属性结构,定义事件属性中文,英文名称,属性类型(字符,数值,日期,日期时间)以及备注信息,用户自定义的事件属性,也会在事件上报的时候,被系统处理入库,可以用作后续的行为圈选和分析。
创建事件属性
创建/编辑用户属性时,需要指定的字段如下。
字段 | 说明 |
---|---|
属性英文名称 | 输入属性英文名称。 |
属性中文名称 | 输入属性中文名称。 |
数据类型 | 选择数据类型(字符、整数、浮点、日期时间)。 |
是否公共属性 | 选择是否公共属性。 如果当前属性被定义为公共属性,则在创建新的事件中会自动携带。 |
关联唯一标识 | 定义是否关联唯一标识(关联、不关联)。 当选择关联时,需要指定主体、主表和字段。 |
计算方式 | 指定计算方式(无数据、事件数据、关联维度表)。 当选择关联维度表时,需要选择维度表和维度字段。 |
示例说明 | 输入示例说明。 |
用户点击右上角批量创建,可以进入批量创建事件属性页面,定义属性的英文、中文名称,数据类型。
- 当定义属性为公共属性时,在创建所有事件时,均会选取到该属性。
- 可以关联主表中的唯一标识,关联后,则上报的事件属性,会被系统等同于系统中定义的唯一标识字段。支持选择“人”、“货”、“场”多主体的唯一标识字段。
- 技术算方式默认为无数据,系统不会去主动计算该属性对应的枚举值,当选择“事件上报“时,系统会自动做实时枚举的动作,将属性的枚举值入库。如不需 要进行枚举,有维表或字典表预处理对应枚举项时,可以选择“字典表”或“枚举表”用于匹配。
- 事件属性创建后,可以在创建事件的时候正常被引用。
编辑删除事件属性
- 当事件属性有数据上报写入后,不允许通过界面进行删除,因为删除后,会导致已经应用的数据出现错误。
- 事件属性可以进行编辑,编辑属性名称,数据类型以及和主表的关联方式,属性编辑后,事件所以引用的属性信息也会变化。
字段 | 说明 |
---|---|
属性英文名称 | 输入属性英文名称。 |
属性中文名称 | 输入属性中文名称。 |
数据类型 | 选择数据类型(字符、整数、浮点、日期时间)。 |
是否公共属性 | 选择是否公共属性。 如果当前属性被定义为公共属性,则在创建新的事件中会自动携带。 |
关联唯一标识 | 定义是否关联唯一标识(关联、不关联)。 当选择关联时,需要指定主体、主表和字段。 |
计算方式 | 指定计算方式(无数据、事件数据、关联维度表)。 当选择关联维度表时,需要选择维度表和维度字段。 |
示例说明 | 输入示例说明。 |