Google アナリティクス 4¶
Google アナリティクスは、Web サイトやアプリ全体のトラフィックとエンゲージメントを測定する分析サービスです。これは、ユニバーサルアナリティクスのプロパティでこれまで使用してきたものとは異なるレポートを含む、新しい種類のプロパティです。
Web サイトとアプリの両方のデータを収集し、カスタマージャーニーの理解を深めます。
セッションベースではなく、イベントベースのデータを使用します。
Cookie のない測定、動作、および変換モデリングなどのプライバシー制御が含まれます。
予測機能は、複雑なモデルを使用しないガイダンスを提供します。
メディアプラットフォームに直接統合することで、Web サイトやアプリでのアクションを促します。
Google Analytics Data API を使用して Denodo に JSON のデータソースと基本ビューを作成することで、Google アナリティクスからデータを取得するように Denodo を構成できます。
Google アナリティクスは非常に多くのデータとビューを管理するため、必要なデータソースと基本ビューをすべて Denodo に追加するのは大変な作業になる場合があります。このプロセスをより簡単にすばやく行えるように、Google アナリティクスウィザードが用意されています。フォームでいくつかのパラメータを構成し、Denodo サーバーにインポートを実行するだけで、Google アナリティクスにアクセスできます。
これらの Google アナリティクス用ウィザードは、 Google アナリティクス 4 に対応しています。
OAuth 2.0 資格情報の取得¶
最初に、Google Cloud コンソールで アプリケーション を登録する必要があります。これは、後ほど入力する資格情報を取得し、このサービスの API に接続するために行います。
Google Cloud コンソールでプロジェクトを作成します。
Google Analytics Data API v1 を有効にします。
OAuth の同意を入力します。
OAuth 2.0 資格情報を作成します。
注釈
詳細については、使用する環境に対応する値を入力するか、Google アナリティクスのドキュメントを参照してください。

Google Cloud コンソールでのプロジェクトの作成¶

API の有効化¶

Google Analytics Data API の有効化¶

OAuth 2.0 の同意画面 1¶

OAuth 2.0 の同意画面 2¶

OAuth 2.0 の同意画面 3¶

資格情報の作成¶

OAuth クライアント ID の作成¶

作成された OAuth 2.0 資格情報¶
Design Studio に戻り、 [Tools] メニュー > [OAuth credential wizards] > [OAuth 2.0 wizard] をクリックします。このウィザードを使用して、OAuth アクセストークンと更新トークンを取得します。

OAuth 2.0 資格情報ウィザード¶
OAuth トークンを取得するには、以下のパラメータを入力します。
Client identifier: Google Cloud コンソールで生成されるクライアント ID。
Client secret: Google Cloud コンソールで生成されるクライアントシークレット。
Token endpoint URL: https://oauth2.googleapis.com/token
Authorization server URL: https://accounts.google.com/o/oauth2/auth
Redirect URI: http://localhost:9090/oauth/2.0/redirectURL.jsp
Scopes: 次の内容を入力します。
https://www.googleapis.com/auth/analytics.edit
https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/analytics.readonly
これらの スコープ には、データにクエリを実行するために必要な権限が必須です。
注釈
コールバック URL が外部からアクセスできない場合、認可応答 URL を取得しようとすると、ブラウザーにエラーページが表示されます。エラーを無視して、手順 3 でブラウザーのアドレスバーに表示されている URL をコピーします。
アーティファクトのインポート¶
これで、事前定義された Google アナリティクスレポートの作成に必要なデータがすべて揃いました。
[File] メニュー > [New] > [Data source] をクリックして、[Google Analytics 4] を選択します。

