接続の確立

Google Analytics への接続を追加

Google Analytics への接続を追加するには：

アプリケーションコンソールで、接続ページに移動します。
接続の追加パネルで、追加したい接続のアイコンを選択します。
Google Analytics アイコンが利用できない場合は、Add More アイコンをクリックしてCData サイトからGoogle Analytics コネクタをダウンロードおよびインストールします。

必須プロパティについては、設定タブを参照してください。

通常必須ではない接続プロパティについては、高度な設定タブを参照してください。

Google Analytics への接続

Google アナリティクス4

認証プロパティを追加する前に、次の接続プロパティを設定してください。

Schema：GoogleAnalytics4 に設定。
PropertyId：接続するGoogle アナリティクスのプロファイル、またはビューに設定。この値はProperties テーブルから取得できます。指定しない場合は、初めに返されたプロファイルが使われます。

Google Analytics への認証

Sync App は、認証にユーザーアカウントおよびGCP インスタンスアカウントの使用をサポートします。

以下のセクションでは、Google Analytics の利用可能な認証スキームについて説明します。

ユーザーアカウント（OAuth）
サービスアカウント（OAuthJWT）
GCP インスタンスアカウント

ユーザーアカウント（OAuth）

AuthScheme は、すべてのユーザーアカウントフローでOAuth に設定する必要があります。

Web アプリケーション

Web アプリケーション経由で接続する場合は、Google Analytics にカスタムOAuth アプリケーションを作成および登録する必要があります。それからSync App を使用してOAuth トークンの値を取得および管理します。カスタムアプリケーションについて詳しくは、カスタムOAuth アプリの作成を参照してください。

OAuth アクセストークンの取得

次の接続プロパティを設定し、OAuthAccessToken を取得します。

OAuthClientId：アプリケーション設定のクライアントId に設定。
OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。

続いてストアドプロシージャを呼び出し、OAuth 交換を完了します。

GetOAuthAuthorizationURL ストアドプロシージャを呼び出します。CallbackURL インプットをアプリケーション設定で指定したコールバックURL に設定します。ストアドプロシージャがOAuth エンドポイントのURL を返します。
ステップ1でストアドプロシージャが返したURL に移動します。カスタムOAuth アプリケーションにログインして、Web アプリケーションを認可します。認証されると、ブラウザはコールバックURL にリダイレクトします。
GetOAuthAccessToken ストアドプロシージャを呼び出します。AuthMode をWEB に、Verifier インプットをコールバックURL のクエリ文字列の"code" パラメータに設定します。

アクセストークンとリフレッシュトークンを取得すると、データに接続し、OAuth アクセストークンを自動または手動でリフレッシュすることができるようになります。

OAuth アクセストークンの自動リフレッシュ

ドライバーがOAuth アクセストークンを自動的にリフレッシュするようにするには、最初のデータ接続で次のように設定します。

InitiateOAuth：REFRESH に設定。
OAuthClientId：アプリケーション設定のクライアントId に設定。
OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。
OAuthAccessToken：GetOAuthAccessToken によって返されたアクセストークンに設定。
OAuthRefreshToken：GetOAuthAccessToken によって返されたリフレッシュトークンに設定。
OAuthSettingsLocation：Sync App がOAuth トークン値を保存する場所に設定。これは接続間で維持されます。

次回のデータ接続では、OAuthAccessToken およびOAuthRefreshToken の値は、OAuthSettingsLocation から取得されます。

OAuth アクセストークンの手動リフレッシュ

データ接続時に手動でOAuth アクセストークンをリフレッシュするために必要な値は、OAuth リフレッシュトークンのみです。

GetOAuthAccessToken によって返されたExpiresIn パラメータ値が経過した後に、RefreshOAuthAccessToken ストアドプロシージャを使用し、手動でOAuthAccessToken をリフレッシュします。次の接続プロパティを設定します。

OAuthClientId：アプリケーション設定のクライアントId に設定。
OAuthClientSecret：アプリケーション設定のクライアントシークレットに設定。

次に、RefreshOAuthAccessToken を呼び出し、OAuthRefreshToken にGetOAuthAccessToken によって返されたOAuth リフレッシュトークンを指定します。新しいトークンが取得できたら、OAuthAccessToken プロパティにRefreshOAuthAccessToken によって返された値を設定し、新しい接続をオープンします。

最後に、OAuth リフレッシュトークンを保存し、OAuth アクセストークンの有効期限が切れた後に手動でリフレッシュできるようにします。

ヘッドレスマシン

ヘッドレスマシンのユーザーアカウントでOAuth を使用するようにドライバーを設定するには、インターネットブラウザに対応した別の端末で認証する必要があります。

以下のオプションから選択します。
- オプション1：後述の「Verifier code を取得および交換」に従い、OAuthVerifier 値を取得します。
- オプション2：インターネットブラウザに対応したマシンにSync App をインストールし、後述の「OAuth 設定を転送」の説明に従い、通常のブラウザベースのフローで認証後にOAuth 認証値を転送します。
次に、ヘッドレスマシンからアクセストークンを自動的にリフレッシュするようにSync App を設定します。

オプション1：Verifier code を取得および交換

Verifier code を取得するには、OAuth Authorization URL で認証する必要があります。

インターネットブラウザに対応したマシンから認証してOAuthVerifier 接続プロパティを取得する方法は次のとおりです。

以下のオプションから選択します。
- 埋め込みOAuth アプリケーションを使用する場合は、Google Analytics OAuth endpoint をクリックし、ブラウザでエンドポイントを開きます。
- カスタムOAuth アプリケーションを使用するには、以下のプロパティを設定し、認証URL を作成します。
  - InitiateOAuth：OFF に設定。
  - OAuthClientId：アプリケーションの登録時に割り当てられたクライアントId に設定。
  - OAuthClientSecret：アプリケーションの登録時に割り当てられたクライアントシークレットに設定。
  次に、適切なCallbackURL を指定してGetOAuthAuthorizationURL ストアドプロシージャを呼び出します。ストアドプロシージャによって返されたURL をブラウザで開きます。
ログインして、Sync App にアクセス許可を与えます。すると、verifier code を含むコールバックURL にリダイレクトされます。
verifier code の値を保存します。後ほどこれをOAuthVerifier 接続プロパティに設定します。

次に、OAuth verifier code をOAuth リフレッシュトークンおよびアクセストークンと交換する必要があります。次のプロパティを設定します。

ヘッドレスマシンでは、次の接続プロパティを設定してOAuth 認証値を取得します。

InitiateOAuth：REFRESH に設定。
OAuthVerifier：verifier code に設定。
OAuthClientId：（カスタムアプリのみ）カスタムOAuth アプリケーション設定のクライアントId に設定。
OAuthClientSecret：（カスタムアプリのみ）カスタムOAuth アプリケーション設定のクライアントシークレットに設定。
OAuthSettingsLocation：これを設定すると、暗号化されたOAuth 認証値が指定された場所に永続化されます。

OAuth 設定ファイルが生成されたら、以下のように接続プロパティをリセットする必要があります。

InitiateOAuth：REFRESH に設定。
OAuthClientId：（カスタムアプリのみ）アプリケーションの登録時に割り当てられたクライアントId に設定。
OAuthClientSecret：（カスタムアプリのみ）アプリケーションの登録時に割り当てられたクライアントシークレットに設定。
OAuthSettingsLocation：暗号化されたOAuth 認証値を含む場所に設定。アクセストークンの自動リフレッシュを有効にするために、この場所がSync App に読み書きのアクセス許可を与えることを確認してください。

オプション2：OAuth 設定を転送

ヘッドレスマシンでの接続に先立ち、インターネットブラウザに対応したデバイスでドライバとの接続を作成し、インストールする必要があります。上述の「デスクトップアプリケーション」の説明に従って、接続プロパティを設定します。

「デスクトップアプリケーション」の手順が完了すると、生成された認証値は、OAuthSettingsLocation で指定された場所に暗号化されて書き込まれます。デフォルトのファイル名はOAuthSettings.txt です。

接続が正常にテストされたら、OAuth 設定ファイルをヘッドレスマシンにコピーします。

ヘッドレスマシンで、次の接続プロパティを設定し、データに接続します。

InitiateOAuth：REFRESH に設定。
OAuthClientId：（カスタムアプリのみ）アプリケーションの登録時に割り当てられたクライアントId に設定。
OAuthClientSecret：（カスタムアプリのみ）アプリケーションの登録時に割り当てられたクライアントシークレットに設定。
OAuthSettingsLocation：OAuth 設定ファイルの場所に設定。アクセストークンの自動リフレッシュを有効にするために、この場所がSync App に読み書きのアクセス許可を与えることを確認してください。

GCP インスタンスアカウント

GCP 仮想マシン上で実行している場合は、Sync App は仮想マシンに関連付けられたサービスアカウントを使用して認証できます。このモードを使用するには、AuthScheme をGCPInstanceAccount に設定します。

OAuth のスコープおよびエンドポイント

Google Analytics に必要なスコープおよびエンドポイントドメイン

Google Analytics と連携する場合、アプリケーションはAPI とやりとりするために特定の権限が必要です。

これらの権限はアクセススコープによって定義され、アプリケーションがアクセス可能なデータと実行可能なアクションを決定します。

このトピックでは、Google Analytics プロバイダーに必要なアクセススコープとエンドポイントドメインについての情報を提供します。

スコープについて

スコープは、ユーザーのデータへのアプリケーションによるアクセスを制限するための手段です。これは、アプリケーションがユーザーに代わって実行できる特定のアクションを定義します。

例えば、読み取り専用スコープではアプリケーションにデータの閲覧を許可し、フルアクセススコープではデータの変更を許可することができます。

Google Analytics に必要なスコープ


スコープ	説明
googleapis.com/auth/analytics.readonly	Google Analytics API への読み取り専用アクセス。利用可能な値は、NONE、CONSENT、およびデフォルトのSELECT ACCOUNT です。

エンドポイントドメインについて

エンドポイントドメインとは、アプリケーションが認証、レコードの取得、その他の重要な操作を実行するために通信する必要がある特定のURL を指します。

これらのドメインを許可することで、アプリケーションとAPI 間のネットワークトラフィックがファイアウォールやセキュリティ設定によってブロックされることがなくなります。

Note： ほとんどのユーザーは特別な設定をする必要はありません。許可リストは通常、送信ネットワークトラフィックの制限など、厳格なセキュリティ対策が施された環境でのみ必要となります。

Google Analytics に必要なエンドポイントドメイン


ドメイン	常に必須	説明
accounts.google.com	TRUE	OAuth に使用するドメイン。
analyticsadmin.googleapis.com	FALSE	このドメインは、Schema=GoogleAnalytics4（デフォルト）の場合に必要です。

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

Google アナリティクスデータは、さまざまな指標（セッション、インプレッション、AdClicks など）に分類され、さまざまなディメンション（国、月など）でクエリすることができます。有効な指標とディメンションの組み合わせは多数あります。Sync App は、最もよく使用される組み合わせを使いやすくテーブルとして公開しています。

また、Sync App は、2つの方式で、事前定義されたテーブルに含まれない組み合わせであっても、有効なすべての組み合わせをクエリできるようにしています。ディメンション列と指標列を使用する方法と、カスタムスキーマを定義する方法です。詳細については、高度なクエリを参照してください。以下に、まずデフォルトのテーブルを使用する方法を示します。

ディメンションおよび指標の選択

ディメンションおよび指標は各テーブルに明確に定義されており、データモデルで参照できます。興味のある指標およびディメンションを選択してください。例えば、月ごとのセッション数を検索するには、月ディメンションに対してセッション指標をクエリします。これにより、12の行（月ごとに1つ）が返されます。

SELECT Sessions, Month FROM Traffic

各年を各月で分割するには、クエリに月と年の両方のディメンションを含めます。

SELECT Sessions, Month, Year FROM Traffic

日付範囲

すべてのGoogle アナリティクスのレポートは特定の日付範囲をカバーしています。デフォルトの動作では、StartDate およびEndDate の入力が設定されていない場合、最後の月のデータが取得されます。この動作をオーバーライドするには、値を直接クエリに設定します。次に例を示します。

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 * Query

通常のデータベーステーブルとは異なり、特定のテーブルですべての指標およびディメンションを選択しても、あまり役には立ちません。

Google アナリティクスでは、1つのクエリでディメンションを9つまで、指標を10までしか指定できないため、すべてを選択することができない場合もあります。

Sync App は、SELECT * クエリをデフォルトの指標とディメンションのセットに対する要求として解釈します。

これは、明示的にすべての列を選択しているクエリにも適用されます。指標が10未満のスキーマの場合は、すべての指標が返されます。

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

高度なクエリ

Google Analytics には、数多くの指標やディメンションがテーブル定義に用意されています。このため、この製品に付属するテーブル定義には、最もよく使用される指標とディメンションの組み合わせだけがリストされています。このような設計選択の代替として、2つの方法が提供されています。すなわち、ディメンション列と指標列を使用してデフォルトテーブルに含まれていないフィールドを要求するか、独自のテーブルを定義することができます。

ディメンション列と指標列の使用

既存のテーブルに対して追加のディメンションまたは指標をリクエストするには、カスタムスキーマを定義するアプローチが推奨されますが、WHERE 句にディメンションおよび指標入力を設定することもできます。どちらの入力もカンマ区切りリストを受け取るため、複数のフィールドを一度に指定できます。これらの値は、指定した順序で、対応するディメンションおよび指標列に返されます。例えば、次のクエリは、Trafficテーブルでセッション、目標1コンバージョン率、および目標1達成数をクエリし、これらの指標をユーザー年齢層ディメンションでグループ化します。

SELECT Sessions, Dimensions, Metrics FROM Traffic WHERE Dimensions='UserAgeBracket' AND Metrics='Goal1ConversionRate,Goal1Completions'

上のクエリの結果では、各行のディメンションフィールドにUserAgeBracket の値が返されます。指標フィールドには、目標1に対して要求した指標を含むカンマ区切り値が含まれます。

高度な機能

このセクションでは、Google Analytics Sync App の高度な機能を厳選して説明します。

ユーザー定義ビュー

Sync App はユーザー定義ビューの使用をサポートします。これは事前設定されたユーザー定義クエリによって内容が決定される仮想テーブルです。このビューは、ドライバーに発行されるクエリを直接制御できない場合に有効です。カスタムビューの作成と設定の概要については、ユーザー定義ビューを参照してください。

SSL の設定

SSL の設定を使用して、Sync App が証明書のネゴシエーションをどのように扱うかを調整します。さまざまな証明書形式を選択できます。詳しくは、「接続文字列オプション」にあるSSLServerCert プロパティを参照してください。

ファイアウォールとプロキシ

Windows プロキシとHTTP プロキシを含むファイアウォールとプロキシに合致するようSync App を設定します。トンネル接続を設定することもできます。

クエリ処理

Sync App は、Google Analytics にできるだけ多くのSELECT ステートメント処理をオフロードし、残りのクエリをクライアント側のインメモリで処理します。

詳しくは、クエリ処理を参照してください。

ログ

CData ログを調整するために使用可能な設定の概要については、ログを参照してください。基本的なロギングに必要なのは2つの接続プロパティだけですが、より詳細なロギングをサポートする多くの機能があり、LogModules 接続プロパティを使用してロギングする情報のサブセットを指定することができます。

SSL の設定

SSL 設定のカスタマイズ

デフォルトでは、Sync App はサーバーとのTLS のネゴシエーションを試みます。サーバー証明書は、デフォルトのシステム信頼済み証明書ストアで検証されます。SSLServerCert 接続プロパティを使用して、証明書の検証方法をオーバーライドできます。

別の証明書を指定するには、SSLServerCert 接続プロパティを参照してください。

ファイアウォールとプロキシ

Firewall またはProxy 経由の接続

HTTP プロキシ

HTTP プロキシへの認証には、以下のように設定します。

ProxyServer：HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
ProxyPort：プロキシサーバーが起動しているTCP ポート。
ProxyAuthScheme：プロキシサーバーに対して認証する際にSync App が使用する認証方法。
ProxyUser：プロキシサーバーに登録されているユーザーアカウントのユーザー名。
ProxyPassword：ProxyUser に紐付けられたパスワード。

その他のプロキシ

次のプロパティを設定します。

プロキシベースのファイヤーウォールを使用するには、FirewallType、FirewallServer、およびFirewallPort を設定します。
接続をトンネルするには、FirewallType をTUNNEL に設定します。
認証するには、FirewallUser とFirewallPassword を設定します。
SOCKS プロキシへの認証には、さらにFirewallType をSOCKS5 に設定します。

データモデル

CData Sync App は、Google Analytics エンティティをリレーショナルテーブル、ビュー、およびストアドプロシージャにモデル化します。提供されるテーブルには、ユーザーのアカウント情報およびGoogle アナリティクスクエリで使用できるプロパティの概要が示されます。Google アナリティクスを使用すると、ディメンションおよび指標をさまざまな組み合わせでクエリすることができます。一般的なGoogle アナリティクスレポートに基づいて、いくつかのサンプルビューが用意されています。また、必要に応じてディメンションおよび指標を任意に組み合わせて、独自のカスタムビューを作成することもできます。

このセクションでは、API の制限および要件について説明します。既定のSupportEnhancedSQL 機能を使って、これらの制限の大半を回避できます。

追加スキーマの作成

CreateCustomSchema ストアドプロシージャを使用すると、ディメンションと指標を独自に組み合わせて、簡単に新しいスキーマファイルを生成できます。このプロシージャは、ディメンションおよび指標のカンマ区切りリストとTableName を受け取り、Sync App で読み取り可能なスキーマファイルを構築します。リスト内の各ディメンションまたは指標の名前は、Google アナリティクスに含まれる値に基づきます（"ga:" プレフィックスなし）。次に例を示します。

Dimensions=UserType,SessionCount

Metrics=Users,PercentNewSessions

Location 接続プロパティが設定されている場合、ファイルはそのフォルダに出力されます。そうでない場合は、OutputFolder 入力を使用して出力フォルダを指定します。これらの新しいファイルをクエリするには、Location 接続プロパティを、新しいスキーマファイルを含むフォルダを設定します。

Google Analytics 4 API の使用

Google Analytics 4 API で利用可能なエンティティについては、GoogleAnalytics4 データモデルを参照してください。

GoogleAnalytics4 データモデル

CData Sync App は、Google Analytics 4 API をリレーショナルテーブル、ビュー、およびストアドプロシージャとしてモデル化します。提供されるテーブルには、ユーザーのアカウント情報およびGoogle アナリティクスクエリで使用できるプロファイルの概要が示されます。Google アナリティクスは、ディメンションおよび指標のクエリをさまざまな組み合わせでサポートしています。一般的なGoogle アナリティクスレポートに基づいて、いくつかのサンプルビューが用意されています。

また、必要に応じてディメンションおよび指標を任意に組み合わせて、独自のカスタムビューを作成することもできます。このセクションでは、API の制限および要件について説明します。既定のSupportEnhancedSQL 機能を使って、これらの制限の大半を回避できます。ただし、特定のテーブルやビューのページで別途明記されていない限り、クエリごとに9ディメンションと10指標の厳格な制限が設けられています。

ビュー

ビューは、Accounts、Properties、Events、Acquisitions、Engagement などの変更ができないテーブルです。一般的には、Read-only で更新が不可能なデータはビューとして表されます。次の2種類のビューが用意されています。

Base Views は、Engagements、Acquisitions、Active Users などを静的にモデル化するように定義されています。ベースビューを使用してカスタムレポートを作成できます。デフォルトでは、これらのビューはすべての時間のデータを1つの行に集計して返します。すべてのベースビューはGlobalAccessObject のサブセットであり、利用可能なすべてのディメンションと指標のすべてのデータを含むビューです。
Predefined Report Views は、Google Analytics のUI で表示される内容を正確に模倣した標準レポートのセットです。すべてのPredefined Report Views の名前には"report" が付加されています。デフォルトでは、これらのビューは、日ごとの内訳を持つすべての時間のデータ返します。

日付範囲と集計

日付範囲 WHERE 句では、"Date" フィールドで演算子（=、<、>）を使用して日付範囲を指定できます。

その他の定義済み日付フィールドも利用可能です：

week
month
quarter

これらの時間間隔でフィルタリングを行う場合、= 演算子を使用して、期間の最初の日の日付を指定できます。異なる日付を指定するとエラーが返されます。例えば、2022年の5月を指定するには、その月の初日を指定して、次のように使用します。

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" を選択すると、2年分のデータが時間ごとに集計された24行のデータ（1時間ごとに1行）が返されます。
Day：指定した日付範囲で日付ごとに集計されたデータを返します。例えば、2年分のデータをクエリして"Day" を選択すると、2年分のデータが曜日ごとに集計された７行のデータ（1曜日ごとに1行）が返されます。
Week：指定した日付範囲で週ごとに集計されたデータを返します。例えば、2年分のデータをクエリして"Week" を選択すると、2年分のデータが週ごとに集計された104行のデータ（1週ごとに1行）が返されます。
Month：指定した日付範囲で月ごとに集計されたデータを返します。例えば、2年分のデータをクエリして"Month" を選択すると、2年分のデータが月ごとに集計された24行のデータ（1月ごとに1行）が返されます。
Year：指定した日付範囲で年ごとに集計されたデータを返します。例えば、2年分のデータをクエリして"Year" を選択すると、2年分のデータが年ごとに集計された2行のデータ（1年ごとに1行）が返されます。

NOTE： 指標として"Date" を選択すると、選択した他の日付指標がオーバーライドされます。日次データのみが返されます。

ストアドプロシージャ

ストアドプロシージャは、データソースのファンクションライクなインターフェースです。これらを使用して、データソース内の情報を検索、更新、および変更できます。

サーバーサイドフィルタリング

