You need to enable JavaScript to run this app.
导航
事件属性
最近更新时间:2024.05.29 16:14:45首次发布时间:2022.04.22 19:17:57

1. 概述

1.1 什么是事件属性

属性用于描述事件发生时的各维度信息,包括用户信息(user_id)、设备信息(app版本、设备号、ip地址、设备型号等)、业务自定义信息(上报到params的自定义参数)等。

1.2 事件属性分类

  1. 事件属性:又称为Params,不同事件有不同的事件属性。同一个埋点可以定义多个属性。以“播放视频”事件为例,它包含如下事件属性:enter_from(动作发生的页面),video_id(视频id)等。
  2. 事件公共属性:又称为Header,每一个事件都会上报的通用属性。Finder SDK会将设备信息类的字段预置到Header中,点击查看详情

1.3 事件属性状态说明

  • 启用:可用的属性,数据会正常更新。
  • 禁用:不可用的属性,数据会被丢弃,系统内不可查。
  • 不显示:数据正常更新,但系统内不可查,通常适用于系统后台消费的属性。

2. 功能说明

2.1 新增事件属性

您可以在登记埋点(一般事件)时一并登记事件属性,也可以单独登记事件属性。
如果您需要单独登记事件属性或登记事件公共属性,可执行以下操作:

  1. 选择数据管理 > 事件属性,进入事件属性页面。
    图片
  2. 单击新增事件属性按钮,弹出新增事件属性侧拉窗口。
    图片
  3. 设置相关信息后,单击确定按钮完成新增事件属性。
    • 如果您登记一般事件属性(params),不要勾选事件公共属性,需要将属性关联到特定事件(有上报这个属性的事件),如果未关联事件,则查询事件时无法使用该事件属性。
    • 如果您登记事件公共属性(header),务必勾选事件公共属性,此时不需要关联到特定事件。每一个事件都可以使用事件公共属性。

    注意

    • 事件属性命名时要具体,谨慎使用泛化的参数名称,反例如 time(什么的时间?是时间戳还是时长?)、name(什么的名字?),正例比如下单时间,建议命名为order_time。
    • 如果业务含义相同,尽量复用已经定义的字段,避免随意定义后导致系统中字段泛滥。
    • 常见的设备、时间等通用参数,SDK 已经自带,无需重复登记。点击查看预置属性列表

2.2 上传字典

字典信息用于描述事件属性value值对应的业务含义翻译值,例如:事件属性user_is_login,当value=1时表示用户当前已登录,value=0时表示用户当前未登录。
操作示意图:
点击列表中某条信息字典列的“上传”按钮,您可以在弹窗中上传当前属性的字典表。
图片

2.3 验收属性

事件属性列表仅展示已验收/登记的事件属性,未验收属性可点击“验收属性”按钮,在“数据验收”页面查看并完成验收。
您也可以在“数据验收”页面管理事件属性黑名单,将需要的事件属性添加或移出黑名单。
图片

2.4 修改属性数据类型

如果您此前登记的数据类型有误或变更了新的类型,可以在列表中修改数据类型字段。

注意

变更类型分兼容变更和非兼容变更, 大类型向小类型转不丢历史数据(比如 string -> int),小类型往大类型转会丢历史数据(比如 int -> float)。请谨慎选择数据类型。

图片

2.5 批量编辑展示名、属性描述

如果您希望批量补全信息,你可以将展示名、属性描述为空的事件筛选出来,打包导出为csv格式文档,在csv文档中填写完整并点击修改信息按钮上传导入,实现批量修改/登记展示、描述信息。
图片

说明

批量导入功能仅支持修改展示名和属性描述,其他字段不支持批量修改。

3. 常见问题FAQ

3.1 如何删除事件属性?

不支持删除已登记/验收的事件属性,如果您不再需要该属性,可以修改状态将其禁用,被禁用的事件属性将不再构建数据,在分析模块不可查。

3.2 事件属性和用户属性的区别是什么?

事件属性记录了描述事件的各种维度信息,例如操作系统、软件版本、软件渠道等,也可以是文章ID文章标题、文章作者等;用户属性是用户自身状态的属性,例如性别、年龄等。

3.3 事件属性验收和新增区别是什么?

新增事件属性和验收事件属性的效果是一样的,都是将事件属性信息注册到数据管理-事件属性列表,从而能够在高级分析使用。差别在于验收属性需要先上报数据,系统检测到上报后才能进行验收;而新增事件属性在数据上报前后都可以进行登记,您可以在埋点设计阶段就将事件属性登记好,这样埋点上线后就不需要验收了,可以直接使用。