将数据从 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 属性作为 DataStore 运行报表，Dimensions 和 Metrics 作为 DataStore 列。
• MetaExtract 将获取所有可用的 GA4 属性 (DataStores) 及其维和度量 (DataStoreColumns) 的元数据。
• 此连接器支持有限数量的 Google Analytics 度量。请参阅 Dimensions Metrics Explorer 以了解可用功能。

1. 在 Google Cloud (Analytics) Project 中，创建服务帐户并下载 credentials.json 文件。
   请参见 https://cloud.google.com/docs/authentication/production 。
2. 将服务帐户添加到 Google Analytics 4 属性。
   请参见 https://developers.google.com/analytics/devguides/reporting/data/v1/quickstart-client-libraries 。
3. 使用以下说明启用 Google Analytics API：
   1. 使用文本编辑器打开已下载的 credentials.json 文件，并搜索 client_email 字段以获取服务帐户电子邮件地址。
   2. 使用此电子邮件地址可将用户添加到要通过 Google Analytics Data API v1 访问的 Google Analytics 4 属性。
   
4. 确保 Google Analytics 管理 API、Google Analytics 数据 API 可用于 Google Analytics 实例。
   
5. 在 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 的 GA4 属性 ID 列表。
      • 回退模式：选择 "Full"（已满）或 "Committed"（已确定）。
      • 前 N 天的回顾列表：以逗号分隔的天数（整数）值列表，例如 7,21。

      
      

      

      
      

      请注意以下几点：

      • 对于回退模式，如果您未提供值，则不支持回退模式。“完全”选项需要一天的值，如果提供多个值，则处理将使用第一个值。您可以为“已提交”选项提供多个值。
      • 对于列表数据存储，REST API 使用账户 ID（如果提供）返回 GA4 属性 ID 列表，或者仅返回源配置或提供的属性列表。
      • 对于列表列，REST API 返回给定 GA4 属性 ID 的列元数据的列表。
   6. 验证是否启用了刷新元数据切换，以确保在保存连接时刷新元数据。
      如果需要，您可以稍后从“Manage Connections（管理连接）”页面上的“Actions（操作）”菜单刷新元数据。

      注意：

      除非执行元数据提取，否则无法为 Google Analytics 创建扩充。

      元数据摘录：

      • 检索源配置中提供的每个 GA4 属性 ID 的元数据列。
      • Oracle Fusion Data Intelligence 以后在提取数据以区分“维”和“度量”列类型时使用的 Dimension_ 或 Metric_ 作为 GA 属性列的前缀。
      • 将有效负载 dataStores 数组留空。
   7. 单击保存。
6. 在“管理连接”页上，为 Google Analytics 连接选择操作，然后选择测试连接。

   注意：

   REST API 签名在各个源中相同。测试连接调用 GA 通用元数据 API。这将返回默认版本值，并且不会调用源。
7. 要删除连接，请在“管理连接”页上，针对适用的连接单击操作，然后选择删除。

   注意：

   在删除之前，请确保删除与数据连接相关的功能区、数据扩充和数据应用程序。无法将数据从已删除的数据连接更新或加载到仓库。
8. 成功建立连接后，导航到“数据配置”页，在数据源中选择连接，然后单击“数据扩充”磁贴，然后使用 Google Analytics 数据创建数据扩充。选择适用的 Google Analytics 源表。确保在源表中指定 "Dimension_transactionId" 作为主键，并使用该主键联接每个数据扩充表。您可以为每个数据扩充选择最多九个维。请参阅扩充您的数据。
   启用数据提取时，您可以安排在选择时运行。对于数据提取，请注意以下事项：

   1. 提供日期范围以运行报表并提取数据。
   2. 常规数据提取使用初始或最后一个 ExtractDate 作为 StartDate ，作业 RunDate 作为 EndDate 。
   3. 回溯模式包括附加日期范围以及常规提取日期范围，这些日期范围在单个 runReport 调用中提取其他数据集。
      • “完全”选项具有单个日期范围；StartDate=ExtractDate - NdaysAgo、EndDate=RunDate。
      • “已提交”选项可以有多个日期范围。对于每个配置的 GA_LIST_OF_N_DAYS_AGO，StartDate=ExtractDate - NdaysAgo，EndDate=RunDate - NdaysAgo。