ตารางสำหรับคำสั่ง sql

คำสั่ง sql`…` เป็นส่วนหนึ่งของ Server SDK: อ่านข้อมูลโดยตรงจากฐานข้อมูล Qubix และใช้งานได้ใน สคริปต์, กฎอัตโนมัติ Britva และ ตัวจัดการไซต์ นี่คือ เอกสารอ้างอิงสำหรับตารางและคอลัมน์ที่เข้าถึงได้ และกฎที่เกี่ยวข้อง

วิธีการทำงานของการเข้าถึง

• อ่านอย่างเดียว อนุญาตเฉพาะคำสั่งที่ขึ้นต้นด้วย SELECT, WITH, SHOW, DESCRIBE หรือ EXPLAIN เท่านั้น การเปลี่ยนแปลงข้อมูล (INSERT, UPDATE, DELETE) และการเชื่อมต่อแหล่งข้อมูลภายนอก จากภายในคำสั่งนั้นถูกบล็อก
• พารามิเตอร์ที่ปลอดภัย ค่าที่ส่งผ่าน ${…} จะถูกใช้เป็นพารามิเตอร์ของคำสั่งเสมอ ไม่ใช่ การต่อข้อความโดยตรง คุณไม่จำเป็นต้อง escape ด้วยตนเอง และการแทนที่คำสั่งเป็นไปไม่ได้
• มองเห็นเฉพาะข้อมูลของตนเอง คำสั่งทำงานภายในสิทธิ์ของบทบาทของคุณ: คุณจะได้รับ เฉพาะแถวที่ได้รับอนุญาตให้ดูในรายงาน ไม่สามารถเข้าถึงข้อมูลของผู้อื่นได้
• ขีดจำกัดขนาด คำสั่งเดียวจะคืนค่าได้สูงสุดไม่กี่พันแถว (ผู้ดูแลระบบกำหนดค่าสูงสุดที่แน่นอน) สำหรับข้อมูลจำนวนมาก ให้รวมผลลัพธ์ในคำสั่งโดยตรง — count(), sum(), GROUP BY

ชื่อตารางเขียนโดยไม่มีคำนำหน้าฐานข้อมูล — เพียงแค่ qubix_events

qubix_events — สตรีมเหตุการณ์

ตารางหลัก: หนึ่งแถวต่อหนึ่งเหตุการณ์ของผู้เข้าชมและต่อหนึ่งการกระทำ Conversion ผ่านตารางนี้ คุณสามารถดูทุกสิ่งที่เกิดขึ้นกับทราฟฟิก ตั้งแต่การเยี่ยมชมครั้งแรกไปจนถึงการฝากเงินและการส่ง push

เหตุการณ์และตัวตน

คอลัมน์	คำอธิบาย
event	ประเภทเหตุการณ์ (ค่าในตารางด้านล่าง)
event_time	เวลาของเหตุการณ์
piuid	รหัสผู้เข้าชม (คงอยู่ข้ามการเยี่ยมชม)
pwa_id	PWA ที่เหตุการณ์นี้สังกัด
domain	โดเมนที่เกิดเหตุการณ์
url	ที่อยู่ของหน้า

ภูมิศาสตร์และอุปกรณ์

คอลัมน์	คำอธิบาย
geo, country	ประเทศของผู้เข้าชม (โดย GeoIP)
city	เมือง
language	ภาษาของเบราว์เซอร์
ua	User-Agent
ip	ที่อยู่ IP
device	ข้อมูลอุปกรณ์ (JSON)

การติดตามและการระบุแหล่งที่มา

คอลัมน์	คำอธิบาย
click_id	รหัสคลิกของ tracker
campaign_id	แคมเปญของ tracker
ad_id	โฆษณา
sub_id_1 … sub_id_16	แท็ก tracker กำหนดเอง
fbc, fbp, fbclid	พารามิเตอร์การระบุแหล่งที่มาของ Facebook
gclid, ttclid	การระบุแหล่งที่มาของ Google / TikTok
source_clid	รหัสคลิกต้นทาง
pixel	รหัส pixel
params	พารามิเตอร์ที่อยู่ทั้งหมด (แผนที่ "key → value")

Offer

คอลัมน์	คำอธิบาย
offer_id	offer
offer_url	ลิงก์ offer

Push

คอลัมน์	คำอธิบาย
push_campaign_id	แคมเปญ push
subscription_id	การสมัครรับ push ของผู้เข้าชม
message_id	รหัสข้อความที่ส่งแล้ว
push_title, push_body	ข้อความ push

Conversion

คอลัมน์	คำอธิบาย
status	สถานะ Conversion
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	push_prompt_shown, push_allow, push_deny, push_ignored, push_subscribe, push_sent, push_shown, push_click, push_dismiss, push_expired
Conversion	reg (การลงทะเบียน), dep (การฝากเงิน)

ค่าของเหตุการณ์ subscribe และ install ตรงกับเหตุการณ์ Browser SDK — สิ่งที่ window.sdk ส่งจากเบราว์เซอร์จะมาอยู่ที่นี่โดยตรง

ตัวอย่าง

จำนวนผู้เข้าชมจากแต่ละประเทศที่อนุญาต push ในช่วง 1 วันที่ผ่านมา:

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	การสมัครรับ push: subscription_id, pwa_id, geo_country, active, subscribed_at
push_campaigns	แคมเปญ push: push_campaign_id, name, status, target_geo

เมตริกรายงานสำเร็จรูป (spend, revenue, ROAS, Conversion ต่อโฆษณา) นำมาได้ง่ายกว่า จากฟิลด์ของออบเจกต์ ad ไม่ใช่จากสตรีมดิบ — ดูรายการทั้งหมดได้ที่ เมตริกและคอลัมน์

ข้อควรระวัง

ความลับของระบบไม่สามารถเข้าถึงได้จากคำสั่ง — ตัวอย่างเช่น ไม่สามารถอ่าน private key สำหรับ push ได้ คำสั่งทำงานแบบอ่านอย่างเดียวเสมอและเฉพาะภายในสิทธิ์ของบทบาทของคุณเท่านั้น

ขั้นตอนถัดไป

Writing a script

Where to use sql and how the editor works.

Site backend

The same queries in page handlers.

Metrics and columns

Ready-made ad metrics for reports and rules.