Bảng cho truy vấn sql
Lệnh sql`…` là một phần của Server SDK: nó đọc dữ liệu trực tiếp từ
cơ sở dữ liệu Qubix và có thể dùng trong script,
auto-rule Britva và site handler. Đây là tài
liệu tham chiếu về các bảng, cột bạn có thể truy cập và theo những quy tắc nào.
Cách truy cập hoạt động
- Chỉ đọc. Chỉ những truy vấn bắt đầu bằng
SELECT,WITH,SHOW,DESCRIBEhoặcEXPLAINmới được phép. Mọi thao tác thay đổi dữ liệu (INSERT,UPDATE,DELETE) và truy cập nguồn bên ngoài từ bên trong truy vấn đều bị chặn. - Tham số an toàn. Các giá trị truyền qua
${…}luôn được dùng dưới dạng tham số truy vấn, không được ghép trực tiếp vào chuỗi. Bạn không cần tự escape bất cứ thứ gì, và SQL injection là không thể. - Bạn chỉ thấy dữ liệu của mình. Truy vấn chạy trong phạm vi quyền của vai trò của bạn: bạn nhận đúng những hàng mà bạn được phép xem trong báo cáo. Dữ liệu của người khác không thể truy cập được.
- Giới hạn kích thước. Một truy vấn trả về tối đa vài nghìn hàng (quản trị viên đặt giới
hạn chính xác). Với các tập dữ liệu lớn, hãy tổng hợp ngay trong truy vấn —
count(),sum(),GROUP BY.
Tên bảng được viết không có tiền tố cơ sở dữ liệu — chỉ cần qubix_events.
qubix_events — luồng sự kiện
Bảng chính: một hàng ứng với mỗi sự kiện của khách truy cập và mỗi hành động chuyển đổi. Qua bảng này bạn có thể xem mọi thứ xảy ra với lưu lượng truy cập — từ lượt truy cập đầu tiên đến lần nạp tiền và đến việc gửi push.
Sự kiện và danh tính
| Cột | Ý nghĩa |
|---|---|
event | Loại sự kiện (các giá trị trong bảng bên dưới) |
event_time | Thời gian sự kiện |
piuid | ID khách truy cập (duy trì qua các lượt truy cập) |
pwa_id | PWA mà sự kiện thuộc về |
domain | Tên miền xảy ra sự kiện |
url | Địa chỉ trang |
Địa lý và thiết bị
| Cột | Ý nghĩa |
|---|---|
geo, country | Quốc gia của khách truy cập (theo GeoIP) |
city | Thành phố |
language | Ngôn ngữ trình duyệt |
ua | User-Agent |
ip | Địa chỉ IP |
device | Dữ liệu thiết bị (JSON) |
Tracking và attribution
| Cột | Ý nghĩa |
|---|---|
click_id | ID click của tracker |
campaign_id | Chiến dịch tracker |
ad_id | Quảng cáo |
sub_id_1 … sub_id_16 | Thẻ tracker tùy chỉnh |
fbc, fbp, fbclid | Tham số attribution Facebook |
gclid, ttclid | Attribution Google / TikTok |
source_clid | ID click gốc |
pixel | ID pixel |
params | Tất cả tham số địa chỉ (dạng map "key → value") |
Offer
| Cột | Ý nghĩa |
|---|---|
offer_id | Offer |
offer_url | Đường dẫn offer |
Push
| Cột | Ý nghĩa |
|---|---|
push_campaign_id | Chiến dịch push |
subscription_id | Đăng ký push của khách truy cập |
message_id | ID tin nhắn đã gửi |
push_title, push_body | Nội dung push |
Chuyển đổi
| Cột | Ý nghĩa |
|---|---|
status | Trạng thái chuyển đổi |
revenue | Doanh thu từ sự kiện |
currency | Đơn vị tiền tệ |
response_code | Mã phản hồi (cho sự kiện phía server) |
error_message | Nội dung lỗi, nếu có |
external_id | Định danh bên ngoài |
extra | Dữ liệu sự kiện bổ sung (JSON) |
Các giá trị của event
Các loại sự kiện chính bạn sẽ thấy trong luồng:
| Nhóm | Giá trị |
|---|---|
| Lượt truy cập và xem trang | campaign_visit, render, white_page |
| Cài đặt PWA | install_accepted, install_rejected, install_blocked, installed, launch_pwa, install_fallback_redirect |
| Push | push_prompt_shown, push_allow, push_deny, push_ignored, push_subscribe, push_sent, push_shown, push_click, push_dismiss, push_expired |
| Chuyển đổi | reg (đăng ký), dep (nạp tiền) |
Các giá trị sự kiện subscribe và install tương ứng với sự kiện trong Browser SDK —
những gì window.sdk gửi từ trình duyệt sẽ đến thẳng đây.
Ví dụ
Số lượng khách truy cập từ mỗi quốc gia đã cho phép push trong ngày qua:
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)
Các bảng khác
| Bảng | Nội dung |
|---|---|
pwa_apps | Cài đặt ứng dụng PWA: pwa_id, name, status, country, category, rating, downloads, push_placement và các trường constructor khác |
push_subscriptions | Đăng ký push: subscription_id, pwa_id, geo_country, active, subscribed_at |
push_campaigns | Chiến dịch push: push_campaign_id, name, status, target_geo |
Các chỉ số báo cáo có sẵn (spend, revenue, ROAS, chuyển đổi theo quảng cáo) dễ lấy hơn
không phải từ luồng thô mà từ các trường của đối tượng ad — danh sách đầy đủ có tại
Chỉ số và cột.
Các bí mật dịch vụ không thể truy cập từ truy vấn — ví dụ, khóa riêng tư cho push không thể đọc được. Truy vấn luôn hoạt động ở chế độ chỉ đọc và chỉ trong phạm vi quyền của vai trò của bạn.