用户标签
1. 概述
用户标签如同用户属性，将用户某类特征作为「用户标签」，用户在该特征下的具体表现作为「标签值」，用以将用户划分为多个不同的群体，便于在各种分析模型中使用标签进行维度分组或筛选。
TapDB 的分析模型中分别以「账号」、「设备」作为查询主体进行查询，在用户标签中同样支持分别以「账号」、「设备」作为主体创建标签。
目前支持通过「指标值」「上传 ID」「SQL」创建用户标签，后续将开放更多标签创建方式。
2. 适用角色与用途
| 角色 | 用途 |
|---|---|
| 分析师 / 业务人员 | 计算用户在一段时间范围内的行为指标，在分析模型对用户进行分组、筛选 |
3. 创建用户标签
点击标签列表右上角的创建标签，可选择「指标值标签」「上传 ID 标签」「SQL 标签」。
3.1 基础信息
在「基础信息」部分，依次录入或选择「标签名」、「标签主体」、「标签显示名」、「更新方式」、「版本备份」、「备注」。
标签显示名，会展示在分群列表、分析模型中，是业务人员识别标签的依据。
标签主体，支持「账号」或「设备」，根据业务场景做选择。
标签名，是分群存储在系统后台的唯一标识，为方便数据分析人员直接查询数据库表，可命名为带有业务含义的参数名。
更新方式，分为「手动更新」与「自动更新」。「手动更新」指在完成首次计算后，系统不会自动更新用户标签，用户需要手动进行更新；「自动更新」会在每日 0 点后，以前一日作为基准进行用户标签更新。
版本备份，分为「开启」与「关闭」。开启版本备份后，以保留历史某个日期的标签标记情况。
3.2 指标值配置
指定时段内，用户完成事件的聚合指标，作为标签值。
完成事件的用户将属于标签，未完成该事件的用户无标签值。
通过构建指标确定用户的标签值，在「事件分析」创建指标方法的基础上，增加「事件」的「天数」、「小时数」，同样支持属性筛选与编辑公式。
3.3 上传 ID 配置
上传包含主体属性与属性对应的标签值文件，利用上传的属性筛选目标群体并打上标签。请注意
- 如果不存在于现有数据中，则默认录入，不会额外检查。
- 主体属性或标签值为空，会被当作无效数据过滤。
- 若文件中出现主体属性一致但标签值不同，则会保留全部标签值
3.4 SQL 配置
分析主体的标签值将基于 SQL 规则生成，查询结果需要分为两列，第一列为分析主体 ID 例如如"user_id"，第二列为对应的标签值。
若您的标签是例行更新，并希望数据范围是动态变化，请使用动态时间进行描述。例如过去 2 天，xxx 日期 date 类型列可以描述为：
xxx between (${version_date} - INTERVAL '2' DAY) and (${version_date} - INTERVAL '1' DAY)
实例：过去 2 天充值次数
select "user_id", count(1) charge_times
from events
where "$part_event" = 'charge'
and '${part_date}' between ('${version_date}' - INTERVAL '2' DAY) and ('${version_date}' - INTERVAL '1' DAY)
group by 1
4. 用户标签的管理与使用
4.1 管理用户标签
创建的标签会以列表形式展示在用户标签页，用户可以对分群进行查看、编辑、删除、更新、下载、复制、更新操作。
其中，「数量」代表在该标签下有值的用户数，「数据更新时间」为标签最近一次进行计算的时间。
4.2 用户标签详情
标签详情可对指标值的分布情况进行概览，也可以通过「查看历史版本」，管理查看版本情况。
4.3 用户标签版本
在开启「版本备份」后，系统会记录手动、自动备份的标签版本内容。
4.3.1 创建方式
| 创建方式 | 描述 |
|---|---|
| 自动更新 | 系统自动更新的版本 |
| 自动备份 | 系统自动备份的版本 |
| 手动更新 | 手动操作刷新的版本 |
| 手动备份 | 手动计算、备份的版本 |
4.3.2 版本状态
| 版本状态 | 描述 |
|---|---|
| 计算中 | 当前版本正在计算中 |
| 正常 | 标签结果计算成功 |
| 过时 | 即当前版本与最新版本条件规则不一致 |
| 异常 | 标签结果计算失败 |
| 缺失 | 该版本无任何内容 |
4.3.3 版本操作
支持「批量计算」「批量删除」「备份」标签版本
5. 最佳实践
创建完毕后所有指标值标签可以在事件分析、属性分析中作为分组维度或筛选项，对用户进行进一步的下钻分析。
与用户属性相同，用户标签可作为筛选条件。
同样，用户标签可作为分组维度。
