Laravel集成Spatie Google Analytics时报Undefined index: ga:bouncerate错误

错误原因 #

Spatie laravel-analytics 扩展的 performQuery 方法返回的是 Google Analytics 查询原始对象，不是直接带ga:bouncerate等键名的关联数组：

• 原始返回结果的实际数据存储在rows属性中，为纯索引数组，顺序和你传入的dimensions、metrics顺序一致
• 字段名存储在columnHeaders属性中，不会自动和rows的数值做关联映射

解决方法（推荐） #

在控制器中先格式化查询结果为关联数组，再传给Blade模板，修改后控制器代码如下：

//retrieve sessions and pageviews with yearMonth dimension since 1 year ago
$analyticsResult = Analytics::performQuery(
    Period::years(1),
    'ga:sessions',
    [
        'metrics' => 'ga:bouncerate',
        'dimensions' => 'ga:yearMonth'
    ]
);

// 将原始结果格式化为带ga:xxx键名的关联数组
$analyticsData_Query = collect($analyticsResult->rows)->map(function ($row) use ($analyticsResult) {
    $keys = collect($analyticsResult->columnHeaders)->pluck('name')->toArray();
    return array_combine($keys, $row);
});

return view('bosses.home',compact('analyticsData_Query'));

修改完成后你原有Blade模板的代码不需要调整，即可正常读取$w['ga:bouncerate']数值。

临时快速解决（不推荐） #

如果不想修改控制器代码，也可以直接在Blade中按索引读取数值，你查询的第一个维度是ga:yearMonth（索引0），第二个指标是ga:bouncerate（索引1），所以Blade代码可以改为：

@foreach ($analyticsData_Query->rows as $w)
    {{ number_format($w[1], 2) }}%    
@endforeach

该方法兼容性差，后续调整查询的维度、指标顺序后索引会发生变化，优先选择控制器格式化的方案。

补充说明 #

返回的跳出率为百分比数值的原始小数格式，例如数值58.2代表58.2%，可以使用number_format函数保留指定小数位后展示更规范。

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