完全修飾クエリは、OR 演算子とAND 演算子の両方をサポートしています。OR 演算子は、ディメンションまたは指標のフィルタリングでAND 演算子と組み合わされる場合にのみ、同じカラムで使用できます。 OR 演算子を異なるカラムでAND 演算子と組み合わせて使用した場合、予期しない結果が生じる可能性があります。例えば、次のクエリは予期しない結果を返す可能性があります。

 SELECT * FROM [Acquisitions] WHERE [StartDate] = '2023-03-22' AND [EndDate] = '2023-03-22' AND [PagePath] LIKE '%as' OR [Country] LIKE 'US'

以下に、有効なクエリの例を示します。

 SELECT * FROM [Acquisitions] WHERE [StartDate] = '2023-03-22' AND [EndDate] = '2023-03-22' AND ([Country] LIKE 'US' OR [Country] LIKE '%In')

 SELECT * FROM [Acquisitions] WHERE [StartDate] = '2023-03-22' AND [EndDate] = '2023-03-22' OR [PagePath] LIKE '%as'

 SELECT * FROM [Acquisitions] WHERE [PagePath] LIKE '%as' OR  [PagePath] LIKE 'A' OR [Country] LIKE '%In'

 SELECT * FROM [Acquisitions] WHERE [PagePath] LIKE '%as' AND [Country] LIKE '%In'

 SELECT * FROM [Acquisitions] WHERE [PagePath] LIKE '%as' AND ([Country] LIKE 'India' OR [Country] LIKE '%US')

 SELECT * FROM [Tech] WHERE [StartDate] = '2021-01-01' AND [EndDate] = '2021-05-18' AND [NewUsers] >= 26 AND [NewUsers] < 35 AND ([Browser] IN ('Chrome', 'Edge') OR [Browser] = 'Edge')

 SELECT * FROM [TechDeviceModelReport] WHERE [Date] >= '2020-05-13' AND [Date] <= '2023-06-13' AND [DeviceModel] != '(not set)' AND [DeviceModel] != '(test)' AND ([NewUsers] = 15 OR [NewUsers] = 20)

 SELECT * FROM [Tech] WHERE [StartDate] = '2017-01-01' AND [EndDate] = '2023-05-02' AND CONTAINS ([Browser], 'ed') OR CONTAINS ([Browser], 'ch')

ビュー

ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。

クエリは、ビューに対して通常のテーブルと同様に実行することができます。

Google Analytics Connector for CData Sync ビュー


Name	Description
Accounts	Lists all Accounts to which the user has access.
AccountSummaries	Lists summaries of all Accounts to which the user has access.
Acquisitions	A base view that retrieves Acquisitions data.
AcquisitionsFirstUserCampaignReport	A predefined view that retrieves Acquisitions first user Campaign data.
AcquisitionsFirstUserGoogleAdsAdGroupNameReport	A predefined view that retrieves user Acquisitions first user google ads ad group name data.
AcquisitionsFirstUserGoogleAdsNetworkTypeReport	A predefined view that retrieves Acquisitions first user google ads ad network type platform data.
AcquisitionsFirstUserMediumReport	A predefined view that retrieves Acquisitions first user medium data.
AcquisitionsFirstUserSourceMediumReport	A predefined view that retrieves Acquisitions first user source medium data.
AcquisitionsFirstUserSourcePlatformReport	A predefined view that retrieves Acquisitions first user source platform data.
AcquisitionsFirstUserSourceReport	A predefined view that retrieves Acquisitions first user source data.
AcquisitionsSessionCampaignReport	A predefined view that retrieves Acquisitions session campaign report data.
AcquisitionsSessionDefaultChannelGroupingReport	A predefined view that retrieves Acquisitions session default channel grouping report data.
AcquisitionsSessionMediumReport	A predefined view that retrieves Acquisitions session medium report data.
AcquisitionsSessionSourceMediumReport	A predefined view that retrieves Acquisitions session source medium report data.
AcquisitionsSessionSourcePlatformReport	A predefined view that retrieves Acquisitions session source platform report data.
AcquisitionsSessionSourceReport	A predefined view that retrieves Acquisitions session source report data.
ActiveUsers	A base view that retrieves Active Users data.
DemographicAgeReport	A predefined view that retrieves Demographics UserAgeBracket data.
DemographicCityReport	A predefined view that retrieves Demographics City data.
DemographicCountryReport	A predefined view that retrieves Demographics Country data.
DemographicGenderReport	A predefined view that retrieves Demographics UserGender data.
DemographicInterestsReport	A predefined view that retrieves Demographics BrandingInterest data.
DemographicLanguageReport	A predefined view that retrieves Demographics Language data.
DemographicRegionReport	A predefined view that retrieves Demographics Region data.
Demographics	A base view that retrieves Demographics data.
EcommPurchasesItemBrandReport	A predefined view that retrieves Ecommerce purchase item brand data.
EcommPurchasesItemCategory2Report	A predefined view that retrieves Ecommerce purchase item category data.
EcommPurchasesItemCategory3Report	A predefined view that retrieves Ecommerce purchase item category data.
EcommPurchasesItemCategory4Report	A predefined view that retrieves Ecommerce purchase item category data.
EcommPurchasesItemCategory5Report	A predefined view that retrieves Ecommerce purchase item category data.
EcommPurchasesItemCategoryReport	A predefined view that retrieves Ecommerce purchase item category data.
EcommPurchasesItemCategoryReportCombined	A predefined view that retrieves Ecommerce purchase item category data.
EcommPurchasesItemIdReport	A predefined view that retrieves Ecommerce purchase item data.
EcommPurchasesItemNameReport	A predefined view that retrieves Ecommerce purchase item data.
Engagement	A base view that retrieves Engagement data
EngagementContentGroupReport	A predefined view that retrieves Engagement Content Group Report data.
EngagementConversionsReport	A predefined view that retrieves Engagement conversions data.
EngagementEventsReport	A predefined view that retrieves Engagement events data.
EngagementPagesPathReport	A predefined view that retrieves Engagement Pages path report data.
EngagementPagesTitleAndScreenClassReport	A predefined view that retrieves Engagement Pages title and screen class data.
EngagementPagesTitleAndScreenNameReport	A predefined view that retrieves Engagement Pages Title And ScreenName data.
Events	A base view that retrieves Event data
GamesReporting	A base view that retrieves Games Reporting data.
GlobalAccessObject	Retrieves data for all the available dimensions and metrics.
KeyEvents	A base view that retrieves KeyEvents data
MetaData	Retrieves metadata information for standard and custom dimensions / metrics.
Monetization	A base view that retrieves Monetization data.
MonetizationPublisherAdsAdFormatReport	A predefined view that retrieves publisher ads page ad format data.
MonetizationPublisherAdsAdSourceReport	A predefined view that retrieves publisher ads ad source data.
MonetizationPublisherAdsAdUnitReport	A predefined view that retrieves publisher ads ad unit data.
MonetizationPublisherAdsPagePathReport	A predefined view that retrieves publisher ads page path data.
Properties	Lists all Properties to which the user has access.
PropertiesAccessBindings	Lists all access bindings on an account or property. Requires one of the following OAuth scopes: https://www.googleapis.com/auth/analytics.manage.users.readonly https://www.googleapis.com/auth/analytics.manage.users
PropertiesAudiences	Lists Audiences on a property.
PropertiesDataStreams	Lists all data streams under a property to which the user has access. Attribute Parent (e.g: 'properties/123') or Name (e.g: 'properties/123/webDataStreams/456') is required to query the table.
PropertiesFireBaseLinks	Lists all FirebaseLinks on a property to which the user has access.
PropertiesGoogleAdsLinks	Lists all GoogleAdsLinks on a property to which the user has access.
PropertiesKeyEvents	Returns a list of Key Events in the specified parent property.
ScreenPageViews	A base view that retrieves ScreenPage data
Tech	A base view that retrieves Tech data.
TechAppVersionReport	A predefined view that retrieves Tech App Version data.
TechBrowserReport	A predefined view that retrieves Tech Browser data.
TechDeviceCategoryReport	A predefined view that retrieves Tech Device Category data.
TechDeviceModelReport	A predefined view that retrieves Tech Device Model data.
TechOSSystemReport	A predefined view that retrieves Tech os system data.
TechOSVersionReport	A predefined view that retrieves Tech Os version data.
TechPlatformDeviceCategoryReport	A predefined view that retrieves Tech platform device category data.
TechPlatformReport	A predefined view that retrieves Tech platform data.
TechScreenResolutionReport	A predefined view that retrieves Tech Screen Resolution data.

Accounts

Lists all Accounts to which the user has access.

Table Specific Information

Select

The Accounts table exposes every account the user has access to. The provider uses the GoogleAnalytics4 API to process WHERE clause conditions built with the Name column, which supports the = operator.

The following query is processed server-side:

	SELECT * FROM Accounts WHERE Name = 'accounts/54516992'

The rest of the filter is executed client-side within the provider.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
CreateTime	Datetime				Time the account was created.
DisplayName	String				display name for the account.
Name	String				Account name.
RegionCode	String				Country for the account.
UpdateTime	Datetime				Time the account was last modified.
Deleted	Boolean				Indicates whether this Account is soft-deleted or not.

AccountSummaries

Lists summaries of all Accounts to which the user has access.

Table Specific Information

Select

The AccountSummaries table exposes summaries of all accounts accessible by the caller. The following query is processed server-side:

    SELECT * FROM AccountSummaries

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
Account	String				Account name referred to by this account summary.
DisplayName	String				display name for the account referred to by this account summary.
Name	String				Account summary name.
Propertysummaries	String				Summaries for child accounts of the specific account.

Acquisitions

A base view that retrieves Acquisitions data.

Table Specific Information

Select

Retrieves data for Acquisitions report. At least one metric must be specified in the query. In the query you can also specify up to 9 dimensions.

The following is an example query:

	SELECT Conversions, NewUsers FROM Acquisitions

CustomChannelGroups are added as dimension columns. You can query customChannelGroup in the following way:

 SELECT SessionCustomChannelGroupName, FirstGroupCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM Acquisitions

NOTE: CustomChannelGroupName is for reference purposes only. The exact value depends on the channelGroupName added.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
Date	Date	True			The date of the session formatted as YYYYMMDD.
Year	Integer	True			The year of the session. A four-digit year from 2005 to the current year.
Month	Integer	True			The month of the session. An integer from 01 to 12.
Week	Integer	True			The week of the session. A number from 01 to 53. Each week starts on Sunday.
Day	Integer	True			The day of the month. A number from 01 to 31.
DayOfWeekName	String	True			The day of the week in English. This dimension has values of Sunday, Monday, etc.
IsoWeek	Integer	True			ISO week number, where each week starts on Monday Example values include 01, 02, 53.
IsoYear	Integer	True			The ISO year of the event. For details, see Example values include 2022 2023.
IsoYearIsoWeek	Integer	True			The combined values of isoWeek and isoYear. Example values include 201652 and 201701.
YearMonth	Integer	True			The combined values of year and month. Example values include 202212 or 202301.
YearWeek	Integer	True			The combined values of year and week. Example values include 202253 or 202301.
Hour	Integer	True			An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time.
FirstUserGoogleAdsAdGroupName	String	True			The Ad Group Name in Google Ads that first acquired the user.
FirstUserGoogleAdsAdNetworkType	String	True			The advertising network that first acquired the user.
FirstUserCampaignName	String	True			Name of the marketing campaign that first acquired the user.
FirstUserGoogleAdsCreativeId	String	True			The campaign creative ID that first acquired the users.
FirstUserMedium	String	True		True	The medium that first acquired the user to the website or app.
FirstUserSource	String	True			The source that first acquired the user to the website or app.
SessionCampaignName	String	True			Campaign that referred the user's session.
SessionDefaultChannelGroup	String	True			Channel groupings are rule-based definitions of your traffic sources. These default system definitions reflect Analytics' current view of what constitutes each channel.
SessionMedium	String	True			Channel that referred the user's session.
SessionSource	String	True			The source that initiated a session on your website or app.
EventName	String	True			The name of the event.
BrandingInterest	String	True			Interests demonstrated by users who are higher in the shopping funnel. Users can be counted in multiple interest categories.
Country	String	True			Country from which user activity originated.
City	String	True			City from which user activity originated.
Language	String	True			Language setting for the device from which activity originated.
UserAgeBracket	String	True			User age brackets.
UserGender	String	True			User gender.
Region	String	True			Geographic region from which activity originated.
UnifiedScreenClass	String	True			The page title (web) or screen class (app) on which the event was logged.
PagePath	String	True			The portion of the URL between the hostname and query string for web.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EngagedSessionsPerUser	Decimal	False	True		Average number of engaged sessions per user.
EventCount	Integer	False	True		The count of events.
EventsPerSession	Decimal	False	True		The average number of events per session.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
Sessions	Integer	False	True		The number of sessions that began on the site or app.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
UserEngagementDuration	Bigint	False	False		The total amount of time (in seconds) the website or app was in the foreground of users device.
ScreenPageViews	Integer	False	False		The number of app screens or web pages the users viewed. Repeated views of a single page or screen are counted.
EventCountPerUser	Decimal	False	False		Average number of events triggered by each user.
SessionsPerUser	Decimal	False	False		The average number of sessions per user (Sessions divided by Active Users).
StartDate	String				Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).
EndDate	String				End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

AcquisitionsFirstUserCampaignReport

A predefined view that retrieves Acquisitions first user Campaign data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
FirstUserGoogleAdsAdGroupName supports the following operator: =
Date supports the following operators: =, >=, <=, <, >

For example, the following queries are processed server-side:

SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE PropertyId = 342020667
SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE FirstUserGoogleAdsAdGroupName = 'Test' 
SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE Date = '01/05/2023' 
SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE PropertyId = 342020667  AND FirstUserGoogleAdsAdGroupName = 'Test' AND Date = '01/05/2023'
SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE Date >= '01/01/2022'
SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE Date <= '01/01/2022'
SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE Date >  '01/01/2022'
SELECT * FROM AcquisitionsFirstUserCampaignReport WHERE Date < '01/01/2022'

CustomChannelGroups are added as dimension columns. You can query customChannelGroup in the following way:

 SELECT FirstUserCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsFirstUserCampaignReport

NOTE: CustomChannelGroupName is for reference purposes only. The exact value depends on the channelGroupName added. The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
FirstUserCampaignName	String	True		True	Name of the marketing campaign that first acquired the user.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
UserEngagementDuration	Bigint	False	False		The total amount of time (in seconds) the website or app was in the foreground of users

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

AcquisitionsFirstUserGoogleAdsAdGroupNameReport

A predefined view that retrieves user Acquisitions first user google ads ad group name data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
FirstUserGoogleAdsAdGroupName supports the following operator: =
Date supports the following operators: =, >=, <=, <, >

For example, the following queries are processed server-side:

SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE PropertyId = 342020667
SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE FirstUserGoogleAdsAdGroupName = 'Test' 
SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE Date = '01/05/2023' 
SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE PropertyId = 342020667  AND FirstUserGoogleAdsAdGroupName = 'Test' AND Date = '01/05/2023'
SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE Date >= '01/01/2022'
SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE Date <= '01/01/2022'
SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE Date >  '01/01/2022'
SELECT * FROM AcquisitionsFirstUserGoogleAdsAdGroupNameReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
FirstUserGoogleAdsAdGroupName	String	True		True	The Ad Group Name in Google Ads that first acquired the user.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
UserEngagementDuration	Bigint	False	True		The total amount of time (in seconds) the website or app was in the foreground of users

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

AcquisitionsFirstUserGoogleAdsNetworkTypeReport

A predefined view that retrieves Acquisitions first user google ads ad network type platform data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
FirstUserGoogleAdsNetworkType supports the following operator: =
Date supports the following operators: =, >=, <=, <, >

For example, the following queries are processed server-side:

SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE PropertyId = 342020667
SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE FirstUserGoogleAdsNetworkType = 'test' 
SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE Date = '01/05/2023' 
SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE PropertyId = 342020667  AND FirstUserGoogleAdsNetworkType = 'test' AND Date = '01/05/2023'
SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE Date >= '01/01/2022'
SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE Date <= '01/01/2022'
SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE Date >  '01/01/2022'
SELECT * FROM AcquisitionsFirstUserGoogleAdsNetworkType WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
FirstUserGoogleAdsAdNetworkType	String	True		True	The source platform that first acquired the user.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
UserEngagementDuration	Bigint	False	True		The total amount of time (in seconds) the website or app was in the foreground of users

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

AcquisitionsFirstUserMediumReport

A predefined view that retrieves Acquisitions first user medium data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
FirstUserMedium supports the following operator: =
Date supports the following operators: =, >=, <=, <, >

For example, the following queries are processed server-side:

SELECT * FROM AcquisitionsFirstUserMediumReport WHERE PropertyId = 342020667
SELECT * FROM AcquisitionsFirstUserMediumReport WHERE FirstUserMedium = 'test' 
SELECT * FROM AcquisitionsFirstUserMediumReport WHERE Date = '20221115' 
SELECT * FROM AcquisitionsFirstUserMediumReport WHERE PropertyId = 342020667  AND FirstUserMedium = 'test' AND Date = '01/05/2023''
SELECT * FROM AcquisitionsFirstUserMediumReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM AcquisitionsFirstUserMediumReport WHERE Date >= '01/01/2022'
SELECT * FROM AcquisitionsFirstUserMediumReport WHERE Date <= '01/01/2022'
SELECT * FROM AcquisitionsFirstUserMediumReport WHERE Date >  '01/01/2022'
SELECT * FROM AcquisitionsFirstUserMediumReport WHERE Date < '01/01/2022'

CustomChannelGroups are added as dimension columns. You can query customChannelGroup in the following way:

 SELECT FirstUserCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsFirstUserMediumReport WHERE FirstUserMedium = 'test'

NOTE: CustomChannelGroupName is for reference purposes only. The exact value depends on the channelGroupName added. The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
FirstUserMedium	String	True		True	The medium that first acquired the user to the website or app.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
UserEngagementDuration	Bigint	False	True		The total amount of time (in seconds) the website or app was in the foreground of users

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

AcquisitionsFirstUserSourceMediumReport

A predefined view that retrieves Acquisitions first user source medium data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
FirstUserGoogleAdsAdGroupName supports the following operator: =
Date supports the following operators: =, >=, <=, <, >

For example, the following queries are processed server-side:

SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE PropertyId = 342020667
SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE FirstUserGoogleAdsAdGroupName = 'Test' 
SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE Date = '01/05/2023'' 
SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE PropertyId = 342020667  AND FirstUserGoogleAdsAdGroupName = 'Test' AND Date = '01/05/2023'
SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE Date >= '01/01/2022'
SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE Date <= '01/01/2022'
SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE Date >  '01/01/2022'
SELECT * FROM AcquisitionsFirstUserSourceMediumReport WHERE Date < '01/01/2022'

CustomChannelGroups are added as dimension columns. You can query customChannelGroup in the following way:

 SELECT FirstUserCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsFirstUserSourceMediumReport

NOTE: CustomChannelGroupName is for reference purposes only. The exact value depends on the channelGroupName added. The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
FirstUserSource	String	True		True	The source that first acquired the user to the website or app.
FirstUserMedium	String	True		True	The medium that first acquired the user to the website or app.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
UserEngagementDuration	Bigint	False	True		The total amount of time (in seconds) the website or app was in the foreground of users

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

AcquisitionsFirstUserSourcePlatformReport

A predefined view that retrieves Acquisitions first user source platform data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
FirstUserSourcePlatform supports the following operator: =
Date supports the following operators: =, >=, <=, <, >

For example, the following queries are processed server-side:

SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE PropertyId = 342020667
SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE FirstUserSourcePlatform = 'Test' 
SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE Date = '01/05/2023' 
SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE PropertyId = 342020667  AND FirstUserSourcePlatform = 'Test' AND Date = '01/05/2023'
SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE Date >= '01/01/2022'
SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE Date <= '01/01/2022'
SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE Date >  '01/01/2022'
SELECT * FROM AcquisitionsFirstUserSourcePlatformReport WHERE Date < '01/01/2022'

CustomChannelGroups are added as dimension columns. You can query customChannelGroup in the following way:

 SELECT FirstUserCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsFirstUserSourcePlatformReport WHERE FirstUserSourcePlatform = 'Test'

NOTE: CustomChannelGroupName is for reference purposes only. The exact value depends on the channelGroupName added. The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
FirstUserSourcePlatform	String	True		True	The source platform that first acquired the user.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
UserEngagementDuration	Bigint	False	True		The total amount of time (in seconds) the website or app was in the foreground of users

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

AcquisitionsFirstUserSourceReport

A predefined view that retrieves Acquisitions first user source data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
FirstUserSource supports the following operator: =
Date supports the following operators: =, >=, <=, <, >

For example, the following queries are processed server-side:

SELECT * FROM AcquisitionsFirstUserSourceReport WHERE PropertyId = 342020667
SELECT * FROM AcquisitionsFirstUserSourceReport WHERE FirstUserSource = '(direct)' 
SELECT * FROM AcquisitionsFirstUserSourceReport WHERE Date = '01/05/2023' 
SELECT * FROM AcquisitionsFirstUserSourceReport WHERE PropertyId = 342020667  AND FirstUserSource = '(direct)' AND Date = '01/05/2023'
SELECT * FROM AcquisitionsFirstUserSourceReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM AcquisitionsFirstUserSourceReport WHERE Date >= '01/01/2022'
SELECT * FROM AcquisitionsFirstUserSourceReport WHERE Date <= '01/01/2022'
SELECT * FROM AcquisitionsFirstUserSourceReport WHERE Date >  '01/01/2022'
SELECT * FROM AcquisitionsFirstUserSourceReport WHERE Date < '01/01/2022'

CustomChannelGroups are added as dimension columns. You can query customChannelGroup in the following way:

 SELECT FirstUserCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsFirstUserSourceReport WHERE FirstUserSource = '(direct)'

