# 项目时区

# 一、时区管理的意义

(1)对多时区项目(项目的用户来自不同时区、业务跨时区如出海)中的事件时间做统一识别记录,避免失去偏移信息。

(2)按照统一口径,计算展示特定时区下的数据情况,以保证唯一性。如全球总部汇总数据。

目标:所有上传数据的时间换算成展示时区下的时间查看

如:中东一用户,采用中国服务器,在旧金山总部查看数据,只需将展示时区配置为旧金山时区再查看即可。

# 二、配置项目时区

管理员及以上用户可在「项目管理」→「分析配置」中配置项目时区信息。

(1)默认时区配置为关闭状态,即直接按照上报数据的原始时间进行计算和展示。

(2)点击开启“多时区开关”后,可开始进行项目时区的配置。

(3)设置时区偏移属性

将您上报数据中记录时区信息的属性选择为“时区偏移属性”。请使用数值型数据记录事件时间与 UTC 时间的偏移小时数,该数值的有效范围仅限于-12~14 间的数值。

提示

如果采用客户端 SDK (Android SDK v2.2.0 / iOS SDK v2.2.0 / JS SDK v1.2.0 / Unity SDK v1.4.3 以上或其他客户端 SDK),TA会默认使用#zone_offset自动采集时区信息。此时,您可以直接选择“默认时区偏移”(#zone_offset属性)作为时区偏移属性。

(4)选择项目展示时区

选择在分析时需要进行时间对齐的时区,可将您最常用使用的统计口径下的时区设置为默认时区,它将作为项目成员在分析时使用的初始默认时区。

比如,总部在旧金山(UTC-08:00),并按照该时区统一全球数据的口径,可将 UTC-08:00设置为项目展示时区。

(5)时区偏移后展示时间的计算方法

展示时间 = 事件时间+( 展示时区 - 事件时区 )

(6)完成设置后,点击“保存配置”,即可在分析模型中使用不同的时区,进行统计分析。

# 三、时区的应用

# 3.1 适用范围

(1)模型、看板中分析时段、分析粒度(按天、按周等)

(2)模型、看板中表格、图表、下载数据,用户列表中的时间类型数据(属性分析除外)

时间类型数据包括触发时间和事件属性

(3)模型、看板中筛选条件、条件分群中的时间条件中的时间

(4)全局时间筛选中的时间都是偏移后的时间信息

(5)用户行为序列中的时间

(6)按时间类型属性分组,并设置汇总粒度

(7)预警管理中的统计时间和展示时间(按照默认时区计算和展示)

# 3.2 不适用范围

使用服务器时间进行显示或定时计算的时间数据不进行时区偏移

(1)报表、看板在计算时的数据更新时间

(2)设置看板定时更新、用户群动态更新

(3)SQL 中进行计算

(4)虚拟属性的创建规则中带有时间类型属性时

创建虚拟属性的过程中时间类型属性不参与偏移,仍按照原始时间计算;如果虚拟属性是时间类型,则在使用虚拟属性时对该属性值进行偏移

# 四、数据计算准则

# 4.1 事件进行偏移处理的条件

选择某属性作为偏移属性后,对某条事件是否进行偏移处理的方法

有该属性,有效
有该属性,无效
无该属性
选择默认属性
使用#zone_offset进行偏移
不做偏移
不做偏移
选择某一属性
使用该属性进行偏移
不做偏移
不做偏移

有该属性无效,如:上传的数据为非数值,无法解析的情况

  1. 在显示时区下的时间为:原始数据时间+(偏移时区-原始数据时区)
  2. 该条原始数据时区信息缺失时,不做偏移处理

# 4.2 事件进行偏移处理的案例

从数据本身、时区配置项、模型中分析时间段 3 个角度来看

(1)某条数据带有的主要信息

#event_time(事件本地时间)
#zone_offset(相对UTC±00:00时区偏移信息)
X某数值型字段(相对UTC±00:00时区偏移信息)
2020-01-01 12:00:00
8
-4

这条事件的含义为,事件发生的本地时间为 2020-01-01 12:00:00

按#zone_offset来判断,本地的时区为 UTC+08:00

按 X 来判断,本地的时区为 UTC-04:00

(2)时区配置项:开启后的选项

场景1
场景2
设置条件
按默认属性偏移至UTC+09:00
按X偏移至UTC+09:00
含义
将原始数据按UTC+09:00下的情况来显示
将原始数据按UTC+09:00下的情况来显示
原始数据在显示时区下的触发时间为
2020-01-01 13:00:00
2020-01-02 01:00:00

# 五、最佳实践

# 5.1 使用标准时区统一海外数据

时区设置最大的作用,就是将出海产品产生的全球数据以一个确定的时区来标准化,比如所有数据都偏移到 UTC±00:00,通过这样的偏移,可以统一数据指标,避免因时区产生的数据跨天问题。

# 5.2 解决非自然日活动数据

非自然日活动指的是开始与结束时间不遵循当地的自然日变更时间,比如活动在当地凌晨 3 点开始与结束。在分析时,就有可能需要以 3 点作为分析的日期切割点,此时可以使用时区编辑功能,设置与日期切割点相应的时区,在分析时进行切换,即可完成这类活动的留存/回访分析需求。

# 5.3 海外团队的数据查看

如果您的团队中存在海外团队,那么使用时区设置功能。将这些团队所在时区配置成可选时区,那么在查看数据时,即可切换为对应时区,更符合海外团队的使用习惯。同时将默认时区设置为所有团队在沟通讨论时使用的通用时区,既保持了各自的使用习惯,也保证了合作的高效。