如何在 java 中使用 Google Analytics Data API (GA4) 以獲取 screenPageViews 計數時擴展獲取值？

Question

感謝您對我的提問的關注。 當我使用下面的 java 代碼從谷歌分析獲取信息時，它只顯示 10 個頁面值...實際上，我網站上的總頁面是 37 頁，我想從 ga4 獲取總值。 我剛開始學習編程 2 個月前。 請幫我解決它。

    private void testUpdateGoogleAnalyticsApi() {
        String ga4PropertyId = Container.config.getGa4PropertyId();
        try (AlphaAnalyticsDataClient analyticsData = AlphaAnalyticsDataClient.create()) {
            RunReportRequest request = RunReportRequest.newBuilder()
                    .setEntity(Entity.newBuilder().setPropertyId(ga4PropertyId))
                    .addDimensions(Dimension.newBuilder().setName("pagePath"))
                    .addMetrics(Metric.newBuilder().setName("screenPageViews"))
                    .addDateRanges(DateRange.newBuilder().setStartDate("2020-12-01").setEndDate("today")).build();

            // Make the request
            RunReportResponse response = analyticsData.runReport(request);
            
            System.out.println("Report result:");
            for (Row row : response.getRowsList()) {
                System.out.printf("%s, %s%n", row.getDimensionValues(0).getValue(), row.getMetricValues(0).getValue());
            }
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

Answer 1

如果未指定 RunReportRequest 中的 limit 參數，則 RunReportResponse 將僅包含 10 行。 對於此報告，這意味着即使您的網站存在大量頁面 (37)，您也只會在 API 報告中看到 10 個頁面路徑。

解決方案是在 RunReportRequest 的 Builder 上使用“setLimit”方法。 例如，請將請求的構建器更新為以下內容以返回最多 10,000 行。

RunReportRequest request = RunReportRequest.newBuilder()
 .setEntity(Entity.newBuilder().setPropertyId(ga4PropertyId))
 .addDimensions(Dimension.newBuilder().setName("pagePath"))
 .addMetrics(Metric.newBuilder().setName("screenPageViews"))
 .addDateRanges(DateRange.newBuilder().setStartDate("2020-12-01").setEndDate("today"))
 .setLimit(10000L).build();

這里有關於這個 API 的分頁機制的文檔。 分頁指定您希望在響應中看到多少行。 在這種情況下，來自您網站的頁面數。

setLimit 方法控制報告響應中的行數，並記錄在github上。