Google AnalyticsからOracle Fusion Data Intelligenceへのデータのロード

サービス管理者は、Oracle Fusion Data Intelligence抽出サービスを使用して、Google Analytics SaaSインスタンスからデータを取得し、それを使用して、様々なEnterprise Resource PlanningおよびSupply Chain Managementユース・ケースのデータ拡張を作成できます。

Google Analyticsソースに接続する前に、次の点に注意してください。

Oracle Fusion Data Intelligenceは、GA4プロパティのGoogle Analyticsエクストラクタをサポートしており、以前のバージョンのGoogle Universal Analytics (UA)プロパティをサポートしていません。
DataStoresは、GA4プロパティのリストです。
DataStore列は、GA4プロパティのディメンションおよびメトリックのリストです。
DataExtractは、データ・ストアとしてGA4プロパティのユーザー選択に基づいてレポートを実行し、データ・ストア列としてディメンションおよびメトリックを実行します。
MetaExtractは、使用可能なすべてのGA4プロパティ(DataStores)とそのディメンションおよびメトリック(DataStoreColumns)のメタデータをフェッチします。
このコネクタは、限られた数のGoogle Analyticsメトリックをサポートします。ディメンション・メトリック・エクスプローラを参照して、使用可能な内容を確認してください。

Google Cloud (Analytics)プロジェクトで、サービス・アカウントを作成し、credentials.jsonファイルをダウンロードします。
https://cloud.google.com/docs/authentication/productionを参照してください。
Google Analytics 4プロパティにサービス・アカウントを追加します。
https://developers.google.com/analytics/devguides/reporting/data/v1/quickstart-client-librariesを参照してください。
次の手順を使用して、Google Analytics APIを有効にします。
1. テキスト・エディタを使用して、ダウンロードしたcredentials.jsonファイルを開き、client_emailフィールドを検索してサービス・アカウントの電子メール・アドレスを取得します。
2. この電子メール・アドレスを使用して、Google Analytics Data API v1を介してアクセスするGoogle Analytics 4プロパティにユーザーを追加します。
Google Analytics管理API、Google AnalyticsデータAPIがGoogle Analyticsインスタンスで使用可能であることを確認します。
Oracle Fusion Data Intelligenceで、次の手順を使用してGoogle Analyticsデータ接続を作成します:
1. Oracle Fusion Data Intelligenceコンソールで、「アプリケーション管理」の下の「データ構成」をクリックします。
2. 「データ構成」ページで、「接続の管理」をクリックします。
3. 「接続の管理」ページで、「作成」、「接続」の順にクリックします。
4. 「接続の作成」で、「使用タイプ」で「データ抽出」を選択し、接続タイプとして「Google Analytics」を選択します。
5. Google Analytics接続のダイアログで、接続タイプとして「標準」を選択し、次の詳細を入力します:
  - サービス・アカウント資格証明Jsonファイル: ダウンロードしたGoogle Cloud Serviceアカウントのcredentials.jsonファイル。
  - アカウントID: Google AnalyticsアカウントID。
  - GA4プロパティIDのリスト: 各IDを区切るカンマを含むプロパティIDのGA4リスト。
  - ルックバック・モード: 「完全」または「コミット済」を選択します。
  - N日前ルックバックのリスト: 7,21などの日数(整数)値のカンマ区切りリスト。
  次の点に注意してください。
  - ルックバック・モードでは、値を指定しないと、ルックバック・モードはサポートされません。「完全」オプションには1日の値が必要です。複数の値を指定した場合、プロセスでは最初の値が使用されます。「コミット済」オプションには複数の値を指定できます。
  - リスト・データ・ストアの場合、REST APIは、アカウントID (指定されている場合)または構成済ソースまたは指定されたプロパティのリストのいずれかを使用して、GA4プロパティIDのリストを返します。
  - リスト列の場合、REST APIは、指定されたGA4プロパティIDの列メタデータのリストを返します。
6. 「メタデータのリフレッシュ」トグルが有効になっていることを確認して、接続の保存時にメタデータがリフレッシュされていることを確認します。
  必要に応じて、「接続の管理」ページの「アクション」メニューからメタデータを後でリフレッシュできます。
  ノート:
  メタデータ抽出を実行しないかぎり、Google Analyticsの拡張は作成できません。
  メタデータ抽出:
  
  ソース構成で指定された各GA4プロパティIDのメタデータ列を取得します。
  
  Oracle Fusion Data Intelligenceが後でディメンション列タイプとメトリック列タイプを区別するためにデータを抽出するときに使用するDimension_またはMetric_で、GAプロパティ列に接頭辞を付けます。
  
  ペイロードのdataStores配列は空のままにします。
7. 「保存」をクリックします
「接続の管理」ページで、Google Analytics接続の「アクション」を選択し、「接続のテスト」を選択します。

ノート:
REST API署名はソース間で同じです。テスト接続はGA共通メタデータAPIを呼び出します。これにより、デフォルトのバージョン値が返され、ソースへのコールは行われません。
接続を削除するには、「接続の管理」ページで、該当する接続の「アクション」をクリックし、「削除」を選択します。

ノート:
データ接続を削除する前に、データ接続に関連する機能領域、データ拡張およびデータ・アプリケーションを削除してください。削除されたデータ接続からウェアハウスにデータを更新またはロードすることはできません。
接続が正常に確立されたら、「データ構成」ページに移動し、「データ・ソース」で接続を選択してから、「データ拡張」タイルをクリックし、Google Analyticsデータを使用してデータ拡張を作成します。該当するGoogle Analyticsソース表を選択します。ソース表のDimension_transactionIdを主キーとして指定し、それを使用して各データ拡張表を結合してください。データ拡張ごとに最大9つのディメンションを選択できます。データの拡張を参照してください。
データ抽出を有効にすると、その選択時に実行するようにスケジュールできます。データ抽出については、次の点に注意してください。
1. レポートを実行してデータをフェッチするための日付範囲を指定します。
2. 通常データ抽出では、初期または最後のExtractDateがStartDate、ジョブRunDateがEndDateとして使用されます。
3. ルックバック・モードには、追加のデータセットをフェッチする通常の抽出日付範囲とともに、単一のrunReportコールで追加の日付範囲が含まれます。
  - 「完全」オプションには、StartDate=ExtractDate - NdaysAgo、EndDate=RunDateの1つの日付範囲があります。
  - 「コミット済」オプションは、複数の日付範囲を持つことができます。構成されたGA_LIST_OF_N_DAYS_AGOごとに、StartDate=ExtractDate - NdaysAgo、EndDate=RunDate - NdaysAgo。