メインコンテンツへスキップ
14分で読めます

Query Studioスキーマリファレンス

Zenovay Query Studioで利用可能なすべてのクエリ可能なテーブルの完全なリファレンス。このガイドを使用して、データベーススキーマを探索し、列タイプを理解し、正確なSQLクエリを作成します。

すべてのクエリは 必ず WHERE website_id = 'your-website-id' を含める必要があります。これはあなたのウェブサイトへの結果を制限します。このフィルターなしのクエリは拒否されます。

Query Studioは 1クエリあたり最大1,000行 および 10秒のタイムアウト を適用します。SELECT ステートメントのみが許可されています。すべての書き込み操作 (INSERT, UPDATE, DELETE, DROP など) はブロックされます。


コア分析

visitors

訪問者個別レコード。地理的位置情報、デバイス情報、UTMトラッキングパラメータ、行動エンゲージメントスコアを含みます。訪問者レベルの粒度の高い分析用のプライマリテーブルです。

タイプ説明
iduuid訪問者レコードの一意な識別子
website_iduuidこの訪問者が属するウェブサイト
visitor_idtext匿名化された訪問者識別子(ハッシュ済み)
page_urltextアクセスされたページの完全なURL
landing_pagetext訪問者が最初にアクセスしたページ
referrertext訪問者を引き継いだリファリングURL
country_codevarcharISO 3166-1 alpha-2国コード(例:US, GB)
country_namevarchar完全な国名(例:United States)
cityvarcharIPジオロケーションからの都市名
device_typetextデバイスカテゴリ:desktop, mobile, または tablet
browservarcharブラウザ名(例:Chrome, Firefox, Safari)
osvarcharオペレーティングシステム(例:Windows, macOS, iOS)
utm_sourcevarcharUTMソースパラメータ(例:google, newsletter)
utm_mediumvarcharUTMメディアムパラメータ(例:cpc, email, organic)
utm_campaignvarcharUTMキャンペーン名
channelvarchar属性化されたマーケティングチャネル(例:Organic Search, Direct, Social)
had_interactionboolean訪問者がページと相互作用したかどうか(クリック、スクロールなど)
is_returning_visitorbooleantrue 訪問者が以前見られている場合
time_on_pageintegerページで過ごした時間(秒)
scroll_depth_percentageinteger達した最大スクロール深度(0-100)
value_scoreinteger行動に基づいて計算されたエンゲージメントスコア(0-100)
conversion_eventvarcharトリガーされたコンバージョンイベント名(存在する場合)
conversion_valuenumericコンバージョンに関連する金銭的価値
visited_attimestamptz訪問が発生した時刻のタイムスタンプ

analytics_daily

ダッシュボードの高速クエリ用の事前集計済み日次統計。日次サマリーが必要な場合は visitors の代わりにこのテーブルを使用します — 日付範囲レポートの場合、大幅に高速です。

タイプ説明
website_iduuidウェブサイト識別子
datedateこの集計のカレンダー日付
visitorsintegerその日の訪問者の総数
page_viewsintegerその日のページビューの総数
unique_visitorsinteger一意の訪問者数
sessionsinteger異なるセッション数
avg_session_durationinteger平均セッション継続時間(秒)
bounce_ratenumericバウンス率(小数)(例:0.45 = 45%)
top_countriesjsonb訪問者数による上位国
top_devicesjsonbデバイスタイプの内訳
top_browsersjsonbブラウザ使用率の内訳
top_referrersjsonb上位リファリングソース
top_pagesjsonb最も訪問されたページ

top_countries などのJSONB列は -> (JSONを返す)および ->> (テキストを返す)オペレータを使用してクエリできます。例:top_countries->0->>'country' は上位国の名前を返します。

page_views

パフォーマンスとエンゲージメントメトリクス付きの個別ページビューイベント。各行は、セッション内の訪問者による単一のページロードを表します。

タイプ説明
website_iduuidウェブサイト識別子
visitor_iduuid訪問者への参照
session_iduuidこのページビューが属するセッション
page_urltextページの完全なURL
page_titletextページのHTMLタイトル
page_pathtextドメインなしのURLパス(例:/pricing)
load_time_msintegerページロード時間(ミリ秒)
time_on_page_secondsintegerこのページで過ごした時間(秒)
scroll_depth_percentageinteger達した最大スクロール深度(0-100)
clicks_countintegerこのページ上のクリック数
had_interactionboolean意味のある相互作用が発生したかどうか
timestamptimestamptzページビューが発生した時刻

