README

此插件为 Winter CMS 添加 Google Analytics 跟踪和报告功能。

注意：此插件的 v3.x 系列仅支持 Google Analytics v4（GA4），因为 GA3 / UA 正在停用。如果您想使用此插件来使用 GA3 / UA，您必须回滚到此插件的 v2.0.2 版本。

配置

配置 API

要开始使用 Google Analytics API，您首先需要在 Google 开发者控制台中创建或选择一个项目并启用 API （点击此链接可指导您完成操作并自动激活 Google Analytics API）。

或者，您可以在开发者控制台中自行激活 Google Analytics API，操作如下

1. 打开 凭据页面。

2. 选择 概览 菜单项并启用 Analytics API。

在任何情况下，您都应该结束在 凭据 页面上，并可以从这里创建您项目的凭据。

创建客户端 ID

1. 打开开发者控制台 权限 页面的 服务帐户 部分。

2. 点击 创建服务帐户。

3. 在 创建服务帐户 窗口中，为服务帐户输入名称，例如：Winter CMS Analytics。

4. 勾选 提供新的私钥 并选择 JSON 作为 密钥类型。

5. 然后，点击 创建。

6. 将生成一个 .json 文件，这是您帐户的私钥。接受下载并将其保存到您的计算机。

7. 点击 关闭。

8. 您应该看到一个以 iam.gserviceaccount.com 结尾的电子邮件，如果不是，请选择 权限标签。将此地址复制到您的剪贴板。

配置 Google Analytics

1. 在新标签页中，导航到主要的 Google Analytics 网站 并选择您想要跟踪的属性。

2. 点击顶部的 管理 主菜单标签，然后选择 属性 > 用户管理 菜单项。

3. 将剪贴板中的电子邮件地址粘贴到 添加权限给 字段中，并确保权限设置为 读取与分析。点击 添加。

4. 再次点击 管理 主菜单标签，然后从菜单中选择 视图 > 视图设置。将 配置文件 ID（应为数字） 复制到您的剪贴板。

配置 Winter CMS 后端区域

1. 打开您的 Winter CMS 后端管理区域，并打开 设置 > Google Analytics。

2. 将剪贴板中的属性ID粘贴到 分析属性ID号码 字段。

3. 将之前下载的 .json 私钥文件上传到 私钥 字段。

4. 如果您要使用插件内置的跟踪组件，请指定 跟踪ID（例如 G-1234ABCDEF）和 域名 值。要查找此代码，请从 Google Analytics 菜单中选择 管理员 > 属性 > 属性设置。

5. 如果跟踪最初不起作用，请将 域名 字段的值设置为 auto。这是针对新建立的 Google Analytics 账户的修复方法。

添加跟踪代码

使用插件提供的跟踪代码是可选的 - 报告部分不依赖于您是否使用内置跟踪器或使用 Google Analytics 工具生成的自定义代码来跟踪流量。

要将插件的跟踪代码添加到您的网站，只需将 Google Analytics 跟踪组件拖放到您的 CMS 布局中，并在页面标签之后添加此代码到布局代码中。

{% page %}
{% component 'googleTracker' %}

故障排除

Windows / XAMPP 的修复

cURL 错误 60：SSL证书问题：无法获取本地颁发者证书

1. 点击此链接：http://curl.haxx.se/ca/cacert.pem 并将其保存为名为 cacert.pem 的文件。

2. 打开您的 php.ini 文件，插入或编辑以下行

   curl.cainfo = "[pathtothisfile]\cacert.pem"
   

3. 重启 Apache

尝试添加 JSON 密钥文件时，弹窗信息仅显示 "错误"。

一些广告拦截器（如 Chrome 的 uBlock Origin 扩展或 Firefox 自带的内置算法）可能会阻止上传 JSON 文件密钥。禁用这些拦截器或将 Winter CMS 网站列入白名单可能解决您的问题。