README

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

注意：此插件不支持通用分析。

重要：此插件需要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控制台并创建或选择您的项目。

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

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

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

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

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

• 返回Google Cloud控制台中的项目仪表板页面。
• 在侧边栏中点击启用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 仪表板小部件并预览流量统计，而无需离开 October CMS。

多站兼容性

如果每个站点都应该有自己的分析设置和小部件，请打开 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 许可证。