このガイドでは、Google アナリティクス スプレッドシート アドオンと Google ドライブ BigQuery コネクタを使用して、BigQuery から Google アナリティクスのカスタム レポートにアクセスする方法について説明します。
このガイドでは、Google アナリティクス スプレッドシート アドオンを使用してカスタム レポートを生成し、レポート結果シートを BigQuery 外部テーブルとして公開し、BigQuery からレポートデータをクエリする方法について説明します。
このガイドでは、ユーザー獲得レポートを例として使用していますが、これらの手順はどのレポートタイプにも適用できます。
ステップ 1: Google スプレッドシートでカスタム レポートを設定する
Google Workspace Marketplace から Google アナリティクス スプレッドシート アドオンをインストールします。
[拡張機能] → [Google アナリティクス用 GA4 レポート ビルダー] → [新しいレポートを作成] ダイアログを開きます。
アナリティクスのプロパティ、期間、レポート フィールドを指定して、レポートを設定します。
ユーザー獲得レポートでは、次のフィールドを使用します。
サイズ
firstUserDefaultChannelGroup
指標
eventCountkeyEventstotalRevenuenewUsersengagedSessionsengagementRate
[ディメンション フィルタ] フィールドと [指標フィルタ] フィールドは空のままにします。
正しいレポート設定の画像を次に示します。
[レポートを作成] をクリックして、現在のスプレッドシート ドキュメントにレポート構成を作成します。
[拡張機能] > [Google アナリティクス向け GA4 レポート ビルダー] > [レポートを実行] を選択してレポートを生成します。レポートの作成が完了すると、レポート名が付いた新しいタブが作成されます。
[拡張機能] > [Google Analytics 向け GA4 レポート ビルダー] > [レポートのスケジュール] ダイアログを開き、最新のレポートデータの定期的なポーリングを設定します。スケジュールを指定し、[保存] をクリックします。
ステップ 2: Google スプレッドシートのレポート ドキュメントを BigQuery 外部テーブルとして接続する
BigQuery では、Google スプレッドシートの外部データソースにリンクされた永続テーブルを作成できます。この機能を使用して、前の手順で作成した Google アナリティクス レポートのスプレッドシートを BigQuery の外部テーブルとして接続します。
この手順では、BigQuery のドキュメントの Google ドライブ外部テーブルを作成するガイドに沿って操作する必要があります。
Google Cloud コンソール
Google Cloud コンソールで、[BigQuery] ページを開きます。
[エクスプローラ] パネルでプロジェクトを開いて、データセットを選択します。
アクション オプションを開いて、[開く] をクリックします。
詳細パネルで [テーブルを作成] をクリックします。
[テーブルの作成] ページの [ソース] セクションで、次の操作を行います。
[テーブルの作成元] で [ドライブ] を選択します。
[ドライブの URI を選択] フィールドに、レポートを含む Google スプレッドシート ドキュメントのドライブの URI を
https://docs.google.com/spreadsheets/d/[file_id]の形式で入力します。[ファイル形式] で [Google スプレッドシート] を選択します。
[テーブルの作成] ページの [送信先] セクションで、次の操作を行います。
[データセット名] で該当するデータセットを選択し、[テーブル名] フィールドに BigQuery で作成するテーブルの名前を入力します。
[テーブルタイプ] が [外部テーブル] に設定されていることを確認します。
[シートの範囲] ボックスで、クエリを実行するシート名とセル範囲を指定します。レポートデータを含むスプレッドシートは次のようになります（セル範囲の場合は
sheet_name!top_left_cell_id:bottom_right_cell_id）。このサンプル レポートでは、範囲をUser acquisition report!A:Gとして指定できます。カスタム レポート名に対応するシートが範囲に指定されていることに注目してください。[スキーマ] セクションで、[自動検出] を有効にします。
[詳細オプション] セクションを開き、[スキップするヘッダー行] ボックスで省略する行数を指定します。この例では、レポートデータは行 15 から始まります。この値は入力ボックスに設定する必要があります。
[テーブルの作成] ページの [送信先] セクションで、次の操作を行います。
[データセット] で適切なデータセットを選択し、[テーブル] フィールドに BigQuery で作成するテーブルの名前を入力します。
[テーブルタイプ] が [外部テーブル] に設定されていることを確認します。
[テーブルを作成] をクリックします。
必要に応じて、自分のアカウントを選択して [許可] をクリックし、BigQuery クライアント ツールにドライブへのアクセスを許可します。
外部 BigQuery テーブルの構成画面の例を次に示します。
ステップ 3: BigQuery から Google スプレッドシートのレポート テーブルにクエリを実行する
これで、標準 BigQuery テーブルの場合と同じように Google スプレッドシート レポート テーブルに対してクエリを実行できます。ただし、外部データソースの制限は適用されます。
user_acquisition_reportテーブルを開いてスキーマを調べます。
[Query] をクリックします。提案されたクエリで
SELECT FROMをSELECT * FROMに変更してすべてのレポート フィールドを取得し、[クエリを実行] をクリックして外部テーブルに対してクエリを実行します。
次の例のクエリは、テーブル内のすべての列のデータのスニペットを出力します。
