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

package/data.js

@@ -3813,6 +3813,12 @@ export const data = {
                 "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",
@@ -4341,6 +4347,49 @@ export const data = {
             }
         }
     },
+    "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.847",
+    "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

@@ -9,6 +9,7 @@ export type OverviewKPIService_GetEmailActivityDistribution = RpcMethod<GetEmail
 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>;
@@ -40,6 +41,8 @@ export interface OverviewKPIService {
     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. */
@@ -331,6 +334,31 @@ 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 */