PHP中调用Analytics Reporting API同时请求device与userGender维度返回空结果

• 先确认维度数据本身的有效性
  单独请求仅包含userGender维度的报表，验证该维度在当前查询的时间范围、筛选条件内是否真的无数据。如果该维度本身无任何数据，部分API会直接返回空，哪怕开启了空行参数。

• 补充启用指标空值展示参数
  很多报表API中，setIncludeEmptyRows仅控制维度空行，若指标值全为0也会被过滤。尝试同时调用setIncludeZeroMetrics(true)，确保指标为0的行也能被返回。

• 检查参数是否针对多维度生效
  部分API的空行参数需要按维度单独配置，而非全局设置。比如有些SDK会提供setBreakdownIncludeEmpty这类细分参数，针对每个维度开启空行展示，而非仅用全局的setIncludeEmptyRows。

• 拆分查询后手动合并结果
  如果API本身不支持多维度下保留单维度有效数据，直接分两次请求：一次仅查device维度，一次仅查userGender维度，再在PHP代码里合并两个结果集。示例代码：

  // 请求device维度报表
  $deviceReq = $reportApi->createRequest();
  $deviceReq->setDimensions(['device']);
  $deviceReq->setIncludeEmptyRows(true);
  $deviceResult = $reportApi->execute($deviceReq);
  
  // 请求userGender维度报表
  $genderReq = $reportApi->createRequest();
  $genderReq->setDimensions(['userGender']);
  $genderReq->setIncludeEmptyRows(true);
  $genderResult = $reportApi->execute($genderReq);
  
  // 合并结果行
  $finalRows = array_merge($deviceResult->getRows(), $genderResult->getRows());
  

• 排查SDK版本或参数拼写问题
  确认使用的PHP SDK是最新稳定版，旧版本可能存在多维度空行参数的处理bug。同时检查参数名是否符合API要求，比如部分API要求用下划线命名include_empty_rows而非驼峰式。

• 检查筛选条件是否冲突
  新增userGender维度后，确认是否误加了该维度的过滤规则（比如筛选userGender = 'female'但无对应数据），导致整个结果集为空。

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