跳到主要内容
版本:3.3-SNAPSHOT

概述

事件属性通常是指在追踪和记录特定事件时所收集的相关信息和数据字段。这些属性可以为分析、报告和了解用户行为提供关键信息。用户可以通过事件属性和用户数属性共同组织起事件的关键结构,在EDT中,预置了部分关键的事件属性,当用户选择确定的平台,和确定的终端后,系统会自动的帮助用户选取默认选取的预制属性。

管理事件属性

预置事件属性

预制事件属性1

英文名称属性名称数据类型:备注二级分类相关终端备注
ts事件触发时间time stamp事件的实际发生时间,由SDK记录保留属性IOS ANDROID 小程序 WEB 业务事件
Apex_id创略唯一IDstring系统赋予的识别 用户的唯一id。保留属性IOS ANDROID 小程序 WEB 业务事件
platform上报平台string事件上报的平台信息, 根据后台配置 和后台配置的平台相同基础预制属性IOS ANDROID 小程序 业务事件
message_id消息类型编号string通过ME触发的消息,对应的消息ID基础预制属性IOS ANDROID 小程序
project_id项目idstring创建项目的时候,赋予该上报项目项目ID,用于识别唯一项目。基础预制属性IOS ANDROID 小程序
app_id产品idstring对于产品的唯一id,识别上报的唯一产品基础预制属性IOS ANDROID 小程序 业务事件
tenant_id租户idstring对于租户的唯一标识,不同的租户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_md5event_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设备idstringAndroid:AndroidID iOS:IDFA 广告标识 或 IDFV 应用开发商标识 -- 根据情况判断设备信息Android SDK
iOS SDK
device_uui设备唯一IDstring设备唯一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通用唯一识别码string设备唯一编码,可以和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)stringUserAgent,服务端解析获取, 客户端不上报。客户端为空。设备信息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同一次会话IDstring仅在web端会话中的浏览器sessionid,仅有web端浏览器信息WEB SDK
sdk_versionsdk版本号stringSDK自带版本号信息SDK信息Android SDK iOS SDK Web SDK 小程序 SDK
sdk_typesdk类型stringIOS/安卓SDK信息Android SDK iOS SDK Web SDK 小程序 SDK
app_versionapp版本号stringapp的版本号SDK信息Android SDK iOS SDK
app_package_idapp包名string来源应用的包名SDK信息Android SDK iOS SDK
mini_program_scene小程序启动场景string打开小程序时的场景信息SDK信息小程序
market_nameAPP下载渠道string下载APP 驱动SDK信息Android SDK iOS SDK
referrer_url站外地址stringweb 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

英文名称属性名称数据类型:备注二级分类相关终端备注
ipip地址stringNginx 解析的IP位置IP地理位置信息Android SDK iOS SDK Web SDK 小程序 SDK
provincestring根据 IP 解析IP地理位置信息Android SDK iOS SDK Web SDK 小程序 SDK
citystring根据 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页面类型stringAPP WEB ANDORID IOS当前页面信息Android SDK iOS SDK Web SDK 小程序 SDK
current_page_id当前页面page_idstring用户自己定义的页面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_idstring上级页面的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元素IDstringAndroid:控件 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关联原始idstring上报关联的原始用户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

自定义拓展事件属性

当用户希望设置预制事件属性中没有的属性,用来描述事件,这时候需要用到事件的拓展属性,用户只要遵循事件属性结构,定义事件属性中文,英文名称,属性类型(字符,数值,日期,日期时间)以及备注信息,用户自定义的事件属性,也会在事件上报的时候,被系统处理入库,可以用作后续的行为圈选和分析。

创建事件属性

创建/编辑用户属性时,需要指定的字段如下。

字段说明
属性英文名称输入属性英文名称。
属性中文名称输入属性中文名称。
数据类型选择数据类型(字符、整数、浮点、日期时间)。
是否公共属性选择是否公共属性。
如果当前属性被定义为公共属性,则在创建新的事件中会自动携带。
关联唯一标识定义是否关联唯一标识(关联、不关联)。
当选择关联时,需要指定主体、主表和字段。
计算方式指定计算方式(无数据、事件数据、关联维度表)。
当选择关联维度表时,需要选择维度表和维度字段。
示例说明输入示例说明。

用户点击右上角批量创建,可以进入批量创建事件属性页面,定义属性的英文、中文名称,数据类型。

  • 当定义属性为公共属性时,在创建所有事件时,均会选取到该属性。
  • 可以关联主表中的唯一标识,关联后,则上报的事件属性,会被系统等同于系统中定义的唯一标识字段。支持选择“人”、“货”、“场”多主体的唯一标识字段。
  • 技术算方式默认为无数据,系统不会去主动计算该属性对应的枚举值,当选择“事件上报“时,系统会自动做实时枚举的动作,将属性的枚举值入库。如不需要进行枚举,有维表或字典表预处理对应枚举项时,可以选择“字典表”或“枚举表”用于匹配。
  • 事件属性创建后,可以在创建事件的时候正常被引用。

编辑删除事件属性

  • 当事件属性有数据上报写入后,不允许通过界面进行删除,因为删除后,会导致已经应用的数据出现错误。
  • 事件属性可以进行编辑,编辑属性名称,数据类型以及和主表的关联方式,属性编辑后,事件所以引用的属性信息也会变化。
字段说明
属性英文名称输入属性英文名称。
属性中文名称输入属性中文名称。
数据类型选择数据类型(字符、整数、浮点、日期时间)。
是否公共属性选择是否公共属性。
如果当前属性被定义为公共属性,则在创建新的事件中会自动携带。
关联唯一标识定义是否关联唯一标识(关联、不关联)。
当选择关联时,需要指定主体、主表和字段。
计算方式指定计算方式(无数据、事件数据、关联维度表)。
当选择关联维度表时,需要选择维度表和维度字段。
示例说明输入示例说明。