live_visitors

現在ウェブサイト上でアクティブな訪問者。このテーブルはリアルタイムで更新され、過去数分間アクティブだった訪問者を反映します。

タイプ説明
website_iduuidウェブサイト識別子
visitor_iduuid訪問者識別子
current_page_urltext訪問者が現在表示しているページ
landing_pagetext現在のセッションの最初のページ
pages_viewedintegerこのセッションで表示されたページ数
device_typevarcharデバイスカテゴリ
browservarcharブラウザ名
country_namevarchar訪問者の国
channelvarcharトラフィックチャネルの属性化
is_activeboolean訪問者がまだアクティブにブラウジング中かどうか
is_new_visitorbooleantrue これが訪問者の最初のセッションの場合

売上と支払い

payments

接続された支払いプロバイダー(Stripe、LemonSqueezy、Polar)から同期された支払いトランザクション。各行は単一のトランザクションを表します。

タイプ説明
website_iduuidウェブサイト識別子
amountnumeric指定された通貨でのトランザクション額
currencyvarcharISO 4217通貨コード(例:USD, EUR)
statusvarchar支払いステータス:succeeded, pending, failed, refunded
providervarchar支払いプロバイダー:stripe, lemonsqueezy, polar
marketing_channelvarcharこの支払いに属性化されたマーケティングチャネル
utm_sourcevarcharこのトランザクションにリンクされたUTMソース
customer_emailvarchar顧客メールアドレス
customer_namevarchar顧客表示名
created_attimestamptz支払いが作成された時刻

revenue_attribution

定義された期間にわたってマーケティングチャネルに属性化された売上。チャネルROI分析とマーケティングパフォーマンスレポートに使用します。

タイプ説明
website_iduuidウェブサイト識別子
period_startdate属性化期間の開始日
period_enddate属性化期間の終了日
marketing_channelvarcharマーケティングチャネル名
utm_sourcevarcharこの属性化のUTMソース
total_revenuenumericこのチャネルに属性化された総売上
transaction_countintegerトランザクション数
unique_customersinteger一意の有料顧客数
conversion_ratenumericコンバージョン率(小数)

identified_users

訪問者識別APIを介して識別された既知のユーザー。サブスクリプションステータスと生涯売上データを含みます。

タイプ説明
website_iduuidウェブサイト識別子
emailvarcharユーザーメールアドレス
namevarcharユーザー表示名
total_revenuenumericこのユーザーからの生涯売上
subscription_statusvarchar現在のステータス:active, canceled, past_due, trialing
subscription_planvarcharプラン名(例:Pro, Enterprise)
total_sessionsintegerセッション総数
first_seen_attimestamptzユーザーが最初に識別された時刻
last_seen_attimestamptz最後のアクティビティのタイムスタンプ

ゴールとファネル

custom_goals

ダッシュボードで設定されたゴール定義。各ゴールはURLの訪問またはカスタムイベントのトリガーなど、特定のユーザーアクションをトラッキングします。

タイプ説明
website_iduuidウェブサイト識別子
namevarchar人間が読めるゴール名
goal_typevarcharゴールタイプ:url, event, pageview
url_patterntextマッチするURLパターン(URLタイプのゴール用)
event_namevarcharマッチするイベント名(イベントタイプのゴール用)
is_activebooleanゴールが現在アクティブかどうか
default_valuenumeric達成あたりのデフォルト金銭的価値

goal_completions

個別ゴール変換イベント。各行は訪問者が定義されたゴールを完了する単一インスタンスを表します。

タイプ説明
goal_iduuidゴール定義への参照
website_iduuidウェブサイト識別子
visitor_idtextゴールを完了した訪問者
completion_valuenumericこの特定の達成の価値
page_urltext達成が発生したページ
utm_sourcevarchar達成時のUTMソース
device_typevarchar使用されたデバイス
country_namevarchar訪問者の国
completed_attimestamptzゴールが完了した時刻

