将 Google Analytics 与 IBM App Connect Enterprise 配合使用

Google Analytics 是一种 Web 分析服务，提供用于分析整个企业中 Web 站点和应用程序上的流量的工具。使用 IBM® App Connect Enterprise 将 Google Analytics 连接到其他应用程序。 IBM App Connect Enterprise 提供了 Google Analytics Request 节点，可用于连接到 Google Analytics ，并发出请求以对对象 (例如，定制数据源，定制度量，过滤器，帐户用户链接和目标) 执行操作。

关于此任务

IBM App Connect Enterprise 通过 Windows ， AIX和 Linux® 系统上提供的 Google Analytics Request 节点与 Google Analytics 同步通信。

您可以使用 Google Analytics Request 节点连接到 Google Analytics 并检索以下对象:

帐户用户链接
定制数据源
定制维度
定制度量指标
过滤器
目标
多渠道漏斗报告
概要文件过滤器链接
概要文件用户链接
概要文件
Web 属性

有关配置 Google Analytics Request 节点的更多信息，请参阅 Google Analytics Request 节点。

过程

在 IBM App Connect Enterprise Toolkit中，创建包含 Google Analytics Request 节点的流。
在流中选择 Google Analytics Request 节点以在编辑器中显示节点属性。
在基本选项卡上，单击启动连接器发现。
此时会显示一个面板，您可以在其中指定要在连接器发现期间使用的策略项目名称和保险库文件详细信息。
指定要在连接器发现期间使用的策略项目和保险库文件的详细信息：
1. 在策略项目字段中，指定用于存储连接器发现期间创建的策略的策略项目。
  也可以通过单击新建并指定新策略项目的名称来创建新的策略项目。然后单击完成。
2. 指定要在连接器发现期间使用的保险库文件。缺省情况下，连接器发现期间使用的凭证存储在外部目录保险库中，这是可供任何集成服务器使用的 App Connect Enterprise 保险库文件。或者，您可以将凭证存储在集成服务器保险库文件中，该保险库文件是在集成服务器的工作目录中创建的，并且只能由该特定集成服务器使用。
  要指定用于存储凭证的保险库文件，请完成下列其中一个主题的 使用连接器发现向导 部分中的步骤:
  - 配置外部目录保险库
  - 配置集成服务器保险库
3. 在保险库密钥字段中，输入用于访问保险库中存储的凭证的保险库密钥。保险库密钥的长度必须至少为 8 个字符。
4. 可选: 缺省情况下，指定的保险库文件位置和保险库文件密钥将另存为 Toolkit 中的首选项，以便在您启动 "连接器发现" 时预设这些值。如果您不希望保存这些首选项，请取消选中保存在保险库文件首选项中。
单击启动发现以启动 Google Analytics 连接器的 "连接器发现" 向导。
此时将显示 " 连接器发现 " 窗口。如果现有 Google Analytics 连接 (帐户) 可用，那么将显示这些连接的列表。如果没有现有连接，那么 Google Analytics 连接器的状态将显示为 Not connected。
- 如果一个或多个 Google Analytics 连接 (帐户) 可用，请完成以下步骤:
  1. 通过单击要使用的连接 (帐户) 来选择该连接。
  2. 单击所需的对象类型，然后选择要对该对象执行的操作。例如，要从 Google Analytics检索过滤器，请单击过滤器，然后单击检索过滤器。
- 如果没有现有连接（帐户），请完成以下步骤：
  1. 单击所需的对象类型，然后选择要对该对象执行的操作。例如，要从 Google Analytics检索过滤器，请单击过滤器，然后单击检索过滤器。
  2. 单击连接。
    此时将显示一个窗口，您可以在该窗口中输入 Google Analytics 帐户的连接详细信息。输入以下信息：
    - 应用程序客户机标识: 从映射到特定项目请求的 Google API 控制台生成的唯一标识。
    - 应用程序客户机密钥: 为特定项目创建的唯一应用程序客户机标识的应用程序客户机密钥。
    - OAuth 访问令牌: 从应用程序客户机标识和客户机密钥生成的访问令牌。
    - OAuth 刷新令牌:从应用程序客户机标识和客户机密钥生成的刷新令牌。
    有关访问或生成这些连接详细信息的更多信息、请参阅如何将 IBM App Connect 与 GoogleAnalytics 文件中的 IBM App Connect Enterprise as a Service。
  3. 单击连接。
