README

此插件为 October CMS 添加 Google Analytics 4 跟踪和报告功能。此插件需要 October CMS 3.3 或更高版本。

注意：此插件不支持 Universal Analytics。

重要：此插件需要 bcmath PHP 扩展。这是 Google PHP API 所需的。

如果您正在使用 October CMS v1 或 v2，请使用以下命令安装插件的 v1.3 版本

composer require rainlab/googleanalytics-plugin "^1.3"

配置 Google Analytics 和 Google Cloud 账户

要使用此插件，您需要一个带有服务账户的 Google Cloud 项目，并且需要为该项目启用 Google Analytics 数据 API。首先，登录到 Google Cloud Console 并创建或选择您的项目。

在 Google Cloud 项目中创建服务账户

• 打开 凭证页面 并选择您的项目。
• 点击 创建凭证 按钮，并选择 服务账户。
• 输入服务账户的名称，例如 "October CMS GA"。输入服务账户的 ID，例如 "october-cms-ga"。
• 点击 完成。这将创建服务账户并将您重定向回账户列表。

为服务账户生成和下载私钥文件

• 在服务账户列表中点击您刚刚创建的账户。
• 在顶部菜单中点击 密钥。
• 点击 添加密钥 / 创建新密钥 并选择 JSON。这将下载 JSON 文件。您稍后需要此文件来配置插件。

插件需要为 Google Cloud 项目启用 Google Analytics 数据 API。这是获取分析数据并在 October CMS 仪表板上显示所必需的。要启用 API

• 返回到 Google Cloud Console 的项目仪表板页面。
• 在侧边栏中点击 启用 API 和服务。
• 在顶部菜单中点击 启用 API 和服务。
• 搜索 "Google Analytics 数据 API"。
• 点击找到的 API 并启用它。

您也可以使用 此链接，但请确保您为正确的项目启用 API。

接下来，您需要授予服务账户对您的 Google Analytics 账户的访问权限

• 在 Google Cloud 仪表板 中选择您的项目，点击侧边栏中的 API 和服务 和 凭证。
• 在服务账户列表中，复制您创建的服务账户的电子邮件。
• 前往Google Analytics并选择您要工作的GA4属性。
• 在左侧菜单中，点击管理。
• 在属性列中，点击属性访问管理。
• 点击添加+按钮并输入服务帐户的电子邮件地址。
• 为服务帐户选择查看者权限。
• 点击添加按钮保存更改。

配置插件

• 打开您的October CMS安装管理区域并转到设置 / Google Analytics。
• 将您之前下载的JSON文件上传到私有密钥字段。
• 要找到分析属性ID，请前往您的Google Analytics属性的管理页面并点击属性设置。从页面复制属性ID值并将其粘贴到插件设置页面上的相应字段。
• 要找到测量ID值，您首先需要在Google Analytics 4属性的管理页面上创建一个数据流。创建流后，在流列表中点击它并复制测量ID值。将其粘贴到插件设置页面上的相应字段。
• 保存设置。

安装Google Analytics跟踪代码

您可以使用Google Tag Manager来安装跟踪代码。以下是如何手动安装跟踪代码的解释。

• 将Google Analytics跟踪组件拖放到您的CMS布局中。
• 将以下代码添加到布局中，紧接在元素之后

{% component 'googleTracker' %}

安装跟踪代码后，您可以在不离开October CMS的情况下添加Google Analytics仪表板小部件并预览流量统计。

与多站点的兼容性

如果每个站点都应该有自己的分析设置和小部件，请打开config/multisite.php文件并启用以下设置。将值更改为true以为每个站点定义启用唯一配置。

'features' => [
    // ...
    'rainlab_googleanalytics_setting' => false,
]

故障排除

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文件密钥。禁用这些拦截器或将October CMS网站列入白名单可能解决您的问题。

许可证

此插件是October CMS平台的官方扩展，如果您拥有平台许可证，则可免费使用。有关更多详细信息，请参阅EULA许可证。