Unique users

src/main/java/com/wechi/adweb/bridge/google/analytics/GADataService.java

@@ -170,6 +170,7 @@ public class GADataService {
                     SourceMediaViewData.toReport(reportRows, metrics, dimensions);
             case ADWEB_PAGE_PATH_VIEW -> PagePathViewData.toReport(reportRows, metrics, dimensions);
             case PAGE_VIEWS -> PageViewsData.toReport(reportRows, metrics, dimensions);
+            case UNIQUE_USERS -> UniqueUsersData.toReport(reportRows, metrics, dimensions);
         };
     }
 }

src/main/java/com/wechi/adweb/bridge/google/analytics/dto/report/ReportType.java

@@ -36,6 +36,12 @@ public enum ReportType {
             List.of(DIMENSION_DATE),
             DIMENSION_DATE,
             DIMENSIONS,
+            false),
+    UNIQUE_USERS(
+            List.of(METRIC_TOTAL_USERS),
+            List.of(DIMENSION_DATE),
+            DIMENSION_DATE,
+            DIMENSIONS,
             false);
 
     ReportType(List<String> defaultMetrics, List<String> defaultDimensions) {

src/main/java/com/wechi/adweb/bridge/google/analytics/dto/report/data/PageViewsData.java

@@ -3,11 +3,11 @@ package com.wechi.adweb.bridge.google.analytics.dto.report.data;
 import static com.wechi.adweb.bridge.google.analytics.dto.report.ReportConstant.*;
 
 import com.google.analytics.data.v1beta.Row;
+import com.wechi.adweb.bridge.util.DateUtils;
 
 import lombok.Builder;
 import lombok.Data;
 
-import java.time.LocalDate;
 import java.time.format.DateTimeFormatter;
 import java.util.List;
 
@@ -36,11 +36,11 @@ public class PageViewsData implements GAReportDataDTO {
                         row ->
                                 PageViewsData.builder()
                                         .date(
-                                                LocalDate.parse(
-                                                                row.getDimensionValues(indexDate)
-                                                                        .getValue(),
-                                                                DateTimeFormatter.BASIC_ISO_DATE)
-                                                        .format(DateTimeFormatter.ISO_LOCAL_DATE))
+                                                DateUtils.format(
+                                                        row.getDimensionValues(indexDate)
+                                                                .getValue(),
+                                                        DateTimeFormatter.BASIC_ISO_DATE,
+                                                        DateTimeFormatter.ISO_LOCAL_DATE))
                                         .pageViews(
                                                 Integer.parseInt(
                                                         row.getMetricValues(indexPageViews)

src/main/java/com/wechi/adweb/bridge/google/analytics/dto/report/data/UniqueUsersData.java

@@ -0,0 +1,50 @@
+package com.wechi.adweb.bridge.google.analytics.dto.report.data;
+
+import static com.wechi.adweb.bridge.google.analytics.dto.report.ReportConstant.*;
+
+import com.google.analytics.data.v1beta.Row;
+import com.wechi.adweb.bridge.util.DateUtils;
+
+import lombok.Builder;
+import lombok.Data;
+
+import java.time.format.DateTimeFormatter;
+import java.util.List;
+
+/**
+ * @author wfansh
+ */
+@Data
+@Builder
+public class UniqueUsersData implements GAReportDataDTO {
+    /**
+     * Formatted as {@link DateTimeFormatter#ISO_LOCAL_DATE}, originated from {@link
+     * DateTimeFormatter#BASIC_ISO_DATE}
+     */
+    private String date;
+
+    private int totalUsers;
+
+    public static List<UniqueUsersData> toReport(
+            List<Row> reportRows, List<String> metrics, List<String> dimensions) {
+        int indexDate = dimensions.indexOf(DIMENSION_DATE);
+        int indexTotalUsers = metrics.indexOf(METRIC_TOTAL_USERS);
+
+        return reportRows.stream()
+                .map(
+                        row ->
+                                UniqueUsersData.builder()
+                                        .date(
+                                                DateUtils.format(
+                                                        row.getDimensionValues(indexDate)
+                                                                .getValue(),
+                                                        DateTimeFormatter.BASIC_ISO_DATE,
+                                                        DateTimeFormatter.ISO_LOCAL_DATE))
+                                        .totalUsers(
+                                                Integer.parseInt(
+                                                        row.getMetricValues(indexTotalUsers)
+                                                                .getValue()))
+                                        .build())
+                .toList();
+    }
+}

src/main/java/com/wechi/adweb/bridge/util/DateUtils.java

@@ -0,0 +1,20 @@
+package com.wechi.adweb.bridge.util;
+
+import java.time.LocalDate;
+import java.time.format.DateTimeFormatter;
+
+/**
+ * @author wfansh
+ */
+public class DateUtils {
+
+    public static String format(LocalDate date, DateTimeFormatter targetFormat) {
+        return date.format(targetFormat);
+    }
+
+    public static String format(
+            String dateStr, DateTimeFormatter sourceFormat, DateTimeFormatter targetFormat) {
+        LocalDate date = LocalDate.parse(dateStr, sourceFormat);
+        return date.format(targetFormat);
+    }
+}

src/test/java/com/wechi/adweb/bridge/google/analytics/GAServiceTests.java

@@ -54,5 +54,13 @@ public class GAServiceTests {
         reportRequest.setStartDate(startDate);
         reportRequest.setEndDate(endDate);
         System.out.println(gson.toJson(gaDataService.runReport(reportRequest)));
+
+        // 5. Unique users.
+        reportRequest = new GAReportRequestDTO();
+        reportRequest.setPropertyName(propertyName);
+        reportRequest.setReportType(ReportType.UNIQUE_USERS);
+        reportRequest.setStartDate(startDate);
+        reportRequest.setEndDate(endDate);
+        System.out.println(gson.toJson(gaDataService.runReport(reportRequest)));
     }
 }