用户标签是具有某一系列特征的人群合集。用户标签是基于用户在平台内的所有行为数据，提炼出用户客观标签、目标、行为和观点等的数字/信息标识，并会关联到用户实体上。

• 功能开关与功能能力：

  • SaaS-非云原生环境中，用户标签功能默认开启。
  • SaaS-云原生、私有化环境中，用户标签功能默认关闭，如需使用此功能，请联系您的客户成功经理开启。

• 操作权限要求

  角色	功能权限
  管理员、集团管理员、标签创建人	可创建用户标签，并可管理/编辑/删除自己创建的用户标签。 可手动更新、启动标签。
  集团管理员	管理编辑全量的用户标签。 编辑 删除

您可从分析工具>用户分析>用户标签进入，并进行使用。

1. 在用户标签列表右侧点击创建标签按钮“+”，在弹出的弹框中选择标签的创建方式。
   
   当前提供「自定义标签、具体特征、SQL、上传文档」4种用户标签的创建方式。
2. 根据业务需求选择对应的方式创建标签，配置标签参数。

   1. 配置标签基本信息。
      

      参数	配置说明
      展示名	自定义标签的展示名称，名称不能超过50个字符，无符号限制。
      标签名	自定义标签名称，不超过50个字符，可输入数字、下划线及大小写字母。 注意 标签名创建后不支持修改。
      计算周期	配置标签创建后，标签用户的计算时间周期，可选择手动更新或每日例行。 手动更新：创建后将不会自动更新用户，可手动点击“更新”按钮更新用户。 每日例行：自动更新任务默认在每日服务器时间零点执行（与App选择时区一致）。
      标签描述	自定义对标签的描述，帮助了解标签业务含义。

   2. 配置标签创建规则，不同的标签创建方式的配置详情不一致，详情请参见下文各类型标签的配置详情章节。

创建方式1：自定义标签

自定义标签为通过配置的筛选规则筛选出特定人群，并对该人群打上标签值。一个自定义标签，支持创建多个标签值（最多可创建20个），例如：创建“用户价值”的自定义标签，可通过标签规则创建“高价值用户”、“中价值用户”、“低价值用户”的多个标签值。

• 每个用户最终仅会有一个标签值，若一个用户同时命中多个标签值的筛选规则，则优先匹配顺序靠前的标签值。

• 每个标签值支持灵活添加用户行为事件、事件属性，并设置多个过滤条件间的逻辑关系为AND或OR，来进行用户过滤。

  条件框	条件类型	支持的计算算子
  用户是	用户标签 用户分群 用户属性	不涉及
  用户不是
  用户做过	行为事件	总次数 每日次数 天数分布 连续天数 按...求和 按...求最小值 按...求最大值 按...求平均值 按...求去重数
  用户没做过
  用户依次做过		不涉及

创建方式2：具体特征标签

具体特征标签为根据某个明确的行为条件或用户标签，筛选特定人群，并对人群打上标签。

• 用户可基于【时间、行为（做过/没做过）、事件、计算方式】以及该事件的标签，筛选人群。
• 选择人群后，基于某个指定事件【首次/末次/TopN/条件事件】的【属性】作为【标签值】。

创建方式3：SQL 计算

使用 SQL 语句进行标签的创建。按照特定的规则，返回指定的 SQL 数据即可进行 SQL 标签的创建。
SQL 目前支持字符串、列表、数值、时间和浮点数5种数据类型。下文为您提供了一个SQL样例。

SQL 样例：

• 要求：
  查询结果需要返回 2 列数据，第一列固定为stat_standard_id，表示统计口径 ID； 第二列需要有别名，别名固定为 value，表示标签值。
  若您的标签是例行更新，并希望数据范围是动态变化，请使用时间函数进行描述。如：where and event_date >= subtractDays(yesterday(), 7) and event_date <= yesterday()
• 样例：

  1. 过去 7 天购买次数

     -- int 类型的
     select stat_standard_id, count(1) as value
     from events
     where event_date >= subtractDays(yesterday(), 7)
       and event_date <= yesterday()
       and event = 'purchase'
     group by stat_standard_id;
     

  2. 过去 7 天购买偏好的商品种类

     -- list 类型
     select stat_standard_id, topK(2)(event_params.purchase.category) as value
     from events
     where event_date >= subtractDays(yesterday(), 7)
       and event_date <= yesterday()
       and event = 'purchase'
     group by stat_standard_id
     

创建方式4：上传文件

使用上传文件计算结果作为标签值，为用户进行标记。上传包含“用户id”与“对应的标签值”文件，利用上传的用户标签筛选目标用户并进行标记。

• 导入标签目前支持字符串、列表、数值、时间和浮点数 5种数据类型。
• 通过上传 id 列表文件的方式创建标签时，需要选择文件id类型，系统将按照所选类型创建。

• string/int/float 格式：

  user_id,value
  a123456,value_a
  b123456,value_b
  c123456,value_c
  

• datetime 格式：
  datetime的值的格式需要符合：
  (19|20)\\d{2}\\-[01]\\d\\-[0123]\\d([T|\\s]\\d{2}\\:\\d{2}\\:\\d{2}(\\.\\d{3})?([\\+\\-]\\d{2}\\:\\d{2})?)?

  user_id,value
  a123456,2021-01-01
  b123456,2021-01-01
  

• list 格式：
  多个值用逗号来进行连接。

  user_id,value
  a123456,value1,value2,value3
  b123456,value1,value5
  

• 查看用户标签详情
  在列表页点击标签名，可以进入详情页查看标签的基本信息&标签最新计算结果。
• 启动&停用
  手动更新或每日例行：可以通过修改【计算方式】来决定是否进行持续计算。
• 更新
  支持通过【更新】操作将标签的计算时间更新到当前日期。
• 下载
  • 下载详情：点击后，下载上次完成计算的用户详情数据。
  • 下载概况：点击后，下载上次完成计算的统计数据。
• 删除：
  超级管理员或创建者可删除标签。

• 点击“历史数据”可查看标签历史结果，最长支持365日的历史结果。
• 历史结果支持下载单日标签的详情&概览数据，同时支持下载单个标签值的详情数据。

• 点击“编辑”/“查看”，进入标签条件配置页面。
• 您可在配置页面对原标签进行修改，或“另存为”成为新标签。