GoogleAnalytics4 データモデル
CData Excel Add-In for Google Analytics は Google Analytics 4 API をリレーショナルなテーブル、ビュー、ストアドプロシージャとしてモデル化します。 提供されているテーブルは、アカウント情報と Google Analytics クエリで利用可能なプロファイルの概要を示します。Google Analytics はさまざまな組み合わせでディメンションと指標をクエリすることをサポートしています。一般的な Google Analytics レポートに基づいたサンプルビューが提供されています。
必要な Dimensions と Metrics の任意の組み合わせに基づいて、独自のカスタムビューを作成することもできます。
本製品 は Google Analytics API を使用してサポートされているフィルタを処理します。その他のフィルタはクライアントサイドで 本製品 内部で処理されます。特定のテーブルまたはビューのページに特別な記載がない限り、クエリあたりのディメンションは最大 9 個、指標は最大 10 個という厳格な制限があります。
ビュー
ビュー は、Accounts、Properties、Events、Acquisitions、Engagement など、変更できないテーブルです。一般的に、読み取り専用で更新できないデータはビューとして表示されます。 2 種類のビューが利用できます：
- Base Views は、Engagements、Acquisitions、Active Users などをモデル化するために静的に定義されています。Base Views を使用してカスタムレポートを作成できます。デフォルトでは、これらのビューは全期間のデータを 1 行に集計して返します。すべての Base Views は GlobalAccessObject のサブセットであり、これはすべての利用可能なディメンションと指標のすべてのデータを含むビューです。
- Predefined Report Views は、Google Analytics UI で表示される内容を正確に再現した標準レポートのセットです。すべての Predefined Report Views はその名前に "report" が付加されています。デフォルトでは、これらのビューは全期間のデータを日別に分けて返します。
日付範囲と集計
日付範囲 WHERE 句で "Date" フィールドと次の演算子を使用して日付範囲を指定できます：=, <,>追加の定義済み日付フィールドも利用できます：
- week
- month
- quarter
month = '2022-05-01'
Note： ビューのデフォルトの時間間隔は 30 日間です。
集計
集計はデータを集約して要約するプロセスです。複数のレベルで集計を適用できます：
以下の例は集計クエリの構文を示しています：
SELECT Date,NewUsers, TotalUsers From Tech where StartDate = '2022-01-01' and EndDate = '2023-05-18'
SELECT Hour,NewUsers, TotalUsers From Tech where StartDate = '2022-01-01' and EndDate = '2023-05-18'
SELECT Day,NewUsers, TotalUsers From Tech where StartDate = '2022-01-01' and EndDate = '2023-05-18'
SELECT Week,NewUsers, TotalUsers From Tech where StartDate = '2022-01-01' and EndDate = '2023-05-18'
SELECT Month,NewUsers, TotalUsers From Tech where StartDate = '2022-01-01' and EndDate = '2023-05-18'
SELECT Year,NewUsers, TotalUsers From Tech where StartDate = '2022-01-01' and EndDate = '2023-05-18'
集計のコード例についての説明：
- Date：クエリ結果に日別データを返します。
- Hour：指定した日付範囲全体で時間別に集計されたデータを返します。例えば、2 年分のデータをクエリして "Hour" を選択すると、24 行のデータ（各時間 1 行）が返され、各時間について 2 年分のデータが集計されます。
- Day：指定した日付範囲全体で曜日別に集計されたデータを返します。例えば、2 年分のデータをクエリして "Day" を選択すると、7 行のデータ（各曜日 1 行）が返され、各曜日について 2 年分のデータが集計されます。
- Week：指定した日付範囲全体で週別に集計されたデータを返します。例えば、2 年分のデータをクエリして "Week" を選択すると、104 行のデータ（各週 1 行）が返され、各週についてデータが集計されます。
- Month：指定した日付範囲全体で月別に集計されたデータを返します。例えば、2 年分のデータをクエリして "Month" を選択すると、24 行のデータ（各月 1 行）が返され、各月についてデータが集計されます。
- Year：指定した日付範囲全体で年別に集計されたデータを返します。例えば、2 年分のデータをクエリして "Year" を選択すると、2 行のデータ（各年 1 行）が返され、年別にデータが集計されます。
Note： "Date" を指標として選択すると、他に選択した日付指標はすべて上書きされます。返されるのは日別データのみです。
ストアドプロシージャ
ストアドプロシージャ はデータソースに対する関数的なインターフェースです。これらを使用してデータソース内の情報を検索、更新、変更できます。