用户标签

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. 最佳实践

创建完毕后所有指标值标签可以在事件分析、属性分析中作为分组维度或筛选项，对用户进行进一步的下钻分析。

与用户属性相同，用户标签可作为筛选条件。

同样，用户标签可作为分组维度。