sql 查询可用的表
sql`…` 命令是 Server SDK 的一部分：它直接从 Qubix 数据库读取数据，可在脚本、Britva 自动规则和站点处理器中使用。本文是关于您可以访问哪些表和列，以及访问规则的参考手册。
访问规则
- 只读。 仅允许以
SELECT、WITH、SHOW、DESCRIBE或EXPLAIN开头的查询。任何数据变更（INSERT、UPDATE、DELETE）以及在查询内部访问外部源均被禁止。 - 安全参数。 通过
${…}传入的值始终作为查询参数传递，而非拼接到文本中。您无需手动转义，也不存在查询注入的可能。 - 只能看到自己的数据。 查询在您角色的权限范围内运行：您只能获取在报告中有权查看的行。他人的数据无法访问。
- 数量限制。 单次查询最多返回数千行（具体上限由管理员设置）。对于大批量查询，请直接在查询中进行聚合——
count()、sum()、GROUP BY。
表名无需数据库前缀，直接写 qubix_events 即可。
qubix_events — 事件流
主表：每条访客事件和每次转化操作对应一行。通过它可以查看流量上发生的一切——从首次访问到存款，再到推送送达。
事件与身份
| 列名 | 含义 |
|---|---|
event | 事件类型（取值见下表） |
event_time | 事件时间 |
piuid | 访客 ID（跨访问持久化） |
pwa_id | 事件所属的 PWA |
domain | 事件发生的域名 |
url | 页面地址 |
地理与设备
| 列名 | 含义 |
|---|---|
geo、country | 访客所在国家/地区（通过 GeoIP） |
city | 城市 |
language | 浏览器语言 |
ua | User-Agent |
ip | IP 地址 |
device | 设备数据（JSON） |
追踪与归因
| 列名 | 含义 |
|---|---|
click_id | 追踪器点击 ID |
campaign_id | 追踪器活动 |
ad_id | 广告 |
sub_id_1 … sub_id_16 | 自定义追踪器标签 |
fbc、fbp、fbclid | Facebook 归因参数 |
gclid、ttclid | Google / TikTok 归因 |
source_clid | 原始点击 ID |
pixel | Pixel ID |
params | 所有地址参数（"键 → 值"映射） |
Offer
| 列名 | 含义 |
|---|---|
offer_id | Offer |
offer_url | Offer 链接 |
推送
| 列名 | 含义 |
|---|---|
push_campaign_id | 推送活动 |
subscription_id | 访客的推送订阅 |
message_id | 已发送消息的 ID |
push_title、push_body | 推送文本 |
转化
| 列名 | 含义 |
|---|---|
status | 转化状态 |
revenue | 该事件的收入 |
currency | 货币 |
response_code | 响应码（用于服务端事件） |
error_message | 错误文本（如有） |
external_id | 外部标识符 |
extra | 额外事件数据（JSON） |
event 取值
事件流中常见的主要事件类型：
| 分组 | 取值 |
|---|---|
| 访问与浏览 | campaign_visit、render、white_page |
| PWA 安装 | install_accepted、install_rejected、install_blocked、installed、launch_pwa、install_fallback_redirect |
| 推送 | push_prompt_shown、push_allow、push_deny、push_ignored、push_subscribe、push_sent、push_shown、push_click、push_dismiss、push_expired |
| 转化 | reg（注册）、dep（存款） |
订阅和安装的事件取值与 Browser SDK 事件一致——window.sdk 从浏览器发送的内容会直接出现在这里。
示例
统计过去一天内各国/地区允许推送的访客数：
JavaScript
const rows = sql`
SELECT geo, count() AS allowed
FROM qubix_events
WHERE event = 'push_allow'
AND event_time >= now() - INTERVAL 1 DAY
GROUP BY geo
ORDER BY allowed DESC`
for (const row of rows) console.log(row.geo, row.allowed)
其他表
| 表名 | 内容 |
|---|---|
pwa_apps | PWA 应用配置：pwa_id、name、status、country、category、rating、downloads、push_placement 及其他构建器字段 |
push_subscriptions | 推送订阅：subscription_id、pwa_id、geo_country、active、subscribed_at |
push_campaigns | 推送活动：push_campaign_id、name、status、target_geo |
现成的报告指标（花费、收入、ROAS、每广告转化）更方便从 ad 对象的字段中获取，而非从原始事件流中——完整列表请参阅指标与列。
注意
服务机密无法通过查询访问——例如，推送的私钥无法被读取。查询始终以只读方式运行，且仅在您角色的权限范围内有效。