sql sorguları için tablolar

sql`…` komutu Server SDK'nın bir parçasıdır: verileri doğrudan Qubix veritabanından okur ve betikler, Britva otomatik kuralları ve site işleyicilerinde kullanılabilir. Bu referans, hangi tablolara ve sütunlara erişebileceğinizi ve hangi kurallara göre erişim sağlandığını açıklar.

Erişim nasıl çalışır

• Yalnızca okuma. Yalnızca SELECT, WITH, SHOW, DESCRIBE veya EXPLAIN ile başlayan sorgulara izin verilir. Veri değiştirme işlemleri (INSERT, UPDATE, DELETE) ve sorgu içinden dış kaynaklara bağlantı kurma engellenir.
• Güvenli parametreler. ${…} aracılığıyla iletilen değerler her zaman sorgu parametresi olarak gönderilir; metne eklenmez. Elle kaçış uygulamanıza gerek yoktur ve sorgu enjeksiyonu mümkün değildir.
• Yalnızca kendi verilerinizi görürsünüz. Sorgu, rolünüzün yetkileri çerçevesinde çalışır: raporlarda görmeye izin verilen satırları alırsınız. Başkalarının verilerine erişim sağlanamaz.
• Boyut sınırı. Tek bir sorgu en fazla birkaç bin satır döndürür (yönetici kesin üst sınırı belirler). Büyük seçimler için sorgunun içinde toplu işlem yapın — count(), sum(), GROUP BY.

Tablo adı veritabanı öneki olmadan yazılır — yalnızca qubix_events.

qubix_events — olay akışı

Ana tablo: her ziyaretçi olayı ve her dönüşüm eylemi için bir satır. Bu tablo aracılığıyla trafikte gerçekleşen her şeyi görebilirsiniz — ilk ziyaretten mevduata ve push iletisine kadar.

Olay ve kimlik

Sütun	Ne olduğu
event	Olay türü (değerler aşağıdaki tabloda)
event_time	Olayın zamanı
piuid	Ziyaretçi kimliği (ziyaretler arasında kalıcı)
pwa_id	Olayın ait olduğu PWA
domain	Olayın gerçekleştiği alan adı
url	Sayfa adresi

Coğrafi konum ve cihaz

Sütun	Ne olduğu
geo, country	Ziyaretçinin ülkesi (GeoIP'ye göre)
city	Şehir
language	Tarayıcı dili
ua	User-Agent
ip	IP adresi
device	Cihaz bilgileri (JSON)

İzleme ve atıf

Sütun	Ne olduğu
click_id	İzleyici tıklama kimliği
campaign_id	İzleyici kampanyası
ad_id	Reklam
sub_id_1 … sub_id_16	Özel izleyici etiketleri
fbc, fbp, fbclid	Facebook atıf parametreleri
gclid, ttclid	Google / TikTok atıfı
source_clid	Özgün tıklama kimliği
pixel	Piksel kimliği
params	Tüm adres parametreleri ("anahtar → değer" eşlemesi)

Teklif

Sütun	Ne olduğu
offer_id	Teklif
offer_url	Teklif bağlantısı

Push

Sütun	Ne olduğu
push_campaign_id	Push kampanyası
subscription_id	Ziyaretçinin push aboneliği
message_id	Gönderilen mesaj kimliği
push_title, push_body	Push metni

Dönüşüm

Sütun	Ne olduğu
status	Dönüşüm durumu
revenue	Olaydan elde edilen gelir
currency	Para birimi
response_code	Yanıt kodu (sunucu taraflı olaylar için)
error_message	Varsa hata metni
external_id	Dış tanımlayıcı
extra	Ek olay verisi (JSON)

event değerleri

Akışta göreceğiniz başlıca olay türleri:

Grup	Değerler
Ziyaretler ve görüntülemeler	campaign_visit, render, white_page
PWA kurulumu	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
Dönüşümler	reg (kayıt), dep (yatırım)

Abone olma ve kurulum olay değerleri Browser SDK olaylarıyla eşleşir — tarayıcıdan window.sdk'nın gönderdiği veriler doğrudan buraya düşer.

Örnek

Son bir gün içinde her ülkeden kaç ziyaretçinin push'a izin verdiği:

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)

Diğer tablolar

Tablo	İçindekiler
pwa_apps	PWA uygulama ayarları: pwa_id, name, status, country, category, rating, downloads, push_placement ve diğer yapılandırıcı alanları
push_subscriptions	Push abonelikleri: subscription_id, pwa_id, geo_country, active, subscribed_at
push_campaigns	Push kampanyaları: push_campaign_id, name, status, target_geo

Hazır rapor metrikleri (spend, revenue, ROAS, reklam başına dönüşümler) ham akıştan değil, ad nesnesinin alanlarından almak daha kolaydır — tam liste Metrikler ve sütunlar bölümündedir.

Dikkat

Servis gizli anahtarları sorgulardan erişilemez — örneğin, push için özel anahtarlar okunamaz. Bir sorgu her zaman yalnızca okuma modunda ve yalnızca rolünüzün yetkileri dahilinde çalışır.

Sıradaki adımlar

Betik yazma

sql'in nerede kullanılacağı ve düzenleyicinin nasıl çalıştığı.

Site arka ucu

Sayfa işleyicilerinde aynı sorgular.

Metrikler ve sütunlar

Raporlar ve kurallar için hazır reklam metrikleri.