CData Cloud は、クラウドホスト型のソリューションで、複数の標準サービスやプロトコルにまたがるGoogle Analytics へのアクセスを実現します。SQL Server データベースに接続できるアプリケーションであれば、CData Cloud を介してGoogle Analytics に接続できます。
CData Cloud により、他のOData エンドポイントや標準SQL Server と同じように、Google Analytics への接続を標準化し、構成することができます。
このページでは、CData Cloud でのGoogle Analytics への接続の確立 のガイド、利用可能なリソースに関する情報、および使用可能な接続プロパティのリファレンスについて説明します。
接続の確立 は、CData Cloud にデータベースを作成するためのGoogle Analytics への認証方法と必要な接続プロパティの設定方法について示します。
利用可能な標準サービスを経由してGoogle Analytics からデータにアクセスする方法と、CData Cloud の管理については、CData Cloud ドキュメント で詳しく説明します。
Database タブで対応するアイコンを選択して、Google Analytics に接続します。必須プロパティはSettings にリストされています。Advanced タブには、通常は必要ない接続プロパティが表示されます。
認証プロパティを追加する前に、次の接続プロパティを設定してください。
Cloud は、認証にユーザーアカウントおよびGCP インスタンスアカウントの使用をサポートします。
以下のセクションでは、Google Analytics の利用可能な認証スキームについて説明します。
AuthScheme は、すべてのユーザーアカウントフローでOAuth に設定する必要があります。
OAuth アクセストークンの取得
次の接続プロパティを設定し、OAuthAccessToken を取得します。
続いてストアドプロシージャを呼び出し、OAuth 交換を完了します。
アクセストークンとリフレッシュトークンを取得すると、データに接続し、OAuth アクセストークンを自動または手動でリフレッシュすることができるようになります。
OAuth アクセストークンの自動リフレッシュ
ドライバーがOAuth アクセストークンを自動的にリフレッシュするようにするには、最初のデータ接続で次のように設定します。
OAuth アクセストークンの手動リフレッシュ
データ接続時に手動でOAuth アクセストークンをリフレッシュするために必要な値は、OAuth リフレッシュトークンのみです。
GetOAuthAccessToken によって返されたExpiresIn パラメータ値が経過した後に、RefreshOAuthAccessToken ストアドプロシージャを使用し、手動でOAuthAccessToken をリフレッシュします。次の接続プロパティを設定します。
次に、RefreshOAuthAccessToken を呼び出し、OAuthRefreshToken にGetOAuthAccessToken によって返されたOAuth リフレッシュトークンを指定します。新しいトークンが取得できたら、OAuthAccessToken プロパティにRefreshOAuthAccessToken によって返された値を設定し、新しい接続をオープンします。
最後に、OAuth リフレッシュトークンを保存し、OAuth アクセストークンの有効期限が切れた後に手動でリフレッシュできるようにします。
オプション1:Verifier code を取得および交換
Verifier code を取得するには、OAuth Authorization URL で認証する必要があります。
インターネットブラウザに対応したマシンから認証してOAuthVerifier 接続プロパティを取得する方法は次のとおりです。
ヘッドレスマシンでは、次の接続プロパティを設定してOAuth 認証値を取得します。
OAuth 設定ファイルが生成されたら、以下のように接続プロパティをリセットする必要があります。
オプション2:OAuth 設定を転送
ヘッドレスマシンでの接続に先立ち、インターネットブラウザに対応したデバイスでドライバとの接続を作成し、インストールする必要があります。上述の「デスクトップアプリケーション」の説明に従って、接続プロパティを設定します。
「デスクトップアプリケーション」の手順が完了すると、生成された認証値は、OAuthSettingsLocation で指定された場所に暗号化されて書き込まれます。デフォルトのファイル名はOAuthSettings.txt です。
接続が正常にテストされたら、OAuth 設定ファイルをヘッドレスマシンにコピーします。
ヘッドレスマシンで、次の接続プロパティを設定し、データに接続します。
GCP 仮想マシン上で実行している場合は、Cloud は仮想マシンに関連付けられたサービスアカウントを使用して認証できます。 このモードを使用するには、AuthScheme をGCPInstanceAccount に設定します。
(OAuthAccessToken およびその他の設定パラメータを取得および設定する方法についての情報は、「Google Analytics への接続」の デスクトップ認証セクションを参照してください。)
ただし、Web 経由で接続するには、カスタムOAuth アプリケーションの作成が必要です。また、カスタムOAuth アプリケーションは、一般的に使用される3つの認証フローをすべてシームレスにサポートするため、これらの認証フロー用にカスタムOAuth アプリケーションを作成(独自のOAuth アプリケーションクレデンシャルを使用)することもできます。
カスタムOAuth アプリケーションは、次のような場合に有用です。
以下のセクションでは、Directory API を有効化し、ユーザーアカウント(OAuth)およびサービスアカウント(OAuth / JWT)用のカスタムOAuth アプリケーションを作成する方法について説明します。
AuthScheme がOAuth であり、Web アプリケーション上で認証する必要があるユーザーの場合は、必ずカスタムOAuth アプリケーションを作成する必要があります。 (デスクトップおよびヘッドレスフローでのカスタムOAuth アプリケーションの作成は任意です。)
以下の手順に従います。
Note: クライアントシークレットはGoogle Cloud コンソールからアクセス可能です。
新しいサービスアカウントを作成するには:
サービスアカウントフローでは、Cloud はJSON Web Token(JWT)をOAuthAccessToken と交換します。 上記の手順でダウンロードした秘密鍵は、JWT に署名するために使用されます。 Cloud は、ドメイン全体の委任を通じて設定されたスコープを含む、サービスアカウントに付与された権限を継承します。
Google アナリティクスデータは、さまざまな指標(セッション、インプレッション、AdClicks など)に分類され、さまざまなディメンション(国、月など)でクエリすることができます。有効な指標とディメンションの組み合わせは多数あります。Cloud は、最もよく使用される組み合わせを使いやすくテーブルとして公開しています。
また、Cloud は、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つの別々の日付範囲をフィルタに設定できます。
通常のデータベーステーブルとは異なり、特定のテーブルですべての指標およびディメンションを選択しても、あまり役には立ちません。
Google アナリティクスでは、1つのクエリでディメンションを9つまで、指標を10までしか指定できないため、すべてを選択することができない場合もあります。
Cloud は、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 プロバイダーに必要なアクセススコープとエンドポイントドメインについての情報を提供します。
スコープは、ユーザーのデータへのアプリケーションによるアクセスを制限するための手段です。これは、アプリケーションがユーザーに代わって実行できる特定のアクションを定義します。
例えば、読み取り専用スコープではアプリケーションにデータの閲覧を許可し、フルアクセススコープではデータの変更を許可することができます。
| スコープ | 説明 |
| googleapis.com/auth/analytics.readonly | Google Analytics API への読み取り専用アクセス。利用可能な値は、NONE、CONSENT、およびデフォルトのSELECT ACCOUNT です。 |
エンドポイントドメインとは、アプリケーションが認証、レコードの取得、その他の重要な操作を実行するために通信する必要がある特定のURL を指します。
これらのドメインを許可することで、アプリケーションとAPI 間のネットワークトラフィックがファイアウォールやセキュリティ設定によってブロックされることがなくなります。
Note: ほとんどのユーザーは特別な設定をする必要はありません。許可リストは通常、送信ネットワークトラフィックの制限など、厳格なセキュリティ対策が施された環境でのみ必要となります。
| ドメイン | 常に必要か? | 説明 |
| analyticsadmin.googleapis.com | TRUE | |
| analyticsdata.googleapis.com | TRUE | |
| accounts.google.com | FALSE | このドメインは、AuthScheme 接続プロパティがOAuth に設定されている場合に必要です。 |
| www.googleapis.com and iamcredentials.googleapis.com | FALSE | このドメインは、AuthScheme 接続プロパティがOAuthJWT に設定されている場合に必要です。"www.googleapis.com" の場合、"www." の部分はドメイン名の一部であり、アプリケーションのEgress Policy に追加する必要があります。 |
| metadata.google.internal | FALSE | このドメインは、AuthScheme 接続プロパティがGCPInstanceAccount に設定されている場合に必要です。 |
| sts.googleapis.com | FALSE | このドメインは、AuthScheme 接続プロパティがAWSWorkloadIdentity に設定されている場合に必要です。 |
デフォルトでは、Cloud はサーバーとのTLS のネゴシエーションを試みます。サーバー証明書は、デフォルトのシステム信頼済み証明書ストアで検証されます。SSLServerCert 接続プロパティを使用して、証明書の検証方法をオーバーライドできます。
別の証明書を指定するには、SSLServerCert 接続プロパティを参照してください。
HTTP プロキシへの認証には、以下のように設定します。
次のプロパティを設定します。
CData Cloud は、Google Analytics エンティティをリレーショナルテーブル、ビュー、およびストアドプロシージャにモデル化します。提供されるテーブルには、ユーザーのアカウント情報およびGoogle アナリティクスクエリで使用できるプロパティの概要が示されます。Google アナリティクスを使用すると、ディメンションおよび指標をさまざまな組み合わせでクエリすることができます。一般的なGoogle アナリティクスレポートに基づいて、いくつかのサンプルビューが用意されています。また、必要に応じてディメンションおよび指標を任意に組み合わせて、独自のカスタムビューを作成することもできます。
Cloud は、Google Analytics API を使用してサポートされているフィルタを処理します。その他のフィルタは、Cloud 内でクライアント側で処理されます。
CreateCustomSchema ストアドプロシージャを使用すると、ディメンションと指標を独自に組み合わせて、簡単に新しいスキーマファイルを生成できます。このプロシージャは、ディメンションおよび指標のカンマ区切りリストとTableName を受け取り、Cloud で読み取り可能なスキーマファイルを構築します。リスト内の各ディメンションまたは指標の名前は、Google アナリティクスに含まれる値に基づきます("ga:" プレフィックスなし)。次に例を示します。
Dimensions=UserType,SessionCount
Metrics=Users,PercentNewSessionsLocation 接続プロパティが設定されている場合、ファイルはそのフォルダに出力されます。そうでない場合は、OutputFolder 入力を使用して出力フォルダを指定します。これらの新しいファイルをクエリするには、Location 接続プロパティを、新しいスキーマファイルを含むフォルダを設定します。
Google Analytics 4 API で利用可能なエンティティについては、GoogleAnalytics4 データモデル を参照してください。
CData Cloud は、Google Analytics 4 API をリレーショナルテーブル、ビュー、およびストアドプロシージャとしてモデル化します。 提供されるテーブルには、ユーザーのアカウント情報およびGoogle アナリティクスクエリで使用できるプロファイルの概要が示されます。Google アナリティクスは、ディメンションおよび指標のクエリをさまざまな組み合わせでサポートしています。一般的なGoogle アナリティクスレポートに基づいて、いくつかのサンプルビューが用意されています。
また、必要に応じてディメンションおよび指標を任意に組み合わせて、独自のカスタムビューを作成することもできます。
Cloud は、Google Analytics API を使用してサポートされているフィルタを処理します。その他のフィルタは、Cloud 内でクライアント側で処理されます。特定のテーブルやビューのページで別途明記されていない限り、クエリごとに9ディメンションと10指標の厳格な制限が設けられています。
ビュー は、Accounts、Properties、Events、Acquisitions、Engagement などの変更ができないテーブルです。一般的には、Read-only で更新が不可能なデータはビューとして表されます。 次の2種類のビューが用意されています。
その他の定義済み日付フィールドも利用可能です:
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'集計コードの例についての補足:
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')
ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。
クエリは、ビューに対して通常のテーブルと同様に実行することができます。
| 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. |
| DataAnnotations | List all Reporting Data Annotations on a property. |
| 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. |
Lists all Accounts to which the user has access.
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.
| 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. |
Lists summaries of all Accounts to which the user has access.
The AccountSummaries table exposes summaries of all accounts accessible by the caller.
The following query is processed server-side:
SELECT * FROM AccountSummaries
| 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. |
A base view that retrieves Acquisitions data.
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 KeyEvents, NewUsers FROM Acquisitions
CustomChannelGroups are added as dimension columns. You can query customChannelGroup in the following way:
SELECT SessionCustomChannelGroupName, FirstGroupCustomChannelGroupName, SessionDefaultChannelGrouping, KeyEvents FROM Acquisitions
NOTE: CustomChannelGroupName is for reference purposes only. The exact value depends on the channelGroupName added.
| 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. | ||
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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). |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Acquisitions first user Campaign data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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, KeyEvents 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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 |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves user Acquisitions first user google ads ad group name data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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 |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Acquisitions first user google ads ad network type platform data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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 |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Acquisitions first user medium data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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, KeyEvents 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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 |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Acquisitions first user source medium data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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, KeyEvents 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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 |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Acquisitions first user source platform data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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, KeyEvents 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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 |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Acquisitions first user source data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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, KeyEvents 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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 |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Acquisitions session campaign report data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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, KeyEvents 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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 |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Acquisitions session default channel grouping report data.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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 |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Acquisitions session medium report data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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, KeyEvents 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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 |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Acquisitions session source medium report data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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, KeyEvents 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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 |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Acquisitions session source platform report data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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, KeyEvents 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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 |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Acquisitions session source report data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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, KeyEvents 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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 |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A base view that retrieves Active Users data.
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
| 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 |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
List all Reporting Data Annotations on a property.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
The API requires that at least one of the following columns must be specified: Name, Parent, or PropertyId.
For example, the following queries are processed server-side:
SELECT * FROM DataAnnotations WHERE parent = 'properties/309787233';
SELECT * FROM DataAnnotations WHERE name = 'properties/309787233/keyEvents/7710067029';
SELECT * FROM DataAnnotations WHERE propertyid=213025502 AND Title != 'New: Data not available' AND Description like '%measu_ement%';
SELECT * FROM DataAnnotations WHERE propertyid=213025502 AND StartDate = '2025-03-27' AND endDate = '2025-12-31';
The Cloud processes other filters client-side.
| Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
| Name [KEY] | String | Resource name of this Reporting Data Annotation. | |||
| Parent | String | Name of the Data Annotations's logical parent. | |||
| PropertyId | Integer | Property ID value to be used when querying this table. | |||
| Title | String | Human-readable title for this Reporting Data Annotation. | |||
| Description | String | Description for this Reporting Data Annotation. | |||
| Color | String | The color used for display of this Reporting Data Annotation. Possible values are: COLOR_UNSPECIFIED, PURPLE, BROWN, BLUE, GREEN, RED, CYAN, ORANGE. | |||
| SystemGenerated | Boolean | If true, this annotation was generated by the Google Analytics system. | |||
| AnnotationDate | String | Reporting Data Annotation is for a specific date represented by this field. | |||
| AnnotationDateRange | String | Reporting Data Annotation is for a range of dates represented by this field. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| StartDate | Date | The Annotation start date for this range. Must be a valid date with year, month, and day set. The date may be in the past, present, or future. Example: 2025-04-07 |
| EndDate | Date | The Annotation end date for this range. Must be a valid date with year, month, and day set. This date must be greater than or equal to the start date. Example: 2025-04-07 |
A predefined view that retrieves Demographics UserAgeBracket data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Demographics City data.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Demographics Country data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Demographics UserGender data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
| UserGender | String | True | True | User gender. | |
| Date | Date | True | True | The date of the session formatted as YYYYMMDD. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Demographics BrandingInterest data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Demographics Language data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Demographics Region data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A base view that retrieves Demographics data.
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 KeyEvents, TotalRevenue FROM Demographics
| 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. | ||
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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). |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item brand data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Ecommerce purchase item data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A base view that retrieves Engagement data
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
| 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 | ||
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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). |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table |
A predefined view that retrieves Engagement Content Group Report data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Engagement conversions data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key events. | |
| EventCountPerUser | Decimal | False | True | Average number of events triggered by each user. | |
| EventCount | Integer | False | True | The count of events. | |
| TotalRevenue | Decimal | 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Engagement events data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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 | Decimal | 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Engagement Pages path report data.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Engagement Pages title and screen class data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Engagement Pages Title And ScreenName data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A base view that retrieves Event data
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.
| 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 | |
| KeyEvents | Decimal | False | True | The count of key 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table |
A base view that retrieves Games Reporting data.
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
| 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). |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
Retrieves data for all the available dimensions and metrics.
SELECT ActiveUsers, city FROM GlobalAccessObject;
| 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). |
A base view that retrieves KeyEvents data
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.
| 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table |
Retrieves metadata information for standard and custom dimensions / metrics.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following column and operator:
Retrieves metadata for standard and custom dimensions and metrics. When the PropertyId connection property and Name filter are not specified, the view returns only the dimensions and metrics common to all properties.
For example, the following queries are processed server-side:
SELECT * FROM Metadata;
SELECT * FROM Metadata WHERE name = 'properties/307787823/metadata';
The Cloud processes other filters client-side.
| 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. | |||
| Name | String | Resource name of this metadata. |
A base view that retrieves Monetization data.
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
| 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 | Decimal | 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). |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves publisher ads page ad format data.
n
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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 | Decimal | False | True | Sum of all advertising revenue. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves publisher ads ad source data.
n
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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 | Decimal | False | True | Sum of all advertising revenue. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves publisher ads ad unit data.
n
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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 | Decimal | False | True | Sum of all advertising revenue. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves publisher ads page path data.
n
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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 | Decimal | False | True | Sum of all advertising revenue. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
Lists all Properties to which the user has access.
SELECT * FROM Properties WHERE Id = '54516992'
SELECT * FROM Properties WHERE Parent = 'accounts/54516992'
| 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. Possible values are INDUSTRY_CATEGORY_UNSPECIFIED, AUTOMOTIVE, BUSINESS_AND_INDUSTRIAL_MARKETS, FINANCE, HEALTHCARE, TECHNOLOGY, TRAVEL, OTHER, ARTS_AND_ENTERTAINMENT, BEAUTY_AND_FITNESS, BOOKS_AND_LITERATURE, FOOD_AND_DRINK, GAMES, HOBBIES_AND_LEISURE, HOME_AND_GARDEN,INTERNET_AND_TELECOM, LAW_AND_GOVERNMENT, NEWS, ONLINE_COMMUNITIES, PEOPLE_AND_SOCIETY, PETS_AND_ANIMALS, REAL_ESTATE, REFERENCE, SCIENCE, SPORTS, JOBS_AND_EDUCATION, SHOPPING | |||
| 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. |
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
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
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 Cloud.
| 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 to grant to the parent resource. | |||
| PropertyId | Integer | Property ID value to be used when querying this table. |
Lists Audiences on a property.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
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 Cloud.
| 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. |
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.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
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 Cloud.
| 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 | The type of this DataStream resource. Possible values are DATA_STREAM_TYPE_UNSPECIFIED, WEB_DATA_STREAM, ANDROID_APP_DATA_STREAM, IOS_APP_DATA_STREAM | |||
| 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 | Property ID value to be used when querying this table. |
Lists all FirebaseLinks on a property to which the user has access.
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'
| Name | Type | Dimension | DefaultMetric | DefaultDimension | Description |
| CreateTime | Datetime | Time the FirebaseLink was created. | |||
| Name | String | FirebaseLink name. | |||
| Parent | String | Name of the FirebaseLink's logical parent. | |||
| Project | String | Firebase project resource name. | |||
| PropertyId | Integer | Property ID value to be used when querying this table. |
Lists all GoogleAdsLinks on a property to which the user has access.
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.
| 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 | Property ID value to be used when querying this table. |
Returns a list of Key Events in the specified parent property.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and operators:
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 Cloud.
| 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. |
A base view that retrieves ScreenPage data
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.
| 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. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table |
A base view that retrieves Tech data.
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 KeyEvents, EngagementRate, EventCount FROM Tech
| 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. | ||
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | 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). |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Tech App Version data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Tech Browser data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Tech Device Category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Tech Device Model data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Tech os system data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Tech Os version data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Tech platform device category data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Tech platform data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
A predefined view that retrieves Tech Screen Resolution data.
The Cloud uses the Google Analytics API to process WHERE clause conditions built with the following columns and 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 Cloud.
| 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. | |
| KeyEvents | Decimal | False | True | The count of key 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 | Decimal | False | True | The sum of revenue from purchases, subscriptions, and advertising. | |
| TotalUsers | Integer | False | True | The total number of users. |
SELECT ステートメントのWHERE 句では、疑似列フィールドを使用して、データソースから返されるタプルを詳細に制御することができます。
| Name | Type | Description |
| PropertyId | String | Property ID value to be used when querying this table. |
ストアドプロシージャはファンクションライクなインターフェースで、Google Analytics の単純なSELECT 処理にとどまらずCloud の機能を拡張します。
ストアドプロシージャは、パラメータのリストを受け取り、目的の機能を実行し、プロシージャが成功したか失敗したかを示すとともにGoogle Analytics から関連するレスポンスデータを返します。
| Name | Description |
| CreateCustomSchema | Creates a custom schema file based on the specified Dimensions and Metrics. |
| GetSignalsSettings | Get Settings values for Google Signals. |
Creates a custom schema file based on the specified Dimensions and Metrics.
Creates a custom schema file based on the specified Dimensions and Metrics.
A custom schema may be used for a more tailored approach to your data. Custom options may include comma-separated lists for specific data.
| Name | Type | Required | Description |
| TableName | String | True | The name for the new table. |
| Description | String | False | An optional description for the table. |
| WriteToFile | String | False | Whether to write to an output file. Defaults totrue and must be set to false to write to FileStream or FileData. |
| Dimensions | String | False | A comma-separated list of dimensions to include in the schema file. Here is a list of the possible values: https://ga-dev-tools.web.app/ga4/dimensions-metrics-explorer/ |
| Metrics | String | False | A comma-separated list of metrics to include in the schema file. Here is a list of the possible values: https://ga-dev-tools.web.app/ga4/dimensions-metrics-explorer/ |
| PropertyId | String | False | The Property Id to retrieve data from. If not specified, dimensions and metrics common to all properties will be retrieved. |
| ReportyType | String | False | The type of report to be created using this custom schema. Available values are: 'RealTime' and 'Standard' (default) |
| Name | Type | Description |
| Success | String | Whether the schema was created successfully. |
| SchemaFile | String | The generated schema file. |
| FileData | String | The generated schema encoded in base64. Only returned if WriteToFile set to false and FileStream is not set. |
Get Settings values for Google Signals.
| Name | Type | Required | Description |
| PropertyId | String | False | The Id of the property for which Google signals settings to retrieve. Format:PropertyId=1234 |
| Name | Type | Description |
| Name | String | Resource name of this setting. |
| State | String | Status of this setting. |
| Consent | String | Terms of Service acceptance. |
このセクションで説明されているシステムテーブルをクエリして、スキーマ情報、データソース機能に関する情報、およびバッチ操作の統計にアクセスできます。
以下のテーブルは、Google Analytics のデータベースメタデータを返します。
以下のテーブルは、データソースへの接続方法およびクエリ方法についての情報を返します。
次のテーブルは、データ変更クエリのクエリ統計を返します。
利用可能なデータベースをリストします。
次のクエリは、接続文字列で決定されるすべてのデータベースを取得します。
SELECT * FROM sys_catalogs
| Name | Type | Description |
| CatalogName | String | データベース名。 |
利用可能なスキーマをリストします。
次のクエリは、すべての利用可能なスキーマを取得します。
SELECT * FROM sys_schemas
| Name | Type | Description |
| CatalogName | String | データベース名。 |
| SchemaName | String | スキーマ名。 |
利用可能なテーブルをリストします。
次のクエリは、利用可能なテーブルおよびビューを取得します。
SELECT * FROM sys_tables
| Name | Type | Description |
| CatalogName | String | テーブルまたはビューを含むデータベース。 |
| SchemaName | String | テーブルまたはビューを含むスキーマ。 |
| TableName | String | テーブル名またはビュー名。 |
| TableType | String | テーブルの種類(テーブルまたはビュー)。 |
| Description | String | テーブルまたはビューの説明。 |
| IsUpdateable | Boolean | テーブルが更新可能かどうか。 |
利用可能なテーブルおよびビューのカラムについて説明します。
次のクエリは、Traffic テーブルのカラムとデータ型を返します。
SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Traffic'
| Name | Type | Description |
| CatalogName | String | テーブルまたはビューを含むデータベースの名前。 |
| SchemaName | String | テーブルまたはビューを含むスキーマ。 |
| TableName | String | カラムを含むテーブルまたはビューの名前。 |
| ColumnName | String | カラム名。 |
| DataTypeName | String | データ型の名前。 |
| DataType | Int32 | データ型を示す整数値。この値は、実行時に環境に基づいて決定されます。 |
| Length | Int32 | カラムのストレージサイズ。 |
| DisplaySize | Int32 | 指定されたカラムの通常の最大幅(文字数)。 |
| NumericPrecision | Int32 | 数値データの最大桁数。文字データおよび日時データの場合は、カラムの長さ(文字数)。 |
| NumericScale | Int32 | カラムのスケール(小数点以下の桁数)。 |
| IsNullable | Boolean | カラムがNull を含められるかどうか。 |
| Description | String | カラムの簡単な説明。 |
| Ordinal | Int32 | カラムのシーケンスナンバー。 |
| IsAutoIncrement | String | カラムに固定増分値が割り当てられるかどうか。 |
| IsGeneratedColumn | String | 生成されたカラムであるかどうか。 |
| IsHidden | Boolean | カラムが非表示かどうか。 |
| IsArray | Boolean | カラムが配列かどうか。 |
| IsReadOnly | Boolean | カラムが読み取り専用かどうか。 |
| IsKey | Boolean | sys_tablecolumns から返されたフィールドがテーブルの主キーであるかどうか。 |
| ColumnType | String | スキーマ内のカラムの役割または分類。可能な値は、SYSTEM、LINKEDCOLUMN、NAVIGATIONKEY、REFERENCECOLUMN、およびNAVIGATIONPARENTCOLUMN が含まれます。 |
利用可能なストアドプロシージャをリストします。
次のクエリは、利用可能なストアドプロシージャを取得します。
SELECT * FROM sys_procedures
| Name | Type | Description |
| CatalogName | String | ストアドプロシージャを含むデータベース。 |
| SchemaName | String | ストアドプロシージャを含むスキーマ。 |
| ProcedureName | String | ストアドプロシージャの名前。 |
| Description | String | ストアドプロシージャの説明。 |
| ProcedureType | String | PROCEDURE やFUNCTION などのプロシージャのタイプ。 |
ストアドプロシージャパラメータについて説明します。
次のクエリは、CreateCustomSchema ストアドプロシージャのすべての入力パラメータについての情報を返します。
SELECT * FROM sys_procedureparameters WHERE ProcedureName = 'CreateCustomSchema' AND Direction = 1 OR Direction = 2
パラメータに加えて結果セットのカラムを含めるには、IncludeResultColumns 擬似カラムをTrue に設定します。
SELECT * FROM sys_procedureparameters WHERE ProcedureName = 'CreateCustomSchema' AND IncludeResultColumns='True'
| Name | Type | Description |
| CatalogName | String | ストアドプロシージャを含むデータベースの名前。 |
| SchemaName | String | ストアドプロシージャを含むスキーマの名前。 |
| ProcedureName | String | パラメータを含むストアドプロシージャの名前。 |
| ColumnName | String | ストアドプロシージャパラメータの名前。 |
| Direction | Int32 | パラメータのタイプに対応する整数値:input (1)。input/output (2)、またはoutput(4)。input/output タイプパラメータは、入力パラメータと出力パラメータの両方になれます。 |
| DataType | Int32 | データ型を示す整数値。この値は、実行時に環境に基づいて決定されます。 |
| DataTypeName | String | データ型の名前。 |
| NumericPrecision | Int32 | 数値データの場合は最大精度。文字データおよび日時データの場合は、カラムの長さ(文字数)。 |
| Length | Int32 | 文字データの場合は、許可される文字数。数値データの場合は、許可される桁数。 |
| NumericScale | Int32 | 数値データの小数点以下の桁数。 |
| IsNullable | Boolean | パラメータがNull を含められるかどうか。 |
| IsRequired | Boolean | プロシージャの実行にパラメータが必要かどうか。 |
| IsArray | Boolean | パラメータが配列かどうか。 |
| Description | String | パラメータの説明。 |
| Ordinal | Int32 | パラメータのインデックス。 |
| Values | String | このパラメータで設定できる値は、このカラムに表示されるものに限られます。指定できる値はカンマ区切りです。 |
| SupportsStreams | Boolean | パラメータがファイルを表すかどうか。ファイルは、ファイルパスとして渡すことも、ストリームとして渡すこともできます。 |
| IsPath | Boolean | パラメータがスキーマ作成操作のターゲットパスかどうか。 |
| Default | String | 何も値が指定されていない場合に、このパラメータで使用される値。 |
| SpecificName | String | 複数のストアドプロシージャが同じ名前を持つ場合、それぞれの同名のストアドプロシージャを一意に識別するラベル。特定の名前を持つプロシージャが1つだけの場合は、その名前がここに単純に反映されます。 |
| IsCDataProvided | Boolean | プロシージャがネイティブのGoogle Analytics プロシージャではなく、CData によって追加 / 実装されているかどうか。 |
| Name | Type | Description |
| IncludeResultColumns | Boolean | 出力にパラメータに加えて結果セットのカラムを含めるかどうか。デフォルトはFalse です。 |
主キーおよび外部キーについて説明します。
次のクエリは、Traffic テーブルの主キーを取得します。
SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Traffic'
| Name | Type | Description |
| CatalogName | String | キーを含むデータベースの名前。 |
| SchemaName | String | キーを含むスキーマの名前。 |
| TableName | String | キーを含むテーブルの名前。 |
| ColumnName | String | キーカラムの名前 |
| IsKey | Boolean | カラムがTableName フィールドで参照されるテーブル内の主キーかどうか。 |
| IsForeignKey | Boolean | カラムがTableName フィールドで参照される外部キーかどうか。 |
| PrimaryKeyName | String | 主キーの名前。 |
| ForeignKeyName | String | 外部キーの名前。 |
| ReferencedCatalogName | String | 主キーを含むデータベース。 |
| ReferencedSchemaName | String | 主キーを含むスキーマ。 |
| ReferencedTableName | String | 主キーを含むテーブル。 |
| ReferencedColumnName | String | 主キーのカラム名。 |
外部キーについて説明します。
次のクエリは、他のテーブルを参照するすべての外部キーを取得します。
SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'
| 名前 | タイプ | 説明 |
| CatalogName | String | キーを含むデータベースの名前。 |
| SchemaName | String | キーを含むスキーマの名前。 |
| TableName | String | キーを含むテーブルの名前。 |
| ColumnName | String | キーカラムの名前 |
| PrimaryKeyName | String | 主キーの名前。 |
| ForeignKeyName | String | 外部キーの名前。 |
| ReferencedCatalogName | String | 主キーを含むデータベース。 |
| ReferencedSchemaName | String | 主キーを含むスキーマ。 |
| ReferencedTableName | String | 主キーを含むテーブル。 |
| ReferencedColumnName | String | 主キーのカラム名。 |
| ForeignKeyType | String | 外部キーがインポート(他のテーブルを指す)キーかエクスポート(他のテーブルから参照される)キーかを指定します。 |
主キーについて説明します。
次のクエリは、すべてのテーブルとビューから主キーを取得します。
SELECT * FROM sys_primarykeys
| Name | Type | Description |
| CatalogName | String | キーを含むデータベースの名前。 |
| SchemaName | String | キーを含むスキーマの名前。 |
| TableName | String | キーを含むテーブルの名前。 |
| ColumnName | String | キーカラムの名前。 |
| KeySeq | String | 主キーのシーケンス番号。 |
| KeyName | String | 主キーの名前。 |
利用可能なインデックスについて説明します。インデックスをフィルタリングすることで、より高速なクエリ応答時間でセレクティブクエリを記述できます。
次のクエリは、主キーでないすべてのインデックスを取得します。
SELECT * FROM sys_indexes WHERE IsPrimary='false'
| Name | Type | Description |
| CatalogName | String | インデックスを含むデータベースの名前。 |
| SchemaName | String | インデックスを含むスキーマの名前。 |
| TableName | String | インデックスを含むテーブルの名前。 |
| IndexName | String | インデックス名。 |
| ColumnName | String | インデックスに関連付けられたカラムの名前。 |
| IsUnique | Boolean | インデックスが固有の場合はTrue。そうでない場合はFalse。 |
| IsPrimary | Boolean | インデックスが主キーの場合はTrue。そうでない場合はFalse。 |
| Type | Int16 | インデックスタイプに対応する整数値:statistic (0)、clustered (1)、hashed (2)、またはother (3)。 |
| SortOrder | String | 並べ替え順序:A が昇順、D が降順。 |
| OrdinalPosition | Int16 | インデックスのカラムのシーケンスナンバー。 |
利用可能な接続プロパティと、接続文字列に設定されている接続プロパティに関する情報を返します。
次のクエリは、接続文字列に設定されている、あるいはデフォルト値で設定されているすべての接続プロパティを取得します。
SELECT * FROM sys_connection_props WHERE Value <> ''
| Name | Type | Description |
| Name | String | 接続プロパティ名。 |
| ShortDescription | String | 簡単な説明。 |
| Type | String | 接続プロパティのデータ型。 |
| Default | String | 明示的に設定されていない場合のデフォルト値。 |
| Values | String | 可能な値のカンマ区切りリスト。別な値が指定されていると、検証エラーがスローされます。 |
| Value | String | 設定した値またはあらかじめ設定されたデフォルト。 |
| Required | Boolean | プロパティが接続に必要かどうか。 |
| Category | String | 接続プロパティのカテゴリ。 |
| IsSessionProperty | String | プロパティが、現在の接続に関する情報を保存するために使用されるセッションプロパティかどうか。 |
| Sensitivity | String | プロパティの機密度。これは、プロパティがロギングおよび認証フォームで難読化されているかどうかを通知します。 |
| PropertyName | String | キャメルケースの短縮形の接続プロパティ名。 |
| Ordinal | Int32 | パラメータのインデックス。 |
| CatOrdinal | Int32 | パラメータカテゴリのインデックス。 |
| Hierarchy | String | このプロパティと一緒に設定する必要がある、関連のある依存プロパティを表示します。 |
| Visible | Boolean | プロパティが接続UI に表示されるかどうかを通知します。 |
| ETC | String | プロパティに関するその他のさまざまな情報。 |
Cloud がデータソースにオフロードできるSELECT クエリ処理について説明します。
SQL 構文の詳細については、SQL 準拠 を参照してください。
以下はSQL 機能のサンプルデータセットです。 SELECT 機能のいくつかの側面がサポートされている場合には、カンマ区切りのリストで返されます。サポートされていない場合、カラムにはNO が入ります。
| 名前 | 説明 | 有効な値 |
| AGGREGATE_FUNCTIONS | サポートされている集計関数。 | AVG, COUNT, MAX, MIN, SUM, DISTINCT |
| COUNT | COUNT 関数がサポートされているかどうか。 | YES, NO |
| IDENTIFIER_QUOTE_OPEN_CHAR | 識別子をエスケープするための開始文字。 | [ |
| IDENTIFIER_QUOTE_CLOSE_CHAR | 識別子をエスケープするための終了文字。 | ] |
| SUPPORTED_OPERATORS | サポートされているSQL 演算子。 | =, >, <, >=, <=, <>, !=, LIKE, NOT LIKE, IN, NOT IN, IS NULL, IS NOT NULL, AND, OR |
| GROUP_BY | GROUP BY がサポートされているかどうか。サポートされている場合、どのレベルでサポートされているか。 | NO, NO_RELATION, EQUALS_SELECT, SQL_GB_COLLATE |
| OJ_CAPABILITIES | サポートされている外部結合の種類。 | NO, LEFT, RIGHT, FULL, INNER, NOT_ORDERED, ALL_COMPARISON_OPS |
| OUTER_JOINS | 外部結合がサポートされているかどうか。 | YES, NO |
| SUBQUERIES | サブクエリがサポートされているかどうか。サポートされていれば、どのレベルでサポートされているか。 | NO, COMPARISON, EXISTS, IN, CORRELATED_SUBQUERIES, QUANTIFIED |
| STRING_FUNCTIONS | サポートされている文字列関数。 | LENGTH, CHAR, LOCATE, REPLACE, SUBSTRING, RTRIM, LTRIM, RIGHT, LEFT, UCASE, SPACE, SOUNDEX, LCASE, CONCAT, ASCII, REPEAT, OCTET, BIT, POSITION, INSERT, TRIM, UPPER, REGEXP, LOWER, DIFFERENCE, CHARACTER, SUBSTR, STR, REVERSE, PLAN, UUIDTOSTR, TRANSLATE, TRAILING, TO, STUFF, STRTOUUID, STRING, SPLIT, SORTKEY, SIMILAR, REPLICATE, PATINDEX, LPAD, LEN, LEADING, KEY, INSTR, INSERTSTR, HTML, GRAPHICAL, CONVERT, COLLATION, CHARINDEX, BYTE |
| NUMERIC_FUNCTIONS | サポートされている数値関数。 | ABS, ACOS, ASIN, ATAN, ATAN2, CEILING, COS, COT, EXP, FLOOR, LOG, MOD, SIGN, SIN, SQRT, TAN, PI, RAND, DEGREES, LOG10, POWER, RADIANS, ROUND, TRUNCATE |
| TIMEDATE_FUNCTIONS | サポートされている日付および時刻関数。 | NOW, CURDATE, DAYOFMONTH, DAYOFWEEK, DAYOFYEAR, MONTH, QUARTER, WEEK, YEAR, CURTIME, HOUR, MINUTE, SECOND, TIMESTAMPADD, TIMESTAMPDIFF, DAYNAME, MONTHNAME, CURRENT_DATE, CURRENT_TIME, CURRENT_TIMESTAMP, EXTRACT |
| REPLICATION_SKIP_TABLES | レプリケーション中にスキップされたテーブルを示します。 | |
| REPLICATION_TIMECHECK_COLUMNS | レプリケーション中に更新判断のカラムとして使用するかどうかを、(指定された順に)チェックするカラムのリストを含む文字列の配列。 | |
| IDENTIFIER_PATTERN | 識別子としてどの文字列が有効かを示す文字列値。 | |
| SUPPORT_TRANSACTION | プロバイダーが、コミットやロールバックなどのトランザクションをサポートしているかどうかを示します。 | YES, NO |
| DIALECT | 使用するSQL ダイアレクトを示します。 | |
| KEY_PROPERTIES | Uniform データベースを特定するプロパティを示します。 | |
| SUPPORTS_MULTIPLE_SCHEMAS | プロバイダー用に複数のスキームが存在するかどうかを示します。 | YES, NO |
| SUPPORTS_MULTIPLE_CATALOGS | プロバイダー用に複数のカタログが存在するかどうかを示します。 | YES, NO |
| DATASYNCVERSION | このドライバーにアクセスするために必要な、CData Sync のバージョン。 | Standard, Starter, Professional, Enterprise |
| DATASYNCCATEGORY | このドライバーのCData Sync カテゴリ。 | Source, Destination, Cloud Destination |
| SUPPORTSENHANCEDSQL | API で提供されている以上の、追加SQL 機能がサポートされているかどうか。 | TRUE, FALSE |
| SUPPORTS_BATCH_OPERATIONS | バッチ操作がサポートされているかどうか。 | YES, NO |
| SQL_CAP | このドライバーでサポートされているすべてのSQL 機能。 | SELECT, INSERT, DELETE, UPDATE, TRANSACTIONS, ORDERBY, OAUTH, ASSIGNEDID, LIMIT, LIKE, BULKINSERT, COUNT, BULKDELETE, BULKUPDATE, GROUPBY, HAVING, AGGS, OFFSET, REPLICATE, COUNTDISTINCT, JOINS, DROP, CREATE, DISTINCT, INNERJOINS, SUBQUERIES, ALTER, MULTIPLESCHEMAS, GROUPBYNORELATION, OUTERJOINS, UNIONALL, UNION, UPSERT, GETDELETED, CROSSJOINS, GROUPBYCOLLATE, MULTIPLECATS, FULLOUTERJOIN, MERGE, JSONEXTRACT, BULKUPSERT, SUM, SUBQUERIESFULL, MIN, MAX, JOINSFULL, XMLEXTRACT, AVG, MULTISTATEMENTS, FOREIGNKEYS, CASE, LEFTJOINS, COMMAJOINS, WITH, LITERALS, RENAME, NESTEDTABLES, EXECUTE, BATCH, BASIC, INDEX |
| PREFERRED_CACHE_OPTIONS | 使用したいcacheOptions を指定する文字列値。 | |
| ENABLE_EF_ADVANCED_QUERY | ドライバーがEntity Framework の高度なクエリをサポートしているかどうかを示します。サポートしていなければ、クエリはクライアントサイドで処理されます。 | YES, NO |
| PSEUDO_COLUMNS | 利用可能な疑似カラムを示す文字列の配列。 | |
| MERGE_ALWAYS | 値がtrue であれば、CData Sync 内でMerge Model が強制的に実行されます。 | TRUE, FALSE |
| REPLICATION_MIN_DATE_QUERY | レプリケート開始日時を返すSELECT クエリ。 | |
| REPLICATION_MIN_FUNCTION | サーバーサイドでmin を実行するために使用する式名を、プロバイダーが指定できるようになります。 | |
| REPLICATION_START_DATE | レプリケート開始日を、プロバイダーが指定できるようになります。 | |
| REPLICATION_MAX_DATE_QUERY | レプリケート終了日時を返すSELECT クエリ。 | |
| REPLICATION_MAX_FUNCTION | サーバーサイドでmax を実行するために使用する式名を、プロバイダーが指定できるようになります。 | |
| IGNORE_INTERVALS_ON_INITIAL_REPLICATE | 初回のレプリケートで、レプリケートをチャンクに分割しないテーブルのリスト。 | |
| CHECKCACHE_USE_PARENTID | CheckCache 構文を親キーカラムに対して実行するかどうかを示します。 | TRUE, FALSE |
| CREATE_SCHEMA_PROCEDURES | スキーマファイルの生成に使用できる、ストアドプロシージャを示します。 |
次のクエリは、WHERE 句で使用できる演算子を取得します。
SELECT * FROM sys_sqlinfo WHERE Name = 'SUPPORTED_OPERATORS'
WHERE 句では、個々のテーブルの制限や要件が異なる場合がありますので注意してください。詳しくは、データモデル セクションを参照してください。
| Name | Type | Description |
| NAME | String | SQL 構文のコンポーネント、またはサーバー上で処理できる機能。 |
| VALUE | String | サポートされるSQL またはSQL 構文の詳細。 |
試行された変更に関する情報を返します。
次のクエリは、バッチ処理で変更された行のId を取得します。
SELECT * FROM sys_identity
| Name | Type | Description |
| Id | String | データ変更処理から返された、データベース生成Id。 |
| Batch | String | バッチの識別子。1 は単一処理。 |
| Operation | String | バッチ内の処理の結果:INSERTED、UPDATED、またはDELETED。 |
| Message | String | SUCCESS、またはバッチ内の更新が失敗した場合のエラーメッセージ。 |
利用可能なシステム情報を説明します。
次のクエリは、すべてのカラムを取得します。
SELECT * FROM sys_information
| Name | Type | Description |
| Product | String | 製品名。 |
| Version | String | 製品のバージョン番号。 |
| Datasource | String | 製品が接続するデータソースの名前。 |
| NodeId | String | 製品がインストールされているマシンの固有識別子。 |
| HelpURL | String | 製品のヘルプドキュメントのURL。 |
| License | String | 製品のライセンス情報。(この情報が利用できない場合、この項目は空白のままか「N/A」と表示されます。) |
| Location | String | 製品のライブラリが格納されているファイルパスの場所。 |
| Environment | String | 製品が現在稼働している環境またはランタイムのバージョン。 |
| DataSyncVersion | String | 本コネクタを使用するために必要なCData Sync のティア。 |
| DataSyncCategory | String | CData Sync 機能のカテゴリ(例:Source、Destination)。 |
| プロパティ | 説明 |
| AuthScheme | Google Analytics への接続に使用する認証方法を指定します。 |
| Schema | 使用するスキーマの種類。 |
| プロパティ | 説明 |
| OAuthClientId | カスタムOAuth アプリケーションに割り当てられたクライアントID(コンシューマーキーとも呼ばれます)を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。 |
| OAuthClientSecret | カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。(カスタムOAuth アプリケーションのみ) |
| DelegatedServiceAccounts | 委任されたリクエストのためのサービスアカウントE メールをスペース区切りで指定します。 |
| RequestingServiceAccount | 委任されたリクエストを行うためのサービスアカウントのE メールを指定します。 |
| Scope | データへの適切なアクセスを確実にするために、認証ユーザーのアプリケーションへのアクセス範囲を指定します。 カスタムOAuth アプリケーションが必要な場合は、通常、アプリケーションの作成時に指定します。 |
| プロパティ | 説明 |
| OAuthJWTCert | クライアント証明書のJWT 証明書ストアの名前を指定します。 |
| OAuthJWTCertType | JWT 証明書を格納しているキーストアの種類を指定します。 |
| OAuthJWTCertPassword | パスワードで保護された証明書ストアにアクセスするために使用されるOAuth JWT 証明書のパスワードを指定します。証明書ストアがパスワードを必要としない場合は、このプロパティを空白のままにします。 |
| OAuthJWTCertSubject | ストアで一致する証明書を検索するために使用される、OAuth JWT 証明書のサブジェクトを指定します。部分一致と、先頭の証明書を選択するためのワイルドカード '*' をサポートします。 |
| OAuthJWTIssuer | Java Web Token の発行者。 |
| OAuthJWTSubject | アプリケーションからデリゲートアクセスの要求対象となるユーザーサブジェクト。 |
| プロパティ | 説明 |
| SSLServerCert | TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。 |
| プロパティ | 説明 |
| Verbosity | ログファイルのVerbosity レベルを指定し、記録される情報の詳細度を制御します。サポートされる値の範囲は1から5までです。 |
| プロパティ | 説明 |
| BrowsableSchemas | レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。 |
| プロパティ | 説明 |
| AWSWorkloadIdentityConfig | AWS 経由でWorkload Identity Federation を使用する場合に指定する設定プロパティ。 |
| AzureWorkloadIdentityConfig | Azure 経由で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 | Specifies whether soft-deleted or trashed items should be included in a list request. |
| 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 を含まないクエリで返される最大行数を指定します。 |
| Pagesize | provider がGoogle Analytics にデータをリクエストするときに返す、ページあたりの最大レコード数を指定します。 |
| PropertyId | V4スキーマでレポートビューをクエリする際に使用されるプロパティID 値。 |
| PseudoColumns | テーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。 |
| ReportType | Events および ActiveUsers ビューの場合に結果を取得するレポートのタイプ。 |
| SupportEnhancedSQL | このプロパティは、インメモリによるクライアントサイド処理を有効にすることで、API から直接サポートされる範囲を超えるSQL 機能の拡張を可能にします。 |
| ThrowsKeyNotFound | 更新された行がない場合に例外をスローするかどうかを指定します。 |
| Timeout | provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。 |
| WorkloadPoolId | Workload Identity Federation プールのID。 |
| WorkloadProjectId | Workload Identity Federation プールをホストするGoogle Cloud プロジェクトのID。 |
| WorkloadProviderId | Workload Identity Federation プールプロバイダーのID。 |
このセクションでは、本プロバイダーの接続文字列で設定可能なAuthentication プロパティの全リストを提供します。
| プロパティ | 説明 |
| AuthScheme | Google Analytics への接続に使用する認証方法を指定します。 |
| Schema | 使用するスキーマの種類。 |
Google Analytics への接続に使用する認証方法を指定します。
string
"OAuth"
使用するスキーマの種類。
string
"GoogleAnalytics4"
利用可能なスキーマはGoogleAnalytics4 です。
このセクションでは、本プロバイダーの接続文字列で設定可能なOAuth プロパティの全リストを提供します。
| プロパティ | 説明 |
| OAuthClientId | カスタムOAuth アプリケーションに割り当てられたクライアントID(コンシューマーキーとも呼ばれます)を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。 |
| OAuthClientSecret | カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。(カスタムOAuth アプリケーションのみ) |
| DelegatedServiceAccounts | 委任されたリクエストのためのサービスアカウントE メールをスペース区切りで指定します。 |
| RequestingServiceAccount | 委任されたリクエストを行うためのサービスアカウントのE メールを指定します。 |
| Scope | データへの適切なアクセスを確実にするために、認証ユーザーのアプリケーションへのアクセス範囲を指定します。 カスタムOAuth アプリケーションが必要な場合は、通常、アプリケーションの作成時に指定します。 |
カスタムOAuth アプリケーションに割り当てられたクライアントID(コンシューマーキーとも呼ばれます)を指定します。このID は、認証時にOAuth 認可サーバーにアプリケーションを識別させるために必要です。
string
""
このプロパティは2つのケースで必要となります:
(ドライバーが埋め込みOAuth 資格情報を提供する場合、この値はすでにCloud によって設定されており、手動で入力する必要がないことがあります。)
OAuthClientId は、認証付きの接続を構成する際に、OAuthClientSecret やOAuthSettingsLocation などの他のOAuth 関連プロパティと一緒に使用されるのが一般的です。
OAuthClientId は、ユーザーがOAuth 経由で認証を行う前に設定する必要がある、主要な接続パラメータの1つです。 この値は、通常、ID プロバイダーのアプリケーション登録設定で確認できます。 Client ID、Application ID、Consumer Key などとラベル付けされた項目を探してください。
クライアントID は、クライアントシークレットのような機密情報とは見なされませんが、アプリケーションの識別情報の一部であるため、慎重に取り扱う必要があります。公開リポジトリや共有設定ファイルでこの値を露出させないようにしてください。
接続設定時にこのプロパティを使用する方法の詳細については、接続の確立 を参照してください。
カスタムOAuth アプリケーションに割り当てられたクライアントシークレットを指定します。この機密情報は、OAuth 認可サーバーに対してアプリケーションを認証するために使用されます。(カスタムOAuth アプリケーションのみ)
string
""
このプロパティ(アプリケーションシークレットまたはコンシューマシークレットとも呼ばれます)は、安全なクライアント認証を必要とするすべてのフローでカスタムOAuth アプリケーションを使用する場合に必要です。たとえば、Web ベースのOAuth、サービスベースの接続、証明書ベースの認可フローなどが該当します。 組み込みOAuth アプリケーションを使用する場合は必要ありません。
クライアントシークレットは、OAuth フローのトークン交換ステップで使用されます。このステップでは、ドライバーが認可サーバーにアクセストークンを要求します。 この値が欠落しているか正しくない場合、認証はinvalid_client またはunauthorized_client エラーで失敗します。
OAuthClientSecret は、ユーザーがOAuth 経由で認証を行う前に設定する必要がある、主要な接続パラメータの1つです。この値は、OAuth アプリケーションを登録する際にID プロバイダーから取得できます。
Notes:
接続設定時にこのプロパティを使用する方法の詳細については、接続の確立 を参照してください。
委任されたリクエストのためのサービスアカウントE メールをスペース区切りで指定します。
string
""
サービスアカウントE メールは、スペース区切りのリストで指定する必要があります。
各サービスアカウントは、チェーン内の次のサービスアカウントのroles/iam.serviceAccountTokenCreator ロールを付与されている必要があります。
チェーンの最後のサービスアカウントは、リクエストするサービスアカウントのroles/iam.serviceAccountTokenCreator ロールが付与されている必要があります。 リクエストするサービスアカウントはRequestingServiceAccount プロパティで指定されたものです。
委任されたリクエストの場合、リクエストするサービスアカウントは、iam.serviceAccounts.getAccessToken 権限を持つ必要があることに注意してください。これは、serviceAccountTokenCreator ロールを介して付与することもできます。
委任されたリクエストを行うためのサービスアカウントのE メールを指定します。
string
""
委任されたリクエストで認証情報が要求されたアカウントのサービスアカウントのE メール。DelegatedServiceAccounts の委任されたサービスアカウントのリストを用いて、このプロパティは、委任されたリクエストを行うために使用されます。
このサービスアカウントには、IAM 権限iam.serviceAccounts.getAccessToken が必要です。
データへの適切なアクセスを確実にするために、認証ユーザーのアプリケーションへのアクセス範囲を指定します。 カスタムOAuth アプリケーションが必要な場合は、通常、アプリケーションの作成時に指定します。
string
""
スコープは、認証ユーザーがどのようなアクセス権を持つかを定義するために設定されます。例えば、読み取り、読み取りと書き込み、機密情報への制限付きアクセスなどです。システム管理者は、スコープを使用して機能またはセキュリティクリアランスによるアクセスを選択的に有効化できます。
InitiateOAuth がGETANDREFRESH に設定されている場合、要求するスコープを変更したい場合はこのプロパティを使用する必要があります。
InitiateOAuth がREFRESH またはOFF のいずれかに設定されている場合、このプロパティまたはScope 入力を使用して、要求するスコープを変更できます。
このセクションでは、本プロバイダーの接続文字列で設定可能なJWT OAuth プロパティの全リストを提供します。
| プロパティ | 説明 |
| OAuthJWTCert | クライアント証明書のJWT 証明書ストアの名前を指定します。 |
| OAuthJWTCertType | JWT 証明書を格納しているキーストアの種類を指定します。 |
| OAuthJWTCertPassword | パスワードで保護された証明書ストアにアクセスするために使用されるOAuth JWT 証明書のパスワードを指定します。証明書ストアがパスワードを必要としない場合は、このプロパティを空白のままにします。 |
| OAuthJWTCertSubject | ストアで一致する証明書を検索するために使用される、OAuth JWT 証明書のサブジェクトを指定します。部分一致と、先頭の証明書を選択するためのワイルドカード '*' をサポートします。 |
| OAuthJWTIssuer | Java Web Token の発行者。 |
| OAuthJWTSubject | アプリケーションからデリゲートアクセスの要求対象となるユーザーサブジェクト。 |
クライアント証明書のJWT 証明書ストアの名前を指定します。
string
""
OAuthJWTCertType フィールドは、OAuthJWTCert により指定された証明書ストアの種類を指定します。 ストアがパスワードで保護されている場合は、OAuthJWTCertPassword を使用してパスワードを指定します。
OAuthJWTCert は、OAuthJWTCertSubject フィールドとともにクライアント証明書を指定するために使われます。 OAuthJWTCert に値が設定され、かつOAuthJWTCertSubject が設定されている場合、CData Cloud は証明書の検索を開始します。 詳しくは、OAuthJWTCertSubject を参照してください。
証明書ストアの指定はプラットフォームに依存します。
注記
JWT 証明書を格納しているキーストアの種類を指定します。
string
"GOOGLEJSONBLOB"
| 値 | 説明 | 注記 |
| USER | 現在のユーザーが所有する証明書ストア。 | Windows のみ使用可能です。 |
| MACHINE | マシンストア。 | Java やその他の非Windows 環境では使用できません。 |
| PFXFILE | 証明書を含むPFX(PKCS12)ファイル。 | |
| PFXBLOB | PFX(PKCS12)形式の証明書ストアをbase-64 でエンコードした文字列。 | |
| JKSFILE | 証明書を含むJava キーストア(JKS)ファイル。 | Java 専用。 |
| JKSBLOB | Java キーストア(JKS)形式の証明書ストアをbase-64 でエンコードした文字列。 | 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 サービスに接続する場合にのみ有効。 |
パスワードで保護された証明書ストアにアクセスするために使用されるOAuth JWT 証明書のパスワードを指定します。証明書ストアがパスワードを必要としない場合は、このプロパティを空白のままにします。
string
""
このプロパティは、パスワードで保護された証明書ストアを開くために必要なパスワードを指定します。 パスワードが必要かどうかを判断するには、ご利用の証明書ストアのドキュメントまたは設定を参照してください。
GOOGLEJSON OAuthJWTCertType を使用する場合は必要ありません。Google JSON キーは暗号化されていません。
ストアで一致する証明書を検索するために使用される、OAuth JWT 証明書のサブジェクトを指定します。部分一致と、先頭の証明書を選択するためのワイルドカード '*' をサポートします。
string
"*"
このプロパティの値は、ストアで一致する証明書を検索するために使用されます。検索プロセスは以下のように動作します。
値を '*' に設定すると、ストアの先頭の証明書が自動的に選択されます。 証明書のサブジェクトは識別名フィールドおよび値のカンマ区切りのリストです。 例:CN=www.server.com, OU=test, C=US, [email protected]。
一般的なフィールドには以下のものが含まれます。
| フィールド | 説明 |
| CN | 共通名。一般的には、www.server.com のようなホスト名です。 |
| O | 法人名 |
| OU | 法人の部署名 |
| L | 法人の住所(市町村名) |
| S | 法人の住所(都道府県) |
| C | 国名 |
| E | E メールアドレス |
フィールド値にカンマが含まれる場合は、引用符で囲んでください。例:"O=ACME, Inc."。
Java Web Token の発行者。
string
""
Java Web Token の発行者。 サービスアカウントのE メールアドレスの値を入力します。
GOOGLEJSON OAuthJWTCertType を使用する場合は必要ありません。Google JSON キーには、発行者アカウントのコピーが含まれています。
アプリケーションからデリゲートアクセスの要求対象となるユーザーサブジェクト。
string
""
アプリケーションからデリゲートアクセスの要求対象となるユーザーサブジェクトです。 アプリケーションが委任されたアクセスをリクエストするユーザーのE メールアドレスを入力します。
このセクションでは、本プロバイダーの接続文字列で設定可能なSSL プロパティの全リストを提供します。
| プロパティ | 説明 |
| SSLServerCert | TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。 |
TLS/SSL を使用して接続する際に、サーバーが受け入れ可能な証明書を指定します。
string
""
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 |
Note:'*' を使用してすべての証明書を受け入れるように指定することも可能ですが、セキュリティ上の懸念があるため推奨されません。
このセクションでは、本プロバイダーの接続文字列で設定可能なLogging プロパティの全リストを提供します。
| プロパティ | 説明 |
| Verbosity | ログファイルのVerbosity レベルを指定し、記録される情報の詳細度を制御します。サポートされる値の範囲は1から5までです。 |
ログファイルのVerbosity レベルを指定し、記録される情報の詳細度を制御します。サポートされる値の範囲は1から5までです。
string
"1"
このプロパティは、Cloud がログファイルに含める詳細レベルを定義します。 Verbosity レベルを高くするとログに記録される情報の詳細が増えますが、ログファイルが大きくなり取り込まれるデータが増えるためパフォーマンスが低下する可能性があります。
デフォルトのVerbosity レベルは1で、通常の運用にはこれが推奨されます。 より高いVerbosity レベルは主にデバッグを目的としています。 各レベルの詳細については、ログ を参照してください。
LogModules プロパティと組み合わせることで、Verbosity は特定の情報カテゴリに対するログの詳細度を調整できます。
このセクションでは、本プロバイダーの接続文字列で設定可能なSchema プロパティの全リストを提供します。
| プロパティ | 説明 |
| BrowsableSchemas | レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。 |
レポートされるスキーマを利用可能なすべてのスキーマのサブセットに制限するオプション設定。例えば、 BrowsableSchemas=SchemaA,SchemaB,SchemaC です。
string
""
利用可能なデータベーススキーマをすべてリストすると余分な時間がかかり、パフォーマンスが低下します。 接続文字列にスキーマのリストを指定することで、時間を節約しパフォーマンスを向上させることができます。
このセクションでは、本プロバイダーの接続文字列で設定可能なMiscellaneous プロパティの全リストを提供します。
| プロパティ | 説明 |
| AWSWorkloadIdentityConfig | AWS 経由でWorkload Identity Federation を使用する場合に指定する設定プロパティ。 |
| AzureWorkloadIdentityConfig | Azure 経由で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 | Specifies whether soft-deleted or trashed items should be included in a list request. |
| 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 を含まないクエリで返される最大行数を指定します。 |
| Pagesize | provider がGoogle Analytics にデータをリクエストするときに返す、ページあたりの最大レコード数を指定します。 |
| PropertyId | V4スキーマでレポートビューをクエリする際に使用されるプロパティID 値。 |
| PseudoColumns | テーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。 |
| ReportType | Events および ActiveUsers ビューの場合に結果を取得するレポートのタイプ。 |
| SupportEnhancedSQL | このプロパティは、インメモリによるクライアントサイド処理を有効にすることで、API から直接サポートされる範囲を超えるSQL 機能の拡張を可能にします。 |
| ThrowsKeyNotFound | 更新された行がない場合に例外をスローするかどうかを指定します。 |
| Timeout | provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。 |
| WorkloadPoolId | Workload Identity Federation プールのID。 |
| WorkloadProjectId | Workload Identity Federation プールをホストするGoogle Cloud プロジェクトのID。 |
| WorkloadProviderId | Workload Identity Federation プールプロバイダーのID。 |
AWS 経由でWorkload Identity Federation を使用する場合に指定する設定プロパティ。
string
""
このプロパティは、Key=Value プロパティのセミコロン区切りリストとしてフォーマットされ、値はオプションで引用符で囲むこともできます。
例えば、この設定はユーザーのルートキーを使用してAWS で認証します:
AWSWorkloadIdentityConfig="AuthScheme=AwsRootKeys;AccessKey='AKIAABCDEF123456';SecretKey=...;Region=us-east-1"
Azure 経由でWorkload Identity Federation を使用する場合に指定する設定プロパティ。
string
""
このプロパティは、Key=Value プロパティのセミコロン区切りリストとしてフォーマットされ、値はオプションで引用符で囲むこともできます。
例えば、この設定はクライアント資格情報を使用してAzure で認証します:
AzureWorkloadIdentityConfig="AuthScheme=AzureServicePrincipal;AzureTenant=directory (tenant) id;OAuthClientID=application (client) id;OAuthClientSecret=client secret;AzureResource=application id uri;"
A default end date to be applied to all queries.
string
""
A default end date to be applied to all queries. These values will be overridden if set in the query.
A default start date to be applied to all queries.
string
""
A default start date to be applied to all queries. These values will be overridden if set in the query.
特定のプロファイルの権限不足に関する例外を無視するかどうか。
bool
false
特定のプロファイルの権限不足に関する例外を無視するかどうか。
Specifies whether soft-deleted or trashed items should be included in a list request.
bool
false
By default, list requests exclude soft-deleted (trashed) items. When IncludeDeleted is set to True, the results contain resources that are in the trash.
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.
bool
true
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.
集計やGROUP BY を含まないクエリで返される最大行数を指定します。
int
-1
このプロパティのデフォルト値である-1 は、クエリに明示的にLIMIT 句が含まれていない限り、行の制限が適用されないことを意味します。 (クエリにLIMIT 句が含まれている場合、クエリで指定された値がMaxRows 設定よりも優先されます。)
MaxRows を0より大きい整数に設定することで、クエリがデフォルトで過度に大きな結果セットを返さないようにします。
このプロパティは、非常に大きなデータセットを返す可能性のあるクエリを実行する際に、パフォーマンスを最適化し、過剰なリソース消費を防ぐのに役立ちます。
provider がGoogle Analytics にデータをリクエストするときに返す、ページあたりの最大レコード数を指定します。
int
10000
クエリを処理する際、Google Analytics でクエリされたデータすべてを一度にリクエストする代わりに、Cloud はクエリされたデータをページと呼ばれる部分ごとにリクエストすることができます。
この接続プロパティは、Cloud がページごとにリクエストする結果の最大数を決定します。
Note:大きなページサイズを設定すると全体的なクエリ実行時間が短縮される可能性がありますが、その場合、クエリ実行時にCloud がより多くのメモリを使用することになり、タイムアウトが発生するリスクがあります。
V4スキーマでレポートビューをクエリする際に使用されるプロパティID 値。
string
""
V4スキーマでレポートビューをクエリする際に使用されるプロパティID 値。
テーブルカラムとして公開する擬似カラムを、'TableName=ColumnName;TableName=ColumnName' の形式の文字列で指定します。
string
""
このプロパティを使用すると、Cloud がテーブルカラムとして公開する擬似カラムを定義できます。
個々の擬似カラムを指定するには、以下の形式を使用します。
Table1=Column1;Table1=Column2;Table2=Column3
すべてのテーブルのすべての擬似カラムを含めるには、次を使用してください:
*=*
Events および ActiveUsers ビューの場合に結果を取得するレポートのタイプ。
string
"RealtimeReports"
利用可能なReportType はRealtimeReports とReports です。Events およびActiveUsers ビューの場合:
| RealtimeReports | ドライバーはrunRealtimeReport エンドポイントを使用します。 |
| Reports | ドライバーはrunReport エンドポイントを使用します。 |
このプロパティは、インメモリによるクライアントサイド処理を有効にすることで、API から直接サポートされる範囲を超えるSQL 機能の拡張を可能にします。
bool
true
SupportEnhancedSQL がtrue に設定されている場合、Cloud はGoogle Analytics にできるだけ多くのSELECT 構文処理をオフロードし、残りのクエリをインメモリで処理します。この方法で、Cloud はサポートされていない宣言、JOIN、および集計を実行することができます。
SupportEnhancedSQL がfalse に設定されている場合、Cloud はSQL 実行をGoogle Analytics API でサポートされている範囲に制限します。
Cloud は、どの句がデータソースでサポートされているかを決定し、クエリを充足する最小セットの行を取得するためにソースにクエリを送信します。そして、残りの行をローカルでフィルタリングします。フィルタリング処理がストリームされている場合、Cloud は大きなデータセットに対しても効率よいフィルタリングが可能です。
Cloud は、インメモリでのJOIN でさまざまな技術を使用します。Cloud は、メモリ使用量と同じテーブルを複数回読む要求をトレードオフします。
Cloud は、インメモリで集計を処理するために必要なすべての行を取得します。
更新された行がない場合に例外をスローするかどうかを指定します。
bool
false
更新された行がない場合に例外をスローするかどうかを指定します。
provider がタイムアウトエラーを返すまでにサーバーからの応答を待機する最大時間を秒単位で指定します。
int
60
タイムアウトは、クエリや操作全体ではなくサーバーとの個々の通信に適用されます。 例えば、各ページング呼び出しがタイムアウト制限内に完了する場合、クエリは60秒を超えて実行を続けることができます。
タイムアウトはデフォルトで60秒に設定されています。タイムアウトを無効にするには、このプロパティを0に設定します。
タイムアウトを無効にすると、操作が成功するか、サーバー側のタイムアウト、ネットワークの中断、またはサーバーのリソース制限などの他の条件で失敗するまで無期限に実行されます。
Note: このプロパティは慎重に使用してください。長時間実行される操作がパフォーマンスを低下させたり、応答しなくなる可能性があるためです。
Workload Identity Federation プールのID。
string
""
Workload Identity Federation プールのID。
Workload Identity Federation プールをホストするGoogle Cloud プロジェクトのID。
string
""
Workload Identity Federation プールをホストするGoogle Cloud プロジェクトのID。
Workload Identity Federation プールプロバイダーのID。
string
""
Workload Identity Federation プールプロバイダーのID。
LZMA from 7Zip LZMA SDK
LZMA SDK is placed in the public domain.
Anyone is free to copy, modify, publish, use, compile, sell, or distribute the original LZMA SDK code, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.
LZMA2 from XZ SDK
Version 1.9 and older are in the public domain.
Xamarin.Forms
Xamarin SDK
The MIT License (MIT)
Copyright (c) .NET Foundation Contributors
All rights reserved.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
NSIS 3.10
Copyright (C) 1999-2025 Contributors THE ACCOMPANYING PROGRAM IS PROVIDED UNDER THE TERMS OF THIS COMMON PUBLIC LICENSE ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THE PROGRAM CONSTITUTES RECIPIENT'S ACCEPTANCE OF THIS AGREEMENT.
1. DEFINITIONS
"Contribution" means:
a) in the case of the initial Contributor, the initial code and documentation distributed under this Agreement, and b) in the case of each subsequent Contributor:
i) changes to the Program, and
ii) additions to the Program;
where such changes and/or additions to the Program originate from and are distributed by that particular Contributor. A Contribution 'originates' from a Contributor if it was added to the Program by such Contributor itself or anyone acting on such Contributor's behalf. Contributions do not include additions to the Program which: (i) are separate modules of software distributed in conjunction with the Program under their own license agreement, and (ii) are not derivative works of the Program.
"Contributor" means any person or entity that distributes the Program.
"Licensed Patents " mean patent claims licensable by a Contributor which are necessarily infringed by the use or sale of its Contribution alone or when combined with the Program.
"Program" means the Contributions distributed in accordance with this Agreement.
"Recipient" means anyone who receives the Program under this Agreement, including all Contributors.
2. GRANT OF RIGHTS
a) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, distribute and sublicense the Contribution of such Contributor, if any, and such derivative works, in source code and object code form.
b) Subject to the terms of this Agreement, each Contributor hereby grants Recipient a non-exclusive, worldwide, royalty-free patent license under Licensed Patents to make, use, sell, offer to sell, import and otherwise transfer the Contribution of such Contributor, if any, in source code and object code form. This patent license shall apply to the combination of the Contribution and the Program if, at the time the Contribution is added by the Contributor, such addition of the Contribution causes such combination to be covered by the Licensed Patents. The patent license shall not apply to any other combinations which include the Contribution. No hardware per se is licensed hereunder.
c) Recipient understands that although each Contributor grants the licenses to its Contributions set forth herein, no assurances are provided by any Contributor that the Program does not infringe the patent or other intellectual property rights of any other entity. Each Contributor disclaims any liability to Recipient for claims brought by any other entity based on infringement of intellectual property rights or otherwise. As a condition to exercising the rights and licenses granted hereunder, each Recipient hereby assumes sole responsibility to secure any other intellectual property rights needed, if any. For example, if a third party patent license is required to allow Recipient to distribute the Program, it is Recipient's responsibility to acquire that license before distributing the Program.
d) Each Contributor represents that to its knowledge it has sufficient copyright rights in its Contribution, if any, to grant the copyright license set forth in this Agreement.
3. REQUIREMENTS
A Contributor may choose to distribute the Program in object code form under its own license agreement, provided that:
a) it complies with the terms and conditions of this Agreement; and
b) its license agreement:
i) effectively disclaims on behalf of all Contributors all warranties and conditions, express and implied, including warranties or conditions of title and non-infringement, and implied warranties or conditions of merchantability and fitness for a particular purpose;
ii) effectively excludes on behalf of all Contributors all liability for damages, including direct, indirect, special, incidental and consequential damages, such as lost profits;
iii) states that any provisions which differ from this Agreement are offered by that Contributor alone and not by any other party; and
iv) states that source code for the Program is available from such Contributor, and informs licensees how to obtain it in a reasonable manner on or through a medium customarily used for software exchange.
When the Program is made available in source code form:
a) it must be made available under this Agreement; and
b) a copy of this Agreement must be included with each copy of the Program.
Contributors may not remove or alter any copyright notices contained within the Program.
Each Contributor must identify itself as the originator of its Contribution, if any, in a manner that reasonably allows subsequent Recipients to identify the originator of the Contribution.
4. COMMERCIAL DISTRIBUTION
Commercial distributors of software may accept certain responsibilities with respect to end users, business partners and the like. While this license is intended to facilitate the commercial use of the Program, the Contributor who includes the Program in a commercial product offering should do so in a manner which does not create potential liability for other Contributors. Therefore, if a Contributor includes the Program in a commercial product offering, such Contributor ("Commercial Contributor") hereby agrees to defend and indemnify every other Contributor ("Indemnified Contributor") against any losses, damages and costs (collectively "Losses") arising from claims, lawsuits and other legal actions brought by a third party against the Indemnified Contributor to the extent caused by the acts or omissions of such Commercial Contributor in connection with its distribution of the Program in a commercial product offering. The obligations in this section do not apply to any claims or Losses relating to any actual or alleged intellectual property infringement. In order to qualify, an Indemnified Contributor must: a) promptly notify the Commercial Contributor in writing of such claim, and b) allow the Commercial Contributor to control, and cooperate with the Commercial Contributor in, the defense and any related settlement negotiations. The Indemnified Contributor may participate in any such claim at its own expense.
For example, a Contributor might include the Program in a commercial product offering, Product X. That Contributor is then a Commercial Contributor. If that Commercial Contributor then makes performance claims, or offers warranties related to Product X, those performance claims and warranties are such Commercial Contributor's responsibility alone. Under this section, the Commercial Contributor would have to defend claims against the other Contributors related to those performance claims and warranties, and if a court requires any other Contributor to pay any damages as a result, the Commercial Contributor must pay those damages.
5. NO WARRANTY
EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, THE PROGRAM IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED INCLUDING, WITHOUT LIMITATION, ANY WARRANTIES OR CONDITIONS OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Each Recipient is solely responsible for determining the appropriateness of using and distributing the Program and assumes all risks associated with its exercise of rights under this Agreement, including but not limited to the risks and costs of program errors, compliance with applicable laws, damage to or loss of data, programs or equipment, and unavailability or interruption of operations.
6. DISCLAIMER OF LIABILITY
EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, NEITHER RECIPIENT NOR ANY CONTRIBUTORS SHALL HAVE ANY LIABILITY FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING WITHOUT LIMITATION LOST PROFITS), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OR DISTRIBUTION OF THE PROGRAM OR THE EXERCISE OF ANY RIGHTS GRANTED HEREUNDER, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
7. GENERAL
If any provision of this Agreement is invalid or unenforceable under applicable law, it shall not affect the validity or enforceability of the remainder of the terms of this Agreement, and without further action by the parties hereto, such provision shall be reformed to the minimum extent necessary to make such provision valid and enforceable.
If Recipient institutes patent litigation against a Contributor with respect to a patent applicable to software (including a cross-claim or counterclaim in a lawsuit), then any patent licenses granted by that Contributor to such Recipient under this Agreement shall terminate as of the date such litigation is filed. In addition, if Recipient institutes patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Program itself (excluding combinations of the Program with other software or hardware) infringes such Recipient's patent(s), then such Recipient's rights granted under Section 2(b) shall terminate as of the date such litigation is filed.
All Recipient's rights under this Agreement shall terminate if it fails to comply with any of the material terms or conditions of this Agreement and does not cure such failure in a reasonable period of time after becoming aware of such noncompliance. If all Recipient's rights under this Agreement terminate, Recipient agrees to cease use and distribution of the Program as soon as reasonably practicable. However, Recipient's obligations under this Agreement and any licenses granted by Recipient relating to the Program shall continue and survive.
Everyone is permitted to copy and distribute copies of this Agreement, but in order to avoid inconsistency the Agreement is copyrighted and may only be modified in the following manner. The Agreement Steward reserves the right to publish new versions (including revisions) of this Agreement from time to time. No one other than the Agreement Steward has the right to modify this Agreement. IBM is the initial Agreement Steward. IBM may assign the responsibility to serve as the Agreement Steward to a suitable separate entity. Each new version of the Agreement will be given a distinguishing version number. The Program (including Contributions) may always be distributed subject to the version of the Agreement under which it was received. In addition, after a new version of the Agreement is published, Contributor may elect to distribute the Program (including its Contributions) under the new version. Except as expressly stated in Sections 2(a) and 2(b) above, Recipient receives no rights or licenses to the intellectual property of any Contributor under this Agreement, whether expressly, by implication, estoppel or otherwise. All rights in the Program not expressly granted under this Agreement are reserved.
This Agreement is governed by the laws of the State of New York and the intellectual property laws of the United States of America. No party to this Agreement will bring a legal action under this Agreement more than one year after the cause of action arose. Each party waives its rights to a jury trial in any resulting litigation.