funnels

マルチステップコンバージョン追跡用のファネル定義。

タイプ説明
iduuid一意なファネル識別子
website_iduuidウェブサイト識別子
namevarcharファネル名

funnel_steps

ファネル内の個別ステップ。順序付けされています。funnel_id 上で funnels とジョインして完全なファネル構成を取得します。

タイプ説明
funnel_iduuid親ファネルへの参照
step_orderintegerファネルシーケンス内の位置(1ベース)
step_namevarcharこのステップの表示名
step_typevarcharステップタイプ:url, event
url_patterntextマッチするURLパターン(URLステップ用)
event_namevarcharマッチするイベント名(イベントステップ用)

エラーとパフォーマンス

error_groups

発生数と重大度を含むグループ化されたエラータイプ。エラーは自動的に重複排除され、タイプとメッセージでグループ化されます。

タイプ説明
website_iduuidウェブサイト識別子
error_typevarcharエラーカテゴリ:javascript, network, unhandled_rejection
error_messagetextエラーメッセージ文字列
occurrence_countintegerこのエラーの発生総数
user_countinteger影響を受けた一意のユーザー数
severityvarchar重大度レベル:low, medium, high, critical
statusvarcharトリアージステータス:open, resolved, ignored
first_seentimestamptzこのエラーが最初に記録された時刻
last_seentimestamptz最後の発生

error_occurrences

スタックトレースと環境の詳細を含む完全なコンテキストを持つ個別エラーイベント。

タイプ説明
website_iduuidウェブサイト識別子
error_typevarcharエラーカテゴリ
error_messagetextエラーメッセージ
stacktracejsonb構造化JSONとしての完全なスタックトレース
page_urltextエラーが発生したページ
browservarcharブラウザ名とバージョン
osvarcharオペレーティングシステム
severityvarchar重大度レベル
timestamptimestamptzエラーが発生した時刻

performance_metrics

リアルユーザー監視から収集されたCore Web Vitals測定(LCP、CLS、INP)。各行は単一ページロードからの単一測定です。

タイプ説明
website_iduuidウェブサイト識別子
page_urltextメトリクスが収集されたページ
lcp_valuenumericLargest Contentful Paint(ミリ秒)
lcp_ratingvarcharLCPレーティング:good, needs-improvement, poor
cls_valuenumericCumulative Layout Shiftスコア
cls_ratingvarcharCLSレーティング:good, needs-improvement, poor
inp_valueintegerInteraction to Next Paint(ミリ秒)
inp_ratingvarcharINPレーティング:good, needs-improvement, poor
device_typevarcharこの測定に使用されたデバイスタイプ
browservarcharブラウザ名
recorded_attimestamptz測定が記録された時刻

アップタイムモニタリング

uptime_checks

監視システムからの個別アップタイム確認結果。各行はウェブサイトへの単一のヘルスチェックpingを表します。

タイプ説明
website_iduuidウェブサイト識別子
checked_attimestamptzチェックが実行された時刻
is_upbooleanサイトが正常に応答したかどうか
status_codeintegerHTTPレスポンスステータスコード
response_time_msintegerレスポンスタイム(ミリ秒)
error_messagetextチェックが失敗した場合のエラーメッセージ
regionvarchar監視地域(例:us-east, eu-west, ap-south)

uptime_daily

日次アップタイム集計。個別チェックをクエリする代わりに、SLAレポートとトレンド分析に使用します。

タイプ説明
website_iduuidウェブサイト識別子
datedateカレンダー日付
uptime_percentagenumericアップタイム(パーセンテージ)(例:99.95)
avg_response_time_msinteger平均レスポンスタイム(ミリ秒)
incidents_countintegerダウンタイムインシデント数
checks_totalinteger実行されたチェックの総数

ユーザー行動

heatmap_data

グリッドオーバーレイで集計されたクリックおよびスクロールヒートマップデータ。各行は蓄積された相互作用数を持つグリッドセルを表します。

タイプ説明
website_iduuidウェブサイト識別子
page_pathvarcharこのヒートマップのページパス
heatmap_typevarcharタイプ:click, scroll, move
grid_xsmallint水平グリッド座標
grid_ysmallint垂直グリッド座標
hit_countintegerこのグリッドセル内の相互作用数
intensitynumeric正規化された強度値(0.0~1.0)

