一つの接続、あらゆる表面
GA4データが保存される場所
- 1 発信接続
- 0 受信ポート
- 読み取り専用 · 認証情報はそのまま保持されます
走る
- チーム、ベンダー、パートナーの皆様へ
-
エクセル アドイン · オンデマンド更新
-
グーグル シート アドオン · オンデマンド更新
-
ノヴァAI 平易な英語で質問する · テキストからSQLへ
-
データビューア ライブ結果を共有 · チーム、ベンダー、パートナー · あらゆるデバイス
- アプリとシステム向け
-
REST API JSONエンドポイント · OpenAPI 3.1
-
Power BI Power Query M
-
スケジュールされた同期 Google Sheets · Airtable · Baserow · SeaTable · Smartsheet · Anvil
- AIツール向け
-
AIアシスタント クロード · カーソル · MCPサーバー
- 人々に届けられる
-
アラートとレポート Slack · Discord · メール · Webhook
Query Streamsは、GA4プロパティを9つのSQLテーブル（トラフィック概要、トラフィックソース、ページ、イベント、エンゲージメント、地理情報、eコマース、トランザクション、およびアクティブユーザーテーブル）に変換します。これらのテーブルは、Microsoft Excel、Google Sheets、Power BI、MCP経由のAIアシスタント、およびRESTエンドポイントから読み取り可能です。BigQueryへのエクスポート、リンクされたプロジェクト、テーブルが表示されるまでの24時間待ちは不要です。サービスアカウントキーとプロパティIDがあれば、データはクエリ可能です。
- チーム、ベンダー、パートナーの皆様へ
-
GA4 から Excel Microsoft Excel · Excelアドイン
GA4のリアルタイム結果をワークシートに直接取り込み、必要に応じて更新できます。対応プラットフォームは、デスクトップ版Excel、Excel Online、Microsoft 365です。
GA4ガイド -
GA4からGoogleスプレッドシートへ Sheetsアドオン
サイドバーから保存済みのGA4クエリを実行し、結果をシートにドラッグ＆ドロップします。共有されている共同作業者は、各自でシートを更新できます。
GA4ガイド -
NovaにGA4について聞いてみてください Nova AI · テキストからSQLへ
平易な英語で質問してください。Novaは既にGA4のテーブルを把握しており、SQL文を作成して実行し、回答を説明してグラフ化します。クエリを作成する必要も、認証情報を提供する必要もありません。
Novaの仕組み -
GA4からデータビューアへ 結果共有 · チーム、ベンダー、パートナー · 電話、タブレット、デスクトップ
GA4のリアルタイム結果を、同僚、ベンダー、パートナーなど、誰とでも共有できます。共有されたグリッドはブックマーク可能で、スマートフォン、タブレット、デスクトップなど、どのデバイスで開いても常に最新の状態に戻ります。相手には結果のみが表示され、SQLや認証情報は一切表示されません。
データビューアの仕組み - アプリとシステム向け
-
GA4 REST API HTTPエンドポイント
GA4クエリを認証済みのJSONエンドポイントとして公開し、あらゆるアプリケーションから呼び出し可能です。OpenAPI 3.1仕様に準拠し、Postman、Insomnia、Hoppscotch用の既製コレクションも用意されています。データベースポートは開放されません。
REST APIの仕組み -
GA4からPower BIへ Power Query M
生成された Power Query M を Power BI アドバンスト エディターに貼り付けると、レポートは HTTPS 経由で GA4 のリアルタイムの結果を読み取ります。ODBC ドライバーもデータベース ポートも必要ありません。
Power BI の仕組み -
GA4からAirtableへ 自動化プラットフォーム
GA4の行をスケジュールに基づいてAirtableベースに同期したり、Airtable自動化スクリプト内で取得したりできます。
GA4ガイド -
GA4からBaserowへ 自動化プラットフォーム
GA4からBaserowテーブルにRESTエンドポイント経由でデータを供給します（セルフホスト型またはBaserowクラウド）。
GA4ガイド -
GA4からシーテーブルへ 自動化プラットフォーム
ファイルをエクスポートしたりデータベースを公開したりすることなく、SeaTableベースをGA4データで最新の状態に保つ。
GA4ガイド -
GA4からSmartsheetへ 自動化プラットフォーム
GA4の結果をSmartsheetグリッドにプッシュすることで、計画やレポートが先週のエクスポートデータではなく、ソースシステムから読み込まれるようにします。
GA4ガイド -
GA4からAnvilへ Anvil Works · アプリプラットフォーム
Anvil PythonアプリをGA4でバックアップするには、アプリ内にデータベース認証情報を埋め込むのではなく、RESTエンドポイントを使用します。
GA4ガイド - AIツール向け
-
GA4 MCPサーバー Claude、Cursor、およびMCPクライアント
AIアシスタントに、正しいSQLを作成するために必要なスキーマを含むGA4への読み取り専用アクセス権を付与します。チャットには認証情報は含めないでください。
GA4ガイド - 人々に届けられる
-
GA4のアラートとレポート Slack · Discord · メール · Webhook
GA4クエリをスケジュール設定して、結果をSlack、Discord、メール、または署名付きWebhookに送信するか、行数、しきい値、または変化率が設定した値を超えるまでメッセージを保留することができます。
アラートとレポートの仕組み
仕組み
5つのステップ、受信ファイアウォールの変更は不要
Googleサービスアカウントを作成し、GA4プロパティへの読み取りアクセス権を付与してください。
ネットワークエージェントをインストールし、サービスアカウントキーと数値プロパティIDを指定します。キーはエージェント上に保持されます。
同期する9つのテーブルから1つを選択してください。トラフィック概要、トラフィックソース、ページビュー、イベントはデフォルトで有効になっています。
ga4.traffic_sources、ga4.page_views、その他に対して通常のSQLクエリを記述するか、Novaに記述させることもできます。
Excel、Sheets、Power BI、MCP、またはRESTからデータを読み込み、サインアップと収益が保存されているあらゆるデータソースに接続します。
機能の詳細解説
GA4が提供するもの
BigQueryを経由せずに
GA4のデータをSQLに取り込む一般的な方法は、BigQueryプロジェクトをリンクし、エクスポートが開始されるのを待ち、ストレージ料金を支払い、その後ネストされたイベントテーブルをクエリするというものです。この方法は、これらの手順をすべて省略します。
- データはGA4独自のレポートAPIから取得されるため、エクスポートの設定は不要で、待機時間もありません。
- 初回同期時にGA4の発売日である2020年10月までさかのぼって履歴が読み込まれるため、設定日からではなく、最初から履歴が記録されます。
- 行は、名前付き列を持つ日単位の集計として到着します。 —日付、ソース、メディア、キャンペーン、チャネル、セッション、ユーザー、エンゲージメント率—ネストされたイベントの塊としてではなく、ネストを解除する必要のない形で表示されます。
- 完全なAPIレスポンスは、raw_data JSONカラムに格納されます。
9つのテーブル
- 交通量 — traffic_overview、traffic_sources、page_views、user_engagement。
- 観客 — 地理データ、イベント。
- 商取引 — eコマースの概要、取引。
- 今 — リアルタイムアクティブユーザー。
時計が2つあり、どちらのテーブルがどちらの時刻に動いているか
GA4にはバッチ処理側とリアルタイム処理側があり、それぞれ動作が異なります。この点を明確に理解しておくことが、信頼できるレポートと、後々議論の的となるレポートとの違いを生むのです。
- 8つのバッチテーブルは昨日までをカバーしています。GA4は1日分の数値を確定するのに1～2日かかるため、各増分処理では過去3日間のデータを再読み込みし、最初に取得したバージョンを固定するのではなく、数値が安定するまで待ちます。
- realtime_active_users は実際にライブです ― 30分間のローリングウィンドウ。クエリが該当した際にオンデマンドで更新され、30秒間の鮮度保持期間を持つ。
- その表は現状のスナップショットであり、履歴ではありません。つまり、現在サイトにアクセスしている人が誰なのかを示すものであり、昨日の午後4時に誰がアクセスしていたのかを示すものではありません。
すべてのAPIコネクタで共有されます
各APIコネクタの仕組み
- あなたのアカウントはテーブルになります エンドポイントは、主キーとインデックスを持つ型付きSQLテーブルにマッピングされるため、JSONをページングする代わりに、SELECT、JOIN、GROUP BYを記述します。
- 同期する項目と頻度は自分で選択できます。 各テーブルにはそれぞれ独自の間隔が設定されている場合と、間隔が設定されていない場合がある。ベンダーのAPIが対応している場合は、前回の実行以降に変更されたレコードのみが取得される。
- コピーはあなたのものです — それは、お客様のマシン上のエージェントと同じ場所にある、AES-256-GCMで暗号化されたDuckDBファイル内に存在します。当社のクラウド上にはありません。
- ベンダーはあなたからしか連絡を受けない エージェントはユーザー自身のネットワークから直接APIを呼び出すため、クエリストリームがクエリに応答する際にトークンは必要ありません。
知っておくと良い
- これは同期されたコピーであり、ライブプロキシではありません。 クエリは既に取得済みのデータを読み取るため、SQLの速度で処理が進み、APIのレート制限を消費することはありません。選択したテーブルでは、読み取り時に古い行を更新することも可能です。
- レート制限は尊重されます 各コネクタはベンダーが公表している制限値を十分に下回るペースで動作するため、レポートによって、そのコネクタを使用する他のすべてのアカウントが制限されることはありません。
- 何も捨てられない テーブルに名前が付けられていないフィールドは、クエリ可能なraw_data JSON列に保持されます。
- データベースに結合してください — 同じステートメント内で API テーブルと SQL Server テーブルを使用することは、ここでは通常のクエリであり、統合プロジェクトではありません。
クロスソースSQL
GA4を他のデータと連携させる
GA4はセッションの発信元は把握していますが、セッションの金額については何も知りません。データベースはアカウントを、決済処理システムは金額を把握しています。1つの明細書でこれら3つの情報を並べて表示できます。各ソースは実行可能な部分のみを実行し、結果をストリームで送信します。結合処理は中央で行われるため、ソース同士が直接やり取りしたり、データがコピーされたりすることはありません。
接続数3件・エージェント数3名
一つの声明
-- GA4からのセッション、データベースからのアカウント、Stripeからの収益
セレクト g.session_source、SUM(g.sessions) AS sessions、SUM(i.amount_due) AS invoiced
フロム ga4_site.ga4.トラフィックソース1 g
ジョイン pg_crm.一般顧客2 c ON c.utm_source = g.session_source
ジョイン 請求する.stripe.invoices3 i ON i.customer = c.stripe_id
GROUP BY g.session_source
ORDER BY 請求書記載のDESC;接続、スキーマ、テーブルの 3 つの部分で構成され、接続名はユーザーが付けた名前になります。これは例示用の列です。テーブルはユーザー独自のテーブルになります。バッチ GA4 テーブルは昨日まで実行されるため、このようなレポートの最新の日付は今日の前日になります。これは GA4 独自の最終処理ウィンドウであり、同期遅延ではありません。読み取り専用はすべての部分に適用されます。SELECT、WITH、EXPLAIN のみで、1 つのクエリで 1 つのソースが渡せるデータの量には上限があります。 フェデレーションクエリの仕組み
接続の詳細
GA4に必要なもの
- 認証
- エージェントが保持する、プロパティへの読み取りアクセス権を持つGoogleサービスアカウントキー。読み取り専用範囲。
- 財産
- 数値型のGA4プロパティID
- 手を伸ばして
- お客様のネットワークからGA4データAPIへの通信はHTTPSで行われます。受信は一切ありません。
- スキーマ
- ga4 — つまり、ga4.traffic_sources、ga4.page_views
- 表
- 9つのうち、デフォルトで有効になっているのは、traffic_overview、traffic_sources、page_views、eventsの4つです。
- 鮮度
- バッチテーブルは昨日まで実行され、GA4が最終処理を行うたびに過去3日間が再読み込みされます。
- 歴史
- 最初の同期で2020年10月1日に戻る
- ライブ更新
- realtime_active_usersのみ — 30分間のローリングウィンドウ、30秒間の鮮度ウィンドウ
- ローカルコピー
- エージェントと同じマシン上に、AES-256-GCMで暗号化されたDuckDBファイルがあります。
リアルタイムテーブルは、Googleがスナップショットで返す上位数百通りの組み合わせに制限されています。これは、このコネクタの制限ではなく、リアルタイムAPIの制限によるものです。1日全体のデータを確認するには、バッチテーブルを使用してください。
クロスソースクエリでは、3つの部分からなる参照の中央部分はga4です。トラフィックソースを読み取るga4_siteという接続は、ga4_site.ga4.traffic_sourcesと記述されます。
ベンダー資料： marketingplatform.google.com
よくある質問
Google Analytics 4に関する質問
クエリ ストリームを通じて Google Analytics 4 のデータを読み取ることができるツールはどれですか？
Excel、Google Sheets、MCP、REST API、Airtable、Baserow、SeaTable、Smartsheet、Anvil、Power BI、スケジュールされたアラートやレポートなど、すべてを1つの接続で利用できます。アカウントを一度接続すれば、すべてのインターフェースが同じ読み取り専用接続を読み取ることができます。ツールごとの設定やデータの複製は一切不要です。
Google Analytics 4アカウントへのファイアウォールポートを開放する必要がありますか？
いいえ。Query Streams Network Agentはネットワーク内で動作し、暗号化された単一の送信接続を開きます。受信トラフィックを監視するものはなく、VPNも不要で、アカウントは既存のファイアウォールルールを維持します。
クエリ ストリームは Google Analytics 4 のデータを変更することができますか？
いいえ。エージェントは実行時に読み取り専用を強制します。つまり、一度に1つのステートメント（SELECT文など）のみを実行します。認証情報はエージェント上に保持され、クエリ ストリームに送信されることはありません。
Query StreamsがGoogle Analytics 4に接続するために必要なものは何ですか？
到達可能なホスト、ロール、およびそのパスワード - エージェントがドライバーを保持するため、アカウントには何もインストールされません。認証: エージェントに保持されている、プロパティへの読み取りアクセス権を持つ Google サービス アカウント キー。読み取り専用スコープ。プロパティ: 数値の GA4 プロパティ ID。アクセス方法: ネットワークから GA4 データ API への HTTPS。受信はありません。スキーマ: ga4 - つまり、ga4.traffic_sources、ga4.page_views。
Google Analytics 4 を同じクエリ内で別のデータベースに結合することはできますか？
はい、それはフェデレーションクエリです。1つのステートメントで、Google Analytics 4と他の接続を同時に参照でき、connection.schema.table の形式で記述されます。各ソースは実行可能な部分のみを実行し、結果をストリームで返します。結合は中央で行われるため、ソース同士が接続されることはなく、何もコピーまたはスケジュールされません。読み取り専用はすべての部分（SELECT、WITH、EXPLAINのみ）に適用され、1つのクエリで1つのソースが渡せるデータ量には上限があります。フェデレーションクエリはプラン機能であり、フェデレーションクエリのページには現在のソースとサイズの制限が表示されます。
English 
Spanish 
German 
French 
Portuguese 
Japanese 
Korean 
Chinese 
Italian 
Dutch 
Indonesian 
Polish