Google アナリティクスウィザード¶
以下の値を入力します。
Database: 事前定義された Google アナリティクスレポートが作成されるデータベース。
Client ID: Google Cloud コンソールで生成されるクライアント ID。
Client Secret: Google Cloud コンソールで生成されるクライアントシークレット。
Access token: 前のセクションのウィザードで生成されたアクセストークン。
Refresh token: 前のセクションのウィザードで生成された更新トークン。
Property id: イベントが追跡される Google アナリティクス GA4 のプロパティ識別子。Google アナリティクスツールで定義したプロパティと同じ数だけ Google アナリティクスウィザードを使用して、そのすべてのプロパティのデータを取得できます。
View name prefix: Virtual DataPort に作成されたすべてのビューとフォルダの名前の接頭辞を構成し、このウィザードで作成されたビューを Google アナリティクスのレポートに関連付けることができます。このパラメータは最長で 10 文字です。
Redirect URI: 構成済みの OAuth 2.0 リダイレクト URI。
事前定義のレポートの一部には、構成可能なディメンションがあります。このため、以下のプロパティを入力する必要があります。
Traffic dimension: ライフサイクルトラフィック獲得レポートに関連する有効な GA4 ディメンション。デフォルト値は
sessionSource
です。他に指定できる値は、sessionMedium
、sessionSourceMedium
、sourcePlatform
、sessionSourcePlatform
、sessionCampaignName
、sessionCampaignId
、sessionDefaultChannelGroup
です。User acquisition dimension: ライフサイクルユーザー獲得レポートに関連する有効な GA4 ディメンション。デフォルト値は
firstUserMedium
です。他に指定できる値は、firstUserMedium
、firstUserSource
、firstUserSourceMedium
、firstUserSourcePlatform
、firstUserCampaignId
、firstUserCampaignName
、firstUserDefaultChannelGroup
、firstUserGoogleAdsAdGroupName
、firstUserGoogleAdsAdNetworkType
です。Event dimension: ライフサイクルエンゲージメントイベントレポートに関連する有効な GA4 ディメンション。デフォルト値は
eventName
です。Conversion dimension: ライフサイクルエンゲージメント変換レポートに関連する有効な GA4 ディメンション。デフォルト値は
eventName
です。Pages screens dimensions: ライフサイクルエンゲージメントページおよび画面レポートに関連する有効な GA4 ディメンション。デフォルト値は
unifiedScreenClass
です。他に指定できる値は、unifiedPagePathScreen
、unifiedScreenName
、contentGroup
です。Page dimension: ライフサイクルエンゲージメントランディングページレポートに関連する有効な GA4 ディメンション。デフォルト値は
landingPage
です。User dimension: ユーザー人口統計詳細レポートに関連する有効な GA4 ディメンション。デフォルト値は
country
です。他に指定できる値は、city
、region
、language
、interests
、userAgeBracket
、userGender
です。Tech dimension: ユーザーテクノロジー詳細レポートに関連する有効な GA4 ディメンション。デフォルト値は
deviceCategory
です。他に指定できる値は、browser
、operatingSystem
、deviceModel
、operatingSystemVersion
、operatingSystemWithVersion
、platform
、platformDeviceCategory
、screenResolution
です。
以下のプロパティを使用すると、ビューと GA4 ディメンションを関連付けることができるように、作成されるすべてのビューの名前の接頭辞を構成できます。
Traffic view prefix: ライフサイクルトラフィック獲得レポートのビューの名前の接頭辞。このパラメータは最長で 10 文字です。
User acquisition view prefix: ライフサイクルユーザー獲得レポートのビューの名前の接頭辞。このパラメータは最長で 10 文字です。
Event view prefix: ライフサイクルエンゲージメントイベントレポートのビューの名前の接頭辞。このパラメータは最長で 10 文字です。
Conversion view prefix: ライフサイクルエンゲージメント変換レポートのビューの名前の接頭辞。このパラメータは最長で 10 文字です。
Pages screens view prefix: ライフサイクルエンゲージメントページおよび画面レポートのビューの名前の接頭辞。このパラメータは最長で 10 文字です。
Page view prefix: ライフサイクルエンゲージメントランディングページレポートのビューの名前の接頭辞。このパラメータは最長で 10 文字です。
User view prefix: ユーザー人口統計詳細レポートのビューの名前の接頭辞。このパラメータは最長で 10 文字です。
Tech view prefix: ユーザーテクノロジー詳細レポートのビューの名前の接頭辞。このパラメータは最長で 10 文字です。
ここで [Execute import] をクリックして、事前定義の Google アナリティクスレポートにクエリを実行するためのデータソースとビューを作成します。
注釈
以下の例では、パラメータ [View name prefix] の値に [view1] を使用しています。
リアルタイムレポート¶
${view_name_prefix}_ga4_real_time: 使用するプロパティのリアルタイムイベントデータのカスタマイズされたレポートを返します。イベントは、Google アナリティクスに送信されてから数秒後にリアルタイムレポートに表示されます。リアルタイムレポートには、現時点から 30 分前 (Google アナリティクス 360 のプロパティの場合は最大 60 分前) までのイベントと使用に関するデータが表示されます。必要なパラメータは以下のとおりです。
dimensions: レポートにリクエストされるディメンション。
metrics: レポートにリクエストされるメトリック。
リアルタイムビューのクエリ¶
作成された Google アナリティクスのビューに対してクエリを実行できます。この例では、 activeUsers
を city
別に表示するリアルタイムレポートを作成しています。

リアルタイムのクエリ¶

