用户属性
在 GrowingIO 平台对用户属性进行声明和管理
简介
在开始配置用户属性之前，推荐您阅读用户模型文档，了解 GrowingIO 如何标记用户。
归因模型
GrowingIO 的用户属性支持最终归因和最近归因两种计算模型。
最终归因
如果一个用户同一个用户属性上传过多个不同数值，按时间排序后距今最近一次上传的用户属性值会保留下来。
例子：
| 日期 | 行为 |
|---|---|
| Day 1 | 小明使用 设备 X 访问 GrowingIO 官网 |
| Day 2 | 小明使用 设备 X 登录 GrowingIO 官网，填写职位为 数据分析师 ( 即上传用户属性 职位 = 数据分析师 ) |
| Day 3 | 小明使用 设备 X 登录 GrwoingIO 官网，修改职位为 产品经理 |
说明：
Day 1：此时在 GrowingIO 系统中，小明的用户属性职位为空
Day 2：此时在 GrowingIO 系统中，小明的用户属性职位为“数据分析师”
Day 3：此时在 GrowingIO 系统中，小明的用户属性职位为“产品经理”
时效性：
用户属性上传后 秒级 生效。
最近归因
如果一个用户同一个用户属性在不同的日期先后上传多个值，则每一次上传的值都会保留下来，且每个值都附带了上传的日期。如果一天内上传多值，则当天仅保留最后上传的值。
例子：
| 日期 | 行为 |
|---|---|
| Day 1 | 小明使用 设备 X 访问 GrowingIO 官网 |
| Day 2 | 小明使用 设备 X 登录 GrowingIO 官网，填写职位为 数据分析师 ( 即上传用户属性 职位 = 数据分析师 ) |
| Day 3 | 小明使用 设备 X 登录 GrwoingIO 官网，修改职位为 产品经理 |
说明：
Day 1：事件分析中，Day 1事件关联小明的用户属性职位为空
Day 2：事件分析中，Day 1事件关联小明的用户属性职位为空，Day 2事件为“数据分析师”
Day 3：事件分析中，Day 1事件关联小明的用户属性职位为空，Day 2事件为“数据分析师”，Day 3事件为“产品经理”
时效性：
用户属性上传后 秒级 生效。
预置用户属性
为方便客户使用，系统预置了 37 个用户属性，分别为：
除 首次识别日期 为系统默认采集字段，其他字段均需主动上报数据。
| 名称 | 标识符 | 类型 |
|---|---|---|
| 首次识别日期 | $first_day | 日期 |
| IDFV | $device_idfv | 字符串 |
| IDFA | $device_idfa | 字符串 |
| 安卓 ID | $device_androidId | 字符串 |
| IMEI | $device_imei | 字符串 |
| 姓名 | $basic_name | 字符串 |
| 注册时间 | $basic_createdAt | 日期 |
| 出生年月日 | $basic_birthday | 日期 |
| 手机号 | $basic_mobile | 字符串 |
| 电子邮箱 | $basic_email | 字符串 |
| 性别 | $basic_gender | 字符串 |
| 地址 | $basic_address | 字符串 |
| 微信 openid | $wechat_openId | 字符串 |
| 微信 unionid | $wechat_unionId | 字符串 |
| 微信昵称 | $wechat_nickName | 字符串 |
| 微信头像 | $wechat_avatarUrl | 字符串 |
| 微信用户性别 | $wechat_gender | 字符串 |
| 微信用户所在国家 | $wechat_country | 字符串 |
| 微信用户所在省份 | $wechat_province | 字符串 |
| 微信用户所在城市 | $wechat_city | 字符串 |
| 微信语言 | $wechat_language | 字符串 |
| 关注公众号 | $wechat_subscribeList | 字符串 |
| 支付宝用户 ID | $alipay_userId | 字符串 |
| 支付宝头像 | $alipay_avatar | 字符串 |
| 支付宝用户所在省份 | $alipay_province | 字符串 |
| 支付宝用户所在城市 | $alipay_city | 字符串 |
| 支付宝用户昵称 | $alipay_nickName | 字符串 |
| 支付宝学生认证 | $alipay_isStudentCertified | 字符串 |
| 支付宝用户类型 | $alipay_userType | 字符串 |
| 支付宝用户状态 | $alipay_userStatus | 字符串 |
| 支付宝实名认证 | $alipay_isCertified | 字符串 |
| 支付宝用户性别 | $alipay_gender | 字符串 |
| 首次广告来源 | $first_utm_source | 字符串 |
| 首次广告媒介 | $first_utm_medium | 字符串 |
| 首次广告名称 | $first_utm_campaign | 字符串 |
| 首次广告内容 | $first_utm_content | 字符串 |
| 首次广告关键词 | $first_utm_term | 字符串 |
首次识别日期
首次识别日期( $first_day )为系统首次识别用户，生成 gio_id 的具体日期，用户生成规则详见 用户模型。
首次广告参数
首次广告参数包含首次广告来源、首次广告媒介、首次广告名称、首次广告内容、首次广告关键词，以上五个用户属性为系统自动采集。
定义逻辑为用户首次识别( $first_day )当天首次访问线上应用( SDK默认采集$visit事件 )的广告参数。
功能说明
创建用户属性
一、您可以在 数据中心 > 用户管理 > 用户属性 中点击 新建用户属性 进入用户属性创建弹窗。
| 项 | 是否必填 | 说明 | 限制条件 |
|---|---|---|---|
| 名称 | 是 | 用户属性名称 | 名称唯一，不可重复 最大输入 30 个字符 |
| 标识符 | 是 | 用户属性标识符 可用于数据库和 API 查询 | 名称唯一，不可重复 最大输入 100 个字符 仅允许大小写英文、数字、以及下划线，并且不能以数字开头 |
| 数值类型 | 是 | 用户属性数值类型 | 支持字符串、整数、小数和日期 |
| 精度 | 否 | 当数值类型为小数时，支持设置精度位数，默认为4位 | |
| 单位 | 否 | 当数值类型为整数或小数时，支持设置单位 | |
| 存储历史数据 | 是 | 开启后，用户属性将存储历史上报值，以支持分析中动态日期匹配的场景 | 无 |
| 所属分类 | 否 | 选择自定义的用户属性分类 如人口属性、交易特征 etc. | 如不选择则为未分类 |
| 描述 | 否 | 用户属性的业务意义描述 | 最大输入 150 个字符 |
三、填写完成后单击 确定，完成一个用户属性的创建。
在完成了配置，以及正确的代码实施后。我们即可开始在 GrowingIO 使用用户属性。
用户属性详情页
在用户属性详情页可以查看单一用户属性的名称、数值类型、创建人、创建日期和统计分布。
您也可以对用户属性进行以下操作：
- 分类列表
| 操作 | 步骤 | 限制条件 |
|---|---|---|
| 搜索 | 您可以在搜索框中根据 用户属性名称 搜索用户属性 | 无 |
| 批量管理 | 您可以点击 管理全部用户属性 进入用户属性管理列表页 | 无 |
- 用户属性详情
| 操作 | 步骤 | 限制条件 |
|---|---|---|
| 新建 | 您可以点击 新建用户属性 创建用户属性 | 无 |
| 编辑 | 您可以点击 编辑，修改用户属性 | 仅支持修改名称、所属分类和描述 |
| 删除 | 您可以点击 操作 > 删除，删除不需要的用户属性 |
用户属性管理页面
在用户属性管理页面可以查看用户属性的名称、标识符、类型、预置、所属分类、创建日期、创建人、最后编辑时间。
您也可以对用户属性进行以下操作：
| 操作 | 步骤 | 限制条件 |
|---|---|---|
| 分类管理 | 您可以在左侧分类列表管理用户属性分类 | 查看文档 |
| 搜索 | 您可以在搜索框中根据 用户属性名称和标识符 搜索用户属性 | 无 |
| 新建 | 您可以点击 新建用户属性 创建用户属性 | 无 |
| 查看详情 | 您可以点击 操作 > 查看详情 跳转到用户属性详情页 | 无 |
| 编辑 | 您可以点击 操作 > 编辑，修改用户属性 | 仅支持修改名称、所属分类和描述 |
| 加密设置 | 您可以点击 操作 > 加密设置，对用户属性进行存储加密 | 加密设置后，采集数据将根据加密算法以密文形式存储 加密设置不可逆向操作 如已采集历史数据，请联系 GrowingIO 技术人员进行加密设置 仅支持字符串类型的用户属性进行加密设置 |
| 删除 | 您可以点击 操作 > 删除，删除不需要的用户属性 | 无 |
| 批量删除 | 在列表中使用复选框选择多个用户属性，进行批量删除 | 无 |
| 批量移动 | 在列表中使用复选框选择多个用户属性，进行批量移动 | 无 |
