ga-top-pages-py

Generate markdown style top pages report based on Google Analytics(GA4) result for Static Site Generator.

Go version is available: hurutoriya/go-ga-toppages

Motivation

Static Site Generator (SSG) is not support data aggregation feature but we want to provide this feature even if we use SSG!

Environment

This script assume

• Installed rye to manage Python environment
• Hugo style' SSG structure

Show top page result

This package use Google Analytics Data API v1. Please follow official docs to use this API.

API Quickstart  |  Google Analytics Data API  |  Google for Developers

Please replace GOOGLE_APPLICATION_CREDENTIALS and every options based on your expected result. Make sure you can modify Dimensions and Metrics based on your purpose.

> GOOGLE_APPLICATION_CREDENTIALS="xxx.json" rye run python src/ga_top_pages_py/main.py -property_id="12345" -site_content_path="../hurutoriya.github.io/content" -pages_root_url="https://shunyaueta.com" -top_n=15
## 直近一年間の人気記事 Top15

1. `3671` views: [Pythonで変数を挿入してSQLクエリを柔軟に構築する](https://shunyaueta.com/posts/2021-04-29/)
1. `1375` views: [Twitter の検索システム、Earilybirdの論文を読む](https://shunyaueta.com/posts/2023-04-29-0030/)
1. `1163` views: [Streamlit でアップロードしたファイルのパスを取得して、特定の処理をする](https://shunyaueta.com/posts/2021-07-08/)
1. `911` views: [タスク管理ツールを Todoist から TickTick へ試しに乗り換えてみた](https://shunyaueta.com/posts/2022-03-13/)
1. `892` views: [How to get the uploaded file path and processing its file in  Streamlit](https://shunyaueta.com/posts/2021-07-09/)
1. `891` views: [愛用しているツールを更新: Joplin→Obsidian & TickTick → Todoist](https://shunyaueta.com/posts/2022-06-03-2133/)
1. `647` views: [kubernetes デプロイ時に `MatchExpressions:[]v1.LabelSelectorRequirement(nil)}: field is immutable` エラーが出た際に対処方法](https://shunyaueta.com/posts/2021-12-02/)
1. `527` views: [Twitter の検索システムを学ぶ - 概要編](https://shunyaueta.com/posts/2023-04-17-2252/)
1. `526` views: [Elasticsearch 8.4 から利用可能な従来の検索機能と近似近傍探索を組み合わせたハイブリッド検索を試す](https://shunyaueta.com/posts/2022-10-29-2337/)
1. `508` views: [Jupyter Notebook上にTensorboard を わずか2行で表示させる](https://shunyaueta.com/posts/2019-09-25/)
1. `467` views: [Standard SQLで 列と列の組み合わせの数を集計したい](https://shunyaueta.com/posts/2021-02-09/)
1. `410` views: [Elasticsearchの近似近傍探索を使って、ドラえもんのひみつ道具検索エンジンを作ってみた](https://shunyaueta.com/posts/2022-10-23-2344/)
1. `393` views: [OSSのアノテーションツール Label Studio を使って、快適にアノテーションする](https://shunyaueta.com/posts/2022-01-09/)
1. `385` views: [社内でデータ分析結果を可視化・共有する際に Google Colab が便利](https://shunyaueta.com/posts/2022-05-10-2200/)
1. `379` views: [AOJの「ITP I」40問をPythonで解いた](https://shunyaueta.com/posts/2020-08-04/)

Example: Following result is how this script's result render in markdown.

直近一年間の人気記事 Top15

1. 3671 views: Python で変数を挿入して SQL クエリを柔軟に構築する
2. 1375 views: Twitter の検索システム、Earilybird の論文を読む
3. 1163 views: Streamlit でアップロードしたファイルのパスを取得して、特定の処理をする
4. 911 views: タスク管理ツールを Todoist から TickTick へ試しに乗り換えてみた
5. 892 views: How to get the uploaded file path and processing its file in Streamlit
6. 891 views: 愛用しているツールを更新: Joplin→Obsidian & TickTick → Todoist
7. 647 views: kubernetes デプロイ時に MatchExpressions:[]v1.LabelSelectorRequirement(nil)}: field is immutable エラーが出た際に対処方法
8. 527 views: Twitter の検索システムを学ぶ - 概要編
9. 526 views: Elasticsearch 8.4 から利用可能な従来の検索機能と近似近傍探索を組み合わせたハイブリッド検索を試す
10. 508 views: Jupyter Notebook 上に Tensorboard を わずか 2 行で表示させる
11. 467 views: Standard SQL で 列と列の組み合わせの数を集計したい
12. 410 views: Elasticsearch の近似近傍探索を使って、ドラえもんのひみつ道具検索エンジンを作ってみた
13. 393 views: OSS のアノテーションツール Label Studio を使って、快適にアノテーションする
14. 385 views: 社内でデータ分析結果を可視化・共有する際に Google Colab が便利
15. 379 views: AOJ の「ITP I」40 問を Python で解いた

Copy result to clip board

You can pipe the pbcopy

GOOGLE_APPLICATION_CREDENTIALS="xxx.json" rye run python src/ga_top_pages_py/main.py -property_id="12345" -site_content_path="../hurutoriya.github.io/content" -pages_root_url="https://shunyaueta.com" -top_n=15 | pbcopy

Wish list

• Support specific date range option
• Support HTML format option