?shù)據(jù)分析工具的核心功能解析)
Analytics Reporter完全指南輕量級政府?dāng)?shù)據(jù)分析工具的核心功能解析【免費下載鏈接】analytics-reporterLightweight analytics reporting and publishing tool for Digital Analytics Programs Google Analytics 360 data.項目地址: https://gitcode.com/gh_mirrors/an/analytics-reporterAnalytics Reporter是一款輕量級政府?dāng)?shù)據(jù)分析工具專為Digital Analytics Program (DAP)的Google Analytics 360數(shù)據(jù)設(shè)計能夠高效地獲取、處理和發(fā)布政府網(wǎng)站的分析數(shù)據(jù)。它使用Google Analytics Data API v1獲取數(shù)據(jù)并將其處理為扁平數(shù)據(jù)結(jié)構(gòu)為政府網(wǎng)站提供關(guān)鍵的訪問洞察。 核心功能概覽1. 多維度數(shù)據(jù)分析能力Analytics Reporter支持豐富的報告類型涵蓋設(shè)備、語言、操作系統(tǒng)、瀏覽器等多個維度。這些報告定義在reports/api.json和reports/usa.json文件中每個報告包含維度、指標(biāo)、日期范圍和排序規(guī)則等配置。例如設(shè)備報告device會分析不同設(shè)備類型桌面、移動、平板的訪問情況而瀏覽器語言報告language則展示訪問者使用的瀏覽器語言分布。2. 靈活的數(shù)據(jù)發(fā)布選項工具提供多種數(shù)據(jù)發(fā)布方式滿足不同場景需求本地文件存儲將報告保存到指定目錄AWS S3發(fā)布配置AWS環(huán)境變量后可將報告發(fā)布到S3 bucket數(shù)據(jù)庫存儲支持PostgreSQL數(shù)據(jù)庫將數(shù)據(jù)寫入數(shù)據(jù)庫以便后續(xù)分析標(biāo)準(zhǔn)輸出直接在終端顯示報告結(jié)果配置示例環(huán)境變量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. 定時任務(wù)與隊列系統(tǒng)應(yīng)用通過定時任務(wù)和隊列系統(tǒng)實現(xiàn)自動化數(shù)據(jù)處理。deploy/publisher.js定義了任務(wù)及其執(zhí)行時間使用pg-boss庫實現(xiàn)基于PostgreSQL的消息隊列。發(fā)布者進程將報告任務(wù)放入隊列消費者進程并行處理隊列中的任務(wù)執(zhí)行數(shù)據(jù)獲取和處理?? 快速上手指南環(huán)境準(zhǔn)備安裝依賴git clone https://gitcode.com/gh_mirrors/an/analytics-reporter cd analytics-reporter npm install配置Git鉤子npm run install-git-hooks設(shè)置環(huán)境變量創(chuàng)建.env文件參考env.example配置Google Analytics和數(shù)據(jù)庫等信息ANALYTICS_REPORT_EMAILyour-service-accountdeveloper.gserviceaccount.com ANALYTICS_REPORT_IDSga:12345678 ANALYTICS_KEY_PATH/path/to/secret_key.json運行應(yīng)用啟動數(shù)據(jù)庫docker-compose up執(zhí)行數(shù)據(jù)庫遷移npm run migrate啟動發(fā)布者和消費者# 啟動發(fā)布者 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 報告示例與解析一個典型的設(shè)備報告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 }這份報告展示了不同設(shè)備類型的訪問量統(tǒng)計包括每日數(shù)據(jù)和總計數(shù)據(jù)幫助政府機構(gòu)了解用戶的設(shè)備使用習(xí)慣。 高級配置選項Google Analytics認(rèn)證在Google開發(fā)者控制臺啟用Google Analytics API創(chuàng)建服務(wù)賬戶并下載JSON私鑰授予服務(wù)賬戶Read, Analyze Collaborate權(quán)限配置環(huán)境變量export ANALYTICS_REPORT_EMAILservice-accountexample.com export ANALYTICS_REPORT_IDSga:12345678 export ANALYTICS_KEY_PATH/path/to/key.json數(shù)據(jù)庫配置設(shè)置PostgreSQL數(shù)據(jù)庫連接export POSTGRES_HOSTmy.db.host.com export POSTGRES_USERpostgres export POSTGRES_PASSWORDpassword export POSTGRES_DATABASEanalytics 開發(fā)與部署流程項目采用持續(xù)交付(CD)模型開發(fā)和部署流程如下功能開發(fā)從develop分支創(chuàng)建feature分支進行開發(fā)代碼審查創(chuàng)建Pull Request通過代碼審查后合并到develop分支測試環(huán)境部署合并到develop分支后自動部署到開發(fā)環(huán)境驗收測試系統(tǒng)所有者在開發(fā)環(huán)境進行驗收測試生產(chǎn)部署通過PR將develop合并到staging再合并到master分支完成生產(chǎn)部署詳細流程請參考Development and deployment process。? 故障排除與常見問題認(rèn)證問題確保系統(tǒng)時間與NTP同步檢查私鑰是否正確配置驗證服務(wù)賬戶權(quán)限是否正確設(shè)置數(shù)據(jù)庫連接問題確認(rèn)PostgreSQL服務(wù)是否運行檢查數(shù)據(jù)庫連接參數(shù)是否正確驗證數(shù)據(jù)庫用戶權(quán)限API調(diào)用限制考慮使用多個憑證進行輪詢調(diào)用通過ANALYTICS_CREDENTIALS環(huán)境變量配置避免頻繁運行集成測試以免觸發(fā)API速率限制 許可證信息本項目屬于公共領(lǐng)域詳細信息請參見LICENSE.md。所有貢獻將根據(jù)CC0 1.0通用公共領(lǐng)域奉獻協(xié)議發(fā)布。【免費下載鏈接】analytics-reporterLightweight analytics reporting and publishing tool for Digital Analytics Programs Google Analytics 360 data.項目地址: https://gitcode.com/gh_mirrors/an/analytics-reporter創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 Analytics Reporter完全指南：輕量級政府?dāng)?shù)據(jù)分析工具的核心功能解析
Analytics Reporter完全指南輕量級政府?dāng)?shù)據(jù)分析工具的核心功能解析【免費下載鏈接】analytics-reporterLightweight analytics reporting and publishing tool for Digital Analytics Programs Google Analytics 360 data.項目地址: https://gitcode.com/gh_mirrors/an/analytics-reporterAnalytics Reporter是一款輕量級政府?dāng)?shù)據(jù)分析工具專為Digital Analytics Program (DAP)的Google Analytics 360數(shù)據(jù)設(shè)計能夠高效地獲取、處理和發(fā)布政府網(wǎng)站的分析數(shù)據(jù)。它使用Google Analytics Data API v1獲取數(shù)據(jù)并將其處理為扁平數(shù)據(jù)結(jié)構(gòu)為政府網(wǎng)站提供關(guān)鍵的訪問洞察。 核心功能概覽1. 多維度數(shù)據(jù)分析能力Analytics Reporter支持豐富的報告類型涵蓋設(shè)備、語言、操作系統(tǒng)、瀏覽器等多個維度。這些報告定義在reports/api.json和reports/usa.json文件中每個報告包含維度、指標(biāo)、日期范圍和排序規(guī)則等配置。例如設(shè)備報告device會分析不同設(shè)備類型桌面、移動、平板的訪問情況而瀏覽器語言報告language則展示訪問者使用的瀏覽器語言分布。2. 靈活的數(shù)據(jù)發(fā)布選項工具提供多種數(shù)據(jù)發(fā)布方式滿足不同場景需求本地文件存儲將報告保存到指定目錄AWS S3發(fā)布配置AWS環(huán)境變量后可將報告發(fā)布到S3 bucket數(shù)據(jù)庫存儲支持PostgreSQL數(shù)據(jù)庫將數(shù)據(jù)寫入數(shù)據(jù)庫以便后續(xù)分析標(biāo)準(zhǔn)輸出直接在終端顯示報告結(jié)果配置示例環(huán)境變量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. 定時任務(wù)與隊列系統(tǒng)應(yīng)用通過定時任務(wù)和隊列系統(tǒng)實現(xiàn)自動化數(shù)據(jù)處理。deploy/publisher.js定義了任務(wù)及其執(zhí)行時間使用pg-boss庫實現(xiàn)基于PostgreSQL的消息隊列。發(fā)布者進程將報告任務(wù)放入隊列消費者進程并行處理隊列中的任務(wù)執(zhí)行數(shù)據(jù)獲取和處理?? 快速上手指南環(huán)境準(zhǔn)備安裝依賴git clone https://gitcode.com/gh_mirrors/an/analytics-reporter cd analytics-reporter npm install配置Git鉤子npm run install-git-hooks設(shè)置環(huán)境變量創(chuàng)建.env文件參考env.example配置Google Analytics和數(shù)據(jù)庫等信息ANALYTICS_REPORT_EMAILyour-service-accountdeveloper.gserviceaccount.com ANALYTICS_REPORT_IDSga:12345678 ANALYTICS_KEY_PATH/path/to/secret_key.json運行應(yīng)用啟動數(shù)據(jù)庫docker-compose up執(zhí)行數(shù)據(jù)庫遷移npm run migrate啟動發(fā)布者和消費者# 啟動發(fā)布者 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 報告示例與解析一個典型的設(shè)備報告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 }這份報告展示了不同設(shè)備類型的訪問量統(tǒng)計包括每日數(shù)據(jù)和總計數(shù)據(jù)幫助政府機構(gòu)了解用戶的設(shè)備使用習(xí)慣。 高級配置選項Google Analytics認(rèn)證在Google開發(fā)者控制臺啟用Google Analytics API創(chuàng)建服務(wù)賬戶并下載JSON私鑰授予服務(wù)賬戶Read, Analyze Collaborate權(quán)限配置環(huán)境變量export ANALYTICS_REPORT_EMAILservice-accountexample.com export ANALYTICS_REPORT_IDSga:12345678 export ANALYTICS_KEY_PATH/path/to/key.json數(shù)據(jù)庫配置設(shè)置PostgreSQL數(shù)據(jù)庫連接export POSTGRES_HOSTmy.db.host.com export POSTGRES_USERpostgres export POSTGRES_PASSWORDpassword export POSTGRES_DATABASEanalytics 開發(fā)與部署流程項目采用持續(xù)交付(CD)模型開發(fā)和部署流程如下功能開發(fā)從develop分支創(chuàng)建feature分支進行開發(fā)代碼審查創(chuàng)建Pull Request通過代碼審查后合并到develop分支測試環(huán)境部署合并到develop分支后自動部署到開發(fā)環(huán)境驗收測試系統(tǒng)所有者在開發(fā)環(huán)境進行驗收測試生產(chǎn)部署通過PR將develop合并到staging再合并到master分支完成生產(chǎn)部署詳細流程請參考Development and deployment process。? 故障排除與常見問題認(rèn)證問題確保系統(tǒng)時間與NTP同步檢查私鑰是否正確配置驗證服務(wù)賬戶權(quán)限是否正確設(shè)置數(shù)據(jù)庫連接問題確認(rèn)PostgreSQL服務(wù)是否運行檢查數(shù)據(jù)庫連接參數(shù)是否正確驗證數(shù)據(jù)庫用戶權(quán)限API調(diào)用限制考慮使用多個憑證進行輪詢調(diào)用通過ANALYTICS_CREDENTIALS環(huán)境變量配置避免頻繁運行集成測試以免觸發(fā)API速率限制 許可證信息本項目屬于公共領(lǐng)域詳細信息請參見LICENSE.md。所有貢獻將根據(jù)CC0 1.0通用公共領(lǐng)域奉獻協(xié)議發(fā)布。【免費下載鏈接】analytics-reporterLightweight analytics reporting and publishing tool for Digital Analytics Programs Google Analytics 360 data.項目地址: https://gitcode.com/gh_mirrors/an/analytics-reporter創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考