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 毫秒。