NOTE: CustomChannelGroupName is for reference purposes only. The exact value depends on the channelGroupName added. The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
FirstUserSource	String	True		True	The source that first acquired the user to the website or app.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
UserEngagementDuration	Bigint	False	False		The total amount of time (in seconds) the website or app was in the foreground of users

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

AcquisitionsSessionCampaignReport

A predefined view that retrieves Acquisitions session campaign report data.

n

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
SessionDefaultChannelGrouping supports the following operator: =
Date supports the following operators: =, >=, <=, <, >

For example, the following queries are processed server-side:

SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE PropertyId = 342020667
SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE SessionDefaultChannelGrouping = 'Direct' 
SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE Date = '01/05/2023' 
SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE PropertyId = 342020667  AND SessionDefaultChannelGrouping = 'Direct' AND Date = '01/05/2023'
SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE Date >= '01/01/2022'
SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE Date <= '01/01/2022'
SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE Date >  '01/01/2022'
SELECT * FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE Date < '01/01/2022'

CustomChannelGroups are added as dimension columns. You can query customChannelGroup in the following way:

 SELECT SessionCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsSessionDefaultChannelGroupingReport WHERE SessionDefaultChannelGrouping = 'Direct'

NOTE: CustomChannelGroupName is for reference purposes only. The exact value depends on the channelGroupName added. The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
SessionCampaignName	String	True		True	Campaign that referred the user
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Sessions	Integer	False	True		The number of sessions that began on the site or app.
EventsPerSession	Decimal	False	True		The average number of events per session.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
UserEngagementDuration	Bigint	False	True		The total amount of time (in seconds) the website or app was in the foreground of users

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

AcquisitionsSessionDefaultChannelGroupingReport

A predefined view that retrieves Acquisitions session default channel grouping report data.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
SessionDefaultChannelGroup	String	True		True	Channel groupings are rule-based definitions of your traffic sources. These default system definitions reflect Analytics current view of what constitutes each channel.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EventsPerSession	Decimal	False	True		The average number of events per session.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
UserEngagementDuration	Bigint	False	True		The total amount of time (in seconds) the website or app was in the foreground of users

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

AcquisitionsSessionMediumReport

A predefined view that retrieves Acquisitions session medium report data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
SessionMedium supports the following operator: =
Date supports the following operators: =, >=, <=, <, >

For example, the following queries are processed server-side:

SELECT * FROM AcquisitionsSessionMediumReport WHERE PropertyId = 342020667
SELECT * FROM AcquisitionsSessionMediumReport WHERE SessionMedium = 'test' 
SELECT * FROM AcquisitionsSessionMediumReport WHERE Date = '01/05/2023' 
SELECT * FROM AcquisitionsSessionMediumReport WHERE PropertyId = 342020667  AND SessionMedium = 'test' AND Date = '01/05/2023'
SELECT * FROM AcquisitionsSessionMediumReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM AcquisitionsSessionMediumReport WHERE Date >= '01/01/2022'
SELECT * FROM AcquisitionsSessionMediumReport WHERE Date <= '01/01/2022'
SELECT * FROM AcquisitionsSessionMediumReport WHERE Date >  '01/01/2022'
SELECT * FROM AcquisitionsSessionMediumReport WHERE Date < '01/01/2022'

CustomChannelGroups are added as dimension columns. You can query customChannelGroup in the following way:

 SELECT SessionCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsSessionMediumReport WHERE SessionMedium = 'test'

NOTE: CustomChannelGroupName is for reference purposes only. The exact value depends on the channelGroupName added. The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
SessionMedium	String	True		True	Channel that referred the user
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Sessions	Integer	False	True		The number of sessions that began on the site or app.
EventsPerSession	Decimal	False	True		The average number of events per session.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
UserEngagementDuration	Bigint	False	True		The total amount of time (in seconds) the website or app was in the foreground of users

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

AcquisitionsSessionSourceMediumReport

A predefined view that retrieves Acquisitions session source medium report data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
FirstUserGoogleAdsAdGroupName supports the following operator: =
Date supports the following operators: =, >=, <=, <, >

For example, the following queries are processed server-side:

SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE PropertyId = 342020667
SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE FirstUserGoogleAdsAdGroupName = 'Test' 
SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE Date = '01/05/2023' 
SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE PropertyId = 342020667  AND FirstUserGoogleAdsAdGroupName = 'Test' AND Date = '01/05/2023'
SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE Date >= '01/01/2022'
SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE Date <= '01/01/2022'
SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE Date >  '01/01/2022'
SELECT * FROM AcquisitionsSessionSourceMediumReport WHERE Date < '01/01/2022'

CustomChannelGroups are added as dimension columns. You can query customChannelGroup in the following way:

 SELECT SessionCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsSessionSourceMediumReport

NOTE: CustomChannelGroupName is for reference purposes only. The exact value depends on the channelGroupName added. The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
SessionMedium	String	True		True	Channel that referred the user
SessionSource	String	True		True	The source that initiated a session on your website or app.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Sessions	Integer	False	True		The number of sessions that began on the site or app.
EventsPerSession	Decimal	False	True		The average number of events per session.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
UserEngagementDuration	Bigint	False	False		The total amount of time (in seconds) the website or app was in the foreground of users

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

AcquisitionsSessionSourcePlatformReport

A predefined view that retrieves Acquisitions session source platform report data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
FirstUserGoogleAdsAdGroupName supports the following operator: =
Date supports the following operators: =, >=, <=, <, >

For example, the following queries are processed server-side:

SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE PropertyId = 342020667
SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE FirstUserGoogleAdsAdGroupName = 'Test' 
SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE Date = '01/05/2023' 
SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE PropertyId = 342020667  AND FirstUserGoogleAdsAdGroupName = 'Test' AND Date = '01/05/2023'
SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE Date >= '01/01/2022'
SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE Date <= '01/01/2022'
SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE Date >  '01/01/2022'
SELECT * FROM AcquisitionsSessionSourcePlatformReport WHERE Date < '01/01/2022'

CustomChannelGroups are added as dimension columns. You can query customChannelGroup in the following way:

 SELECT SessionCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsSessionSourcePlatformReport

NOTE: CustomChannelGroupName is for reference purposes only. The exact value depends on the channelGroupName added. The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
SessionSourcePlatform	String	True		True	The source platform of the session
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EventsPerSession	Decimal	False	True		The average number of events per session.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
UserEngagementDuration	Bigint	False	False		The total amount of time (in seconds) the website or app was in the foreground of users

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

AcquisitionsSessionSourceReport

A predefined view that retrieves Acquisitions session source report data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
FirstUserGoogleAdsAdGroupName supports the following operator: =
Date supports the following operators: =, >=, <=, <, >

For example, the following queries are processed server-side:

SELECT * FROM AcquisitionsSessionSourceReport WHERE PropertyId = 342020667
SELECT * FROM AcquisitionsSessionSourceReport WHERE FirstUserGoogleAdsAdGroupName = 'Test' 
SELECT * FROM AcquisitionsSessionSourceReport WHERE Date = '01/01/2022' 
SELECT * FROM AcquisitionsSessionSourceReport WHERE PropertyId = 342020667  AND FirstUserGoogleAdsAdGroupName = 'Test' AND Date = '01/05/2023'
SELECT * FROM AcquisitionsSessionSourceReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM AcquisitionsSessionSourceReport WHERE Date >= '01/01/2022'
SELECT * FROM AcquisitionsSessionSourceReport WHERE Date <= '01/01/2022'
SELECT * FROM AcquisitionsSessionSourceReport WHERE Date >  '01/01/2022'
SELECT * FROM AcquisitionsSessionSourceReport WHERE Date < '01/01/2022'

CustomChannelGroups are added as dimension columns. You can query customChannelGroup in the following way:

 SELECT SessionCustomChannelGroupName, SessionDefaultChannelGrouping, Conversions FROM AcquisitionsSessionSourceReport

NOTE: CustomChannelGroupName is for reference purposes only. The exact value depends on the channelGroupName added. The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
SessionSource	String	True		True	The source that initiated a session on your website or app.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Sessions	Integer	False	True		The number of sessions that began on the site or app.
EventsPerSession	Decimal	False	True		The average number of events per session.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
UserEngagementDuration	Bigint	False	False		The total amount of time (in seconds) the website or app was in the foreground of users

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

ActiveUsers

A base view that retrieves Active Users data.

Table Specific Information

Select

Retrieves data for ActiveUsers report. At least one metric must be specified in the query. This endpoint uses the realtime report API endpoint to get more up to date data than the standard reporting endpoint. The realtime reporting API supports a maximum of four dimensions compared to the standard nine for the standard report API.

The following is an example query:

	SELECT ActiveUsers, Platform FROM ActiveUsers

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
AppVersion	String	True			The app's versionName (Android) or short bundle version (iOS).
City	String	True			The city from which the user activity originated.
Country	String	True			The country from which the user activity originated.
DeviceCategory	String	True			The type of device: Desktop, Tablet, or Mobile.
Platform	String	True		True	The platform on which your app or website ran.
AudienceName	String	True			The given name of an Audience.
UnifiedScreenName	String	True			The page title (web) or screen name (app) on which the event was logged.
ActiveUsers	Integer	False	True		The total number of active users.
AudienceId	Long	True			The numeric identifier of an Audience.
AudienceResourceName	String	True			The resource name of this audience.
CityId	Integer	True			The geographic ID of the city from which the user activity originated, derived from their IP address.
CountryId	String	True			The geographic ID of the country from which the user activity originated, derived from their IP address.
MinutesAgo	Integer	True			The number of minutes ago that an event was collected. 00 is the current minute, and 01 means the previous minute.
StreamId	Long	True			The numeric data stream identifier for your app or website.
StreamName	String	True			The data stream name for your app or website.
EventName	String	True			The name of the event

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

DemographicAgeReport

A predefined view that retrieves Demographics UserAgeBracket data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the '=' operator.
UserAgeBracket supports the '=' operator.
Date supports the '=,>=,<=,<,>' operators.

For example, the following queries are processed server-side:

SELECT * FROM DemographicAgeReport WHERE PropertyId = 342020667
SELECT * FROM DemographicAgeReport WHERE UserAgeBracket = '18-24' 
SELECT * FROM DemographicAgeReport WHERE Date = '01/05/2023' 
SELECT * FROM DemographicAgeReport WHERE PropertyId = 342020667 AND Date = '01/05/2023' AND UserAgeBracket = '18-24'
SELECT * FROM DemographicAgeReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM DemographicAgeReport WHERE Date >= '01/01/2022'
SELECT * FROM DemographicAgeReport WHERE Date <= '01/01/2022'
SELECT * FROM DemographicAgeReport WHERE Date >  '01/01/2022'
SELECT * FROM DemographicAgeReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
UserAgeBracket	String	True		True	User age brackets.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

DemographicCityReport

A predefined view that retrieves Demographics City data.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
City	String	True		True	City from which user activity originated.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

DemographicCountryReport

A predefined view that retrieves Demographics Country data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the '=' operator.
Country supports the '=' operator.
Date supports the '=,>=,<=,<,>' operators.

For example, the following queries are processed server-side:

SELECT * FROM DemographicCountryReport WHERE PropertyId = 342020667
SELECT * FROM DemographicCountryReport WHERE Country = 'America' 
SELECT * FROM DemographicCountryReport WHERE Date = '01/05/2023' 
SELECT * FROM DemographicCountryReport WHERE PropertyId = 342020667 AND Date = '01/05/2023' AND Country = 'America'
SELECT * FROM DemographicCountryReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM DemographicCountryReport WHERE Date >= '01/01/2022'
SELECT * FROM DemographicCountryReport WHERE Date <= '01/01/2022'
SELECT * FROM DemographicCountryReport WHERE Date >  '01/01/2022'
SELECT * FROM DemographicCountryReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
Country	String	True		True	Country from which user activity originated.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

DemographicGenderReport

A predefined view that retrieves Demographics UserGender data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the '=' operator.
UserGender supports the '=' operator.
Date supports the '=,>=,<=,<,>' operators.

For example, the following queries are processed server-side:

SELECT * FROM DemographicGenderReport WHERE PropertyId = 342020667
SELECT * FROM DemographicGenderReport WHERE UserGender = 'Female' 
SELECT * FROM DemographicGenderReport WHERE Date = '01/01/2022' 
SELECT * FROM DemographicGenderReport WHERE PropertyId = 342020667 AND Date = '01/01/2022' AND UserGender = 'Female'
SELECT * FROM DemographicGenderReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM DemographicGenderReport WHERE Date >= '01/01/2022'
SELECT * FROM DemographicGenderReport WHERE Date <= '01/01/2022'
SELECT * FROM DemographicGenderReport WHERE Date >  '01/01/2022'
SELECT * FROM DemographicGenderReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
UserGender	String	True		True	User gender.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

DemographicInterestsReport

A predefined view that retrieves Demographics BrandingInterest data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the '=' operator.
BrandingInterest supports the '=' operator.
Date supports the '=,>=,<=,<,>' operators.

For example, the following queries are processed server-side:

SELECT * FROM DemographicInterestsReport WHERE PropertyId = 342020667
SELECT * FROM DemographicInterestsReport WHERE BrandingInterest = 'Marketing' 
SELECT * FROM DemographicInterestsReport WHERE Date = '01/05/2023' 
SELECT * FROM DemographicInterestsReport WHERE PropertyId = 342020667 AND Date = '01/05/2023' AND BrandingInterest = 'Marketing'
SELECT * FROM DemographicInterestsReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM DemographicInterestsReport WHERE Date >= '01/01/2022'
SELECT * FROM DemographicInterestsReport WHERE Date <= '01/01/2022'
SELECT * FROM DemographicInterestsReport WHERE Date >  '01/01/2022'
SELECT * FROM DemographicInterestsReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
BrandingInterest	String	True		True	Interests demonstrated by users who are higher in the shopping funnel. Users can be counted in multiple interest categories.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

DemographicLanguageReport

A predefined view that retrieves Demographics Language data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the '=' operator.
Language supports the '=' operator.
Date supports the '=,>=,<=,<,>' operators.

For example, the following queries are processed server-side:

SELECT * FROM DemographicLanguageReport WHERE PropertyId = 342020667
SELECT * FROM DemographicLanguageReport WHERE Language = 'English' 
SELECT * FROM DemographicLanguageReport WHERE Date = '01/05/2023' 
SELECT * FROM DemographicLanguageReport WHERE PropertyId = 342020667 AND Date = '01/05/2023' AND Language = 'English'
SELECT * FROM DemographicLanguageReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM DemographicLanguageReport WHERE Date >= '01/01/2022'
SELECT * FROM DemographicLanguageReport WHERE Date <= '01/01/2022'
SELECT * FROM DemographicLanguageReport WHERE Date >  '01/01/2022'
SELECT * FROM DemographicLanguageReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
Language	String	True		True	Language setting for the device from which activity originated.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

DemographicRegionReport

A predefined view that retrieves Demographics Region data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the '=' operator.
Region supports the '=' operator.
Date supports the '=,>=,<=,<,>' operators.

For example, the following queries are processed server-side:

SELECT * FROM DemographicRegionReport WHERE PropertyId = 342020667
SELECT * FROM DemographicRegionReport WHERE Region = 'California' 
SELECT * FROM DemographicRegionReport WHERE Date = '01/05/2023' 
SELECT * FROM DemographicRegionReport WHERE PropertyId = 342020667 AND Date = '01/05/2023' AND Region = 'California'
SELECT * FROM DemographicRegionReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM DemographicRegionReport WHERE Date >= '01/01/2022'
SELECT * FROM DemographicRegionReport WHERE Date <= '01/01/2022'
SELECT * FROM DemographicRegionReport WHERE Date >  '01/01/2022'
SELECT * FROM DemographicRegionReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
Region	String	True		True	Geographic region from which activity originated.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

Demographics

A base view that retrieves Demographics data.

Table Specific Information

Select

Retrieves data for Demographics report. At least one metric must be specified in the query. In the query you can also specify up to nine dimensions. The following is an example query:

	SELECT Conversions, TotalRevenue FROM Demographics

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
Date	Date	True			The date of the session formatted as YYYYMMDD.
Year	Integer	True			The year of the session. A four-digit year from 2005 to the current year.
Month	Integer	True			The month of the session. An integer from 01 to 12.
Week	Integer	True			The week of the session. A number from 01 to 53. Each week starts on Sunday.
Day	Integer	True			The day of the month. A number from 01 to 31.
DayOfWeekName	String	True			The day of the week in English. This dimension has values of Sunday, Monday, etc.
IsoWeek	Integer	True			ISO week number, where each week starts on Monday. Example values include 01, 02, 53.
IsoYear	Integer	True			The ISO year of the event.Example values include 2022 2023.
IsoYearIsoWeek	Integer	True			The combined values of isoWeek and isoYear. Example values include 201652 and 201701.
YearMonth	Integer	True			The combined values of year and month. Example values include 202212 or 202301.
YearWeek	Integer	True			The combined values of year and week. Example values include 202253 or 202301.
Hour	Integer	True			An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time.
BrandingInterest	String	True			Interests demonstrated by users who are higher in the shopping funnel. Users can be counted in multiple interest categories.
Country	String	True		True	Country from which user activity originated.
City	String	True			City from which user activity originated.
Language	String	True			Language setting for the device from which activity originated.
UserAgeBracket	String	True			User age brackets.
UserGender	String	True			User gender.
Region	String	True			Geographic region from which activity originated.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EngagedSessionsPerUser	Decimal	False	True		Average number of engaged sessions per user.
EventCount	Integer	False	True		The count of events.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
StartDate	String				Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).
EndDate	String				End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

EcommPurchasesItemBrandReport

A predefined view that retrieves Ecommerce purchase item brand data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
ItemBrand supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM EcommPurchasesItemBrandReport WHERE PropertyId = 342020667
SELECT * FROM EcommPurchasesItemBrandReport WHERE ItemBrand = 'test' 
SELECT * FROM EcommPurchasesItemBrandReport WHERE Date = '01/05/2023' 
SELECT * FROM EcommPurchasesItemBrandReport WHERE PropertyId = 342020667  AND ItemBrand = 'test' AND Date = '01/05/2023'
SELECT * FROM EcommPurchasesItemBrandReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM EcommPurchasesItemBrandReport WHERE Date >= '01/01/2022'
SELECT * FROM EcommPurchasesItemBrandReport WHERE Date <= '01/01/2022'
SELECT * FROM EcommPurchasesItemBrandReport WHERE Date >  '01/01/2022'
SELECT * FROM EcommPurchasesItemBrandReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
ItemBrand	String	True		True	Brand name of the item.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
ItemsAddedToCart	Integer	False	True		The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, hence this is the replacement of the AddToCarts metric.
CartToViewRate	Decimal	False	True		The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s).
EcommercePurchases	Integer	False			The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions.
PurchaseToViewRate	Decimal	False	True		The total cost of shipping.
ItemsPurchased	Integer	False	True		The total amount of tax. ItemPurchaseQuantity metric has been renamed to this metric.
ItemRevenue	Decimal	False	True		The total revenue from items only. Item revenue is the product of its price and quantity.
ItemsViewed	Integer	False	True		The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

EcommPurchasesItemCategory2Report

A predefined view that retrieves Ecommerce purchase item category data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
ItemCategory2 supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM EcommPurchasesItemCategory2Report WHERE PropertyId = 342020667
SELECT * FROM EcommPurchasesItemCategory2Report WHERE ItemCategory2 = 'Apparel' 
SELECT * FROM EcommPurchasesItemCategory2Report WHERE Date = '01/05/2023' 
SELECT * FROM EcommPurchasesItemCategory2Report WHERE PropertyId = 342020667  AND ItemCategory2 = 'Apparel' AND Date = '01/05/2023'
SELECT * FROM EcommPurchasesItemCategory2Report WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM EcommPurchasesItemCategory2Report WHERE Date >= '01/01/2022'
SELECT * FROM EcommPurchasesItemCategory2Report WHERE Date <= '01/01/2022'
SELECT * FROM EcommPurchasesItemCategory2Report WHERE Date >  '01/01/2022'
SELECT * FROM EcommPurchasesItemCategory2Report WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
ItemCategory2	String	True		True	Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Mens is the item category2
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
ItemsAddedToCart	Integer	False	True		The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, hence this is the replacement of the AddToCarts metric.
CartToViewRate	Decimal	False	True		The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s).
EcommercePurchases	Integer	False			The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions.
PurchaseToViewRate	Decimal	False	True		The total cost of shipping.
ItemsPurchased	Integer	False	True		The total amount of tax. ItemPurchaseQuantity metric has been renamed to this metric.
ItemRevenue	Decimal	False	True		The total revenue from items only. Item revenue is the product of its price and quantity.
ItemsViewed	Integer	False	True		The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

EcommPurchasesItemCategory3Report

A predefined view that retrieves Ecommerce purchase item category data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
ItemCategory3 supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM EcommPurchasesItemCategory3Report WHERE PropertyId = 342020667
SELECT * FROM EcommPurchasesItemCategory3Report WHERE ItemCategory3 = 'Apparel' 
SELECT * FROM EcommPurchasesItemCategory3Report WHERE Date = '01/05/2023' 
SELECT * FROM EcommPurchasesItemCategory3Report WHERE PropertyId = 342020667  AND ItemCategory3 = 'Apparel' AND Date = '01/05/2023'
SELECT * FROM EcommPurchasesItemCategory3Report WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM EcommPurchasesItemCategory3Report WHERE Date >= '01/01/2022'
SELECT * FROM EcommPurchasesItemCategory3Report WHERE Date <= '01/01/2022'
SELECT * FROM EcommPurchasesItemCategory3Report WHERE Date >  '01/01/2022'
SELECT * FROM EcommPurchasesItemCategory3Report WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
ItemCategory3	String	True		True	Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Summer is the item category3.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
ItemsAddedToCart	Integer	False	True		The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, hence this is the replacement of the AddToCarts metric.
CartToViewRate	Decimal	False	True		The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s).
EcommercePurchases	Integer	False			The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions.
PurchaseToViewRate	Decimal	False	True		The total cost of shipping.
ItemsPurchased	Integer	False	True		The total amount of tax. ItemPurchaseQuantity metric has been renamed to this metric.
ItemRevenue	Decimal	False	True		The total revenue from items only. Item revenue is the product of its price and quantity.
ItemsViewed	Integer	False	True		The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

