Juttle Google Analytics Adapter 是一个 npm 包,可以轻松地将 Google Analytics 数据导入到 Juttle 实时数据分析管道中。本文将介绍如何使用 juttle-googleanalytics-adapter 包,以及如何将其集成到您的 Juttle 流程中。
安装
在开始之前,您需要确保已经安装了 Juttle。安装方法请参考 Juttle 安装指南。
接下来,您可以使用 npm 安装 juttle-googleanalytics-adapter 包:
npm install --save-dev juttle-googleanalytics-adapter
设置身份验证
使用 Google Analytics API 进行身份验证需要一些准备工作。跟随以下步骤以设置所需的身份验证信息:
- 前往 Google API Console 并创建一个项目。
- 在项目概览页面上启用 "Google Analytics API"。
- 从 "Credentials" 页面生成一个新的 "OAuth 2.0 客户端 ID"。
- 在 "授权重定向 URI" 中添加
http://localhost:3000/auth/google
。 - 下载 JSON 格式的客户端密钥并将其保存到您的项目中。将此文件的名称设置为
client_secret.json
。
请注意,设置正确的授权重定向 URI 非常重要,因为它将用于生成身份验证令牌。
配置模块
在身份验证信息准备好之后,您可以配置 juttle-googleanalytics-adapter 模块。这是一个典型的配置对象:
{ "client_email": "<YOUR_CLIENT_EMAIL>", "private_key": "<YOUR_PRIVATE_KEY>", "view_id": "<YOUR_VIEW_ID>" }
在 client_email
和 private_key
字段中输入您在前一步中下载的 JSON 文件中的值。view_id
是您用于 Google Analytics 中的特定视图 ID。
您需要将该配置对象传递给 googleanalytics
函数:
import adaptor from 'juttle-googleanalytics-adapter'; var env = adaptor({ "client_email": "<YOUR_CLIENT_EMAIL>", "private_key": "<YOUR_PRIVATE_KEY>", "view_id": "<YOUR_VIEW_ID>" });
进行查询
在成功配置模块之后,您就可以开始使用 juttle-googleanalytics-adapter 了。这是一个简单的查询示例,用于从 Google Analytics 中获取流量渠道的数据:
read googleanalytics::metrics { metric "sessions", dimension "channelGrouping", start "7daysAgo", end "today" }
在此查询中,我们定义了一个称为 googleanalytics
的 adapter。我们请求 “sessions” 作为“渠道分组”的度量值,并将查询时间范围设置为过去 7 天和今天。
请注意,在 Juttle 中,单次查询不会立即生成可用的结果。相反,它需要计划为一个 Juttle 程序。尽管您可以在 Juttle 中使用语法来处理结果,但必须先将查询计划为程序。
为了计划查询,请在控制台中键入:
juttle program.juttle
在此命令中,program.juttle
是 Juttle 程序的名称。
结论
在这篇文章中,我们介绍了如何使用 juttle-googleanalytics-adapter 包,并将其集成到您的 Juttle 流程中。我们还讨论了如何设置身份验证以及如何配置模块。通过本文,您了解了如何使用 Juttle 进行实时数据分析,并从 Google Analytics 中获取数据。希望本文对您有所帮助!
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/60066ef94c49986ca68d878e