リアルタイムのクエリ結果¶
カスタムレポート¶
${view_name_prefix}_ga4_custom_report: Google アナリティクスのイベントデータをカスタマイズしたレポートを返します。レポートには、Google アナリティクスの追跡コードによって収集されたデータから得られた統計情報が含まれます。API から返されるデータは、リクエストされたディメンションとメトリックの列を含むテーブルです。必要なパラメータは以下のとおりです。
dimensions
: Google アナリティクスの有効なディメンション。metrics
: Google アナリティクスの有効なメトリック。startdate
: Google アナリティクスデータの取得開始日。enddate
: Google アナリティクスデータの取得終了日。
カスタムレポートビューのクエリ¶
作成された Google アナリティクスのビューに対してクエリを実行できます。この例では、2022-12-01 から 2022-12-31 までの sessions
を browser
別に表示するカスタムレポートを作成しています。

カスタムレポートのクエリ¶

カスタムレポートのクエリ結果¶
カスタムピボットレポート¶
${view_name_prefix}_ga4_custom_pivot_report: Google アナリティクスのイベントデータをカスタマイズしたピボットレポートを返します。ピボットレポートでは、ディメンションはピボットに含まれる場合のみ表示されます。必要なパラメータは以下のとおりです。
dimensions
: Google アナリティクスの有効なディメンション。metrics
: Google アナリティクスの有効なメトリック。startdate
: Google アナリティクスデータの取得開始日。enddate
: Google アナリティクスデータの取得終了日。limit_0
: このピボットで返すディメンション値の一意の組み合わせの数。dimension_pivot1
: レポート応答に表示される列のディメンション名。dimension_pivot2
: レポート応答に表示される列のディメンション名。
カスタムピボットレポートのビューのクエリ¶
作成された Google アナリティクスのビューに対してクエリを実行できます。この例では、2022-12-01 から 2022-12-31 までの sessions
を deviceCategory
と date
別に表示するカスタムピボットレポートを作成しています。

カスタムピボットレポートのクエリ¶

カスタムピボットレポートのクエリ結果¶
GA4 新機能の事前定義レポート¶
これらのビューには固定のメトリックがある一方で、ディメンションを Google アナリティクスウィザードで構成できます。すべてのビューに startdate
および enddate
の必須パラメータがあります。
${traffic_view_prefix}_ga4_traffic: 事前定義のライフサイクルトラフィック獲得レポートを以下のパラメータで返します。
metrics
: newUsers、engagedSessions、engagementRate、sessionsPerUser、averageSessionDuration、eventCount、conversions、totalRevenue。dimension
: [Traffic dimension] パラメータで構成可能。デフォルト値は sessionSource です。
${user_acquisition_view_prefix}_ga4_user_ac: 事前定義のライフサイクルユーザー獲得レポートを以下のパラメータで返します。
metrics
: newUsers、engagedSessions、engagementRate、sessionsPerUser、averageSessionDuration、eventCount、conversions、totalRevenue。dimension
: [User acquisition dimension] パラメータで構成可能。デフォルト値は firstUserMedium です。
${user_view_prefix}_ga4_users: 事前定義のユーザー人口統計詳細レポートを以下のパラメータで返します。
metrics
: activeUsers、newUsers、engagedSessions、sessionsPerUser、userEngagementDuration、eventCount、conversions、totalRevenue。dimension
: [User dimension] パラメータで構成可能。デフォルト値は country です。
${conversion_view_prefix}_ga4_conversion: 事前定義のライフサイクルエンゲージメント変換レポートを以下のパラメータで返します。
metrics
: conversions、totalUsers、totalRevenue。dimension
: [Event dimension] パラメータで構成可能。デフォルト値は eventName です。
${event_view_prefix}_ga4_events: 事前定義のライフサイクルエンゲージメントイベントレポートを以下のパラメータで返します。
metrics
: eventCount、totalUsers、eventCountPerUser、totalRevenue。dimension
: [Event dimension] パラメータで構成可能。デフォルト値は eventName です。
${page_view_prefix}_ga4_pages: 事前定義のライフサイクルエンゲージメントランディングページレポートを以下のパラメータで返します。
metrics
: sessions、activeUsers、newUsers、averageSessionDuration、conversions、totalRevenue。dimensions
: [Page dimension] パラメータで構成可能。デフォルト値は landingPage です。
${pages_screens_view_prefix}_ga4_screens: 事前定義のライフサイクルエンゲージメントページおよび画面レポートを以下のパラメータで返します。
metrics
: screenPageViewsPerSession、activeUsers、screenPageViewsPerUser、averageSessionDuration、eventCount,conversions、totalRevenue。dimension
: [Pages screens dimension] パラメータで構成可能。デフォルト値は unifiedScreenClass です。
${tech_view_prefix}_ga4_tech: 事前定義のユーザーテクノロジー詳細レポートを以下のパラメータで返します。
metrics
: activeUsers、newUsers、engagedSessions、engagementRate、sessionsPerUser、userEngagementDuration、eventCount、conversions、totalRevenue。dimension
: [Tech dimension] パラメータで構成可能。デフォルト値は deviceCategory です。
GA4 ディメンションの構成可能なレポートビューのクエリ¶
新たにインポートされた事前定義のレポートを実行できるようになりました。 以下の例では、 ${traffic_view_prefix}_ga4_traffic ビューが次の構成パラメータ値で実行されています。
traffic_view_prefix
= sstraffic_dimension
= sessionSource