EcommPurchasesItemCategory4Report

A predefined view that retrieves Ecommerce purchase item category data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
ItemCategory4 supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM EcommPurchasesItemCategory4Report WHERE PropertyId = 342020667
SELECT * FROM EcommPurchasesItemCategory4Report WHERE ItemCategory4 = 'Apparel' 
SELECT * FROM EcommPurchasesItemCategory4Report WHERE Date = '01/05/2023' 
SELECT * FROM EcommPurchasesItemCategory4Report WHERE PropertyId = 342020667  AND ItemCategory4 = 'Apparel' AND Date = '01/05/2023'
SELECT * FROM EcommPurchasesItemCategory4Report WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM EcommPurchasesItemCategory4Report WHERE Date >= '01/01/2022'
SELECT * FROM EcommPurchasesItemCategory4Report WHERE Date <= '01/01/2022'
SELECT * FROM EcommPurchasesItemCategory4Report WHERE Date >  '01/01/2022'
SELECT * FROM EcommPurchasesItemCategory4Report WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
ItemCategory4	String	True		True	Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Shirts is the item category4.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
ItemsAddedToCart	Integer	False	True		The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, hence this is the replacement of the AddToCarts metric.
CartToViewRate	Decimal	False	True		The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s).
EcommercePurchases	Integer	False			The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions.
PurchaseToViewRate	Decimal	False	True		The total cost of shipping.
ItemsPurchased	Integer	False	True		The total amount of tax. ItemPurchaseQuantity metric has been renamed to this metric.
ItemRevenue	Decimal	False	True		The total revenue from items only. Item revenue is the product of its price and quantity.
ItemsViewed	Integer	False	True		The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

EcommPurchasesItemCategory5Report

A predefined view that retrieves Ecommerce purchase item category data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
ItemCategory5 supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM EcommPurchasesItemCategory5Report WHERE PropertyId = 342020667
SELECT * FROM EcommPurchasesItemCategory5Report WHERE ItemCategory4 = 'Apparel' 
SELECT * FROM EcommPurchasesItemCategory5Report WHERE Date = '01/05/2023' 
SELECT * FROM EcommPurchasesItemCategory5Report WHERE PropertyId = 342020667  AND ItemCategory5 = 'Apparel' AND Date = '01/05/2023'
SELECT * FROM EcommPurchasesItemCategory5Report WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM EcommPurchasesItemCategory5Report WHERE Date >= '01/01/2022'
SELECT * FROM EcommPurchasesItemCategory5Report WHERE Date <= '01/01/2022'
SELECT * FROM EcommPurchasesItemCategory5Report WHERE Date >  '01/01/2022'
SELECT * FROM EcommPurchasesItemCategory5Report WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
ItemCategory5	String	True		True	Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, T-shirts is the item category5.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
ItemsAddedToCart	Integer	False	True		The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, hence this is the replacement of the AddToCarts metric.
CartToViewRate	Decimal	False	True		The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s).
EcommercePurchases	Integer	False			The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions.
PurchaseToViewRate	Decimal	False	True		The total cost of shipping.
ItemsPurchased	Integer	False	True		The total amount of tax. ItemPurchaseQuantity metric has been renamed to this metric.
ItemRevenue	Decimal	False	True		The total revenue from items only. Item revenue is the product of its price and quantity.
ItemsViewed	Integer	False	True		The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

EcommPurchasesItemCategoryReport

A predefined view that retrieves Ecommerce purchase item category data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
ItemCategory supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM EcommPurchasesItemCategoryReport WHERE PropertyId = 342020667
SELECT * FROM EcommPurchasesItemCategoryReport WHERE ItemCategory = 'Apparel' 
SELECT * FROM EcommPurchasesItemCategoryReport WHERE PropertyId = 342020667  AND ItemCategory = 'Apparel' AND Date = '01/05/2023'
SELECT * FROM EcommPurchasesItemCategoryReport WHERE Date = '01/05/2023' 
SELECT * FROM EcommPurchasesItemCategoryReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM EcommPurchasesItemCategoryReport WHERE Date >= '01/01/2022'
SELECT * FROM EcommPurchasesItemCategoryReport WHERE Date <= '01/01/2022'
SELECT * FROM EcommPurchasesItemCategoryReport WHERE Date >  '01/01/2022'
SELECT * FROM EcommPurchasesItemCategoryReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
ItemCategory	String	True		True	Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Apparel is the item category.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
ItemsAddedToCart	Integer	False	True		The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, hence this is the replacement of the AddToCarts metric.
CartToViewRate	Decimal	False	True		The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s).
EcommercePurchases	Integer	False			The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions.
PurchaseToViewRate	Decimal	False	True		The total cost of shipping.
ItemsPurchased	Integer	False	True		The total amount of tax. ItemPurchaseQuantity metric has been renamed to this metric.
ItemRevenue	Decimal	False	True		The total revenue from items only. Item revenue is the product of its price and quantity.
ItemsViewed	Integer	False	True		The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

EcommPurchasesItemCategoryReportCombined

A predefined view that retrieves Ecommerce purchase item category data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
ItemCategory supports the following operator: =
ItemCategory2 supports the following operator: =
ItemCategory3 supports the following operator: =
ItemCategory3 supports the following operator: =
ItemCategory5 supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE PropertyId = 342020667
SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE ItemCategory = 'Apparel' 
SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE ItemCategory2 = 'Mens' 
SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE ItemCategory3 = 'Summer' 
SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE ItemCategory4 = 'Shirts' 
SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE ItemCategory5 = 'T-shirts' 
SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE Date = '01/05/2023' 
SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE PropertyId = 342020667  AND ItemCategory = 'Apparel' AND Date = '01/05/2023'
SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE Date >= '01/01/2022'
SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE Date <= '01/01/2022'
SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE Date >  '01/01/2022'
SELECT * FROM EcommPurchasesItemCategoryReportCombined WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
ItemCategory	String	True		True	Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Apparel is the item category.
ItemCategory2	String	True		True	Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Mens is the item category2
ItemCategory3	String	True		True	Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Summer is the item category3.
ItemCategory4	String	True		True	Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Shirts is the item category4.
ItemCategory5	String	True		True	Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, T-shirts is the item category5.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
ItemsAddedToCart	Integer	False	True		The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, hence this is the replacement of the AddToCarts metric.
CartToViewRate	Decimal	False	True		The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s).
EcommercePurchases	Integer	False			The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions.
PurchaseToViewRate	Decimal	False	True		The total cost of shipping.
ItemsPurchased	Integer	False	True		The total amount of tax. ItemPurchaseQuantity metric has been renamed to this metric.
ItemRevenue	Decimal	False	True		The total revenue from items only. Item revenue is the product of its price and quantity.
ItemsViewed	Integer	False	True		The number of units viewed for a single item. This metric counts the quantity of items in 'view_item' events.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

EcommPurchasesItemIdReport

A predefined view that retrieves Ecommerce purchase item data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
ItemId supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM EcommPurchasesItemIdReport WHERE PropertyId = 342020667
SELECT * FROM EcommPurchasesItemIdReport WHERE ItemId = '1234' 
SELECT * FROM EcommPurchasesItemIdReport WHERE Date = '01/05/2023' 
SELECT * FROM EcommPurchasesItemIdReport WHERE PropertyId = 342020667  AND ItemId = '1234' AND Date = '01/05/2023'
SELECT * FROM EcommPurchasesItemIdReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM EcommPurchasesItemIdReport WHERE Date >= '01/01/2022'
SELECT * FROM EcommPurchasesItemIdReport WHERE Date <= '01/01/2022'
SELECT * FROM EcommPurchasesItemIdReport WHERE Date >  '01/01/2022'
SELECT * FROM EcommPurchasesItemIdReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
ItemId	String	True		True	ID of the item.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
ItemsAddedToCart	Integer	False	True		The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, hence this is the replacement of the AddToCarts metric.
CartToViewRate	Decimal	False	True		The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s).
EcommercePurchases	Integer	False			The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions.
PurchaseToViewRate	Decimal	False	True		The total cost of shipping.
ItemsPurchased	Integer	False	True		The total amount of tax. ItemPurchaseQuantity metric has been renamed to this metric.
ItemRevenue	Decimal	False	True		The total revenue from items only. Item revenue is the product of its price and quantity.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

EcommPurchasesItemNameReport

A predefined view that retrieves Ecommerce purchase item data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
ItemName supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM EcommPurchasesItemNameReport WHERE PropertyId = 342020667
SELECT * FROM EcommPurchasesItemNameReport WHERE ItemName = 'test' 
SELECT * FROM EcommPurchasesItemNameReport WHERE Date = '01/05/2023' 
SELECT * FROM EcommPurchasesItemNameReport WHERE PropertyId = 342020667  AND ItemName = 'test' AND Date = '01/05/2023'
SELECT * FROM EcommPurchasesItemNameReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM EcommPurchasesItemNameReport WHERE Date >= '01/01/2022'
SELECT * FROM EcommPurchasesItemNameReport WHERE Date <= '01/01/2022'
SELECT * FROM EcommPurchasesItemNameReport WHERE Date >  '01/01/2022'
SELECT * FROM EcommPurchasesItemNameReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
ItemName	String	True		True	The name of the item.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
ItemsAddedToCart	Integer	False	True		The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, hence this is the replacement of the AddToCarts metric.
CartToViewRate	Decimal	False	True		The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s).
EcommercePurchases	Integer	False			The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions.
PurchaseToViewRate	Decimal	False	True		The total cost of shipping.
ItemsPurchased	Integer	False	True		The total amount of tax. ItemPurchaseQuantity metric has been renamed to this metric.
ItemRevenue	Decimal	False	True		The total revenue from items only. Item revenue is the product of its price and quantity.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

Engagement

A base view that retrieves Engagement data

Table Specific Information

Select

Retrieves data for Engagement report. At least one metric must be specified in the query. In the query you can also specify up to 9 dimensions. The following are example queries:

	SELECT NewUsers, TotalRevenue FROM Engagement

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
Date	Date	True			The date of the session formatted as YYYYMMDD
Year	Integer	True			The year of the session. A four-digit year from 2005 to the current year.
Month	Integer	True			The month of the session. A two digit integer from 01 to 12.
Week	Integer	True			The week of the session. A two-digit number from 01 to 53. Each week starts on Sunday.
Day	Integer	True			The day of the month. A two-digit number from 01 to 31.
DayOfWeekName	String	True			The day of the week in English. This dimension has values of Sunday, Monday, etc.
IsoWeek	Integer	True			ISO week number, where each week starts on Monday. For details, see http://en.wikipedia.org/wiki/ISO_week_date. Example values include 01, 02, 53.
IsoYear	Integer	True			The ISO year of the event. For details, see http://en.wikipedia.org/wiki/ISO_week_date. Example values include 2022 2023.
IsoYearIsoWeek	Integer	True			The combined values of isoWeek and isoYear. Example values include 201652 and 201701.
YearMonth	Integer	True			The combined values of year and month. Example values include 202212 or 202301.
YearWeek	Integer	True			The combined values of year and week. Example values include 202253 or 202301.
Hour	Integer	True			A two-digit hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time.
ContentGroup	String	True			A category that applies to items of published content
EventName	String	True			The name of the event
UnifiedPageScreen	String	True			The page path (web) or screen class (app) on which the event was logged
UnifiedScreenClass	String	True		True	The page title (web) or screen class (app) on which the event was logged
UnifiedScreenName	String	True			The page title (web) or screen name (app) on which the event was logged
PagePath	String	True			The portion of the URL between the hostname and query string for web
PageTitle	String	True			The web page titles used on your site
Conversions	Decimal	False	True		The count of conversion events
EngagedSessionsPerUser	Decimal	False	True		Average number of engaged sessions per user
EventCount	Integer	False	True		The count of events
EventCountPerUser	Decimal	False	True		Average number of events triggered by each user
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time
ScreenPageViews	Integer	False	True		The number of app screens or web pages the users viewed. Repeated views of a single page or screen are counted.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising
TotalUsers	Integer	False	True		The number of distinct users who visited the site or app
userEngagementDuration	Bigint	False	True		The total amount of time (in seconds) the website or app was in the foreground of users' device
ViewsPerUser	Decimal	False	True		Average number of screens viewed by each user
SessionsPerUser	Decimal	False	False		The average number of sessions per user (Sessions divided by Active Users).
StartDate	String				Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).
EndDate	String				End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table

EngagementContentGroupReport

A predefined view that retrieves Engagement Content Group Report data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
ContentGroup supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM EngagementContentGroupReport WHERE PropertyId = 342020667
SELECT * FROM EngagementContentGroupReport WHERE ContentGroup = 'CData Test' 
SELECT * FROM EngagementContentGroupReport WHERE Date = '01/05/2023' 
SELECT * FROM EngagementContentGroupReport WHERE PropertyId = 342020667  AND ContentGroup = 'CData Test' AND Date = '01/05/2023'
SELECT * FROM EngagementContentGroupReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM EngagementContentGroupReport WHERE Date >= '01/01/2022'
SELECT * FROM EngagementContentGroupReport WHERE Date <= '01/01/2022'
SELECT * FROM EngagementContentGroupReport WHERE Date >  '01/01/2022'
SELECT * FROM EngagementContentGroupReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
ContentGroup	String	True		True	A category that applies to items of published content.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EventCount	Integer	False	True		The count of events.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
ScreenPageViews	Integer	False	True		The number of app screens or web pages the users viewed. Repeated views of a single page or screen are counted.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The number of distinct users who visited the site or app.
UserEngagementDuration	Bigint	False	True		The total amount of time (in seconds) the website or app was in the foreground of users device.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

EngagementConversionsReport

A predefined view that retrieves Engagement conversions data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
EventName supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM EngagementConversionsReport WHERE PropertyId = 342020667
SELECT * FROM EngagementConversionsReport WHERE EventName = 'page_view' 
SELECT * FROM EngagementConversionsReport WHERE Date = '01/05/2023' 
SELECT * FROM EngagementConversionsReport WHERE PropertyId = 342020667  AND EventName = 'page_view' AND Date = '01/05/2023'
SELECT * FROM EngagementConversionsReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM EngagementConversionsReport WHERE Date >= '01/01/2022'
SELECT * FROM EngagementConversionsReport WHERE Date <= '01/01/2022'
SELECT * FROM EngagementConversionsReport WHERE Date >  '01/01/2022'
SELECT * FROM EngagementConversionsReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
EventName	String	True		True	The name of the event.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EventCountPerUser	Decimal	False	True		Average number of events triggered by each user.
EventCount	Integer	False	True		The count of events.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The number of distinct users who visited the site or app.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

EngagementEventsReport

A predefined view that retrieves Engagement events data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
EventName supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM EngagementEventsReport WHERE PropertyId = 342020667
SELECT * FROM EngagementEventsReport WHERE EventName = 'page_view' 
SELECT * FROM EngagementEventsReport WHERE Date = '01/05/2023' 
SELECT * FROM EngagementEventsReport WHERE PropertyId = 342020667  AND EventName = 'page_view' AND Date = '01/05/2023'
SELECT * FROM EngagementEventsReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM EngagementEventsReport WHERE Date >= '01/01/2022'
SELECT * FROM EngagementEventsReport WHERE Date <= '01/01/2022'
SELECT * FROM EngagementEventsReport WHERE Date >  '01/01/2022'
SELECT * FROM EngagementEventsReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
EventName	String	True		True	The name of the event.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
EventCountPerUser	Decimal	False	True		Average number of events triggered by each user.
EventCount	Integer	False	True		The count of events.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The number of distinct users who visited the site or app.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	The Property Id value to be used when querying this table.

EngagementPagesPathReport

A predefined view that retrieves Engagement Pages path report data.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
PagePath	String	True		True	The portion of the URL between the hostname and query string for web.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EventCount	Integer	False	True		The count of events.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
ScreenPageViews	Integer	False	True		The number of app screens or web pages the users viewed. Repeated views of a single page or screen are counted.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The number of distinct users who visited the site or app.
UserEngagementDuration	Bigint	False	True		The total amount of time (in seconds) the website or app was in the foreground of users device.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

EngagementPagesTitleAndScreenClassReport

A predefined view that retrieves Engagement Pages title and screen class data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
UnifiedScreenClass supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE PropertyId = 342020667
SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE UnifiedScreenClass = 'CData Test' 
SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE Date = '01/05/2023' 
SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE PropertyId = 342020667  AND UnifiedScreenClass = 'CData Test' AND Date = '01/05/2023'
SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE Date >= '01/01/2022'
SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE Date <= '01/01/2022'
SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE Date >  '01/01/2022'
SELECT * FROM EngagementPagesTitleAndScreenClassReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
UnifiedScreenClass	String	True		True	The page title (web) or screen class (app) on which the event was logged.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EventCount	Integer	False	True		The count of events.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
ScreenPageViews	Integer	False	True		The number of app screens or web pages the users viewed. Repeated views of a single page or screen are counted.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The number of distinct users who visited the site or app.
UserEngagementDuration	Bigint	False	True		The total amount of time (in seconds) the website or app was in the foreground of users device.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

EngagementPagesTitleAndScreenNameReport

A predefined view that retrieves Engagement Pages Title And ScreenName data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
UnifiedScreenName supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE PropertyId = 342020667
SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE UnifiedScreenName = 'CData Test' 
SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE Date = '01/05/2023' 
SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE PropertyId = 342020667  AND UnifiedScreenName = 'CData Test' AND Date = '01/05/2023'
SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE Date >= '01/01/2022'
SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE Date <= '01/01/2022'
SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE Date >  '01/01/2022'
SELECT * FROM EngagementPagesTitleAndScreenNameReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
UnifiedScreenName	String	True		True	The page title (web) or screen name (app) on which the event was logged.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EventCount	Integer	False	True		The count of events.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
ScreenPageViews	Integer	False	True		The number of app screens or web pages the users viewed. Repeated views of a single page or screen are counted.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The number of distinct users who visited the site or app.
UserEngagementDuration	Bigint	False	True		The total amount of time (in seconds) the website or app was in the foreground of users device.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

Events

A base view that retrieves Event data

Table Specific Information

Select

Retrieves data for Events reports. At least one metric must be specified in the query. This endpoint uses the real-time report API endpoint to get more up-to-date data than the standard reporting endpoint. The real-time reporting API supports a maximum of four dimensions compared to nine for the standard report API.

The following is an example query:

	SELECT EventCount, Platform FROM Events

Since PagePath and PlatTitle dimensions are not available in the runRealReport endpoint, use the connection property ReportType = reports to leverage the result with these dimensions.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
AppVersion	String	True			The application's versionName (Android) or short bundle version (iOS)
City	String	True			The city from which the user activity originated
Country	String	True			The country from which the user activity originated
DeviceCategory	String	True			The type of device: Desktop, Tablet, or Mobile
Platform	String	True			The platform on which your app or website ran
AudienceName	String	True			The given name of an Audience
UnifiedScreenName	String	True			The page title (web) or screen name (app) on which the event was logged
EventName	String	True		True	The name of the event
PagePath	String	True			The portion of the URL between the hostname and query string for web. This works when connection property ReportType=reports;.
PageTitle	String	True			The web page titles used on your site. This works when connection property ReportType=reports;
EventCount	Integer	False	True		Number of times an individual event was triggered
Conversions	Decimal	False	True		The count of conversion events
AudienceId	Long	True			The numeric identifier of an Audience.
AudienceResourceName	String	True			The resource name of this audience.
CityId	Integer	True			The geographic ID of the city from which the user activity originated, derived from their IP address.
CountryId	String	True			The geographic ID of the country from which the user activity originated, derived from their IP address.
MinutesAgo	Integer	True			The number of minutes ago that an event was collected. 00 is the current minute, and 01 means the previous minute.
StreamId	Long	True			The numeric data stream identifier for your app or website.
StreamName	String	True			The data stream name for your app or website.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table

GamesReporting

A base view that retrieves Games Reporting data.

Table Specific Information

Select

Retrieves data for GamesReporting report. At least one metric must be specified in the query. In the query you can also specify up to 9 dimensions.

The following is an example query:

	SELECT AveragePurchaseRevenue, AverageRevenuePerUser FROM GamesReporting

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
Date	Date	True			The date of the session formatted as YYYYMMDD.
Year	Integer	True			The year of the session. A four-digit year from 2005 to the current year.
Month	Integer	True			The month of the session. A two digit integer from 01 to 12.
Week	Integer	True			The week of the session. A two-digit number from 01 to 53. Each week starts on Sunday.
Day	Integer	True			The day of the month. A two-digit number from 01 to 31.
DayOfWeekName	String	True			The day of the week in English. This dimension has values of Sunday, Monday, etc.
IsoWeek	Integer	True			ISO week number, where each week starts on Monday. Example values include 01, 02, 53.
IsoYear	Integer	True			The ISO year of the event. Example values include 2022 2023.
IsoYearIsoWeek	Integer	True			The combined values of isoWeek and isoYear. Example values include 201652 and 201701.
YearMonth	Integer	True			The combined values of year and month. Example values include 202212 or 202301.
YearWeek	Integer	True			The combined values of year and week. Example values include 202253 or 202301.
Hour	Integer	True			A two-digit hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time.
AudienceName	String	True			The given name of an Audience.
FirstUserCampaignName	String	True			Name of the marketing campaign that first acquired the user.
FirstUserGoogleAdsCreativeId	String	True			The campaign creative ID that first acquired the user.
FirstUserGoogleAdsAdGroupId	String	True			The Ad Group Id in Google Ads that first acquired the user.
FirstUserGoogleAdsAdGroupName	String	True			The Ad Group Name in Google Ads that first acquired the user.
FirstUserGoogleAdsAdNetworkType	String	True			The advertising network that first acquired the user.
FirstUserMedium	String	True		True	The medium that first acquired the user to the website or app.
FirstUserSource	String	True			The source that first acquired the user to the website or app.
AveragePurchaseRevenue	Decimal	False	True		The average purchase revenue in the transaction group of events.
AveragePurchaseRevenuePerPayingUser	Decimal	False	True		Average revenue per paying user (ARPPU) is the total purchase revenue per active user that logged a purchase event. The summary metric is for the time period selected.
AverageRevenuePerUser	Decimal	False	True		Average revenue per active user (ARPU). The summary metric is for the time period selected.
EngagedSessionsPerUser	Decimal	False	True		Average number of engaged sessions per user.
FirstTimeBuyersPerNewUsers	Decimal	False	True		Percentage of unique new users to the game who made their first in-app purchase.
FirstTimePurchasers	Integer	False	True		The number of users that completed their first purchase event.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
StartDate	String				Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).
EndDate	String				End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