heatmap_sessions

セッションレベルのページ当たりのヒートマップ相互作用データの概要。

タイプ説明
website_iduuidウェブサイト識別子
page_urltextページの完全なURL
total_clicksinteger記録されたクリックの総数
total_movementsinteger記録されたマウス移動の総数
total_scroll_eventsinteger記録されたスクロールイベントの総数

replay_sessions

セッション再生記録メタデータ。各行はダッシュボードで再生できる記録されたブラウジングセッションを表します。

タイプ説明
website_iduuidウェブサイト識別子
visitor_idvarchar記録された訪問者
duration_msinteger総記録時間(ミリ秒)
total_eventsintegerキャプチャされたDOMイベント数
total_sizeinteger記録データサイズ(バイト)
started_attimestamptz記録が開始された時刻

frustration_events

検出されたユーザーフラストレーションシグナル。レイジクリック、デッドクリック、エラークリックを含みます。

タイプ説明
website_iduuidウェブサイト識別子
frustration_typevarcharタイプ:rage_click, dead_click, error_click, thrashed_cursor
page_urltextフラストレーションが検出されたページ
timestamptimestamptzイベントが発生した時刻

scroll_depth_stats

ページ当たりの集計スクロール深度統計。訪問者が各ページをどこまでスクロールするかを示します。

タイプ説明
website_iduuidウェブサイト識別子
page_pathvarcharページパス
depth_percentagesmallintスクロール深度バケット(例:25, 50, 75, 100)
reach_countintegerこの深度に達した訪問者数

session_history

エンゲージメントとコンバージョンメトリクス付きの完了したセッション概要。

タイプ説明
website_iduuidウェブサイト識別子
visitor_iduuid訪問者識別子
total_duration_secondsinteger総セッション継続時間(秒)
pages_viewedintegerセッションで表示されたページ数
bouncebooleantrue 訪問者が1ページ後に去った場合
convertedbooleantrue コンバージョンイベントがトリガーされた場合
conversion_valuenumericセッションの総コンバージョン値

B2B と企業

b2b_companies

ウェブサイトにアクセスする特定の企業。IPから企業への解決からのファームグラフィックデータで充実しています。

タイプ説明
idtext一意な企業識別子
nametext企業名
domaintext企業ウェブサイトドメイン
industrytext業界分類
employee_countinteger推定従業員数
revenue_rangetext推定年間収益範囲(例:$10M-$50M)

b2b_company_visits

企業レベルのビジット集計。company_id = id 上で b2b_companies とジョインして完全な企業の詳細を取得します。

タイプ説明
company_idtext企業への参照
website_iduuidウェブサイト識別子
total_visitsintegerこの企業からのビジット総数
total_page_viewsintegerこの企業からのページビュー総数
engagement_scorenumeric計算されたエンゲージメントスコア(0-100)
last_visittimestamptz最後のビジットのタイムスタンプ

マーケティングとキャンペーン

campaign_performance

日付ごとに集計されたUTMキャンペーンパフォーマンスメトリクス。マーケティングROI分析とキャンペーン比較に使用します。

タイプ説明
website_iduuidウェブサイト識別子
utm_sourcevarcharUTMソースパラメータ
utm_campaignvarcharUTMキャンペーン名
visitorsintegerこのキャンペーンからの訪問者数
conversionsinteger属性化されたコンバージョン数
revenuenumeric属性化された総売上
bounce_ratenumericバウンス率(小数)
datedateメトリクスの日付

gsc_keyword_data

GSC統合を介して同期されたGoogle Search Consoleキーワードパフォーマンスデータ。Google検索結果でのページのパフォーマンスを示します。

タイプ説明
website_iduuidウェブサイト識別子
querytext検索クエリ(キーワード)
clicksinteger検索結果からのクリック数
impressionsinteger検索結果に表示された回数
ctrnumericクリック率(小数)(例:0.034 = 3.4%)
positionnumeric検索結果での平均位置
datedate検索データの日付

カスタムイベント

custom_events

