多Google Analytics账户跨站点聚合报告及高层仪表盘制作技术求助

我之前刚好做过类似的跨多个Google Analytics账户的聚合仪表盘，用的就是PHP版的GA API，给你分享下实际的实现思路和代码示例，应该能帮你快速搭建起来：

核心思路 #

Google Analytics的Reporting API本身不支持直接跨账户/站点聚合数据，所以我们的核心思路是：

1. 先枚举所有你有权限访问的GA账户、站点（Web Property）和视图（View）
2. 逐个请求每个视图的目标指标数据
3. 在本地对这些数据进行聚合计算，最终生成高层汇总仪表盘

具体实现步骤 #

1. 完成授权认证 #

首先得确保你的PHP应用能访问所有目标GA账户的数据，常用的两种授权方式：

• 服务账号（Service Account）：适合服务器端自动运行的脚本，需要把服务账号的邮箱添加到每个GA账户的权限列表中（赋予「读取者」权限即可）
• OAuth 2.0授权：适合需要用户手动登录授权的场景，比如面向多用户的仪表盘

不管用哪种方式，都需要先在Google Cloud Console中创建项目、启用Analytics Reporting API和Analytics Management API，然后下载对应的密钥文件。

2. 枚举所有可访问的视图 #

用Management API遍历所有有权限的账户、站点和视图，过滤掉不需要的测试视图或无关视图：

• 先获取所有账户
• 再遍历每个账户下的所有站点（Web Property）
• 最后遍历每个站点下的所有视图（View），收集需要的视图ID和基本信息

3. 批量获取数据并本地聚合 #

对每个收集到的视图，调用Reporting API获取你需要的通用指标（比如会话数、用户数、页面浏览量等），然后在PHP代码中累加这些指标，或者按日期、站点维度分组聚合。

关键代码片段 #

初始化GA客户端 #

require __DIR__ . '/vendor/autoload.php';

// 初始化客户端（以服务账号为例）
$client = new Google\Client();
$client->setApplicationName('跨GA账户汇总仪表盘');
$client->setAuthConfig('your-service-account-key.json'); // 替换成你的密钥文件路径
$client->addScope(Google\Service\Analytics::ANALYTICS_READONLY);
$client->setAccessType('offline');

// 初始化Reporting API和Management API客户端
$reportingService = new Google\Service\AnalyticsReporting($client);
$managementService = new Google\Service\Analytics($client);

收集所有目标视图 #

$allViews = [];
// 获取所有账户
$accounts = $managementService->management_accounts->listManagementAccounts();

foreach ($accounts->getItems() as $account) {
    // 获取账户下的所有站点
    $webProperties = $managementService->management_webproperties->listManagementWebproperties($account->getId());
    
    foreach ($webProperties->getItems() as $webProperty) {
        // 获取站点下的所有视图
        $views = $managementService->management_profiles->listManagementProfiles($account->getId(), $webProperty->getId());
        
        foreach ($views->getItems() as $view) {
            // 过滤掉测试视图（根据你的实际情况调整规则）
            if (strpos($view->getName(), '测试') === false) {
                $allViews[] = [
                    'accountName' => $account->getName(),
                    'siteName' => $webProperty->getName(),
                    'viewId' => $view->getId(),
                    'viewName' => $view->getName()
                ];
            }
        }
    }
}

聚合各视图数据 #

// 定义要获取的指标和时间范围
$targetMetrics = ['ga:sessions', 'ga:users', 'ga:pageviews'];
$startDate = '7daysAgo';
$endDate = 'today';

// 初始化聚合结果
$aggregatedData = [
    'totalSessions' => 0,
    'totalUsers' => 0,
    'totalPageviews' => 0,
    'siteBreakdown' => [] // 按站点分组的明细数据
];

foreach ($allViews as $view) {
    // 构建报告请求
    $dateRange = new Google\Service\AnalyticsReporting\DateRange([
        'startDate' => $startDate,
        'endDate' => $endDate
    ]);
    
    $metrics = array_map(function($expr) {
        return new Google\Service\AnalyticsReporting\Metric(['expression' => $expr]);
    }, $targetMetrics);
    
    $reportRequest = new Google\Service\AnalyticsReporting\ReportRequest([
        'viewId' => $view['viewId'],
        'dateRanges' => [$dateRange],
        'metrics' => $metrics
    ]);
    
    $body = new Google\Service\AnalyticsReporting\GetReportsRequest([
        'reportRequests' => [$reportRequest]
    ]);
    
    try {
        // 发送请求并处理响应
        $response = $reportingService->reports->batchGet($body);
        $report = $response->getReports()[0];
        
        if ($report->getData()->getRows()) {
            $values = $report->getData()->getRows()[0]->getMetrics()[0]->getValues();
            
            // 累加总数据
            $aggregatedData['totalSessions'] += (int)$values[0];
            $aggregatedData['totalUsers'] += (int)$values[1];
            $aggregatedData['totalPageviews'] += (int)$values[2];
            
            // 记录站点明细
            $aggregatedData['siteBreakdown'][$view['siteName']] = [
                'sessions' => (int)$values[0],
                'users' => (int)$values[1],
                'pageviews' => (int)$values[2]
            ];
        }
    } catch (Exception $e) {
        // 处理请求错误，比如权限不足、视图不存在等
        error_log("获取视图 {$view['viewId']} 数据失败：" . $e->getMessage());
        continue;
    }
}

// 输出聚合结果
print_r($aggregatedData);

注意事项 #

• API配额限制：GA Reporting API有每日请求配额，批量请求（一次提交多个报告请求）可以有效节省配额，每个批量请求最多包含5个报告请求
• 权限问题：确保授权账号拥有所有目标GA账户的「读取者」权限，否则会返回403禁止访问错误
• 数据延迟：GA的标准报告数据通常有24-48小时的延迟，如果需要实时数据，可以使用Real-Time API，但实时API支持的指标有限
• 性能优化：如果视图数量很多，建议分批次处理或者使用异步请求，避免脚本超时；可以考虑缓存聚合结果，减少重复API调用
• 错误处理：一定要添加异常捕获，处理API请求失败、网络错误等情况，避免整个仪表盘崩溃

内容的提问来源于stack exchange，提问作者monde