Saavo

ANALYTICS_DB

第一方访问统计数据库的全部数据表和字段。

ANALYTICS_DB 是默认模板的访问统计数据库，初始表结构由 schema/analytics-init.sql 定义。这里按表介绍访问会话、统计事件和自定义属性，包括字段类型、能否为空、默认值和数据库约束。

时间和布尔值

时间字段使用 Unix 毫秒；布尔状态使用 SQLite INTEGER 保存，通常以 1 表示是、0 表示否。

analytics_session

保存一次访问会话的访客标识、设备信息、首次活动时间和服务端首次收到数据的时间。

字段类型可空默认值键含义
site_idTEXT否—PK（组合）站点 ID，对应 config/deploy.ts 中的 analytics.site.id。
session_idTEXT否—PK（组合）访问会话 ID。
distinct_idTEXT是——业务代码提供的访客标识。
browserTEXT是——浏览器名称。
osTEXT是——操作系统名称。
deviceTEXT是——设备类型。
screenTEXT是——屏幕尺寸。
languageTEXT是——浏览器语言。
countryTEXT是——国家或地区代码。
regionTEXT是——地区。
cityTEXT是——城市。
first_seen_atINTEGER否——第一次活动时间，Unix 毫秒。
first_received_atINTEGER否——服务端第一次收到该会话数据的时间，Unix 毫秒。

analytics_event

保存页面浏览和自定义事件，以及来源、设备、地理位置和性能指标。

字段类型可空默认值键含义
event_idTEXT否—PK统计事件 ID。
site_idTEXT否—FK → analytics_session.(site_id, session_id)（组合外键）站点 ID，对应 config/deploy.ts 中的 analytics.site.id。
session_idTEXT否—FK → analytics_session.(site_id, session_id)（组合外键）访问会话 ID。
visit_idTEXT否——本次访问 ID。
event_typeINTEGER否——统计事件类型：1 为页面浏览，2 为自定义事件，5 为性能数据。
event_nameTEXT是——事件名称。
url_pathTEXT否''—页面 URL 路径。
url_queryTEXT是——页面 URL 查询字符串。
page_titleTEXT是——页面标题。
hostnameTEXT否——页面主机名。
referrer_pathTEXT是——来源页面的路径。
referrer_queryTEXT是——来源页面的查询字符串。
referrer_domainTEXT是——来源页面的域名。
utm_sourceTEXT是——UTM 来源。
utm_mediumTEXT是——UTM 媒介。
utm_campaignTEXT是——UTM 活动名称。
utm_contentTEXT是——UTM 内容标识。
utm_termTEXT是——UTM 关键词。
gclidTEXT是——Google Ads 点击标识。
fbclidTEXT是——Facebook 点击标识。
msclkidTEXT是——Microsoft Ads 点击标识。
ttclidTEXT是——TikTok 点击标识。
li_fat_idTEXT是——LinkedIn Ads 点击标识。
twclidTEXT是——X Ads 点击标识。
browserTEXT是——浏览器名称。
osTEXT是——操作系统名称。
deviceTEXT是——设备类型。
screenTEXT是——屏幕尺寸。
languageTEXT是——浏览器语言。
countryTEXT是——国家或地区代码。
regionTEXT是——地区。
cityTEXT是——城市。
distinct_idTEXT是——业务代码提供的访客标识。
tagTEXT是——事件标签。
lcpREAL是——Largest Contentful Paint，单位为毫秒。
inpREAL是——Interaction to Next Paint，单位为毫秒。
clsREAL是——Cumulative Layout Shift。
fcpREAL是——First Contentful Paint，单位为毫秒。
ttfbREAL是——Time to First Byte，单位为毫秒。
durationREAL是——事件或页面停留时长，单位由采集端约定。
created_atINTEGER否——创建时间，Unix 毫秒。
received_atINTEGER否——收到数据的时间，Unix 毫秒。

analytics_event_property

按 Key 保存事件的自定义属性。

字段类型可空默认值键含义
event_idTEXT否—PK（组合）
FK → analytics_event.event_id（级联删除）		统计事件 ID。
data_keyTEXT否—PK（组合）自定义属性或特征的 Key。
site_idTEXT否——站点 ID，对应 config/deploy.ts 中的 analytics.site.id。
data_typeINTEGER否——属性值类型：1 字符串、2 数值、3 布尔值、4 日期、5 字符串数组。
string_valueTEXT是——字符串值。
number_valueREAL是——数值。
date_valueINTEGER是——日期值，Unix 毫秒。
created_atINTEGER否——创建时间，Unix 毫秒。

analytics_session_trait

按 Key 保存会话级自定义特征。

字段类型可空默认值键含义
site_idTEXT否—PK（组合）
FK → analytics_session.(site_id, session_id)（级联删除）		站点 ID，对应 config/deploy.ts 中的 analytics.site.id。
session_idTEXT否—PK（组合）
FK → analytics_session.(site_id, session_id)（级联删除）		访问会话 ID。
data_keyTEXT否—PK（组合）自定义属性或特征的 Key。
data_typeINTEGER否——特征值类型：1 字符串、2 数值、3 布尔值、4 日期、5 字符串数组。
string_valueTEXT是——字符串值。
number_valueREAL是——数值。
date_valueINTEGER是——日期值，Unix 毫秒。
distinct_idTEXT是——业务代码提供的访客标识。
updated_atINTEGER否——最后更新时间，Unix 毫秒。