カスタムイベントAPIを介して送信されたユーザー定義トラッキングイベント。各行はオプションのプロパティと売上データを持つ単一のイベント発生を表します。

タイプ説明
website_iduuidウェブサイト識別子
event_namevarcharカスタムイベント名(例:signup, add_to_cart)
event_categoryvarcharグループ化用のイベントカテゴリ
visitor_iduuidイベントをトリガーした訪問者
propertiesjsonbイベントに添付されたカスタムキー値プロパティ
revenuenumericこのイベントに関連する売上価値
page_urltextイベントがトリガーされたページ

properties 列はJSONBです。properties->>'key_name' を使用して特定のプロパティをクエリします。例:WHERE properties->>'plan' = 'pro'

events

Zenovayトラッカーによって自動的にトラッキングされるシステムレベルイベント。ページビュー、クリック、フォーム送信、その他の組み込みイベントタイプを含みます。

タイプ説明
website_iduuidウェブサイト識別子
visitor_iduuid訪問者識別子
event_typetextイベントタイプ:pageview, click, form_submit, video_progress, file_upload, scroll, custom
event_nametext特定のイベント名
event_valuetextイベントに関連する文字列値
event_datajsonb追加の構造化イベントデータ
timestamptimestamptzイベントが発生した時刻

その他

chart_notes

特定の日付に添付されたダッシュボード注釈。これらは時系列チャート上のマーカーとして表示され、データトレンドのコンテキストを提供します。

タイプ説明
website_iduuidウェブサイト識別子
note_datedate注釈が添付されている日付
contenttext注釈テキストコンテンツ
show_on_chartbooleanこの注釈をダッシュボードチャートに表示するかどうか

alerts

指定された条件が満たされたときに通知をトリガーする設定されたアラートルール。

タイプ説明
website_iduuidウェブサイト識別子
alert_typetextアラートカテゴリ:traffic_spike, traffic_drop, error_rate, uptime, goal
nametext人間が読めるアラート名
conditionsjsonb構造化JSONとしてのアラートトリガー条件
statustextアラートステータス:active, paused, triggered

websites

ウェブサイト構成レコード。トラッキングされた各ウェブサイトは、設定とトラッキングコードを持つここにエントリを持ちます。

タイプ説明
iduuid一意なウェブサイト識別子(あらゆる場所で website_id として使用)
domainvarcharウェブサイトドメイン(例:example.com)
namevarcharウェブサイト表示名
is_activebooleanトラッキングが現在アクティブかどうか
tracking_codevarchar埋め込みスクリプト用の一意なトラッキングコード
timezonevarchar日付集計用のタイムゾーン(例:America/New_York)

クエリの例

コア分析

今月の訪問者数による上位10ページSQL
SELECT page_url, COUNT(*) as visits, AVG(time_on_page) as avg_time
FROM visitors
WHERE website_id = 'YOUR_WEBSITE_ID'
AND visited_at >= date_trunc('month', now())
GROUP BY page_url
ORDER BY visits DESC
LIMIT 10;
過去30日間の日次トラフィックトレンドSQL
SELECT date, visitors, page_views, bounce_rate
FROM analytics_daily
WHERE website_id = 'YOUR_WEBSITE_ID'
AND date >= now() - interval '30 days'
ORDER BY date ASC;

売上と支払い

今月のマーケティングチャネル別売上SQL
SELECT marketing_channel, SUM(amount) as total_revenue, COUNT(*) as transactions
FROM payments
WHERE website_id = 'YOUR_WEBSITE_ID'
AND status = 'succeeded'
AND created_at >= date_trunc('month', now())
GROUP BY marketing_channel
ORDER BY total_revenue DESC;
生涯価値による上位顧客SQL
SELECT email, name, total_revenue, subscription_status, subscription_plan
FROM identified_users
WHERE website_id = 'YOUR_WEBSITE_ID'
ORDER BY total_revenue DESC
LIMIT 20;

ゴールとファネル

今週のソース別ゴール完了SQL
SELECT utm_source, COUNT(*) as completions, SUM(completion_value) as total_value
FROM goal_completions
WHERE website_id = 'YOUR_WEBSITE_ID'
AND completed_at >= date_trunc('week', now())
GROUP BY utm_source
ORDER BY completions DESC;

