Tabelas para consultas sql
O comando sql`…` faz parte do Server SDK: ele lê dados diretamente do banco de dados do
Qubix e está disponível em scripts,
regras automáticas Britva e handlers de sites. Esta
é uma referência de quais tabelas e colunas você pode acessar e por quais regras.
Como o acesso funciona
- Somente leitura. Apenas consultas que começam com
SELECT,WITH,SHOW,DESCRIBEouEXPLAINsão permitidas. Qualquer alteração de dados (INSERT,UPDATE,DELETE) e acesso a fontes externas a partir de dentro da consulta são bloqueados. - Parâmetros seguros. Valores passados por
${…}sempre vão como parâmetros de consulta, não emendados ao texto. Você não precisa escapar nada manualmente e a substituição de consultas é impossível. - Você vê apenas seus próprios dados. A consulta é executada dentro das permissões da sua função: você obtém exatamente as linhas que tem permissão de ver nos relatórios. Os dados de outras pessoas não são acessíveis.
- Um limite de tamanho. Uma única consulta retorna no máximo alguns milhares de linhas (o
administrador define o limite exato). Para seleções grandes, agregue diretamente na consulta —
count(),sum(),GROUP BY.
O nome da tabela é escrito sem prefixo de banco de dados — apenas qubix_events.
qubix_events — o fluxo de eventos
A tabela principal: uma linha por evento do visitante e por ação de conversão. Por meio dela você pode ver tudo o que acontece com o tráfego — da primeira visita ao depósito e à entrega do push.
Evento e identidade
| Coluna | O que é |
|---|---|
event | O tipo de evento (valores na tabela abaixo) |
event_time | O horário do evento |
piuid | O id do visitante (persistente entre visitas) |
pwa_id | O PWA ao qual o evento pertence |
domain | O domínio em que o evento ocorreu |
url | O endereço da página |
Geo e dispositivo
| Coluna | O que é |
|---|---|
geo, country | O país do visitante (por GeoIP) |
city | A cidade |
language | O idioma do navegador |
ua | O User-Agent |
ip | O endereço IP |
device | Dados do dispositivo (JSON) |
Rastreamento e atribuição
| Coluna | O que é |
|---|---|
click_id | O id de clique do tracker |
campaign_id | A campanha do tracker |
ad_id | O anúncio |
sub_id_1 … sub_id_16 | Tags personalizadas do tracker |
fbc, fbp, fbclid | Parâmetros de atribuição do Facebook |
gclid, ttclid | Atribuição do Google / TikTok |
source_clid | O id de clique original |
pixel | O id do pixel |
params | Todos os parâmetros de endereço (um mapa "chave → valor") |
Oferta
| Coluna | O que é |
|---|---|
offer_id | A oferta |
offer_url | O link da oferta |
Push
| Coluna | O que é |
|---|---|
push_campaign_id | A campanha de push |
subscription_id | A inscrição de push do visitante |
message_id | O id da mensagem enviada |
push_title, push_body | O texto do push |
Conversão
| Coluna | O que é |
|---|---|
status | O status da conversão |
revenue | A receita do evento |
currency | A moeda |
response_code | O código de resposta (para eventos do lado do servidor) |
error_message | O texto de erro, se houver |
external_id | Um identificador externo |
extra | Dados adicionais do evento (JSON) |
Valores de event
Os principais tipos de eventos que você verá no fluxo:
| Grupo | Valores |
|---|---|
| Visitas e visualizações | campaign_visit, render, white_page |
| Instalação do 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 |
| Conversões | reg (registro), dep (depósito) |
Os valores de eventos de inscrição e instalação correspondem aos eventos do Browser SDK — o que o window.sdk envia do navegador chega diretamente aqui.
Exemplo
Quantos visitantes de cada país permitiram o push no último dia:
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)
Outras tabelas
| Tabela | O que contém |
|---|---|
pwa_apps | Configurações do aplicativo PWA: pwa_id, name, status, country, category, rating, downloads, push_placement e outros campos do construtor |
push_subscriptions | Inscrições de push: subscription_id, pwa_id, geo_country, active, subscribed_at |
push_campaigns | Campanhas de push: push_campaign_id, name, status, target_geo |
As métricas de relatório prontas (spend, revenue, ROAS, conversões por anúncio) são mais fáceis de
obter não do fluxo bruto, mas dos campos do objeto ad — a lista completa está em
Métricas e colunas.
Segredos de serviço não são acessíveis a partir de consultas — por exemplo, as chaves privadas para push não podem ser lidas. Uma consulta sempre funciona em modo somente leitura e apenas dentro das permissões da sua função.