一步一步连接 Google Analytics

本指南分为四个部分，只需做一次。请同时打开两个浏览器标签页：Kaam360 和 Google。

最终您将得到

两样需要粘贴到 Kaam360 的内容：

• 媒体资源编号：只有数字，例如 412345678。
• 密钥文件（JSON）：Google 允许您下载的一个文本文件。您需要粘贴它的全部内容。

第 1 部分：找到您的媒体资源编号

1. 打开 analytics.google.com 并登录。
2. 点击左下角的齿轮图标（管理）。
3. 在中间一列（媒体资源）中，点击媒体资源详情。如果您有多个媒体资源，请先在顶部选择正确的那个。
4. 在右上角您会看到媒体资源 ID，它是一串数字。请复制它。

第 2 部分：开启 Google Analytics Data API

1. 打开 console.cloud.google.com，并使用同一个 Google 账户登录。
2. 点击顶部的项目选择器，然后按新建项目。将其命名为“Kaam360 stats”，然后按创建。请确保该项目已被选中。
3. 在顶部的搜索框中输入 Google Analytics Data API，然后打开搜索结果。
4. 按启用，等待几秒钟。

第 3 部分：创建密钥文件

1. 在同一个 Google Cloud 页面中，打开菜单，然后依次选择 IAM 和管理、服务账号。
2. 按创建服务账号。将其命名为“kaam360-reader”。按创建并继续，然后按完成。您不需要选择任何角色。
3. 在列表中点击刚创建的服务账号。复制它的电子邮件地址。它看起来像这样：kaam360-reader@kaam360-stats.iam.gserviceaccount.com。
4. 打开密钥标签页。按添加密钥，然后选择创建新密钥，选择 JSON，再按创建。
5. 一个小文件会下载到您的电脑。请像对待密码一样妥善保管它。

第 4 部分：让服务账号查看您的数据

1. 回到 Google Analytics，点击齿轮图标（管理）。
2. 在媒体资源一列中选择媒体资源访问权限管理。
3. 按蓝色的 + 按钮，然后选择添加用户。
4. 粘贴您刚才复制的服务账号电子邮件地址。
5. 选择角色查看者。如果出现“通过电子邮件通知新用户”，请取消勾选。然后按添加。

第 5 部分：填入 Kaam360

1. 打开营销、网站流量，然后选择您的网站。
2. 在数据来自哪里？下选择 Google Analytics 4。
3. 把媒体资源编号粘贴到 Google Analytics 媒体资源编号中。
4. 用记事本（Windows）或文本编辑（Mac）打开下载的文件。全选并复制，然后粘贴到 Google 密钥文件（JSON）中。内容以 { 开头，以 } 结尾。
5. 按保存，然后按测试连接。
6. 出现绿色消息就表示完成了。数据会显示在“网站流量”页面上，并每 10 分钟刷新一次。

我需要修改我的网站吗？

不需要。如果您的网站已经有 Google Analytics 代码，请保持原样。Kaam360 直接从 Google 读取数据，所以不会向您的网站添加任何内容，也不需要 Kaam360 的计数器代码。

如果测试失败

• 出现“权限”或“403”消息：第 4 部分没有完成，或者您添加了错误的电子邮件。请检查服务账号电子邮件是否已在媒体资源访问权限管理中，且角色为“查看者”。更改可能需要几分钟才会生效。
• 出现“API has not been used”或“disabled”：第 2 部分没有在密钥所属的同一个 Google Cloud 项目中完成。请在该项目中启用 Google Analytics Data API。
• 出现“找不到媒体资源”：您粘贴了错误的编号。请使用媒体资源详情中的数字，而不是 G- 开头的代码。
• 出现“密钥文件无效”：您没有复制完整的文件。请从第一个 { 一直复制到最后一个 }。
• 出现“已连接……来自 0 位访客的 0 次页面浏览”：连接是正常的，但这个媒体资源编号对应的媒体资源并不是接收您网站访问的那一个。很多账户有不止一个媒体资源。请在 Google Analytics 中（左上角）选择显示您访问量的那个媒体资源，然后打开管理、媒体资源详情，复制它的媒体资源 ID。把它粘贴到 Kaam360，按保存，再次按测试连接。
• 数据为零：新的媒体资源需要一天时间来收集数据。请确认您的网站确实装有 Google Analytics 标记。

如何撤销

在 Google Cloud 中删除该服务账号，或者把它从媒体资源访问权限管理中移除。这样 Kaam360 就无法再读取任何数据了。