エラーとパフォーマンス

発生数による解決されていない上位エラーSQL
SELECT error_type, error_message, occurrence_count, user_count, severity, last_seen
FROM error_groups
WHERE website_id = 'YOUR_WEBSITE_ID'
AND status = 'open'
ORDER BY occurrence_count DESC
LIMIT 10;
ページ別のCore Web Vitals平均SQL
SELECT page_url,
ROUND(AVG(lcp_value), 0) as avg_lcp_ms,
ROUND(AVG(cls_value), 3) as avg_cls,
ROUND(AVG(inp_value), 0) as avg_inp_ms
FROM performance_metrics
WHERE website_id = 'YOUR_WEBSITE_ID'
AND recorded_at >= now() - interval '7 days'
GROUP BY page_url
ORDER BY avg_lcp_ms DESC
LIMIT 10;

アップタイムモニタリング

過去30日間のアップタイム率SQL
SELECT date, uptime_percentage, avg_response_time_ms, incidents_count
FROM uptime_daily
WHERE website_id = 'YOUR_WEBSITE_ID'
AND date >= now() - interval '30 days'
ORDER BY date ASC;

ユーザー行動

フラストレーションイベントが最も多いページSQL
SELECT page_url, frustration_type, COUNT(*) as occurrences
FROM frustration_events
WHERE website_id = 'YOUR_WEBSITE_ID'
AND timestamp >= now() - interval '7 days'
GROUP BY page_url, frustration_type
ORDER BY occurrences DESC
LIMIT 10;
2分以上のセッション再生記録SQL
SELECT visitor_id, duration_ms / 1000 as duration_seconds, total_events, started_at
FROM replay_sessions
WHERE website_id = 'YOUR_WEBSITE_ID'
AND duration_ms > 120000
ORDER BY started_at DESC
LIMIT 20;

B2B と企業

あなたのサイトにアクセスする最もエンゲージされた企業SQL
SELECT c.name, c.industry, c.employee_count, v.total_visits, v.engagement_score, v.last_visit
FROM b2b_company_visits v
JOIN b2b_companies c ON c.id = v.company_id
WHERE v.website_id = 'YOUR_WEBSITE_ID'
ORDER BY v.engagement_score DESC
LIMIT 15;

マーケティングとキャンペーン

キャンペーンパフォーマンス比較SQL
SELECT utm_source, utm_campaign, SUM(visitors) as total_visitors,
SUM(conversions) as total_conversions, SUM(revenue) as total_revenue,
ROUND(AVG(bounce_rate), 3) as avg_bounce_rate
FROM campaign_performance
WHERE website_id = 'YOUR_WEBSITE_ID'
AND date >= now() - interval '30 days'
GROUP BY utm_source, utm_campaign
ORDER BY total_revenue DESC;
Google Search Consoleからの上位検索クエリSQL
SELECT query, SUM(clicks) as total_clicks, SUM(impressions) as total_impressions,
ROUND(AVG(ctr), 4) as avg_ctr, ROUND(AVG(position), 1) as avg_position
FROM gsc_keyword_data
WHERE website_id = 'YOUR_WEBSITE_ID'
AND date >= now() - interval '28 days'
GROUP BY query
ORDER BY total_clicks DESC
LIMIT 20;

カスタムイベント

売上を含むカスタムイベント頻度SQL
SELECT event_name, event_category, COUNT(*) as occurrences, SUM(revenue) as total_revenue
FROM custom_events
WHERE website_id = 'YOUR_WEBSITE_ID'
AND properties->>'source' IS NOT NULL
GROUP BY event_name, event_category
ORDER BY occurrences DESC
LIMIT 20;

その他

現在月のダッシュボード注釈SQL
SELECT note_date, content
FROM chart_notes
WHERE website_id = 'YOUR_WEBSITE_ID'
AND note_date >= date_trunc('month', now())
AND show_on_chart = true
ORDER BY note_date ASC;
アクティブなアラートルールSQL
SELECT name, alert_type, status, conditions
FROM alerts
WHERE website_id = 'YOUR_WEBSITE_ID'
AND status = 'active'
ORDER BY name;
このページは役に立ちましたか?