下面我以 **PHP 服务器后台通过 GA4 Data API 读取网站数据** 为目标，详细讲一下从 0 到 1 的配置流程。整个流程大约 **30~60 分钟**。
---
# 第一步：创建 GA4 账号并添加网站
## 1. 进入 Google Analytics
打开：
[Google Analytics 官网](https://analytics.google.com/?utm_source=chatgpt.com)
登录你的 Google 账号。
---
## 2. 创建账号
点击：
```
管理（Admin）
↓
创建（Create）
↓
账号（Account）
```
例如：
```
账号名称：
我的网站统计
```
---
## 3. 创建 Property（资源）
继续创建：
```
Property 名称：
example.com
```
选择：
* 时区：你的地区
* 货币：人民币/美元等
---
## 4. 创建数据流（Data Stream）
选择 Admin 》Property settings 》 Data collection and modification 》 Data Stream 》 Add stream：
```
平台：
Web
```
填写：
```
网站 URL：
https://example.com
流名称：
example 网站
```
创建后你会看到：
```
Measurement ID
G-XXXXXXXXXX
```
这个就是你的 GA4 跟踪 ID。
---
# 第二步：网站安装 GA4 Tracking Code
## 方式一：直接添加 JS（最简单）
在网站所有页面 `<head>` 里添加：
```html
<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){
dataLayer.push(arguments);
}
gtag('js', new Date());
gtag('config', 'G-XXXVIII');
</script>
```
把：
```
G-XXXXXXXXXX
```
换成你的 Measurement ID。
---
## 方式二：Google Tag Manager
如果你网站已经使用 GTM，可以在 GTM 中配置 GA4。
GTM：
[Google Tag Manager 官网](https://tagmanager.google.com/?utm_source=chatgpt.com)
---
# 第三步：验证数据是否正常
安装代码后：
打开网站。
然后回到：
```
Google Analytics
↓
报告
↓
实时
```
你应该能看到：
```
当前用户 1
国家
设备
访问页面
```
一般几秒到几分钟内出现。
---
# 第四步：创建 Google Cloud 项目
因为 GA4 API 是 Google Cloud 服务。
进入：
[Google Cloud Console](https://console.cloud.google.com/?utm_source=chatgpt.com)
自 2026年7月7日起，Google Cloud 开始强制执行两步验证 (2SV)，也称为多重身份验证 (MFA)。请前往安全设置，开启两步验证。
---
## 创建项目
顶部：
```
选择项目
↓
新建项目
```
例如：
```
项目名称：
my-ga4-api
```
点击：
```
创建
```
---
# 第五步：开启 Analytics Data API
进入：
```
API 和服务
↓
库
```
搜索：
```
Analytics Data API
```
或者直接打开：
[Analytics Data API 页面](https://console.cloud.google.com/apis/library/analyticsdata.googleapis.com?utm_source=chatgpt.com)
点击：
```
启用（Enable）
```
成功后：
```
API 和服务
↓
已启用 API
```
应该看到：
```
Google Analytics Data API
```
---
# 第六步：创建 Service Account（推荐 PHP 后台使用）
为什么推荐？
因为你的 PHP 程序是服务器自动运行，不需要用户登录。
---
进入：
```
API 和服务
↓
凭据
↓
创建凭据
↓
服务账号
```
或者：
[Service Account 页面](https://console.cloud.google.com/iam-admin/serviceaccounts?utm_source=chatgpt.com)
---
## 填写：
例如：
```
Service account name:
ga4-reader
Service account ID:
自动生成
```
点击：
```
创建并继续
```
角色：
可以先选择：
```
Viewer
```
继续完成。
---
# 第七步：生成 JSON Key
进入刚创建的 Service Account。
点击：
```
Keys
↓
Add Key
↓
Create New Key
```
选择：
```
JSON
```
下载：
```
xxx-123456.json
```
例如：
```
{
"type": "service_account",
"project_id": "my-ga4-api",
"private_key": "xxxxx",
"client_email":
"ga4-reader@my-ga4-api.iam.gserviceaccount.com"
}
```
⚠️ **这个文件非常重要，不要提交到 GitHub。**
建议放：
```
/var/www/your-project/storage/ga-key.json
```
权限：
```
600
```
---
# 第八步：把 Service Account 添加到 GA4 权限
这一步很多人会漏。
回到：
```
Google Analytics
↓
Admin
↓
Property Access Management
```
点击：
```
+
Add users
```
添加：
```
ga4-reader@my-ga4-api.iam.gserviceaccount.com
```
权限选择：
```
Viewer
```
保存。
---
# 第九步：找到 GA4 Property ID
注意：
不是：
```
G-XXXXXXXX
```
API 使用的是：
```
Property ID
```
查看位置：
```
Admin
↓
Property Settings
↓
Property ID
```
例如：
```
123456789
```
API 里写：
```php
properties/123456789
```
---
# 第十步：PHP 配置认证
## 方法一：环境变量（推荐）
Linux：
```bash
export GOOGLE_APPLICATION_CREDENTIALS=/var/www/project/storage/ga-key.json
```
永久生效：
```bash
nano ~/.bashrc
```
添加：
```bash
GOOGLE_APPLICATION_CREDENTIALS=/var/www/project/storage/ga-key.json
```
---
## 方法二：代码指定 Key
PHP：
```php
$client = new BetaAnalyticsDataClient([
'credentials' => '/var/www/project/storage/ga-key.json'
]);
```
---
# 第十一步：测试 API
安装：
```bash
composer require google/analytics-data
```
测试：
```php
$response = $client->runReport([
'property' => 'properties/123456789',
'metrics' => [
['name' => 'activeUsers']
],
'dateRanges' => [
[
'startDate' => '7daysAgo',
'endDate' => 'today'
]
]
]);
```
返回类似：
```
activeUsers: 3250
```
说明成功。
---
# 最终架构
你的 PHP 后台结构大概是：
```
用户访问网站
|
↓
GA4 JavaScript
|
↓
Google Analytics
|
↓
Analytics Data API
|
↓
PHP 后台
|
↓
MySQL（缓存统计）
|
↓
ECharts 数据面板
```
---
## 常见坑（非常重要）
| 问题 | 原因 |
|------------------------|------------------------------|
| 403 Permission denied | 没把 Service Account 加到 GA4 用户 |
| 404 Property not found | 用了 G-123456 而不是 Property ID |
| 数据为 0 | GA4 刚安装，还没有访问量 |
| 找不到 API | 没开启 Analytics Data API |
| PHP 报 credentials 错误 | JSON Key 路径不对 |
---
如果你的目标是**做一个类似 SimilarWeb / GA 后台的 PHP 统计系统**，建议下一步了解 **GA4 的常用 Metrics（指标）和 Dimensions（维度）组合**，比如如何查询：
* 今日/昨日访客
* 7天趋势图
* 流量来源 Top 10
* 国家分布
* 浏览器占比
* 设备占比
这些正好对应你截图里的 Overview、Traffic、Audience 模块。
浙公网安备 33010602011771号