PHP调用Google Analytics API获取特定URL的页面浏览量/会话数问题

看起来你在GA界面里已经通过细分看到了目标页面的会话和页面浏览数据，但API调用没拿到会话数，大概率是请求里的配置和界面的细分规则没对齐，我来帮你梳理几个关键点：

可能的问题点及解决方法 #

1. 未在API请求中添加会话指标 #

你提到界面里有17次会话，但如果你的API代码只请求了ga:pageviews指标，那自然不会返回会话数据。一定要确保指标数组里包含ga:sessions。

2. 未正确应用页面过滤规则 #

界面里的细分是针对123456.html这个页面的，API请求里需要添加对应的维度过滤，或者直接复用你在GA里创建的细分ID。

3. 视图ID/日期范围错误 #

再核对下代码里的$VIEW_ID是否和你在GA界面查看的视图一致，日期格式是不是严格的YYYY-MM-DD，有没有拼写错误。

修正后的代码示例 #

下面是调整后的完整代码，包含了会话指标、页面过滤，和界面的细分规则对齐：

function getReport($analytics) {
    // 替换为你的视图ID
    $VIEW_ID = "XXX";
    $_date = "2018-03-01";
    $_end = "2018-03-29";

    // 创建日期范围对象
    $dateRange = new Google_Service_AnalyticsReporting_DateRange();
    $dateRange->setStartDate($_date);
    $dateRange->setEndDate($_end);

    // 定义需要获取的指标：会话数 + 页面浏览量
    $sessionsMetric = new Google_Service_AnalyticsReporting_Metric();
    $sessionsMetric->setExpression("ga:sessions");
    $sessionsMetric->setAlias("会话数");

    $pageviewsMetric = new Google_Service_AnalyticsReporting_Metric();
    $pageviewsMetric->setExpression("ga:pageviews");
    $pageviewsMetric->setAlias("页面浏览量");

    // 定义维度：页面路径，用于过滤目标页面
    $pagePathDim = new Google_Service_AnalyticsReporting_Dimension();
    $pagePathDim->setName("ga:pagePath");

    // 创建页面过滤规则：精确匹配123456.html
    $filterClause = new Google_Service_AnalyticsReporting_DimensionFilterClause();
    $pageFilter = new Google_Service_AnalyticsReporting_DimensionFilter();
    $pageFilter->setDimensionName("ga:pagePath");
    $pageFilter->setOperator("EXACT");
    $pageFilter->setExpressions(["123456.html"]);
    $filterClause->setFilters([$pageFilter]);

    // 构建报表请求
    $reportRequest = new Google_Service_AnalyticsReporting_ReportRequest();
    $reportRequest->setViewId($VIEW_ID);
    $reportRequest->setDateRanges([$dateRange]);
    $reportRequest->setMetrics([$sessionsMetric, $pageviewsMetric]);
    $reportRequest->setDimensions([$pagePathDim]);
    $reportRequest->setDimensionFilterClauses([$filterClause]);

    // 发送请求并返回结果
    $requestBody = new Google_Service_AnalyticsReporting_GetReportsRequest();
    $requestBody->setReportRequests([$reportRequest]);

    return $analytics->reports->batchGet($requestBody);
}

复用GA自定义细分的方法 #

如果你不想手动写过滤规则，也可以直接用你在GA界面创建的细分ID（在细分详情页能找到，格式类似gaid::XXXXXX），只需要在请求里添加Segment参数：

// 添加到报表请求前
$customSegment = new Google_Service_AnalyticsReporting_Segment();
$customSegment->setSegmentId("gaid::你的细分ID");
$reportRequest->setSegments([$customSegment]);

这样就能完全复用你在界面里配置的细分逻辑，避免手动过滤出错。

最后再确认下你的服务账号有没有该GA视图的访问权限，权限不足也会导致返回空数据哦～

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