@pushwoosh/rpc-gateway-statistics-api 1.3.841 → 1.3.843

package/data.js

@@ -1914,6 +1914,18 @@ export const data = {
             }
         }
     },
+    "pushwoosh.statistics.statistics.v1.MessageHistoryChannel": {
+        "type": "E",
+        "values": [
+            "MESSAGE_HISTORY_CHANNEL_UNSPECIFIED",
+            "MESSAGE_HISTORY_CHANNEL_PUSH",
+            "MESSAGE_HISTORY_CHANNEL_INBOX",
+            "MESSAGE_HISTORY_CHANNEL_EMAIL",
+            "MESSAGE_HISTORY_CHANNEL_SMS",
+            "MESSAGE_HISTORY_CHANNEL_WHATSAPP",
+            "MESSAGE_HISTORY_CHANNEL_FB_MESSENGER"
+        ]
+    },
     "pushwoosh.statistics.statistics.v1.GetMessageHistoryFilters": {
         "type": "I",
         "fields": {
@@ -1950,6 +1962,9 @@ export const data = {
             "messageCodes": {
                 "type": "string",
                 "array": true
+            },
+            "channel": {
+                "type": "pushwoosh.statistics.statistics.v1.MessageHistoryChannel"
             }
         }
     },
@@ -2000,6 +2015,20 @@ export const data = {
             }
         }
     },
+    "pushwoosh.statistics.statistics.v1.MessageHistoryInboxMetric": {
+        "type": "I",
+        "fields": {
+            "read": {
+                "type": "number"
+            },
+            "clicked": {
+                "type": "number"
+            },
+            "clickRate": {
+                "type": "number"
+            }
+        }
+    },
     "pushwoosh.statistics.statistics.v1.MessageHistoryItemMetric": {
         "type": "I",
         "fields": {
@@ -2014,6 +2043,9 @@ export const data = {
             },
             "errors": {
                 "type": "number"
+            },
+            "inbox": {
+                "type": "pushwoosh.statistics.statistics.v1.MessageHistoryInboxMetric"
             }
         }
     },
@@ -2080,6 +2112,12 @@ export const data = {
             },
             "smsPresetCode": {
                 "type": "string"
+            },
+            "inboxExpiresAt": {
+                "type": "string"
+            },
+            "channel": {
+                "type": "pushwoosh.statistics.statistics.v1.MessageHistoryChannel"
             }
         }
     },
@@ -3751,6 +3789,12 @@ export const data = {
                 "method": "post",
                 "path": "/api/v2/statistics/overview/getEmailRates"
             },
+            "GetEmailActivityDistribution": {
+                "request": "pushwoosh.statistics.statistics.v2.overviewkpi.GetEmailActivityDistributionRequest",
+                "response": "pushwoosh.statistics.statistics.v2.overviewkpi.GetEmailActivityDistributionResponse",
+                "method": "post",
+                "path": "/api/v2/statistics/overview/getEmailActivityDistribution"
+            },
             "GetRetentionCurve": {
                 "request": "pushwoosh.statistics.statistics.v2.overviewkpi.GetRetentionCurveRequest",
                 "response": "pushwoosh.statistics.statistics.v2.overviewkpi.GetRetentionCurveResponse",
@@ -4096,6 +4140,49 @@ export const data = {
             }
         }
     },