GlobalAccessObject

Retrieves data for all the available dimensions and metrics.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
achievementId	String	True			The achievement Id in a game for an event. Populated by the event parameter achievementid.
adFormat	String	True			Describes the way ads looked and where they were located. Typical formats include Interstitial, Banner, Rewarded, and Native advanced.
adSourceName	String	True			The source network that served the ad. Typical sources include AdMob Network, Liftoff, Facebook Audience Network, and Mediated house ads.
adUnitName	String	True			The name you chose to describe this Ad unit. Ad units are containers you place in your apps to show ads to users.
appVersion	String	True			The apps versionName (Android) or short bundle version (iOS).
audienceId	String	True			The numeric identifier of an Audience. Users are reported in the audiences to which they belonged during the reports date range. Current user behavior does not affect historical audience membership in reports.
audienceName	String	True			The given name of an Audience. Users are reported in the audiences to which they belonged during the report's date range. Current user behavior does not affect historical audience membership in reports.
brandingInterest	String	True			Interests demonstrated by users who are higher in the shopping funnel. Users can be counted in multiple interest categories.
browser	String	True			The browsers used to view your website.
campaignId	String	True			The identifier of the marketing campaign. Present only for conversion events. Includes Google Ads Campaigns, Manual Campaigns, and other Campaigns.
campaignName	String	True			The name of the marketing campaign. Present only for conversion events. Includes Google Ads Campaigns, Manual Campaigns, and other Campaigns.
character	String	True			The player character in a game for an event. Populated by the event parameter character.
city	String	True			The city from which the user activity originated.
cityId	String	True			The geographic Id of the city from which the user activity originated, derived from their IP address.
cohort	String	True			The cohorts name in the request. A cohort is a set of users who started using your website or app in any consecutive group of days. If a cohort name is not specified in the request, cohorts are named by their zero based index: cohort_0, cohort_1, etc.
cohortNthDay	String	True			Day offset relative to the firstSessionDate for the users in the cohort. For example, if a cohort is selected with the start and end date of 2020-03-01, then for the date 2020-03-02, cohortNthDay is 0001.
cohortNthMonth	String	True			Month offset relative to the firstSessionDate for the users in the cohort. Month boundaries align with calendar month boundaries. For example, if a cohort is selected with the start and end date in March 2020, then for any date in April 2020, cohortNthMonth is 0001.
cohortNthWeek	String	True			Week offset relative to the firstSessionDate for the users in the cohort. Weeks start on Sunday and end on Saturday. For example, if a cohort is selected with the start and end date in the range 2020-11-08 to 2020-11-14, then for the dates in the range 2020-11-15 to 2020-11-21, cohortNthWeek is 0001.
contentGroup	String	True			A category that applies to items of published content. Populated by the event parameter content_group.
contentId	String	True			The identifier of the selected content. Populated by the event parameter content_id.
contentType	String	True			The category of the selected content. Populated by the event parameter content_type.
continent	String	True			The continent from which the user activity originated. For example, Americas or Asia.
continentId	String	True			The geographic Id of the continent from which the user activity originated, derived from their IP address.
country	String	True			The country from which the user activity originated.
countryId	String	True			The geographic Id of the country from which the user activity originated, derived from their IP address. Formatted according to ISO 3166-1 alpha-2 standard.
date	String	True			The date of the event, formatted as YYYYMMDD.
dateHour	String	True			The combined values of date and hour formatted as YYYYMMDDHH.
dateHourMinute	String	True			The combined values of date, hour, and minute formatted as YYYYMMDDHHMM.
day	String	True			The day of the month, a two-digit number from 01 to 31.
dayOfWeek	String	True			The integer day of the week. It returns values in the range [0,6] with Sunday as the first day of the week.
dayOfWeekName	String	True			The day of the week in English. This dimension has values of Sunday, Monday, etc.
defaultChannelGroup	String	True			The conversion's default channel group is based primarily on source and medium.
deviceCategory	String	True			The type of device: Desktop, Tablet, or Mobile.
deviceModel	String	True			The mobile device model (example: iPhone 10,6).
eventName	String	True			The name of the event.
fileExtension	String	True			The extension of the downloaded file (for example, pdf or txt). Automatically populated if Enhanced Measurement is enabled .
fileName	String	True			The page path of the downloaded file . Automatically populated if Enhanced Measurement is enabled.
firstSessionDate	String	True			The date the user's first session occurred, formatted as YYYYMMDD.
firstUserCampaignId	String	True			Identifier of the marketing campaign that first acquired the user. Includes Google Ads Campaigns, Manual Campaigns, and other Campaigns.
firstUserCampaignName	String	True			Name of the marketing campaign that first acquired the user. Includes Google Ads Campaigns, Manual Campaigns, and other Campaigns.
firstUserDefaultChannelGroup	String	True			The default channel group that first acquired the user. Default channel group is based primarily on source and medium.
firstUserGoogleAdsAccountName	String	True			The Account name from Google Ads that first acquired the user.
firstUserGoogleAdsAdGroupId	String	True			The Ad Group Id in Google Ads that first acquired the user.
firstUserGoogleAdsAdGroupName	String	True			The Ad Group Name in Google Ads that first acquired the user.
firstUserGoogleAdsAdNetworkType	String	True			The advertising network that first acquired the user.
firstUserGoogleAdsCampaignId	String	True			Identifier of the Google Ads marketing campaign that first acquired the user.
firstUserGoogleAdsCampaignName	String	True			Name of the Google Ads marketing campaign that first acquired the user.
firstUserGoogleAdsCampaignType	String	True			The campaign type of the Google Ads campaign that first acquired the user. Campaign types determine where customers see your ads and the settings and options available to you in Google Ads. Campaign type is an enumeration that includes: Search, Display, Shopping, Video, Discovery, App, Smart, Hotel, Local, and Performance Max.
firstUserGoogleAdsCreativeId	String	True			The Id of the Google Ads creative that first acquired the user. Creative IDs identify individual ads.
firstUserGoogleAdsCustomerId	String	True			The Customer Id from Google Ads that first acquired the user. Customer IDs in Google Ads uniquely identify Google Ads accounts.
firstUserGoogleAdsKeyword	String	True			The matched keyword that first acquired the user. Keywords are words or phrases describing your product or service that you choose to get your ad in front of the right customers.
firstUserGoogleAdsQuery	String	True			The search query that first acquired the user.
firstUserManualAdContent	String	True			The ad content that first acquired the user. Populated by the utm_content parameter.
firstUserManualTerm	String	True			The term that first acquired the user. Populated by the utm_term parameter.
firstUserMedium	String	True			The medium that first acquired the user to your website or app.
firstUserSource	String	True			The source that first acquired the user to your website or app.
firstUserSourceMedium	String	True			The combined values of the dimensions firstUserSource and firstUserMedium.
firstUserSourcePlatform	String	True			The source platform that first acquired the user. Please do not depend on this field returning Manual for traffic that uses UTMs; this field will update from returning Manual to returning (not set) for an upcoming feature launch.
fullPageUrl	String	True			The hostname, page path, and query string for web pages visited
googleAdsAccountName	String	True			The Account name from Google Ads for the campaign that led to the conversion event. Corresponds to customer.descriptive_name in the Google Ads API.
googleAdsAdGroupId	String	True			The ad group id attributed to the conversion event.
googleAdsAdGroupName	String	True			The ad group name attributed to the conversion event.
googleAdsAdNetworkType	String	True			The advertising network type of the conversion.
googleAdsCampaignId	String	True			The campaign Id for the Google Ads campaign attributed to the conversion event.
googleAdsCampaignName	String	True			The campaign name for the Google Ads campaign attributed to the conversion event.
googleAdsCampaignType	String	True			The campaign type for the Google Ads campaign attributed to the conversion event. Campaign types determine where customers see your ads and the settings and options available to you in Google Ads. Campaign type is an enumeration that includes: Search, Display, Shopping, Video, Discovery, App, Smart, Hotel, Local, and Performance Max.
googleAdsCreativeId	String	True			The Id of the Google Ads creative attributed to the conversion event. Creative IDs identify individual ads.
googleAdsCustomerId	String	True			The Customer Id from Google Ads for the campaign that led to conversion event. Customer IDs in Google Ads uniquely identify Google Ads accounts.
googleAdsKeyword	String	True			The matched keyword that led to the conversion event. Keywords are words or phrases describing your product or service that you choose to get your ad in front of the right customers.
googleAdsQuery	String	True			The search query that led to the conversion event.
groupId	String	True			The player group Id in a game for an event. Populated by the event parameter group_id.
hostName	String	True			Includes the subdomain and domain names of a URL; for example, the Host Name of www.example.com/contact.html is www.example.com.
hour	String	True			The two-digit hour of the day that the event was logged. This dimension ranges from 0-23 and is reported in your property's timezone.
isConversionEvent	String	True			The string 'true' if the event is a conversion. Events are marked as conversions at collection time; changes to an event's conversion marking apply going forward. You can mark any event as a conversion in Google Analytics, and some events (i.e. first_open, purchase) are marked as conversions by default.
isoWeek	String	True			ISO week number, where each week starts on Monday. Example values include 01, 02, and 53.
isoYear	String	True			The ISO year of the event. Example values include 2022 and 2023.
isoYearIsoWeek	String	True			The combined values of isoWeek and isoYear. Example values include 201652 and 201701.
itemAffiliation	String	True			The name or code of the affiliate (partner/vendor if any) associated with an individual item. Populated by the 'affiliation' item parameter.
itemBrand	String	True			Brand name of the item.
itemCategory	String	True			The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Apparel is the item category.
itemCategory2	String	True			The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Mens is the item category 2.
itemCategory3	String	True			The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Summer is the item category 3.
itemCategory4	String	True			The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Shirts is the item category 4.
itemCategory5	String	True			The hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, T-shirts is the item category 5.
itemId	String	True			The Id of the item.
itemListId	String	True			The Id of the item list.
itemListName	String	True			The name of the item list.
itemListPosition	String	True			The position of an item (e.g., a product you sell) in a list. This dimension is populated in tagging by the index parameter in the items array.
itemLocationID	String	True			The physical location associated with the item (e.g. the physical store location). It is recommended to use the [Google Place ID] that corresponds to the associated item. A custom location Id can also be used. This field is populated in tagging by the location_id parameter in the items array.
itemName	String	True			The name of the item.
itemPromotionCreativeName	String	True			The name of the item-promotion creative.
itemPromotionCreativeSlot	String	True			The name of the promotional creative slot associated with the item. This dimension can be specified in tagging by the creative_slot parameter at the event or item level. If the parameter is specified at both the event and item level, the item-level parameter is used.
itemPromotionId	String	True			The Id of the item promotion.
itemPromotionName	String	True			The name of the promotion for the item.
itemVariant	String	True			The specific variation of a product. e.g., XS, S, M, L for size; or Red, Blue, Green, Black for color. Populated by the item_variant parameter.
landingPage	String	True			The page path associated with the first pageview in a session.
landingPagePlusQueryString	String	True			The page path + query string associated with the first pageview in a session.
language	String	True			The language setting of the user's browser or device. e.g. English
languageCode	String	True			The language setting (ISO 639) of the user's browser or device. e.g. en-us
level	String	True			The players level in a game. Populated by the event parameter level.
linkClasses	String	True			The HTML class attribute for an outbound link
StartDate	String				Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).
EndDate	String				End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).

KeyEvents

A base view that retrieves KeyEvents data

Table Specific Information

Select

Retrieves data for KeyEvents reports. At least one metric must be specified in the query. This endpoint uses the real-time report API endpoint to get more up-to-date data than the standard reporting endpoint. The real-time reporting API supports a maximum of four dimensions compared to nine for the standard report API.

The following is an example query:

	SELECT KeyEvents, EventName FROM KeyEvents;

Since PagePath and PlatTitle dimensions are not available in the runRealReport endpoint, use the connection property ReportType = reports to leverage the result with these dimensions.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
AppVersion	String	True			The application's versionName (Android) or short bundle version (iOS)
City	String	True			The city from which the user activity originated
Country	String	True			The country from which the user activity originated
DeviceCategory	String	True			The type of device: Desktop, Tablet, or Mobile
Platform	String	True			The platform on which your app or website ran
AudienceName	String	True			The given name of an Audience
UnifiedScreenName	String	True			The page title (web) or screen name (app) on which the event was logged
EventName	String	True		True	The name of the event
PagePath	String	True			The portion of the URL between the hostname and query string for web. This works when connection property ReportType=reports;.
PageTitle	String	True			The web page titles used on your site. This works when connection property ReportType=reports;
AudienceId	Long	True			The numeric identifier of an Audience.
AudienceResourceName	String	True			The resource name of this audience.
CityId	Integer	True			The geographic ID of the city from which the user activity originated, derived from their IP address.
CountryId	String	True			The geographic ID of the country from which the user activity originated, derived from their IP address.
MinutesAgo	Integer	True			The number of minutes ago that an event was collected. 00 is the current minute, and 01 means the previous minute.
StreamId	Long	True			The numeric data stream identifier for your app or website.
StreamName	String	True			The data stream name for your app or website.
KeyEvents	String	False	True		The count of key events.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table

MetaData

Retrieves metadata information for standard and custom dimensions / metrics.

Table Specific Information

Select

Retrieves metadata information for standard and custom dimensions / metrics. If PropertyID connection property not set, dimensions and metrics common to all properties will be retrieved. The following is an example query:

	SELECT * FROM Metadata

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
ApiName	String				The API name for the dimension / metric.
CustomDefinition	Boolean				Whether the dimension / metric is custom or not.
Description	String				Description of how the dimension / metric is used and calculated.
Type	String				Datatype of the dimension / metric.
FieldType	String				Whether the field is a dimension or metric.
UIName	String				The dimension / metric name within the Google Analytics user interface.
DimensionDeprecatedAPINames	String				Returns the list of depricated names for this dimension but still usable.
MetricDeprecatedAPINames	String				Returns the list of depricated names for this metric but still usable.
Expressions	String				The mathematical expression for this derived metric.
BlockedReasons	String				Return the reasons why access to this metric is blocked for this property.
Category	String				The display name of the category that this dimension / metric belongs to.

Monetization

A base view that retrieves Monetization data.

Table Specific Information

Select

Retrieves data for Monetization report. At least one metric must be specified in the query. In the query you can also specify up to nine dimensions. The following is an example query:

	SELECT ItemsAddedToCart, CartToViewRate FROM Monetization

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
Date	Date	True			The date of the session formatted as YYYYMMDD.
Year	Integer	True			The year of the session. A four-digit year from 2005 to the current year.
Month	Integer	True			The month of the session. An integer from 01 to 12.
Week	Integer	True			The week of the session. A number from 01 to 53. Each week starts on Sunday.
Day	Integer	True			The day of the month. A number from 01 to 31.
DayOfWeekName	String	True			The day of the week in English. This dimension has values of Sunday, Monday, etc.
IsoWeek	Integer	True			ISO week number, where each week starts on Monday. Example values include 01, 02, 53.
IsoYear	Integer	True			The ISO year of the event. Example values include 2022 2023.
IsoYearIsoWeek	Integer	True			The combined values of isoWeek and isoYear. Example values include 201652 and 201701.
YearMonth	Integer	True			The combined values of year and month. Example values include 202212 or 202301.
YearWeek	Integer	True			The combined values of year and week. Example values include 202253 or 202301.
Hour	Integer	True			An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time.
Country	String	True			The country of users, derived from IP addresses.
City	String	True			The cities of property users, derived from IP addresses.
AdFormat	String	True			Format of the ad(e.g., text, image, video).
AdSourceName	String	True			Demand source that provided the ad.
AdUnitName	String	True			Space on the website or app that displayed the ad.
ItemBrand	String	True			Brand name of the item.
ItemCategory	String	True			Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Apparel is the item category.
ItemCategory2	String	True			Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Mens is the item category2
ItemCategory3	String	True			Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Summer is the item category3.
ItemCategory4	String	True			Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, Shirts is the item category4.
ItemCategory5	String	True			Hierarchical category in which the item is classified. For example, in Apparel/Mens/Summer/Shirts/T-shirts, T-shirts is the item category5.
ItemId	String	True			ID of the item.
ItemListId	String	True			The ID of the item list.
ItemListName	String	True			The name of the item list.
ItemName	String	True		True	The name of the item.
ItemPromotionCreativeName	String	True			The name of the item-promotion creative.
ItemPromotionId	String	True			ID of the item promotion.
ItemPromotionName	String	True			Name of the promotion for the item.
OrderCoupon	String	True			Code for the order-level coupon.
UnifiedPageScreen	String	True			The page path (web) or screen class (app) on which the event was logged.
TransactionId	String	True			The ID of the ecommerce transaction.
adUnitExposure	Integer	False			The amount of time the ad unit was exposed to the user. This metric is not compatible with item-scoped dimensions.
ItemsAddedToCart	Integer	False	True		The number of times users added items to their shopping carts. Since AddToCarts is not compatible with item-scoped dimensions, hence this is the replacement of the AddToCarts metric.
CartToViewRate	Decimal	False	True		The number of users who added a product(s) to their cart divided by the number of users who viewed the same product(s).
ItemsCheckedOut	Integer	False	True		Number of times users started the checkout process. Since Checkouts is not compatible with item-scoped dimensions, hence this is the replacement of the Checkouts metric.
EcommercePurchases	Integer	False			The number of times users completed a purchase. This metric is not compatible with item-scoped dimensions.
EventCount	Integer	False			The count of events. This metric is not compatible with item-scoped dimensions. This metric is not compatible with item-scoped dimensions.
FirstTimePurchasers	Integer	False	True		The number of users that completed their first purchase event.
ItemsClickedInList	Integer	False	True		The number of times users clicked an item when it appeared in a list. Since ItemListClicks is not compatible with item-scoped dimensions, hence this is the replacement of the ItemListClicks metric.
ItemListClickThroughRate	Decimal	False	True		Rate at which users clicked the item in an item list to view the item details.
ItemsViewedInList	Integer	False	True		The number of times the item list was viewed. Since ItemListViews is not compatible with item-scoped dimensions, hence this is the replacement of the ItemListViews metric.
PromotionClicks	Integer	False			The number of times an item promotion was clicked. ItemPromotionClicks metric has been renamed to this metric.
ItemPromotionClickThroughRate	Decimal	False			The number of users who selected a promotion(s) divided by the number of users who viewed the same promotion(s).
PromotionViews	Integer	False			The number of times an item promotion was viewed. ItemPromotionViews metric has been renamed to this metric.
ItemsPurchased	Integer	False			The total amount of tax. ItemPurchaseQuantity metric has been renamed to this metric.
ItemRevenue	Decimal	False			The total revenue from items only. Item revenue is the product of its price and quantity.
ItemViewEvents	Integer	False			The number of times the item details were viewed. ItemViews metric has been renamed to this metric.
PublisherAdClicks	Integer	False			The number of times an ad was clicked on the publisher's site.
PublisherAdImpressions	Integer	False			The number of times an ad was displayed on the publisher's site.
PurchaseToViewRate	Decimal	False			The total cost of shipping.
TotalAdRevenue	Integer	False			Sum of all advertising revenue.
StartDate	String				Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).
EndDate	String				End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

MonetizationPublisherAdsAdFormatReport

A predefined view that retrieves publisher ads page ad format data.

n

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
AdFormat supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE PropertyId = 342020667
SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE AdFormat = 'image' 
SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE Date = '01/05/2023' 
SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE PropertyId = 342020667  AND AdFormat = 'image' AND Date = '01/05/2023'
SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE Date >= '01/01/2022'
SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE Date <= '01/01/2022'
SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE Date >  '01/01/2022'
SELECT * FROM MonetizationPublisherAdsAdFormatReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
AdFormat	String	True		True	Format of the ad(e.g., text, image, video).
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
PublisherAdImpressions	Integer	False	True		The number of times an ad was displayed on the publishers site.
adUnitExposure	Integer	False	True		The amount of time the ad unit was exposed to the user.
PublisherAdClicks	Integer	False	True		The number of times an ad was clicked on the publisherss site.
TotalAdRevenue	Integer	False	True		Sum of all advertising revenue.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	The Property Id value to be used when querying this table.

MonetizationPublisherAdsAdSourceReport

A predefined view that retrieves publisher ads ad source data.

