pelican-ga-pageview

Google分析页面浏览插件，用于与nice博客主题兼容

页面浏览使用Google分析

如果您使用Google分析跟踪您的网站页面浏览量，此插件可以从您的Google分析配置文件中提取页面浏览信息，并将一个page_view属性添加到Pelican站点的每个文章和页面。在此处查看实时示例。

http://jwkennington.com

要求和设置

首先，遵循此处 说明 <https://developers.google.com/analytics/devguides/reporting/core/v3/quickstart/service-py>__ 来设置Google API服务帐户。

然后在Google分析中，将您上面创建的电子邮件地址添加为用户，以便我们可以访问Google分析API。

此时，您应该有

• Google API服务电子邮件： <prioject_id>-<unique_id>@developer.gserviceaccount.com
• Google私钥文件： client_private.p12。请将其保存在安全的地方。如果您将此文件放入Git存储库，请务必将其添加到.gitignore。

最后，安装Google API Python库

pip install --upgrade google-api-python-client

设置

您需要在此插件的Pelican配置文件中提供以下信息，以便与Google分析API进行通信。

• GOOGLE_SERVICE_ACCOUNT：服务电子邮件。
• GOOGLE_KEY_FILE：私钥文件的路径，例如./client_private.p12。
• GA_START_DATE：计算页面浏览的起始日期。例如，2005-01-01。
• GA_END_DATE：计算页面浏览的结束日期。例如，今天。
• GA_METRIC：计数指标，默认为ga:pageviews。查看其他选项 这里 <https://developers.google.com/analytics/devguides/reporting/core/dimsmets>__。目前我们仅支持查询一个指标。
• POPULAR_POST_START：计算热门页面浏览的起始日期。例如，一个月前。

安装此插件后，每个 article 和 page 对象都有两个额外的属性

• pageview：在 GA_START_DATE 和 GA_END_DATE 之间页面的总浏览量。
• popular_pageview：在 POPULAR_POST_START 和 GA_END_DATE 之间的总浏览量。

还有一个名为 total_page_view 的全局上下文，它是整个站点的总浏览量。

注意

如果在构建过程中遇到此错误

NotImplementedError: PKCS12 format is not supported by the PyCrypto library.

尝试将 p12 文件转换为 pem 文件

openssl pkcs12 -in client_private.p12 -nodes -nocerts > client_private.pem

密码应该是 notasecret。

然后设置 GOOGLE_KEY_FILE 为刚刚生成的 pem 文件。

资源

• Google Analytics 核心报告 API <https://developers.google.com/analytics/devguides/reporting/core/v3/reference>_
• Google Analytics 查询探索器 <https://ga-dev-tools.appspot.com/query-explorer/>_

归属

此插件基于 ga_pageview 插件