CData Python Connector for Google Analytics

Build 26.0.9663

Google アナリティクスデータの取得

Google Analytics のデータはさまざまな指標(Sessions、Impressions、AdClicks など)に整理されており、さまざまなディメンション(Country、Month など)に対してクエリできます。指標とディメンションの有効な組み合わせは多数あります。本製品 は使いやすさのために、最もよく使用される組み合わせをテーブルとして公開しています。

また、本製品 では、Dimensions および Metrics カラムを使用する方法とカスタムスキーマを定義する方法の 2 つのアプローチにより、定義済みテーブルに含まれないものも含め、すべての有効な組み合わせをクエリできます。詳細については 高度なクエリ を参照してください。以下はデフォルトのテーブルを使い始めるためのガイドです。

ディメンションとメジャーの選択

ディメンションと指標は各テーブルで明確に定義されており、データモデル で確認できます。関心のある指標とディメンションを選択するだけです。 例えば、各月のセッション数を確認するには、Month ディメンションに対して Session 指標をクエリします。これにより各月 1 行、合計 12 行が返されます。

SELECT Sessions, Month FROM Traffic
各年の月を分けるには、クエリに month と year の両方のディメンションを含めます:
SELECT Sessions, Month, Year FROM Traffic

日付範囲

すべての Google Analytics レポートは特定の日付範囲をカバーします。StartDate と EndDate を未設定のままにした場合のデフォルトの動作は、過去 1 か月分のデータを取得することです。この動作を上書きするには、クエリ内で直接値を設定できます。例えば:

SELECT Sessions, Month, Year FROM Traffic WHERE StartDate = '90daysAgo' AND EndDate = 'Today'

Google Analytics API でサポートされる StartDate と EndDate の入力値は 'today'、'yesterday'、'NdaysAgo'(N は任意の数値)、および特定の日付です。v4 API 以降、フィルタに最大 2 つの個別の日付範囲を設定できます。

SELECT * クエリ

一般的なデータベーステーブルとは異なり、特定のテーブル内のすべての指標とディメンションを選択することはあまり有用ではありません。

Google Analytics では 1 つのクエリで最大 9 個のディメンションと 10 個の指標しか使用できないため、場合によってはこれが不可能なこともあります。

本製品 は SELECT * クエリをデフォルトの指標とディメンションのセットに対するリクエストとして解釈します。

これには、すべてのカラムを明示的に選択するクエリも含まれます。指標が 10 個未満のスキーマでは、すべての指標が返されます。

各スキーマのデフォルトフィールドについては、データモデル の各ビューのドキュメントを参照してください。

Copyright (c) 2026 CData Software, Inc. - All rights reserved.
Build 26.0.9663