n

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
AdSourceName supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE PropertyId = 342020667
SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE AdSourceName = 'test' 
SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE Date = '01/05/2023' 
SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE PropertyId = 342020667  AND AdSourceName = 'test' AND Date = '01/05/2023'
SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE Date >= '01/01/2022'
SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE Date <= '01/01/2022'
SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE Date >  '01/01/2022'
SELECT * FROM MonetizationPublisherAdsAdSourceReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
AdSourceName	String	True		True	Demand source that provided the ad.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
PublisherAdImpressions	Integer	False	True		The number of times an ad was displayed on the publishers site.
adUnitExposure	Integer	False	True		The amount of time the ad unit was exposed to the user.
PublisherAdClicks	Integer	False	True		The number of times an ad was clicked on the publishers site.
TotalAdRevenue	Integer	False	True		Sum of all advertising revenue.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	The Property Id value to be used when querying this table.

MonetizationPublisherAdsAdUnitReport

A predefined view that retrieves publisher ads ad unit data.

n

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
AdUnitName supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE PropertyId = 342020667
SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE AdUnitName = 'Test' 
SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE Date = '01/05/2023' 
SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE PropertyId = 342020667  AND AdUnitName = 'Test' AND Date = '01/05/2023'
SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE Date >= '01/01/2022'
SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE Date <= '01/01/2022'
SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE Date >  '01/01/2022'
SELECT * FROM MonetizationPublisherAdsAdUnitReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
AdUnitName	String	True		True	Space on the website or app that displayed the ad.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
PublisherAdImpressions	Integer	False	True		The number of times an ad was displayed on the publishers site.
adUnitExposure	Integer	False	True		The amount of time the ad unit was exposed to the user.
PublisherAdClicks	Integer	False	True		The number of times an ad was clicked on the publishers site.
TotalAdRevenue	Integer	False	True		Sum of all advertising revenue.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	The Property Id value to be used when querying this table.

MonetizationPublisherAdsPagePathReport

A predefined view that retrieves publisher ads page path data.

n

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
PagePath supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE PropertyId = 342020667
SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE PagePath = '/cdataH.test.io/' 
SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE Date = '01/05/2023' 
SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE PropertyId = 342020667  AND PagePath = '/cdataH.test.io/' AND Date = '01/05/2023'
SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE Date >= '01/01/2022'
SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE Date <= '01/01/2022'
SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE Date >  '01/01/2022'
SELECT * FROM MonetizationPublisherAdsPagePathReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
PagePath	String	True		True	The portion of the URL between the hostname and query string for web.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
PublisherAdImpressions	Integer	False	True		The number of times an ad was displayed on the publishers site.
adUnitExposure	Integer	False	True		The amount of time the ad unit was exposed to the user.
PublisherAdClicks	Integer	False	True		The number of times an ad was clicked on the publishers site.
TotalAdRevenue	Integer	False	True		Sum of all advertising revenue.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	The Property Id value to be used when querying this table.

Properties

Lists all Properties to which the user has access.

Table Specific Information

Select

The provider will use the GoogleAnalytics4 API to process WHERE clause conditions built with the following columns and operators: The rest of the filter is executed client-side within the provider.

Parent supports the following operators: =,IN
Id supports the following operators: =,IN

The following queries are processed server-side:

   	SELECT * FROM Properties WHERE Id = '54516992'
    SELECT * FROM Properties WHERE Parent = 'accounts/54516992'

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
CreateTime	Datetime				Time the property was created.
CurrencyCode	String				The currency type used in reports involving monetary values.
DisplayName	String				Display name for the property.
IndustryCategory	String				Industry associated with the property.
Id	Integer				Property Id.
Parent	String				Name of the property's logical parent.
TimeZone	String				Reporting Time Zone.
UpdateTime	Datetime				Time the property was last modified.
DeleteTime	Datetime				Time at which this property was trashed.

PropertiesAccessBindings

Lists all access bindings on an account or property. Requires one of the following OAuth scopes: https://www.googleapis.com/auth/analytics.manage.users.readonly https://www.googleapis.com/auth/analytics.manage.users

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

Parent supports the following operator: =
Name supports the following operator: =

The Name or Parent is required to make a request. For example, the following queries are processed server-side:

	SELECT * FROM PropertiesAccessBindings where parent ='properties/307712345';
	SELECT * FROM PropertiesAccessBindings where name = 'properties/307712345/accessBindings/1234559643';

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
Name [KEY]	String				Resource name of this binding. Format: accounts/{account}/accessBindings/{accessBinding} or properties/{property}/accessBindings/{accessBinding}
Parent	String				Name of the Access Binding's logical parent. Format: accounts/{account} or properties/{property}
User	String				The email address of the user to set roles for.
Roles	String				A list of roles for to grant to the parent resource.
PropertyId	Integer				Property ID value to be used when querying this table.

PropertiesAudiences

Lists Audiences on a property.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

Parent supports the following operator: =
Name supports the following operator: =

The Name or Parent is required to make a request. For example, the following queries are processed server-side:

	SELECT * FROM PropertiesAudiences where parent = 'properties/153123282'
	SELECT * FROM PropertiesAudiences where name = 'properties/211225502/audiences/2041236988'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
Name [KEY]	String				The resource name for this Audience resource. Format: properties/{propertyId}/audiences/{audienceId}
Parent	String				Name of the Audiences's logical parent.
PropertyId	Integer				Property ID value to be used when querying this table.
DisplayName	String				The display name of the Audience.
Description	String				The description of the Audience.
MembershipDurationDays	Integer				The duration a user should stay in an Audience. It cannot be set to more than 540 days.
AdsPersonalizationEnabled	Boolean				It is automatically set by GA to false if this is an NPA Audience and is excluded from ads personalization.
EventTrigger	String				Specifies an event to log when a user joins the Audience. If not set, no event is logged when a user joins the Audience.
ExclusionDurationMode	String				Specifies how long an exclusion lasts for users that meet the exclusion filter. It is applied to all EXCLUDE filter clauses and is ignored when there is no EXCLUDE filter clause in the Audience.
FilterClauses	String				Filter clauses that define the Audience. All clauses will be AND’ed together.
CreateTime	Datetime				Time when the Audience was created.

PropertiesDataStreams

Lists all data streams under a property to which the user has access. Attribute Parent (e.g: 'properties/123') or Name (e.g: 'properties/123/webDataStreams/456') is required to query the table.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

Parent supports the following operator: =
Name supports the following operator: =

The Name or Parent is required to make a request. For example, the following queries are processed server-side:

	SELECT * FROM PropertiesDataStreams WHERE Parent = 'properties/123'
	SELECT * FROM PropertiesDataStreams WHERE Name =   'properties/123/webDataStreams/456'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
CreateTime	Datetime				Time the stream was created.
DisplayName	String				Display name for the data stream.
Name	String				Web data stream name.
Parent	String				Name of the web data stream's logical parent.
Type	String				Name of the web data stream's logical parent.
webStreamData	String				Data specific to web streams.
androidAppStreamData	String				Data specific to Android app streams.
iosAppStreamData	String				Data specific to iOS app streams.
UpdateTime	Datetime				Time the stream was last modified.
PropertyId	Integer				The Property Id value to be used when querying this table.

PropertiesFireBaseLinks

Lists all FirebaseLinks on a property to which the user has access.

Table Specific Information

Select

Lists all FirebaseLinks on a property to which the user has access. The provider uses the GoogleAnalytics4 API to process WHERE clause conditions built with the Parent column and the = operator. Queries are processed server-side.

The following is an example query:

	SELECT * FROM PropertiesFirebaseLinks WHERE Parent = 'properties/54516992'

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
CreateTime	Datetime				Time the FirebaseLink was created.
MaximumUserAccess	String				Maximum user access to the property allowed to admins of the linked Firebase project.
Name	String				FirebaseLink name.
Parent	String				Name of the FirebaseLink's logical parent.
Project	String				Firebase project resource name.
PropertyId	Integer				The Property Id value to be used when querying this table.

PropertiesGoogleAdsLinks

Lists all GoogleAdsLinks on a property to which the user has access.

Table Specific Information

Select

Lists all GoogleAdsLinks on a property to which the user has access. The provider will use the GoogleAnalytics4 API to process WHERE clause conditions built with the Parent column with the = operator. Queries are processed server-side, and a value for the attribute Parent is required to query this table. The following is an example query:

	SELECT * FROM PropertiesGoogleAdsLinks WHERE Parent = 'properties/54516992'

The rest of the filter is executed client-side within the provider.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
CanManageClients	Boolean				Whether the link if for a Google Ads manager account.
AdsPersonalizationEnabled	Boolean				Whether to enable personalized advertising.
CreateTime	Datetime				Time the link was created.
CustomerId	String				Google Ads customer ID.
EmailAddress	String				Email address of the user that created the link.
Name	String				GoogleAdsLinks name.
Parent	String				Name of the GoogleAdsLink's logical parent.
UpdateTime	Datetime				Time the link was last modified.
PropertyId	Integer				The Property Id value to be used when querying this table.

PropertiesKeyEvents

Returns a list of Key Events in the specified parent property.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

Parent supports the following operator: =
Name supports the following operator: =

The Name or Parent is required to make a request. For example, the following queries are processed server-side:

	SELECT * FROM PropertiesKeyEvents where parent = 'properties/309787233'
	SELECT * FROM PropertiesKeyEvents where name = 'properties/309787233/keyEvents/7710067029'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
Name [KEY]	String				Resource name of this key event. Format: properties/{property}/keyEvents/{keyEvent}
Parent	String				Name of the Key Events's logical parent.
PropertyId	Integer				Property ID value to be used when querying this table.
EventName	String				The event name for this key event. Examples: 'click', 'purchase'
CreateTime	Datetime				Time when this key event was created in the property.
Deletable	Boolean				Whether this event can be deleted.
Custom	Boolean				Whether this key event refers to a custom event.
CountingMethod	String				The method by which Key Events will be counted across multiple events within a session.
DefaultValue	String				Defines a default value/currency for a key event.

ScreenPageViews

A base view that retrieves ScreenPage data

Table Specific Information

Select

Retrieves data for ScreenPageViews reports. At least one metric must be specified in the query. This endpoint uses the real-time report API endpoint to get more up-to-date data than the standard reporting endpoint. The real-time reporting API supports a maximum of four dimensions compared to nine for the standard report API.

The following is an example query:

	SELECT ScreenPageViews, EventName FROM ScreenPageViews;

Since PagePath and PlatTitle dimensions are not available in the runRealReport endpoint, use the connection property ReportType = reports to leverage the result with these dimensions.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
AppVersion	String	True			The application's versionName (Android) or short bundle version (iOS)
City	String	True			The city from which the user activity originated
Country	String	True			The country from which the user activity originated
DeviceCategory	String	True			The type of device: Desktop, Tablet, or Mobile
Platform	String	True			The platform on which your app or website ran
AudienceName	String	True			The given name of an Audience
UnifiedScreenName	String	True			The page title (web) or screen name (app) on which the event was logged
EventName	String	True		True	The name of the event
PagePath	String	True			The portion of the URL between the hostname and query string for web. This works when connection property ReportType=reports;.
PageTitle	String	True			The web page titles used on your site. This works when connection property ReportType=reports;
AudienceId	Long	True			The numeric identifier of an Audience.
AudienceResourceName	String	True			The resource name of this audience.
CityId	Integer	True			The geographic ID of the city from which the user activity originated, derived from their IP address.
CountryId	String	True			The geographic ID of the country from which the user activity originated, derived from their IP address.
MinutesAgo	Integer	True			The number of minutes ago that an event was collected. 00 is the current minute, and 01 means the previous minute.
StreamId	Long	True			The numeric data stream identifier for your app or website.
StreamName	String	True			The data stream name for your app or website.
ScreenPageViews	String	False	True		The number of app screens or web pages your users viewed. Repeated views of a single page or screen are counted.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table

Tech

A base view that retrieves Tech data.

Table Specific Information

Select