トラフィック獲得レポートのクエリ¶

トラフィック獲得レポートのクエリ結果¶
付録 I. Google Analytics Data API v1 の使用方法¶
Google Analytics Data API v1 を使用すると、Google アナリティクスプラットフォームのレポートデータにアクセスできます。Analytics Data API v1 を使用してデータをリクエストするには、以下の最小要件を満たす RunReportRequest
オブジェクトを作成します。
dateRangesfield
に有効なエントリがあること。dimensions
フィールドに少なくとも 1 つの有効なエントリがあること。metrics
フィールドに少なくとも 1 つの有効なエントリがあること。
ここで RunReportRequest
オブジェクト全体を確認できます。
{
"dimensions": [
{
object (Dimension)
}
],
"metrics": [
{
object (Metric)
}
],
"dateRanges": [
{
object (DateRange)
}
],
"dimensionFilter": {
object (FilterExpression)
},
"metricFilter": {
object (FilterExpression)
},
"offset": string,
"limit": string,
"metricAggregations": [
enum (MetricAggregation)
],
"orderBys": [
{
object (OrderBy)
}
],
"currencyCode": string,
"cohortSpec": {
object (CohortSpec)
},
"keepEmptyRows": boolean,
"returnPropertyQuota": boolean
}
例¶
VDP の Safari ブラウザーで eventCount
と sessions
を表示するレポートを作成します。
最初に、[New] > [Data source] > [Others] > [JSON] をクリックして新しい JSON データソースを作成し、HTTP クライアントをデータルートに設定します。

JSON データソースの構成¶
最後に、データソース認証を構成する必要があります。Google Cloud コンソールで作成された OAuth 2.0 資格情報を使用してください。
以下の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics scopes

JSON データソース認証¶
[Save] をクリックします。
JSON データソースを作成したら、次に Google アナリティクスのレポートデータを取得するための基本ビューを作成します。作成するには、[CREATE BASE VIEW] ボタンを使用します。

基本ビューの作成¶
基本ビューの構成ウィザードで、相対 URL として properties/YOUR_PROPERTY_ID:runReport
を使用し、POST 本文 (目的に応じてカスタマイズ可能) に以下の json オブジェクトを使用します。
{
"dateRanges": [
{"endDate": "2022-12-31", "startDate": "2022-12-01"}
],
"metrics": [
{"name": "sessions"},
{"name": "eventCount"}
],
"dimensions": [
{"name": "browser" }
],
"dimensionFilter": {
"filter": {
"fieldName": "browser",
"stringFilter": {
"value": "Safari"
}
}
}
}
これで、作成された基本ビューを実行できます。

基本ビューのクエリ¶

基本ビューのクエリ結果¶
API リクエストの 応答の本文 は RunReportResponse
オブジェクトのインスタンスです。この構造は、レポート内のディメンションとメトリクス、およびそのデータ型を記述する dimensionHeaders
オブジェクトと metricHeaders
オブジェクトで定義されます。ディメンションとメトリックの値は rows
フィールドで指定します。
これは、上記で作成されたサンプルレポートの JSON 応答です。
{
"dimensionHeaders": [
{
"name": "browser"
}
],
"metricHeaders": [
{
"name": "sessions",
"type": "TYPE_INTEGER"
},
{
"name": "eventCount",
"type": "TYPE_INTEGER"
}
],
"rows": [
{
"dimensionValues": [
{
"value": "Safari"
}
],
"metricValues": [
{
"value": "3231"
},
{
"value": "22961"
}
]
}
],
"rowCount": 1,
"metadata": {
"currencyCode": "USD",
"timeZone": "America/Los_Angeles"
},
"kind": "analyticsData#runReport"
}