@pushwoosh/rpc-gateway-statistics-api 1.3.846 → 1.3.848

package/data.js

@@ -3807,6 +3807,18 @@ export const data = {
                 "method": "post",
                 "path": "/api/v2/statistics/overview/getEmailPerformance"
             },
+            "GetEmailCategoryStats": {
+                "request": "pushwoosh.statistics.statistics.v2.overviewkpi.GetEmailCategoryStatsRequest",
+                "response": "pushwoosh.statistics.statistics.v2.overviewkpi.GetEmailCategoryStatsResponse",
+                "method": "post",
+                "path": "/api/v2/statistics/overview/getEmailCategoryStats"
+            },
+            "GetEmailSendFrequency": {
+                "request": "pushwoosh.statistics.statistics.v2.overviewkpi.GetEmailSendFrequencyRequest",
+                "response": "pushwoosh.statistics.statistics.v2.overviewkpi.GetEmailSendFrequencyResponse",
+                "method": "post",
+                "path": "/api/v2/statistics/overview/getEmailSendFrequency"
+            },
             "GetRetentionCurve": {
                 "request": "pushwoosh.statistics.statistics.v2.overviewkpi.GetRetentionCurveRequest",
                 "response": "pushwoosh.statistics.statistics.v2.overviewkpi.GetRetentionCurveResponse",
@@ -4283,6 +4295,101 @@ export const data = {
             }
         }
     },
