# 公共属性
公共属性是各个行为数据规范的相同部分，包含行为时间、行为页面、行为人、行为产生的来源渠道，行为产生的来源页面组件等维度。
# 数据规范
名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| page | string | Y | 行为发生的小程序页面路径，开头不要加 /，路径后可带查询参数 例pages/product?sku_id=AOdjf7u |
| page_title | string | 行为发生的小程序页面标题 例商品详情、商城首页 | |
| sr_sdk_version | string | sdk版本号 例1.1.6 | |
| time | datetime | Y | 行为发生时间 13位时间戳 例1560409473714 |
| wx_user | object | Y | 用户相关属性 |
| app_id | string | Y | 公众号或小程序唯一标识 例wx9d4f5f22pa099f82 |
| open_id | string | Y | 微信用户在小程序下的唯一标识符 例ogN6X0T-ilsH-XmIdzXtuR1f1r3Q |
| user_id | string | 用户在商户的唯一标识符 例548019854034 | |
| union_id | string | 微信用户在开放平台账号下的唯一标识符 例o6_bmlsdaXds8d6_sgVt7hM3OPfL | |
| local_id | string | 用户在有数的唯一标识符 例360b8853-64bf-3fba-e9a0-5abb1e4d7721 | |
| tag | array | 用户的个性化标签 | |
| tag_id | string | C | 标签ID，唯一标识符 例游客，若填写了`tag_name`则必填 |
| tag_name | string | C | 标签名称 例游客，若填写了`tag_id`则必填 |
| extra | object | ||
| chan | object | Y | 渠道相关属性 |
| chan_wxapp_scene | integer | Y | 小程序场景值，必填 例1037 |
| chan_id | string | 引流渠道的标识符 | |
| chan_refer_app_id | string | 来源小程序或公众号appid 例wx9d6f5f6gea059654 | |
| chan_shop_id | string | 微信用门店ID，若需要计算门店业务则必填 | |
| chan_shop_name | string | 用户在有数的门店名称，展示字段，若chan_shop_id存在则必填 | |
| chan_custom | object | 自定义渠道 | |
| chan_custom_id | string | C | 4级自定义渠道的标识符，是自定义渠道的最小粒度 例mp-article-12375，若填写了chan_custom相关任一字段需必填 |
| chan_custom_id_desc | string | C | 4级自定义渠道的描述 例公众号文章(id=12375)，若填写了chan_custom相关任一字段需必填 |
| chan_custom_cat_3 | string | C | 3级自定义渠道的标识符，3级是针对4级的分类，要求4级数据必须存在 例mp-article，若填写了chan_custom相关任一字段需必填 |
| chan_custom_cat_3_desc | string | C | 3级自定义渠道的描述，若chan_custom_cat_3存在则必须存在 例公众号文章，若填写了chan_custom相关任一字段需必填 |
| chan_custom_cat_2 | string | C | 2级自定义渠道的标识符，2级是针对3级的分类，要求34级数据必须存在 例media，若填写了chan_custom相关任一字段需必填 |
| chan_custom_cat_2_desc | string | C | 2级自定义渠道的描述，若chan_custom_cat_2存在则必须存在 例媒体，若填写了chan_custom相关任一字段需必填 |
| chan_custom_cat_1 | string | C | 1级自定义渠道的标识符，1级是针对2级的分类，要求234级数据必须存在 例wechat，若填写了chan_custom相关任一字段需必填 |
| chan_custom_cat_1_desc | string | C | 1级自定义渠道的描述，若chan_custom_cat_1存在则必须存在 例微信，若填写了chan_custom相关任一字段需必填 |
| extra | object | ||
| component | object | 组件是视图上的一个区块元素 | |
| component_id | string | 组件ID | |
| component_name | string | 组件名称 |
# 使用说明
使用 context 可上报公共属性。
每次事件上报都会合并最新的 context。
# 更新 context
- setContext - 不推荐，容易写错；
- setUser - 如补充用户的（
open_id、app_id、union_id… ）； - setChan - 如补充渠道相关的信息（
chan_shop_id、chan_custom… ），chan_id由SDK在 query 中采集，不会被覆盖。
# SDK 辅助采集的范围
- 通过注册部分小程序事件，可以获取到小程序相关的信息。
- 通过 接入准备，查看上报的请求记录
props中的数据。