Analytics Reporter完全指南轻量级政府数据分析工具的核心功能解析【免费下载链接】analytics-reporterLightweight analytics reporting and publishing tool for Digital Analytics Programs Google Analytics 360 data.项目地址: https://gitcode.com/gh_mirrors/an/analytics-reporterAnalytics Reporter是一款轻量级政府数据分析工具专为Digital Analytics Program (DAP)的Google Analytics 360数据设计能够高效地获取、处理和发布政府网站的分析数据。它使用Google Analytics Data API v1获取数据并将其处理为扁平数据结构为政府网站提供关键的访问洞察。 核心功能概览1. 多维度数据分析能力Analytics Reporter支持丰富的报告类型涵盖设备、语言、操作系统、浏览器等多个维度。这些报告定义在reports/api.json和reports/usa.json文件中每个报告包含维度、指标、日期范围和排序规则等配置。例如设备报告device会分析不同设备类型桌面、移动、平板的访问情况而浏览器语言报告language则展示访问者使用的浏览器语言分布。2. 灵活的数据发布选项工具提供多种数据发布方式满足不同场景需求本地文件存储将报告保存到指定目录AWS S3发布配置AWS环境变量后可将报告发布到S3 bucket数据库存储支持PostgreSQL数据库将数据写入数据库以便后续分析标准输出直接在终端显示报告结果配置示例环境变量export AWS_REGIONus-east-1 export AWS_ACCESS_KEY_ID[your-key] export AWS_SECRET_ACCESS_KEY[your-secret-key] export AWS_BUCKET[your-bucket]3. 定时任务与队列系统应用通过定时任务和队列系统实现自动化数据处理。deploy/publisher.js定义了任务及其执行时间使用pg-boss库实现基于PostgreSQL的消息队列。发布者进程将报告任务放入队列消费者进程并行处理队列中的任务执行数据获取和处理⚙️ 快速上手指南环境准备安装依赖git clone https://gitcode.com/gh_mirrors/an/analytics-reporter cd analytics-reporter npm install配置Git钩子npm run install-git-hooks设置环境变量创建.env文件参考env.example配置Google Analytics和数据库等信息ANALYTICS_REPORT_EMAILyour-service-accountdeveloper.gserviceaccount.com ANALYTICS_REPORT_IDSga:12345678 ANALYTICS_KEY_PATH/path/to/secret_key.json运行应用启动数据库docker-compose up执行数据库迁移npm run migrate启动发布者和消费者# 启动发布者 npx dotenv -e .env.analytics node -- deploy/publisher.js # 启动消费者 npx dotenv -e .env.analytics node -- deploy/consumer.js运行单个报告npx dotenv -- npm start -- --onlydevices --json --output./output 报告示例与解析一个典型的设备报告devices输出如下{ name: devices, frequency: daily, data: [ { date: 2023-12-25, device: mobile, visits: 13681896 }, { date: 2023-12-25, device: desktop, visits: 5775002 }, { date: 2023-12-25, device: tablet, visits: 367039 } ], totals: { visits: 3584551745, devices: { mobile: 2012722956, desktop: 1513968883, tablet: 52313579, smart tv: 5546327 } }, taken_at: 2023-12-26T20:52:50.062Z }这份报告展示了不同设备类型的访问量统计包括每日数据和总计数据帮助政府机构了解用户的设备使用习惯。 高级配置选项Google Analytics认证在Google开发者控制台启用Google Analytics API创建服务账户并下载JSON私钥授予服务账户Read, Analyze Collaborate权限配置环境变量export ANALYTICS_REPORT_EMAILservice-accountexample.com export ANALYTICS_REPORT_IDSga:12345678 export ANALYTICS_KEY_PATH/path/to/key.json数据库配置设置PostgreSQL数据库连接export POSTGRES_HOSTmy.db.host.com export POSTGRES_USERpostgres export POSTGRES_PASSWORDpassword export POSTGRES_DATABASEanalytics 开发与部署流程项目采用持续交付(CD)模型开发和部署流程如下功能开发从develop分支创建feature分支进行开发代码审查创建Pull Request通过代码审查后合并到develop分支测试环境部署合并到develop分支后自动部署到开发环境验收测试系统所有者在开发环境进行验收测试生产部署通过PR将develop合并到staging再合并到master分支完成生产部署详细流程请参考Development and deployment process。️ 故障排除与常见问题认证问题确保系统时间与NTP同步检查私钥是否正确配置验证服务账户权限是否正确设置数据库连接问题确认PostgreSQL服务是否运行检查数据库连接参数是否正确验证数据库用户权限API调用限制考虑使用多个凭证进行轮询调用通过ANALYTICS_CREDENTIALS环境变量配置避免频繁运行集成测试以免触发API速率限制 许可证信息本项目属于公共领域详细信息请参见LICENSE.md。所有贡献将根据CC0 1.0通用公共领域奉献协议发布。【免费下载链接】analytics-reporterLightweight analytics reporting and publishing tool for Digital Analytics Programs Google Analytics 360 data.项目地址: https://gitcode.com/gh_mirrors/an/analytics-reporter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考