+    "pushwoosh.statistics.statistics.v2.overviewkpi.GetEmailActivityDistributionRequest": {
+        "type": "I",
+        "fields": {
+            "applicationCode": {
+                "type": "string"
+            },
+            "dayFrom": {
+                "type": "Date"
+            },
+            "dayTo": {
+                "type": "Date"
+            }
+        }
+    },
+    "pushwoosh.statistics.statistics.v2.overviewkpi.GetEmailActivityDistributionResponse": {
+        "type": "I",
+        "fields": {
+            "base": {
+                "type": "number"
+            },
+            "baseDay": {
+                "type": "Date"
+            },
+            "clicked": {
+                "type": "number"
+            },
+            "openedNotClicked": {
+                "type": "number"
+            },
+            "dormant": {
+                "type": "number"
+            },
+            "clickedPercent": {
+                "type": "number"
+            },
+            "openedNotClickedPercent": {
+                "type": "number"
+            },
+            "dormantPercent": {
+                "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.841",
+    "version": "1.3.843",
     "description": "Statistics API gateway HTTP API Types and Data",
     "main": "index.js",
     "module": "index.js",

package/pushwoosh_statistics_statistics_v1.d.ts

@@ -804,6 +804,11 @@ export type MessageHistoryOrderBy = {
     by: MessageHistoryOrderColumn;
     order: OrderType;
 };
+/**
+ * MessageHistoryChannel is one tab of the one-time messages listing: a message belongs to
+ * exactly one channel, told apart by its source and platforms
+ */
+export type MessageHistoryChannel = 'MESSAGE_HISTORY_CHANNEL_UNSPECIFIED' | 'MESSAGE_HISTORY_CHANNEL_PUSH' | 'MESSAGE_HISTORY_CHANNEL_INBOX' | 'MESSAGE_HISTORY_CHANNEL_EMAIL' | 'MESSAGE_HISTORY_CHANNEL_SMS' | 'MESSAGE_HISTORY_CHANNEL_WHATSAPP' | 'MESSAGE_HISTORY_CHANNEL_FB_MESSENGER';
 export type GetMessageHistoryFilters = {
     statuses: MessageStatus[];
     platforms: number[];
@@ -814,6 +819,7 @@ export type GetMessageHistoryFilters = {
     campaigns: string[];
     messageIds: number[];
     messageCodes: string[];
+    channel: MessageHistoryChannel;
 };
 export type GetMessageHistoryRequest_MessageType = 'UNKNOWN' | 'MARKETING' | 'TRANSACTIONAL';
 export type GetMessageHistoryRequest = {
@@ -829,11 +835,23 @@ export type GetMessageHistoryRequest = {
     messageType: GetMessageHistoryRequest_MessageType;
     checkForMessages: boolean;
 };
+/**
+ * MessageHistoryInboxMetric counts an App Inbox message's entries by what their users did
+ * with them; users, not devices, one per entry over its whole lifetime
+ */
+export type MessageHistoryInboxMetric = {
+    read: number;
+    clicked: number;
+    /** clicked / recipients, percent */
+    clickRate: number;
+};
 export type MessageHistoryItemMetric = {
     recipients: number;
     opened: number;
     ctr: number;
     errors: number;
+    /** App Inbox messages only */
+    inbox: MessageHistoryInboxMetric;
 };
 export type MessageHistoryItem = {
     messageId: number;
@@ -857,6 +875,9 @@ export type MessageHistoryItem = {
     viberTemplateId: string;
     whatsappContentId: string;
     smsPresetCode: string;
+    /** App Inbox messages only; when the entries leave the inboxes */
+    inboxExpiresAt: string;
+    channel: MessageHistoryChannel;
 };
 export type GetMessageHistoryResponse = {
     total: number;

package/pushwoosh_statistics_statistics_v2_overviewkpi.d.ts

@@ -5,6 +5,7 @@ export type OverviewKPIService_GetReachByPlatform = RpcMethod<GetReachByPlatform
 export type OverviewKPIService_GetActiveTrend = RpcMethod<GetActiveTrendRequest, GetActiveTrendResponse>;
 export type OverviewKPIService_GetChannelUsersTrend = RpcMethod<GetChannelUsersTrendRequest, GetChannelUsersTrendResponse>;
 export type OverviewKPIService_GetEmailRates = RpcMethod<GetEmailRatesRequest, GetEmailRatesResponse>;
+export type OverviewKPIService_GetEmailActivityDistribution = RpcMethod<GetEmailActivityDistributionRequest, GetEmailActivityDistributionResponse>;
 export type OverviewKPIService_GetRetentionCurve = RpcMethod<GetRetentionCurveRequest, GetRetentionCurveResponse>;
 export type OverviewKPIService_GetBaseChange = RpcMethod<GetBaseChangeRequest, GetBaseChangeResponse>;
 export type OverviewKPIService_GetUserMessageMetrics = RpcMethod<GetUserMessageMetricsRequest, GetUserMessageMetricsResponse>;
@@ -28,6 +29,8 @@ export interface OverviewKPIService {
      * sending pause counts them, plus the account-wide check that pause runs on.
      */
     GetEmailRates: OverviewKPIService_GetEmailRates;
+    /** GetEmailActivityDistribution splits the email base into clicked, opened and dormant users. */
+    GetEmailActivityDistribution: OverviewKPIService_GetEmailActivityDistribution;
     /** GetRetentionCurve returns the D1/D7/D30 curve of one cohort. */
     GetRetentionCurve: OverviewKPIService_GetRetentionCurve;
     /** GetBaseChange returns how the push device base moved over a period. */
@@ -218,6 +221,27 @@ export type GetEmailRatesResponse = {
      */
     pauseCheck: EmailPauseCheck;
 };
+export type GetEmailActivityDistributionRequest = {
+    applicationCode: string;
+    dayFrom: Date;
+    dayTo: Date;
+};
+export type GetEmailActivityDistributionResponse = {
+    /** users of the base, taken from the last snapshot day the writer has filled */
+    base: number;
+    baseDay: Date;
+    /** a click writes an open of its own, so the two groups below never overlap */
+    clicked: number;
+    openedNotClicked: number;
+    /**
+     * the base less the two above, floored at zero: the base is a snapshot while
+     * the activity is a period, so a churned user can outlive their own row
+     */
+    dormant: number;
+    clickedPercent: number;
+    openedNotClickedPercent: number;
+    dormantPercent: number;
+};
 export type GetRetentionCurveRequest = {
     applicationCode: string;
     /** day the cohort registered on */