+    "pushwoosh.statistics.statistics.v2.overviewkpi.GetEmailCategoryStatsRequest": {
+        "type": "I",
+        "fields": {
+            "applicationCode": {
+                "type": "string"
+            },
+            "dayFrom": {
+                "type": "Date"
+            },
+            "dayTo": {
+                "type": "Date"
+            }
+        }
+    },
+    "pushwoosh.statistics.statistics.v2.overviewkpi.EmailCategoryStats": {
+        "type": "I",
+        "fields": {
+            "categoryCode": {
+                "type": "string"
+            },
+            "categoryName": {
+                "type": "string"
+            },
+            "sends": {
+                "type": "number"
+            },
+            "recipients": {
+                "type": "number"
+            },
+            "opens": {
+                "type": "number"
+            },
+            "clicks": {
+                "type": "number"
+            },
+            "unsubscribers": {
+                "type": "number"
+            },
+            "cohortUnsubscribers": {
+                "type": "number"
+            }
+        }
+    },
+    "pushwoosh.statistics.statistics.v2.overviewkpi.GetEmailCategoryStatsResponse": {
+        "type": "I",
+        "fields": {
+            "rows": {
+                "type": "pushwoosh.statistics.statistics.v2.overviewkpi.EmailCategoryStats",
+                "array": true
+            }
+        }
+    },
+    "pushwoosh.statistics.statistics.v2.overviewkpi.GetEmailSendFrequencyRequest": {
+        "type": "I",
+        "fields": {
+            "applicationCode": {
+                "type": "string"
+            },
+            "dayFrom": {
+                "type": "Date"
+            },
+            "dayTo": {
+                "type": "Date"
+            }
+        }
+    },
+    "pushwoosh.statistics.statistics.v2.overviewkpi.EmailSendFrequencyBucket": {
+        "type": "I",
+        "fields": {
+            "from": {
+                "type": "number"
+            },
+            "to": {
+                "type": "number"
+            },
+            "users": {
+                "type": "number"
+            },
+            "unsubscribed": {
+                "type": "number"
+            }
+        }
+    },
+    "pushwoosh.statistics.statistics.v2.overviewkpi.GetEmailSendFrequencyResponse": {
+        "type": "I",
+        "fields": {
+            "buckets": {
+                "type": "pushwoosh.statistics.statistics.v2.overviewkpi.EmailSendFrequencyBucket",
+                "array": true
+            },
+            "unsubscribedWithoutSends": {
+                "type": "number"
+            }
+        }
+    },
     "pushwoosh.statistics.statistics.v2.overviewkpi.GetRetentionCurveRequest": {
         "type": "I",
         "fields": {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@pushwoosh/rpc-gateway-statistics-api",
-    "version": "1.3.846",
+    "version": "1.3.848",
     "description": "Statistics API gateway HTTP API Types and Data",
     "main": "index.js",
     "module": "index.js",

package/pushwoosh_statistics_statistics_v2_overviewkpi.d.ts

@@ -8,6 +8,8 @@ export type OverviewKPIService_GetEmailRates = RpcMethod<GetEmailRatesRequest, G
 export type OverviewKPIService_GetEmailActivityDistribution = RpcMethod<GetEmailActivityDistributionRequest, GetEmailActivityDistributionResponse>;
 export type OverviewKPIService_GetEmailBaseChange = RpcMethod<GetEmailBaseChangeRequest, GetEmailBaseChangeResponse>;
 export type OverviewKPIService_GetEmailPerformance = RpcMethod<GetEmailPerformanceRequest, GetEmailPerformanceResponse>;
+export type OverviewKPIService_GetEmailCategoryStats = RpcMethod<GetEmailCategoryStatsRequest, GetEmailCategoryStatsResponse>;
+export type OverviewKPIService_GetEmailSendFrequency = RpcMethod<GetEmailSendFrequencyRequest, GetEmailSendFrequencyResponse>;
 export type OverviewKPIService_GetRetentionCurve = RpcMethod<GetRetentionCurveRequest, GetRetentionCurveResponse>;
 export type OverviewKPIService_GetBaseChange = RpcMethod<GetBaseChangeRequest, GetBaseChangeResponse>;
 export type OverviewKPIService_GetUserMessageMetrics = RpcMethod<GetUserMessageMetricsRequest, GetUserMessageMetricsResponse>;
@@ -37,6 +39,10 @@ export interface OverviewKPIService {
     GetEmailBaseChange: OverviewKPIService_GetEmailBaseChange;
     /** GetEmailPerformance returns the sends, deliveries, opens and clicks of the period. */
     GetEmailPerformance: OverviewKPIService_GetEmailPerformance;
+    /** GetEmailCategoryStats returns the per-category email numbers of the period. */
+    GetEmailCategoryStats: OverviewKPIService_GetEmailCategoryStats;
+    /** GetEmailSendFrequency splits the users of the period by how many letters they got. */
+    GetEmailSendFrequency: OverviewKPIService_GetEmailSendFrequency;
     /** GetRetentionCurve returns the D1/D7/D30 curve of one cohort. */
     GetRetentionCurve: OverviewKPIService_GetRetentionCurve;
     /** GetBaseChange returns how the push device base moved over a period. */
@@ -297,6 +303,62 @@ export type GetEmailPerformanceResponse = {
     bySends: EmailPerformanceCounts;
     byUsers: EmailPerformanceCounts;
 };
+export type GetEmailCategoryStatsRequest = {
+    applicationCode: string;
+    dayFrom: Date;
+    dayTo: Date;
+};
+/**
+ * EmailCategoryStats is one row of the table. An empty code is the letters that
+ * neither their message nor their journey point names.
+ */
+export type EmailCategoryStats = {
+    categoryCode: string;
+    categoryName: string;
+    /** letters, not recipients */
+    sends: number;
+    recipients: number;
+    /** users who opened; Apple MPP prefetches are left out where the log marks them */
+    opens: number;
+    /** users who clicked; our own unsubscribe link belongs to the unsubscribe event */
+    clicks: number;
+    /** everyone who unsubscribed inside the period, whatever letter caused it */
+    unsubscribers: number;
+    /**
+     * of them, those whose letter was sent inside the period too: the only
+     * numerator that cannot exceed the sends it is divided by
+     */
+    cohortUnsubscribers: number;
+};
+export type GetEmailCategoryStatsResponse = {
+    /** one row per category of the application, zero rows and the unnamed row included */
+    rows: EmailCategoryStats[];
+};
+export type GetEmailSendFrequencyRequest = {
+    applicationCode: string;
+    dayFrom: Date;
+    dayTo: Date;
+};
+/** EmailSendFrequencyBucket holds the users who got between from and to letters. */
+export type EmailSendFrequencyBucket = {
+    from: number;
+    /** zero on the last bucket, which is open ended */
+    to: number;
+    users: number;
+    unsubscribed: number;
+};
+export type GetEmailSendFrequencyResponse = {
+    /**
+     * the edges scale with the period, so a wide window does not pile everyone
+     * into the open ended bucket
+     */
+    buckets: EmailSendFrequencyBucket[];
+    /**
+     * users who unsubscribed without a letter inside the period; no bucket holds
+     * them, because the axis is the letter count they do not have
+     */
+    unsubscribedWithoutSends: number;
+};
 export type GetRetentionCurveRequest = {
     applicationCode: string;
     /** day the cohort registered on */