在向导中设置必需的连接器属性。

您还可以设置一些属性，这些属性指定要检索的最大记录数以及在超过该限制时要执行的操作。
在 "连接器发现" 向导中指定完属性后，单击保存。
用于连接到 Google Analytics 的凭证存储在保险库文件中，其他连接详细信息保存在 Google Analytics 策略中。您在向导中设置的属性值将返回到 IBM App Connect Enterprise Toolkit中的 Google Analytics Request 节点。
完成发现并保存属性值后，通过单击窗口右上角的 X 或按 Alt+F4来退出 "连接器发现" 向导。
返回以编辑 IBM App Connect Enterprise Toolkit中的 Google Analytics Request 节点。
现在，在 "连接器发现" 向导 (在步骤 6中) 中设置的连接器属性在属性编辑器中的 Google Analytics Request 节点上可见。基本选项卡显示您在向导中设置的操作和对象属性的值。例如，如果在向导中选择了过滤器 > 检索过滤器，那么将在节点的基本选项卡上显示以下属性:
- 操作 - RETRIEVEALL
- 对象 - filters
操作和对象属性的值将以只读格式显示。如果要更改这些值，您可以通过再次单击启动连接器发现并在“连接器发现”向导中设置新值来执行此操作。

模式基本名称属性指定模式文件的基本名称，这些文件描述从 Google Analytics 连接器发送和接收的请求和响应消息的格式。模式基本名称是在您第一次为节点运行发现时自动设置的，它基于当前流名称和节点名。如果在首次运行发现之前手动设置此属性，那么将使用您设置的值。如果在发现后重命名模式，那么必须编辑此属性，以使其与项目中重命名的模式所使用的模式基本名称相匹配。如果在发现后更改此属性，那么必须重命名模式名称以匹配或再次运行发现。

根据发现期间选择的操作， "连接器发现" 向导将生成请求模式和响应模式，或者仅生成响应模式。仅当所选操作和对象需要请求消息时，才会生成请求模式。生成的请求模式用于验证请求消息。如果操作为 RETRIEVE 或 DELETE，那么连接器仅返回响应模式。

生成的模式文件将添加到项目中，并且可供映射节点用于变换输入或输出数据。模式的完整文件名派生自模式基本名称 (例如 gen/MyMessageFlow.Google_Analytics_Request) ，后缀为 response.schema.json 或 request.schema.json。您可以通过单击打开请求模式或打开响应模式来打开模式。
检查 Google Analytics Request 节点上的属性设置是否正确，然后保存消息流。
在 Google Analytics Request 节点的连接选项卡上，策略属性显示策略的名称，该策略包含要用于连接的安全身份的详细信息。策略的类型为 Google Analytics。
有关更多信息，请参阅 Google Analytics 策略。
可选: 在连接选项卡上设置超时属性，以指定节点等待 Google Analytics 处理操作的时间 (以秒计)。
Google Analytics Request 节点的过滤器选项卡包含用于控制消息流选择数据的方式的属性。这些属性的初始值取自在 "连接器发现" 向导中为 Google Analytics 连接器设置的属性值，包括过滤器选项属性和指定的任何条件 (如步骤 6中所述)。如果您随后返回到 "连接器发现" 向导并更改任何属性的值，那么这些更新将反映在节点上设置的属性中。

过滤器选项属性控制执行 Google Analytics Request 节点时要对哪些对象进行操作。过滤器限制属性控制要检索的最大项数以及超出限制时要执行的操作。

您可以通过单击要在 " 过滤器选项 " 部分中修改的值旁边的编辑，并通过更改已在过滤器限制部分中设置的属性值来修改值。

属性值可以是文本值， ESQL 或 XPATH 表达式，这些表达式是从执行时传递到 Google Analytics Request 节点的消息内容解析而来的。
在请求选项卡上，设置数据位置属性以指定入局消息树中包含要在 Google Analytics中创建的对象数据的位置。此数据构成从 Google Analytics Request 节点发送到 Google Analytics的请求。
在结果选项卡上，设置输出数据位置属性以指定输出消息树中包含在 Google Analytics中创建的记录数据的位置。
缺省情况下，将根据连接器发现期间生成的请求模式验证请求消息。您可以通过使用 Google Analytics Request 节点的验证属性来关闭请求验证或更改验证设置。
保存消息流。