Retrieves data for Tech report. At least one metric must be specified in the query. In the query you can also specify up to nine dimensions. The following is an example query:

	SELECT Conversions, EngagementRate, EventCount FROM Tech

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
Date	Date	True			The date of the session formatted as YYYYMMDD.
Year	Integer	True			The year of the session. A four-digit year from 2005 to the current year.
Month	Integer	True			The month of the session. An integer from 01 to 12.
Week	Integer	True			The week of the session. A number from 01 to 53. Each week starts on Sunday.
Day	Integer	True			The day of the month. A number from 01 to 31.
DayOfWeekName	String	True			The day of the week in English. This dimension has values of Sunday, Monday, etc.
IsoWeek	Integer	True			ISO week number, where each week starts on Monday. Example values include 01, 02, 53.
IsoYear	Integer	True			The ISO year of the event. Example values include 2022 2023.
IsoYearIsoWeek	Integer	True			The combined values of isoWeek and isoYear. Example values include 201652 and 201701.
YearMonth	Integer	True			The combined values of year and month. Example values include 202212 or 202301.
YearWeek	Integer	True			The combined values of year and week. Example values include 202253 or 202301.
Hour	Integer	True			An hour of the day ranging from 00-23 in the timezone configured for the account. This value is also corrected for daylight savings time.
AppVersion	String	True			Version of the app.
Browser	String	True		True	Browser used to engage with the site.
DeviceCategory	String	True			Type of device used to engage with the site/app: Desktop, Tablet, or Mobile.
DeviceModel	String	True			Model of the device used to engage with the site/app.
OperatingSystem	String	True			Operating systems used by visitors to the app or website.
OperatingSystemVersion	String	True			Version of the operating systems used by visitors to the app or website.
OperatingSystemWithVersion	String	True			Operating system name and version.
Platform	String	True			Platform for the app or site (Android, iOS, Web).
ScreenResolution	String	True			Resolution of the screen used to engage with the site/app.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.
StartDate	String				Start date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).
EndDate	String				End date for fetching Analytics data. Either a date string or a relative date (e.g., today, yesterday, or #daysAgo).

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

TechAppVersionReport

A predefined view that retrieves Tech App Version data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
AppVersion supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM TechAppVersionReport WHERE PropertyId = 342020667
SELECT * FROM TechAppVersionReport WHERE AppVersion = 'test' 
SELECT * FROM TechAppVersionReport WHERE Date = '01/05/2023' 
SELECT * FROM TechAppVersionReport WHERE PropertyId = 342020667  AND AppVersion = 'test' AND Date = '01/05/2023'
SELECT * FROM TechAppVersionReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM TechAppVersionReport WHERE Date >= '01/01/2022'
SELECT * FROM TechAppVersionReport WHERE Date <= '01/01/2022'
SELECT * FROM TechAppVersionReport WHERE Date >  '01/01/2022'
SELECT * FROM TechAppVersionReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
AppVersion	String	True		True	Version of the app.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

TechBrowserReport

A predefined view that retrieves Tech Browser data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
Browser supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM TechBrowserReport WHERE PropertyId = 342020667
SELECT * FROM TechBrowserReport WHERE Browser = 'chrome' 
SELECT * FROM TechBrowserReport WHERE Date = '01/05/2023' 
SELECT * FROM TechBrowserReport WHERE PropertyId = 342020667  AND Browser = 'chrome' AND Date = '01/05/2023'
SELECT * FROM TechBrowserReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM TechBrowserReport WHERE Date >= '01/01/2022'
SELECT * FROM TechBrowserReport WHERE Date <= '01/01/2022'
SELECT * FROM TechBrowserReport WHERE Date >  '01/01/2022'
SELECT * FROM TechBrowserReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
Browser	String	True		True	Browser used to engage with the site.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

TechDeviceCategoryReport

A predefined view that retrieves Tech Device Category data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
DeviceCategory supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM TechDeviceCategoryReport WHERE PropertyId = 342020667
SELECT * FROM TechDeviceCategoryReport WHERE  DeviceCategory = 'desktop' 
SELECT * FROM TechDeviceCategoryReport WHERE Date = '01/05/2023' 
SELECT * FROM TechDeviceCategoryReport WHERE PropertyId = 342020667  AND  DeviceCategory = 'desktop' AND Date = '01/05/2023'
SELECT * FROM TechDeviceCategoryReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM TechDeviceCategoryReport WHERE Date >= '01/01/2022'
SELECT * FROM TechDeviceCategoryReport WHERE Date <= '01/01/2022'
SELECT * FROM TechDeviceCategoryReport WHERE Date >  '01/01/2022'
SELECT * FROM TechDeviceCategoryReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
DeviceCategory	String	True		True	Type of device used to engage with the site/app: Desktop, Tablet, or Mobile.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

TechDeviceModelReport

A predefined view that retrieves Tech Device Model data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
DeviceModel supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM TechDeviceModelReport WHERE PropertyId = 342020667
SELECT * FROM TechDeviceModelReport WHERE DeviceModel = 'test' 
SELECT * FROM TechDeviceModelReport WHERE Date = '01/01/2022' 
SELECT * FROM TechDeviceModelReport WHERE PropertyId = 342020667  AND DeviceModel = 'test' AND Date = '01/01/2022'
SELECT * FROM TechDeviceModelReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM TechDeviceModelReport WHERE Date >= '01/01/2022'
SELECT * FROM TechDeviceModelReport WHERE Date <= '01/01/2022'
SELECT * FROM TechDeviceModelReport WHERE Date >  '01/01/2022'
SELECT * FROM TechDeviceModelReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
DeviceModel	String	True		True	Model of the device used to engage with the site/app.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

TechOSSystemReport

A predefined view that retrieves Tech os system data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
OperatingSystem supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM TechOSSystemReport WHERE PropertyId = 342020667
SELECT * FROM TechOSSystemReport WHERE OperatingSystem = 'Windows' 
SELECT * FROM TechOSSystemReport WHERE Date = '01/05/2023' 
SELECT * FROM TechOSSystemReport WHERE PropertyId = 342020667  AND OperatingSystem = 'Windows' AND Date = '01/05/2023'
SELECT * FROM TechOSSystemReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM TechOSSystemReport WHERE Date >= '01/01/2022'
SELECT * FROM TechOSSystemReport WHERE Date <= '01/01/2022'
SELECT * FROM TechOSSystemReport WHERE Date >  '01/01/2022'
SELECT * FROM TechOSSystemReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
OperatingSystem	String	True		True	Operating systems used by visitors to the app or website.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

TechOSVersionReport

A predefined view that retrieves Tech Os version data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
OperatingSystemVersion supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM TechOSVersionReport WHERE PropertyId = 342020667
SELECT * FROM TechOSVersionReport WHERE OperatingSystemVersion = '10' 
SELECT * FROM TechOSVersionReport WHERE Date = '01/01/2022' 
SELECT * FROM TechOSVersionReport WHERE PropertyId = 342020667  AND OperatingSystem = '10' AND Date = '01/01/2022'
SELECT * FROM TechOSVersionReport  WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM TechOSVersionReport  WHERE Date >= '01/01/2022'
SELECT * FROM TechOSVersionReport  WHERE Date <= '01/01/2022'
SELECT * FROM TechOSVersionReport  WHERE Date >  '01/01/2022'
SELECT * FROM TechOSVersionReport  WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
OperatingSystemVersion	String	True		True	Version of the operating systems used by visitors to the app or website.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

TechPlatformDeviceCategoryReport

A predefined view that retrieves Tech platform device category data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
Platform supports the following operator: =
Date supports the following operator: =
DeviceCategory supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM TechPlatformDeviceCategoryReport WHERE PropertyId = 342020667
SELECT * FROM TechPlatformDeviceCategoryReport WHERE Platform = 'web' 
SELECT * FROM TechPlatformDeviceCategoryReport WHERE Date = '01/05/2023' 
SELECT * FROM TechPlatformDeviceCategoryReport WHERE PropertyId = 342020667 AND DeviceCategory = 'desktop'
SELECT * FROM TechPlatformDeviceCategoryReport WHERE PropertyId = 342020667 AND Platform = 'web'
SELECT * FROM TechPlatformDeviceCategoryReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM TechPlatformDeviceCategoryReport WHERE Date >= '01/01/2022'
SELECT * FROM TechPlatformDeviceCategoryReport WHERE Date <= '01/01/2022'
SELECT * FROM TechPlatformDeviceCategoryReport WHERE Date >  '01/01/2022'
SELECT * FROM TechPlatformDeviceCategoryReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
DeviceCategory	String	True		True	Type of device used to engage with the site/app: Desktop, Tablet, or Mobile.
Platform	String	True		True	Platform for the app or site (Android, iOS, Web).
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

TechPlatformReport

A predefined view that retrieves Tech platform data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
OperatinPlatformgSystem supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM TechPlatformReport WHERE PropertyId = 342020667
SELECT * FROM TechPlatformReport WHERE Platform  = 'web' 
SELECT * FROM TechPlatformReport WHERE Date = '01/05/2023' 
SELECT * FROM TechPlatformReport WHERE PropertyId = 342020667  AND Platform = 'web' AND Date = '01/05/2023'
SELECT * FROM TechPlatformReport WHERE PropertyId = 342020667 AND Platform = 'web'
SELECT * FROM TechPlatformReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM TechPlatformReport WHERE Date >= '01/01/2022'
SELECT * FROM TechPlatformReport WHERE Date <= '01/01/2022'
SELECT * FROM TechPlatformReport WHERE Date >  '01/01/2022'
SELECT * FROM TechPlatformReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
Platform	String	True		True	Platform for the app or site (Android, iOS, Web).
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than ten seconds, had a conversion event, or had two or more screen views.
EventCount	Integer	False	True		The count of events.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	The Property Id value to be used when querying this table.

TechScreenResolutionReport

A predefined view that retrieves Tech Screen Resolution data.

Select

The Sync App uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:

PropertyId supports the following operator: =
ScreenResolution supports the following operator: =
Date supports the following operators: =,>=,<=,<,>

For example, the following queries are processed server-side:

SELECT * FROM TechScreenResolutionReport WHERE PropertyId = 342020667
SELECT * FROM TechScreenResolutionReport WHERE ScreenResolution = '1920x1080' 
SELECT * FROM TechScreenResolutionReport WHERE Date = '01/05/2023' 
SELECT * FROM TechScreenResolutionReport WHERE PropertyId = 342020667  AND ScreenResolution = '1920x1080' AND Date = '01/05/2023'
SELECT * FROM TechScreenResolutionReport WHERE Date >= '01/01/2022' AND <= '01/05/2023'
SELECT * FROM TechScreenResolutionReport WHERE Date >= '01/01/2022'
SELECT * FROM TechScreenResolutionReport WHERE Date <= '01/01/2022'
SELECT * FROM TechScreenResolutionReport WHERE Date >  '01/01/2022'
SELECT * FROM TechScreenResolutionReport WHERE Date < '01/01/2022'

The rest of the filter is executed client-side in the Sync App.

Columns


Name	Type	Dimension	DefaultMetric	DefaultDimension	Description
ScreenResolution	String	True		True	Resolution of the screen used to engage with the site/app.
Date	Date	True		True	The date of the session formatted as YYYYMMDD.
Conversions	Decimal	False	True		The count of conversion events.
EngagementRate	Decimal	False	True		The percentage of engaged sessions.
EngagedSessions	Integer	False	True		The number of sessions that lasted longer than 10 seconds, or had a conversion event, or had 2 or more screen views.
EventCount	Integer	False	True		The count of events.
NewUsers	Integer	False	True		The number of users who interacted with the site or launched the app for the first time.
TotalRevenue	Integer	False	True		The sum of revenue from purchases, subscriptions, and advertising.
TotalUsers	Integer	False	True		The total number of users.

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。


Name	Type	Description
PropertyId	String	Property ID value to be used when querying this table.

接続文字列オプション

接続文字列プロパティは、接続を確立するために使用できるさまざまなオプションです。このセクションでは、本プロバイダーの接続文字列で設定できるオプションの一覧を示します。詳細については各リンクをクリックしてください。

接続を確立する方法について詳しくは、接続の確立を参照してください。

Authentication

プロパティ	説明
AuthScheme	Google Analytics に接続する際に使用する認証の種類。
Schema	使用するスキーマの種類。

OAuth

プロパティ	説明
OAuthClientId	カスタムOAuth アプリケーションの作成時に割り当てられたクライアントId を指定します。（コンシューマーキーとも呼ばれます。）このID は、カスタムアプリケーションをOAuth 認可サーバーに登録します。
OAuthClientSecret	カスタムOAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。（コンシューマーシークレットとも呼ばれます。）このシークレットは、カスタムアプリケーションをOAuth 認可サーバーに登録します。
DelegatedServiceAccounts	委任されたリクエストのためのサービスアカウントE メールのスペース区切りのリスト。
RequestingServiceAccount	委任されたリクエストを行うためのサービスアカウントのE メール。

JWT OAuth

プロパティ	説明
OAuthJWTCert	JWT 証明書のストア。
OAuthJWTCertType	JWT 証明書を格納するキーストアの種類。
OAuthJWTCertPassword	OAuth JWT 証明書のパスワード。パスワードを必要とする証明書ストアにアクセスするために使用されます。証明書ストアがパスワードを必要としない場合は、このプロパティを空白のままにします。
OAuthJWTCertSubject	OAuth JWT 証明書のサブジェクトで、ストアで一致する証明書を検索するために使用されます。部分一致と、先頭の証明書を選択するためのワイルドカード '*' をサポートします。
OAuthJWTIssuer	Java Web Token の発行者。
OAuthJWTSubject	アプリケーションからデリゲートアクセスの要求対象となるユーザーサブジェクト。

SSL

プロパティ	説明
SSLServerCert	TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。

Firewall

プロパティ	説明
FirewallType	provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。
FirewallServer	ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。
FirewallPort	プロキシベースのファイアウォールで使用するTCP ポートを指定します。
FirewallUser	プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。
FirewallPassword	プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。

Proxy

プロパティ	説明
ProxyAutoDetect	provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。
ProxyServer	HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
ProxyPort	クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー（ProxyServer 接続プロパティで設定）のTCP ポート。
ProxyAuthScheme	ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。
ProxyUser	ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。
ProxyPassword	ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。
ProxySSLType	ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。
ProxyExceptions	ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

Logging

プロパティ	説明
LogModules	ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。

Schema

プロパティ	説明
Location	テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。
BrowsableSchemas	レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tables	レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。
Views	レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。

Miscellaneous

プロパティ	説明
AWSWorkloadIdentityConfig	AWS 経由でWorkload Identity Federation を使用する場合に指定する設定プロパティ。
DefaultEndDate	A default end date to be applied to all queries.
DefaultStartDate	A default start date to be applied to all queries.
IgnorePermissionsException	特定のプロファイルの権限不足に関する例外を無視するかどうか。
IncludeDeleted	If set to True, the provider include the deleted rows. The default value is False which will not include these rows.
IncludeEmptyRows	If set to false, the provider does not include rows if all the retrieved metrics are equal to zero. The default is true which will include these rows.
MaxRows	集計やGROUP BY を使用しないクエリで返される最大行数を指定します。
Other	特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。
Pagesize	Google Analytics から返される、1ページあたりの結果の最大数を指定します。この設定は、ほとんどのユースケースに最適化されている、データソースによって設定されたデフォルトのページサイズをオーバーライドします。
PropertyId	V4スキーマでレポートビューをクエリする際に使用されるプロパティID 値。
PseudoColumns	テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。
ReportType	Events および ActiveUsers ビューの場合に結果を取得するレポートのタイプ。
SupportEnhancedSQL	このプロパティは、インメモリによるクライアントサイド処理を有効にすることで、API から直接サポートされる範囲を超えるSQL 機能の拡張を可能にします。
Timeout	provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。
UserDefinedViews	カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。
WorkloadPoolId	Workload Identity Federation プールのID。
WorkloadProjectId	Workload Identity Federation プールをホストするGoogle Cloud プロジェクトのID。
WorkloadProviderId	Workload Identity Federation プールプロバイダーのID。

Authentication

このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。

プロパティ	説明
AuthScheme	Google Analytics に接続する際に使用する認証の種類。
Schema	使用するスキーマの種類。

AuthScheme

Google Analytics に接続する際に使用する認証の種類。

解説

OAuth：標準のユーザーアカウントを使用してOAuth 認証を実行する場合に設定。
OAuthJWT：OAuth サービスアカウントを使用してOAuth 認証を実行する場合に設定。
GCPInstanceAccount：Google Cloud Platform インスタンスからアクセストークンを取得する場合に設定。
AWSWorkloadIdentity：Workload Identity Federation を使用して認証する場合に設定。 Sync App はAWSWorkloadIdentityConfig に従ってAWS を認証し、Google Security Token Serivce に認証トークンを提供します。 Google STS はこのトークンを検証し、Google のサービスにアクセスできるOAuth トークンを生成します。

Schema

使用するスキーマの種類。

解説

利用可能なスキーマはGoogleAnalytics4 です。

OAuth

このセクションでは、本プロバイダーの接続文字列で設定可能なOAuth プロパティの全リストを提供します。

プロパティ	説明
OAuthClientId	カスタムOAuth アプリケーションの作成時に割り当てられたクライアントId を指定します。（コンシューマーキーとも呼ばれます。）このID は、カスタムアプリケーションをOAuth 認可サーバーに登録します。
OAuthClientSecret	カスタムOAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。（コンシューマーシークレットとも呼ばれます。）このシークレットは、カスタムアプリケーションをOAuth 認可サーバーに登録します。
DelegatedServiceAccounts	委任されたリクエストのためのサービスアカウントE メールのスペース区切りのリスト。
RequestingServiceAccount	委任されたリクエストを行うためのサービスアカウントのE メール。

OAuthClientId

カスタムOAuth アプリケーションの作成時に割り当てられたクライアントId を指定します。（コンシューマーキーとも呼ばれます。）このID は、カスタムアプリケーションをOAuth 認可サーバーに登録します。

解説

OAuthClientId は、ユーザーがOAuth 経由で認証を行う前に設定する必要があるいくつかの接続パラメータの1つです。詳細は接続の確立を参照してください。

OAuthClientSecret

カスタムOAuth アプリケーションの作成時に割り当てられたクライアントシークレットを指定します。（コンシューマーシークレットとも呼ばれます。）このシークレットは、カスタムアプリケーションをOAuth 認可サーバーに登録します。

解説

OAuthClientSecret は、ユーザーがOAuth 経由で認証を行う前に設定する必要があるいくつかの接続パラメータの1つです。詳細は接続の確立を参照してください。

DelegatedServiceAccounts

委任されたリクエストのためのサービスアカウントE メールのスペース区切りのリスト。

解説

サービスアカウントE メールは、スペース区切りのリストで指定する必要があります。

各サービスアカウントは、チェーン内の次のサービスアカウントのroles/iam.serviceAccountTokenCreator ロールを付与されている必要があります。

チェーンの最後のサービスアカウントは、リクエストするサービスアカウントのroles/iam.serviceAccountTokenCreator ロールが付与されている必要があります。リクエストするサービスアカウントはRequestingServiceAccount プロパティで指定されたものです。

委任されたリクエストの場合、リクエストするサービスアカウントは、iam.serviceAccounts.getAccessToken 権限を持つ必要があることに注意してください。これは、serviceAccountTokenCreator ロールを介して付与することもできます。

RequestingServiceAccount

委任されたリクエストを行うためのサービスアカウントのE メール。

解説

委任されたリクエストで認証情報が要求されたアカウントのサービスアカウントのE メール。DelegatedServiceAccounts の委任されたサービスアカウントのリストを用いて、このプロパティは、委任されたリクエストを行うために使用されます。

このサービスアカウントには、IAM 権限iam.serviceAccounts.getAccessToken が必要です。

JWT OAuth

このセクションでは、本プロバイダーの接続文字列で設定可能なJWT OAuth プロパティの全リストを提供します。

プロパティ	説明
OAuthJWTCert	JWT 証明書のストア。
OAuthJWTCertType	JWT 証明書を格納するキーストアの種類。
OAuthJWTCertPassword	OAuth JWT 証明書のパスワード。パスワードを必要とする証明書ストアにアクセスするために使用されます。証明書ストアがパスワードを必要としない場合は、このプロパティを空白のままにします。
OAuthJWTCertSubject	OAuth JWT 証明書のサブジェクトで、ストアで一致する証明書を検索するために使用されます。部分一致と、先頭の証明書を選択するためのワイルドカード '*' をサポートします。
OAuthJWTIssuer	Java Web Token の発行者。
OAuthJWTSubject	アプリケーションからデリゲートアクセスの要求対象となるユーザーサブジェクト。

OAuthJWTCert

JWT 証明書のストア。

解説

クライアント証明書のための証明書ストア名。

OAuthJWTCertType フィールドは、OAuthJWTCert により指定された証明書ストアの種類を指定します。ストアがパスワードで保護されている場合は、OAuthJWTCertPassword でパスワードを指定します。

OAuthJWTCert は、OAuthJWTCertSubject フィールドとともにクライアント証明書を指定するために使われます。 OAuthJWTCert に値がある場合で、OAuthJWTCertSubject が設定されている場合は、証明書の検索が始まります。詳しくは、OAuthJWTCertSubject フィールドを参照してください。

証明書ストアの指定はプラットフォームに依存します。

Windows の共通のユーザとシステム証明書ストアの指定は以下のとおりです。


MY	個人証明書と関連付けられた秘密キーを格納している証明書ストア。
CA	証明機関の証明書。
ROOT	ルート証明書。
SPC	ソフトウェア発行元証明書。

Javaでは、証明書ストアは通常、証明書および任意の秘密キーを含むファイルです。

証明書ストアの種類がPFXFile の場合は、このプロパティにファイル名を設定します。 PFXBlob の場合は、このプロパティをPFX ファイルのバイナリコンテンツ（例えば、PKCS12証明書ストア）に設定する必要があります。

OAuthJWTCertType

JWT 証明書を格納するキーストアの種類。

解説

このプロパティには次の値の一つを設定できます。


USER	Windows の場合、現在のユーザーにより所有された証明書ストアであることを指定します。 Note：この種類はJava では利用できません。
MACHINE	Windows の場合、この証明書ストアがシステムストアであることを指定します。 Note：この種類はJava では利用できません。
PFXFILE	この証明書ストアは、証明書を含むPFX（PKCS12）ファイルの名前です。
PFXBLOB	この証明書ストアは、PFX（PKCS12）形式の証明書ストアを表すBase-64でエンコードされた文字列です。
JKSFILE	この証明書ストアは、証明書を含むJava key store（JKS）ファイルの名前です。 Note：この種類はJava のみで利用できます。
JKSBLOB	この証明書ストアは、Java key store（JKS）形式の証明書ストアを表すBase-64でエンコードされた文字列です。 Note：この種類はJava のみで利用できます。
PEMKEY_FILE	この証明書ストアは、秘密キーと任意の証明書を含むPEM でエンコードされたファイルの名前です。
PEMKEY_BLOB	この証明書ストアは、秘密キーと任意の証明書を含むBase-64でエンコードされた文字列です。
PUBLIC_KEY_FILE	この証明書ストアは、PEM またはDER でエンコードされた公開キーの証明書を含むファイルの名前です。
PUBLIC_KEY_BLOB	この証明書ストアは、PEM またはDER でエンコードされた公開キーの証明書を含むBase-64でエンコードされた文字列です。
SSHPUBLIC_KEY_FILE	この証明書ストアは、SSH 公開キーを含むファイルの名前です。
SSHPUBLIC_KEY_BLOB	この証明書ストアは、SSH 公開キーを含むBase-64でエンコードされた文字列です。
P7BFILE	この証明書ストアは、証明書を含むPKCS7 ファイルの名前です。
PPKFILE	この証明書ストアは、PuTTY 秘密キー（PPK）を含むファイルの名前です。
XMLFILE	この証明書ストアは、XML 形式の証明書を含むファイルの名前です。
XMLBLOB	この証明書ストアは、XML 形式の証明書を含む文字列の名前です。
BCFKSFILE	この証明書ストアは、Bouncy Castle キーストアを含むファイルの名前です。
BCFKSBLOB	この証明書ストアは、Bouncy Castle キーストアを含む文字列（Base-64エンコード）です。
GOOGLEJSON	この証明書ストアは、サービスアカウント情報を含むJSON ファイルの名前です。Google サービスに接続する場合にのみ有効です。
GOOGLEJSONBLOB	この証明書ストアは、サービスアカウントのJSON を含む文字列です。Google サービスに接続する場合にのみ有効です。

OAuthJWTCertPassword

OAuth JWT 証明書のパスワード。パスワードを必要とする証明書ストアにアクセスするために使用されます。証明書ストアがパスワードを必要としない場合は、このプロパティを空白のままにします。

解説

このプロパティは、証明書ストアを開くために必要なパスワードを指定します。ただし、ストアの種類がパスワードを必要とする場合に限ります。パスワードが必要かどうかを判断するには、ご利用の証明書ストアのドキュメントまたは設定を参照してください。

GOOGLEJSON OAuthJWTCertType を使用する場合は必要ありません。Google JSON キーは暗号化されていません。

OAuthJWTCertSubject

OAuth JWT 証明書のサブジェクトで、ストアで一致する証明書を検索するために使用されます。部分一致と、先頭の証明書を選択するためのワイルドカード '*' をサポートします。

解説

このプロパティの値は、ストアで一致する証明書を検索するために使用されます。検索プロセスは以下のように動作します。

サブジェクトに完全に一致する証明書が見つかれば、該当する証明書が選択されます。
完全に一致するものがない場合、ストアは、サブジェクトがプロパティ値を含む証明書を検索します。
一致する証明書がない場合、証明書は選択されません。

値を '*' に設定すると、ストアの先頭の証明書が自動的に選択されます。証明書のサブジェクトは識別名フィールドおよび値のカンマ区切りのリストです。例：CN=www.server.com, OU=test, C=US, [email protected]。一般的なフィールドには以下のものが含まれます。


フィールド	説明
CN	共通名。一般的には、www.server.com のようなホスト名です。
O	法人名
OU	法人の部署名
L	法人の住所（市町村名）
S	法人の住所（都道府県）
C	国名
E	E メールアドレス

フィールド値にカンマが含まれる場合は、引用符で囲んでください。例："O=ACME, Inc."。

OAuthJWTIssuer

Java Web Token の発行者。

解説

Java Web Token の発行者。サービスアカウントのE メールアドレスの値を入力します。

GOOGLEJSON OAuthJWTCertType を使用する場合は必要ありません。Google JSON キーには、発行者アカウントのコピーが含まれています。

OAuthJWTSubject

アプリケーションからデリゲートアクセスの要求対象となるユーザーサブジェクト。

解説

アプリケーションからデリゲートアクセスの要求対象となるユーザーサブジェクトです。アプリケーションが委任されたアクセスをリクエストするユーザーのE メールアドレスを入力します。

SSL

このセクションでは、本プロバイダーの接続文字列で設定可能なSSL プロパティの全リストを提供します。

プロパティ	説明
SSLServerCert	TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。

SSLServerCert

TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。

解説

TLS/SSL 接続を使用する場合は、このプロパティを使用して、サーバーが受け入れるTLS/SSL 証明書を指定できます。コンピュータによって信頼されていない他の証明書はすべて拒否されます。

このプロパティは、次のフォームを取ります：


説明	例
フルPEM 証明書（例では省略されています）	-----BEGIN CERTIFICATE----- MIIChTCCAe4CAQAwDQYJKoZIhv......Qw== -----END CERTIFICATE-----
証明書を保有するローカルファイルへのパス。	C:\cert.cer
公開鍵（例では省略されています）	-----BEGIN RSA PUBLIC KEY----- MIGfMA0GCSq......AQAB -----END RSA PUBLIC KEY-----
MD5 Thumbprint （hex 値はスペースおよびコロン区切り）	ecadbdda5a1529c58a1e9e09828d70e4
SHA1 Thumbprint （hex 値はスペースおよびコロン区切り）	34a929226ae0819f2ec14b4a3d904f801cbb150d

これを指定しない場合は、マシンが信用するすべての証明書が受け入れられます。

すべての証明書の受け入れを示すには、'*'を使用します。セキュリティ上の理由から、これはお勧めできません。

Firewall

このセクションでは、本プロバイダーの接続文字列で設定可能なFirewall プロパティの全リストを提供します。

プロパティ	説明
FirewallType	provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。
FirewallServer	ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。
FirewallPort	プロキシベースのファイアウォールで使用するTCP ポートを指定します。
FirewallUser	プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。
FirewallPassword	プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。

FirewallType

provider がプロキシベースのファイアウォールを介してトラフィックをトンネリングするために使用するプロトコルを指定します。

解説

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

Note：デフォルトでは、Sync App はシステムプロキシに接続します。この動作を無効化し、次のプロキシタイプのいずれかに接続するには、ProxyAutoDetect をfalse に設定します。

次の表は、サポートされている各プロトコルのポート番号情報です。


プロトコル	デフォルトポート	説明
TUNNEL	80	Sync App がGoogle Analytics への接続を開くポート。トラフィックはこの場所のプロキシを経由して行き来します。
SOCKS4	1080	Sync App がGoogle Analytics への接続を開くポート。SOCKS 4 は次にFirewallUser 値をプロキシに渡し、接続リクエストが許容されるかどうかを決定します。
SOCKS5	1080	Sync App がGoogle Analytics にデータを送信するポート。SOCKS 5 プロキシに認証が必要な場合には、FirewallUser およびFirewallPassword をプロキシが認識する認証情報に設定します。

HTTP プロキシへの接続には、ProxyServer およびProxyPort ポートを使ってください。HTTP プロキシへの認証には、ProxyAuthScheme、ProxyUser、およびProxyPassword を使ってください。

FirewallServer

ファイアウォールを通過し、ユーザーのクエリをネットワークリソースに中継するために使用されるプロキシのIP アドレス、DNS 名、またはホスト名を識別します。

解説

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

FirewallPort

プロキシベースのファイアウォールで使用するTCP ポートを指定します。

解説

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

FirewallUser

プロキシベースのファイアウォールに認証するアカウントのユーザーID を識別します。

解説

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

FirewallPassword

プロキシベースのファイアウォールで認証するユーザーアカウントのパスワードを指定します。

解説

プロキシベースのファイアウォール（またはプロキシファイアウォール）は、ユーザーのリクエストとそれがアクセスするリソースの間に介在するネットワークセキュリティデバイスです。プロキシは認証済みのユーザーのリクエストを受け取り、ファイアウォールを通過して適切なサーバーにリクエストを送信します。

プロキシは、リクエストを送信したユーザーに代わってデータバケットを評価し転送するため、ユーザーはサーバーに直接接続することなく、プロキシのみに接続します。

Proxy

このセクションでは、本プロバイダーの接続文字列で設定可能なProxy プロパティの全リストを提供します。

プロパティ	説明
ProxyAutoDetect	provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。
ProxyServer	HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。
ProxyPort	クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー（ProxyServer 接続プロパティで設定）のTCP ポート。
ProxyAuthScheme	ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。
ProxyUser	ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。
ProxyPassword	ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。
ProxySSLType	ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。
ProxyExceptions	ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

ProxyAutoDetect

provider が、手動で指定されたプロキシサーバーを使用するのではなく、既存のプロキシサーバー構成についてシステムプロキシ設定をチェックするかどうかを指定します。

解説

この接続プロパティをTrue に設定すると、Sync App は既存のプロキシサーバー構成についてシステムプロキシ設定をチェックします（プロキシサーバーの詳細を手動で入力する必要はありません）。

この接続プロパティは他のプロキシ設定より優先されます。特定のプロキシサーバーに接続するためにSync App を手動で構成する場合は、False に設定します。

HTTP プロキシへの接続には、ProxyServer を参照してください。SOCKS やトンネリングなどの他のプロキシには、FirewallType を参照してください。

ProxyServer

HTTP トラフィックをルートするプロキシサーバーのホストネームもしくはIP アドレス。

解説

ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたプロキシサーバーを通じてのみHTTP トラフィックをルーティングします。ProxyAutoDetect がTrue に設定されている場合（デフォルト）、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーを介してHTTP トラフィックをルーティングします。

ProxyPort

クライアントとの間でHTTP トラフィックをルーティングするために予約された、指定されたプロキシサーバー（ProxyServer 接続プロパティで設定）のTCP ポート。

解説

ProxyAutoDetect がFalse に設定されている場合、Sync App はこの接続プロパティで指定されたプロキシサーバーポートを通じてのみHTTP トラフィックをルーティングします。ProxyAutoDetect がTrue に設定されている場合（デフォルト）、Sync App は代わりにシステムプロキシ設定で指定されたプロキシサーバーポートを介してHTTP トラフィックをルーティングします。

その他のプロキシタイプについては、FirewallType を参照してください。

ProxyAuthScheme

ProxyServer 接続プロパティで指定されたプロキシサーバーに対して認証する際にprovider が使用する認証方法を指定します。

解説

認証タイプは次のいずれかです。

BASIC：Sync App はHTTP BASIC 認証を行います。
DIGEST：Sync App はHTTP DIGEST 認証を行います。
NTLM：Sync App はNTLM トークンを取得します。
NEGOTIATE：Sync App は認証において有効なプロトコルに応じて、NTLM もしくはKerberos トークンを取得します。
NONE：ProxyServer が認証を必要としない場合に設定します。

"NONE" 以外のすべての値については、ProxyUser およびProxyPassword 接続プロパティも設定する必要があります。

SOCKS 5 認証のような他の認証タイプを使用するには、FirewallType を参照してください。

ProxyUser

ProxyServer 接続プロパティで指定されたプロキシサーバーに登録されているユーザーアカウントのユーザー名。

解説

ProxyUser および ProxyPassword 接続プロパティは、ProxyServer で指定されたHTTP プロキシに対して接続よび認証するために使用されます。

ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。


ProxyAuthScheme の値	ProxyUser に設定する値
BASIC	プロキシサーバーに登録されているユーザーのユーザー名。
DIGEST	プロキシサーバーに登録されているユーザーのユーザー名。
NEGOTIATE	プロキシサーバーが属するドメインまたは信頼されたドメイン内の有効なユーザーであるWindows ユーザーのユーザー名。`user@domain` または`domain\user` の形式で指定。
NTLM	プロキシサーバーが属するドメインまたは信頼されたドメイン内の有効なユーザーであるWindows ユーザーのユーザー名。`user@domain` または`domain\user` の形式で指定。
NONE	ProxyPassword 接続プロパティは設定しないでください。

Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このユーザー名を使用します。ProxyAutoDetect がTrue に設定されている場合（デフォルト）、Sync App は代わりにシステムのプロキシ設定で指定されているユーザー名を使用します。

ProxyPassword

ProxyUser 接続プロパティで指定されたユーザーに紐付けられたパスワード。

解説

ProxyUser および ProxyPassword 接続プロパティは、ProxyServer で指定されたHTTP プロキシに対して接続よび認証するために使用されます。

ProxyAuthScheme で利用可能な認証タイプを1つ選択した後、このプロパティを以下のように設定します。


ProxyAuthScheme の値	ProxyPassword に設定する値
BASIC	ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。
DIGEST	ProxyUser で指定したプロキシサーバーユーザーに紐付けられたパスワード。
NEGOTIATE	ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。
NTLM	ProxyUser で指定したWindows ユーザーアカウントに紐付けられたパスワード。
NONE	ProxyPassword 接続プロパティは設定しないでください。

SOCKS 5 認証もしくは、トンネリングは、FirewallType を参照してください。

Sync App は、ProxyAutoDetect がFalse に設定されている場合にのみ、このパスワードを使用します。ProxyAutoDetect がTrue に設定されている場合（デフォルト）、Sync App は代わりにシステムのプロキシ設定で指定されているパスワードを使用します。

ProxySSLType

ProxyServer 接続プロパティで指定されたプロキシサーバーに接続する際に使用するSSL タイプ。

解説

このプロパティは、ProxyServer で指定されたHTTP プロキシへの接続にSSL を使用するかどうかを決定します。この接続プロパティには、以下の値を設定できます。


AUTO	デフォルト設定。ProxyServer がHTTPS URL に設定されている場合、Sync App は、TUNNEL オプションを使用します。ProxyServer がHTTP URL に設定されている場合、コンポーネントはNEVER オプションを使用します。
ALWAYS	接続は、常にSSL 有効となります。
NEVER	接続は、SSL 有効になりません。
TUNNEL	接続はトンネリングプロキシ経由で行われます。プロキシサーバーがリモートホストへの接続を開き、プロキシを経由して通信が行われます。

ProxyExceptions

ProxyServer 接続プロパティで設定されたプロキシサーバー経由での接続が免除される宛先ホスト名またはIP のセミコロン区切りのリスト。

解説

ProxyServer は、このプロパティで定義されたアドレスを除くすべてのアドレスに使用されます。セミコロンを使用してエントリを区切ります。

Sync App はデフォルトでシステムプロキシ設定を使用するため、それ以上の設定は必要ありません。この接続にプロキシ例外を明示的に設定する場合は、ProxyAutoDetect をFalse に設定します。

Logging

このセクションでは、本プロバイダーの接続文字列で設定可能なLogging プロパティの全リストを提供します。

プロパティ	説明
LogModules	ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。

LogModules

ログファイルに含めるコアモジュールを指定します。セミコロンで区切られたモジュール名のリストを使用します。デフォルトでは、すべてのモジュールがログに記録されます。

解説

このプロパティは、含めるログモジュールを指定することでログファイルの内容をカスタマイズすることができます。ログモジュールは、クエリ実行、メタデータ、SSL 通信などの異なる領域にログ情報を分類します。各モジュールは4文字のコードで表され、文字の名前の場合は末尾にスペースが必要なものもあります。

例えば、EXEC はクエリ実行をログに記録し、INFO は一般的なプロバイダーメッセージをログに記録します。複数のモジュールを含めるには、次のように名前をセミコロンで区切ります：INFO;EXEC;SSL。

Verbosity 接続プロパティは、このプロパティで指定されたモジュールベースのフィルタリングよりも優先されます。 Verbosity レベルを満たし、指定されたモジュールに属するログエントリのみが記録されます。利用可能なすべてのモジュールをログファイルに含めるには、このプロパティを空白のままにします。

利用可能なモジュールの完全なリストとログの設定に関する詳細な手引きについては、ログの「高度なログの記録」セクションを参照してください。

Schema

このセクションでは、本プロバイダーの接続文字列で設定可能なSchema プロパティの全リストを提供します。

プロパティ	説明
Location	テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。
BrowsableSchemas	レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
Tables	レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。
Views	レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。

Location

テーブル、ビュー、およびストアドプロシージャを定義するスキーマファイルを格納するディレクトリの場所を指定します。サービスの要件に応じて、これは絶対パスまたは相対パスのいずれかで表されます。

解説

Location プロパティは、定義をカスタマイズしたり（例えば、カラム名を変更する、カラムを無視するなど）、新しいテーブル、ビュー、またはストアドプロシージャでデータモデルを拡張する場合にのみ必要です。

Note： Sync App は複数のスキーマをサポートするため、Google Analytics のカスタムスキーマファイルは以下のような構造にになります。

各スキーマには、そのスキーマ名に対応するフォルダが作られます。
すべてのスキーマフォルダは、親フォルダに含まれる必要があります。

Location は常に親フォルダに設定されるべきで、個々のスキーマのフォルダに設定すべきではありません。

指定しない場合、デフォルトの場所は%APPDATA%\\CData\\GoogleAnalytics Data Provider\\Schema となり、%APPDATA%はユーザーのコンフィギュレーションディレクトリに設定されます：


プラットフォーム	%APPDATA%
Windows	APPDATA 環境変数の値
Linux	~/.config

BrowsableSchemas

レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。

解説

利用可能なデータベーススキーマをすべてリストすると余分な時間がかかり、パフォーマンスが低下します。接続文字列にスキーマのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

Tables

レポートされるテーブルを利用可能なすべてのテーブルのサブセットに制限するオプション設定。例えば、 Tables=TableA,TableB,TableC です。

解説

データベースによっては、利用可能なすべてのテーブルをリストするのに時間がかかり、パフォーマンスが低下する場合があります。接続文字列にテーブルのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

利用可能なテーブルがたくさんあり、すでに作業したいテーブルが決まっている場合、このプロパティを使用して対象のテーブルのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいテーブルを指定します。各テーブルは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。例えば、Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space` です。

Note：複数のスキーマまたはカタログを持つデータソースに接続する場合は、表示する各テーブルを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するテーブルが混同されることを防ぎます。

Views

レポートされたビューを使用可能なテーブルのサブセットに制限するオプション設定。例えば、 Views=ViewA,ViewB,ViewC です。

解説

データベースによっては、利用可能なすべてのビューをリストするのに時間がかかり、パフォーマンスが低下する場合があります。接続文字列にビューのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。

利用可能なビューがたくさんあり、すでに作業したいビューが決まっている場合、このプロパティを使用して対象のビューのみに表示を制限することができます。これを行うには、カンマ区切りのリストで使用したいビューを指定します。各ビューは、角かっこ、二重引用符、またはバッククオートを使用してエスケープされた特殊文字列を含む有効なSQL 識別子である必要があります。例えば、Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space` です。

Note：複数のスキーマまたはカタログを持つデータソースに接続する場合は、確認する各ビューを完全修飾名で指定する必要があります。これにより、複数のカタログやスキーマに存在するビューが混同されることを防ぎます。

Miscellaneous

このセクションでは、本プロバイダーの接続文字列で設定可能なMiscellaneous プロパティの全リストを提供します。

プロパティ	説明
AWSWorkloadIdentityConfig	AWS 経由でWorkload Identity Federation を使用する場合に指定する設定プロパティ。
DefaultEndDate	A default end date to be applied to all queries.
DefaultStartDate	A default start date to be applied to all queries.
IgnorePermissionsException	特定のプロファイルの権限不足に関する例外を無視するかどうか。
IncludeDeleted	If set to True, the provider include the deleted rows. The default value is False which will not include these rows.
IncludeEmptyRows	If set to false, the provider does not include rows if all the retrieved metrics are equal to zero. The default is true which will include these rows.
MaxRows	集計やGROUP BY を使用しないクエリで返される最大行数を指定します。
Other	特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。
Pagesize	Google Analytics から返される、1ページあたりの結果の最大数を指定します。この設定は、ほとんどのユースケースに最適化されている、データソースによって設定されたデフォルトのページサイズをオーバーライドします。
PropertyId	V4スキーマでレポートビューをクエリする際に使用されるプロパティID 値。
PseudoColumns	テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。
ReportType	Events および ActiveUsers ビューの場合に結果を取得するレポートのタイプ。
SupportEnhancedSQL	このプロパティは、インメモリによるクライアントサイド処理を有効にすることで、API から直接サポートされる範囲を超えるSQL 機能の拡張を可能にします。
Timeout	provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。
UserDefinedViews	カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。
WorkloadPoolId	Workload Identity Federation プールのID。
WorkloadProjectId	Workload Identity Federation プールをホストするGoogle Cloud プロジェクトのID。
WorkloadProviderId	Workload Identity Federation プールプロバイダーのID。

AWSWorkloadIdentityConfig

AWS 経由でWorkload Identity Federation を使用する場合に指定する設定プロパティ。

解説

このプロパティは、Key=Value プロパティのセミコロン区切りリストとしてフォーマットされ、値はオプションで引用符で囲むこともできます。例えば、この設定はユーザーのルートキーを使用してAWS で認証します：

AWSWorkloadIdentityConfig="AuhtScheme=AwsRootKeys;AccessKey='AKIAABCDEF123456';SecretKey=...;Region=us-east-1"

DefaultEndDate

A default end date to be applied to all queries.

解説

A default end date to be applied to all queries. These values will be overridden if set in the query.

DefaultStartDate

A default start date to be applied to all queries.

解説

A default start date to be applied to all queries. These values will be overridden if set in the query.

IgnorePermissionsException

特定のプロファイルの権限不足に関する例外を無視するかどうか。

解説

特定のプロファイルの権限不足に関する例外を無視するかどうか。

IncludeDeleted

If set to True, the provider include the deleted rows. The default value is False which will not include these rows.

解説

Allowed Values:


TRUE	The provider includes the deleted rows.
FALSE	The provider does not include the deleted rows.

IncludeEmptyRows

If set to false, the provider does not include rows if all the retrieved metrics are equal to zero. The default is true which will include these rows.

解説

Allowed Values:


TRUE	The provider includes the rows where all the retrieved metrics are equal to zero.
FALSE	The provider does not include the rows where all the retrieved metrics are equal to zero.

Note that it is still possible for no rows to be returned with this set to TRUE depending on the dimensions included in the query. This property will only work when the cardinality of the dimension is known over the date range (such as with the Date dimension). If the cardinality is unknown or not defined, such as with the ProductName dimension on the Ecommerce table, no results would be returned.

MaxRows

集計やGROUP BY を使用しないクエリで返される最大行数を指定します。

解説

このプロパティは、集計やGROUP BY 句を含まないクエリに対してSync App が返す行数の上限を設定します。この制限により、クエリがデフォルトで過度に大きな結果セットを返さないようにします。

クエリにLIMIT 句が含まれている場合、クエリで指定された値がMaxRows 設定よりも優先されます。 MaxRows が"-1" に設定されている場合、LIMIT 句が明示的にクエリに含まれていない限り、行の制限は行われません。

このプロパティは、非常に大きなデータセットを返す可能性のあるクエリを実行する際に、パフォーマンスを最適化し過剰なリソース消費を防ぐのに役立ちます。

Other

特定のユースケースに対して追加の隠しプロパティを指定します。これらは通常のprovider の機能では必要ありません。複数のプロパティを定義するには、セミコロンで区切られたリストを使用します。

解説

このプロパティは、シニアユーザーが特定のシナリオに対して隠しプロパティを設定できるようにします。これらの設定は通常のユースケースには必要ありませんが、特定の要件に対応したり、追加の機能を提供したりすることができます。複数のプロパティをセミコロン区切りのリストで定義できます。

Note： 特定のシナリオや問題に対処するためにサポートチームから助言があった場合にのみ、これらのプロパティを設定することを強く推奨します。

複数のプロパティをセミコロン区切りリストで指定します。

統合およびフォーマット


DefaultColumnSize	データソースがメタデータにカラムの長さを提供しない場合に、文字列フィールドのデフォルトの長さを設定します。デフォルト値は2000です。
ConvertDateTimeToGMT	日時の値を、マシンのローカルタイムではなくGMT グリニッジ標準時に変換するかどうかを決定します。
RecordToFile=filename	基底のソケットデータ転送を指定のファイルに記録します。

Pagesize

Google Analytics から返される、1ページあたりの結果の最大数を指定します。この設定は、ほとんどのユースケースに最適化されている、データソースによって設定されたデフォルトのページサイズをオーバーライドします。

解説

クエリする特定のオブジェクトやサービスエンドポイントの結果を最適化するために、デフォルトのページサイズを調整したい場合があります。ページサイズを大きくするとパフォーマンスが向上するかもしれませんが、ページあたりのメモリ消費量が増える可能性もあることに注意してください。

PropertyId

V4スキーマでレポートビューをクエリする際に使用されるプロパティID 値。

解説

V4スキーマでレポートビューをクエリする際に使用されるプロパティID 値。

PseudoColumns

テーブルカラムとして公開する擬似カラムを指定します。'TableName=ColumnName;TableName=ColumnName' という形式を使用します。デフォルトは空の文字列で、このプロパティを無効にします。

解説

このプロパティを使用すると、Sync App がテーブルカラムとして公開する擬似カラムを定義できます。

個々の擬似カラムを指定するには、以下の形式を使用します。"Table1=Column1;Table1=Column2;Table2=Column3"

すべてのテーブルのすべての擬似カラムを含めるには、次のようにします："*=*"

ReportType

Events および ActiveUsers ビューの場合に結果を取得するレポートのタイプ。

解説

利用可能なReportType はRealtimeReports とReports です。Events およびActiveUsers ビューの場合：


RealtimeReports	ドライバーはrunRealtimeReport エンドポイントを使用します。
Reports	ドライバーはrunReport エンドポイントを使用します。

SupportEnhancedSQL

このプロパティは、インメモリによるクライアントサイド処理を有効にすることで、API から直接サポートされる範囲を超えるSQL 機能の拡張を可能にします。

解説

SupportEnhancedSQL がtrue に設定されている場合、Sync App はGoogle Analytics にできるだけ多くのSELECT 構文処理をオフロードし、残りのクエリをインメモリで処理します。この方法で、Sync App はサポートされていない宣言、JOIN、および集計を実行することができます。

SupportEnhancedSQL がfalse に設定されている場合、Sync App はSQL 実行をGoogle Analytics API でサポートされている範囲に制限します。

宣言の実行

Sync App は、どの句がデータソースでサポートされているかを決定し、クエリを充足する最小セットの行を取得するためにソースにクエリを送信します。そして、残りの行をローカルでフィルタリングします。フィルタリング処理がストリームされている場合、Sync App は大きなデータセットに対しても効率よいフィルタリングが可能です。

JOIN 実行

Sync App は、インメモリでのJOIN でさまざまな技術を使用します。Sync App は、メモリ使用量と同じテーブルを複数回読む要求をトレードオフします。

集計の実行

Sync App は、インメモリで集計を処理するために必要なすべての行を取得します。

Timeout

provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。デフォルトは60秒です。タイムアウトを無効にするには0を設定します。

解説

このプロパティは、Sync App が操作をキャンセルする前に操作の完了を待機する最大時間を秒単位で制御します。操作の完了前にタイムアウト時間が経過すると、Sync App は操作をキャンセルして例外をスローします。

タイムアウトは、クエリや操作全体ではなくサーバーとの個々の通信に適用されます。例えば、各ページング呼び出しがタイムアウト制限内に完了する場合、クエリは60秒を超えて実行を続けることができます。

このプロパティを0に設定するとタイムアウトが無効になり、操作が成功するか、サーバー側のタイムアウト、ネットワークの中断、またはサーバーのリソース制限などの他の条件で失敗するまで無期限に実行されます。このプロパティは慎重に使用してください。長時間実行される操作がパフォーマンスを低下させたり、応答しなくなる可能性があるためです。

UserDefinedViews

カスタムビューを定義するJSON 構成ファイルへのファイルパスを指定します。provider は、このファイルで指定されたビューを自動的に検出して使用します。

解説

このプロパティを使用すると、UserDefinedViews.json というJSON 形式の構成ファイルを通じてカスタムビューを定義および管理できます。これらのビューはSync App によって自動的に認識され、標準のデータベースビューのようにカスタムSQL クエリを実行できるようになります。 JSON ファイルは、各ビューをルート要素として定義し、その子要素として"query" を持ちます。この"query" にはビューのSQL クエリが含まれています。次に例を示します。

{
	"MyView": {
		"query": "SELECT * FROM Traffic WHERE MyColumn = 'value'"
	},
	"MyView2": {
		"query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
	}
}

このプロパティを使用して、1つのファイルに複数のビューを定義し、ファイルパスを指定できます。例：UserDefinedViews=C:\Path\To\UserDefinedViews.json。このプロパティを使用すると、指定されたビューのみがSync App によって検知されます。

詳しくは、ユーザー定義ビューを参照してください。

WorkloadPoolId

Workload Identity Federation プールのID。

解説

Workload Identity Federation プールのID。

WorkloadProjectId

Workload Identity Federation プールをホストするGoogle Cloud プロジェクトのID。

解説

Workload Identity Federation プールをホストするGoogle Cloud プロジェクトのID。

WorkloadProviderId

Workload Identity Federation プールプロバイダーのID。

解説

Workload Identity Federation プールプロバイダーのID。

Google Analytics Connector for CData Sync

Google Analytics Connector for CData Sync

概要

Google Analytics バージョンサポート

接続の確立

Google Analytics への接続を追加

Google Analytics への接続

Google アナリティクス4

Google Analytics への認証

ユーザーアカウント（OAuth）

Web アプリケーション

ヘッドレスマシン

GCP インスタンスアカウント

OAuth のスコープおよびエンドポイント

Google Analytics に必要なスコープおよびエンドポイントドメイン

スコープについて

Google Analytics に必要なスコープ

エンドポイントドメインについて

Google Analytics に必要なエンドポイントドメイン

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

ディメンションおよび指標の選択

日付範囲

SELECT * Query

高度なクエリ

ディメンション列と指標列の使用

高度な機能

ユーザー定義ビュー

SSL の設定

ファイアウォールとプロキシ

クエリ処理

ログ

SSL の設定

SSL 設定のカスタマイズ

ファイアウォールとプロキシ

Firewall またはProxy 経由の接続

HTTP プロキシ

その他のプロキシ

データモデル

追加スキーマの作成

Google Analytics 4 API の使用

GoogleAnalytics4 データモデル

ビュー

日付範囲と集計

ストアドプロシージャ

サーバーサイドフィルタリング

サーバーサイドフィルタリング

ビュー

Google Analytics Connector for CData Sync ビュー

Accounts

Table Specific Information

Select

Columns

AccountSummaries

Table Specific Information

Select

Columns

Acquisitions

Table Specific Information

Select

Columns

Pseudo-Columns

AcquisitionsFirstUserCampaignReport

Select

Columns

Pseudo-Columns

AcquisitionsFirstUserGoogleAdsAdGroupNameReport

Select

Columns

Pseudo-Columns

AcquisitionsFirstUserGoogleAdsNetworkTypeReport

Select

Columns

Pseudo-Columns

AcquisitionsFirstUserMediumReport

Select

Columns

Pseudo-Columns

AcquisitionsFirstUserSourceMediumReport

Select

Columns