@pushwoosh/rpc-gateway-statistics-api 1.3.765 → 1.3.767

package/data.js

@@ -213,12 +213,6 @@ export const data = {
                 "method": "post",
                 "path": "/api/v2/statistics/audience/getEmailEventTriggeredPerformance"
             },
-            "GetEmailCategoryPerformanceCP": {
-                "request": "pushwoosh.statistics.statistics.v1.GetEmailCategoryPerformanceCPRequest",
-                "response": "pushwoosh.statistics.statistics.v1.GetEmailCategoryPerformanceCPResponse",
-                "method": "post",
-                "path": "/api/v2/statistics/audience/getEmailCategoryPerformance"
-            },
             "GetEmailFrequencyCappingCP": {
                 "request": "pushwoosh.statistics.statistics.v1.GetEmailFrequencyCappingCPRequest",
                 "response": "pushwoosh.statistics.statistics.v1.GetEmailFrequencyCappingCPResponse",
@@ -1282,58 +1276,6 @@ export const data = {
             }
         }
     },
-    "pushwoosh.statistics.statistics.v1.GetEmailCategoryPerformanceCPRequest": {
-        "type": "I",
-        "fields": {
-            "applicationCode": {
-                "type": "string"
-            },
-            "timestampFrom": {
-                "type": "string"
-            },
-            "timestampTo": {
-                "type": "string"
-            }
-        }
-    },
-    "pushwoosh.statistics.statistics.v1.EmailCategoryPerformance": {
-        "type": "I",
-        "fields": {
-            "categoryCode": {
-                "type": "string"
-            },
-            "categoryName": {
-                "type": "string"
-            },
-            "sends": {
-                "type": "number"
-            },
-            "opens": {
-                "type": "number"
-            },
-            "clicks": {
-                "type": "number"
-            },
-            "unsubscribes": {
-                "type": "number"
-            }
-        }
-    },
-    "pushwoosh.statistics.statistics.v1.GetEmailCategoryPerformanceCPResponse": {
-        "type": "I",
-        "fields": {
-            "rows": {
-                "type": "pushwoosh.statistics.statistics.v1.EmailCategoryPerformance",
-                "array": true
-            },
-            "windowFrom": {
-                "type": "string"
-            },
-            "windowTo": {
-                "type": "string"
-            }
-        }
-    },
     "pushwoosh.statistics.statistics.v1.GetEmailFrequencyCappingCPRequest": {
         "type": "I",
         "fields": {
@@ -3821,6 +3763,12 @@ export const data = {
                 "response": "pushwoosh.statistics.statistics.v2.statistics.GetActiveAudienceResponse",
                 "method": "post",
                 "path": "/api/v2/statistics/audience/getActiveAudience"
+            },
+            "GetEmailCategoryPerformance": {
+                "request": "pushwoosh.statistics.statistics.v2.statistics.GetEmailCategoryPerformanceRequest",
+                "response": "pushwoosh.statistics.statistics.v2.statistics.GetEmailCategoryPerformanceResponse",
+                "method": "post",
+                "path": "/api/v2/statistics/messages/getEmailCategoryPerformance"
             }
         }
     },
@@ -5370,5 +5318,59 @@ export const data = {
                 "array": true
             }
         }
+    },
+    "pushwoosh.statistics.statistics.v2.statistics.GetEmailCategoryPerformanceRequest": {
+        "type": "I",
+        "fields": {
+            "application": {
+                "type": "string"
+            },
+            "dateFrom": {
+                "type": "Date"
+            },
+            "dateTo": {
+                "type": "Date"
+            },
+            "campaignCategories": {
+                "type": "string",
+                "mapKeyType": "number"
+            }
+        }
+    },
+    "pushwoosh.statistics.statistics.v2.statistics.EmailCategoryCounters": {
+        "type": "I",
+        "fields": {
+            "categoryCode": {
+                "type": "string"
+            },
+            "sends": {
+                "type": "number"
+            },
+            "opens": {
+                "type": "number"
+            },
+            "clicks": {
+                "type": "number"
+            }
+        }
+    },
+    "pushwoosh.statistics.statistics.v2.statistics.GetEmailCategoryPerformanceResponse": {
+        "type": "I",
+        "fields": {
+            "categories": {
+                "type": "pushwoosh.statistics.statistics.v2.statistics.EmailCategoryCounters",
+                "array": true
+            },
+            "unsubscribes": {
+                "type": "number",
+                "mapKeyType": "string"
+            },
+            "windowFrom": {
+                "type": "Date"
+            },
+            "windowTo": {
+                "type": "Date"
+            }
+        }
     }
 };

package/package.json

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

package/pushwoosh_statistics_statistics_v1.d.ts

@@ -23,7 +23,6 @@ export type StatisticsService_GetSubscribersTotalStatisticsCP = RpcMethod<GetSub
 export type StatisticsService_GetSubscribersDailyStatisticsCP = RpcMethod<GetSubscribersDailyStatisticsCPRequest, GetSubscribersDailyStatisticsCPResponse>;
 export type StatisticsService_GetEmailActivityDistributionCP = RpcMethod<GetEmailActivityDistributionCPRequest, GetEmailActivityDistributionCPResponse>;
 export type StatisticsService_GetEmailEventTriggeredPerformanceCP = RpcMethod<GetEmailEventTriggeredPerformanceCPRequest, GetEmailEventTriggeredPerformanceCPResponse>;
-export type StatisticsService_GetEmailCategoryPerformanceCP = RpcMethod<GetEmailCategoryPerformanceCPRequest, GetEmailCategoryPerformanceCPResponse>;
 export type StatisticsService_GetEmailFrequencyCappingCP = RpcMethod<GetEmailFrequencyCappingCPRequest, GetEmailFrequencyCappingCPResponse>;
 export type StatisticsService_GetEmailUnsubscribeByFrequencyCP = RpcMethod<GetEmailUnsubscribeByFrequencyCPRequest, GetEmailUnsubscribeByFrequencyCPResponse>;
 export type StatisticsService_GetRetentionTotalStatisticsCP = RpcMethod<GetRetentionTotalStatisticsCPRequest, GetRetentionTotalStatisticsCPResponse>;
@@ -76,8 +75,6 @@ export interface StatisticsService {
     GetEmailActivityDistributionCP: StatisticsService_GetEmailActivityDistributionCP;
     /** GetEmailEventTriggeredPerformanceCP returns performance of event-triggered emails for control panel */
     GetEmailEventTriggeredPerformanceCP: StatisticsService_GetEmailEventTriggeredPerformanceCP;
-    /** GetEmailCategoryPerformanceCP returns per-email-category performance for control panel */
-    GetEmailCategoryPerformanceCP: StatisticsService_GetEmailCategoryPerformanceCP;
     /** GetEmailFrequencyCappingCP returns email sends suppressed by frequency capping for control panel */
     GetEmailFrequencyCappingCP: StatisticsService_GetEmailFrequencyCappingCP;
     /** GetEmailUnsubscribeByFrequencyCP returns the unsubscribe rate by how many letters an address got */
@@ -506,27 +503,6 @@ export type GetEmailEventTriggeredPerformanceCPResponse = {
     windowFrom: string;
     windowTo: string;
 };
-export type GetEmailCategoryPerformanceCPRequest = {
-    applicationCode: string;
-    timestampFrom: string;
-    timestampTo: string;
-};
-export type EmailCategoryPerformance = {
-    categoryCode: string;
-    categoryName: string;
-    sends: number;
-    opens: number;
-    clicks: number;
-    /** Unsubscribes from this very category, not from the whole mailing. */
-    unsubscribes: number;
-};
-/** One row per email category of the application, including categories nothing was sent to. */
-export type GetEmailCategoryPerformanceCPResponse = {
-    rows: EmailCategoryPerformance[];
-    /** The window actually read, clamped to the event log retention. */
-    windowFrom: string;
-    windowTo: string;
-};
 export type GetEmailFrequencyCappingCPRequest = {
     applicationCode: string;
     timestampFrom: string;

package/pushwoosh_statistics_statistics_v2_statistics.d.ts

@@ -17,6 +17,7 @@ export type StatisticsService_GetCampaignDeliveryFunnel = RpcMethod<GetCampaignD
 export type StatisticsService_GetMessageDeliveryTimeline = RpcMethod<GetMessageDeliveryTimelineRequest, GetDeliveryTimelineResponse>;
 export type StatisticsService_GetCampaignDeliveryTimeline = RpcMethod<GetCampaignDeliveryTimelineRequest, GetDeliveryTimelineResponse>;
 export type StatisticsService_GetActiveAudience = RpcMethod<GetActiveAudienceRequest, GetActiveAudienceResponse>;
+export type StatisticsService_GetEmailCategoryPerformance = RpcMethod<GetEmailCategoryPerformanceRequest, GetEmailCategoryPerformanceResponse>;
 /** StatisticsService provides various statistics operations */
 export interface StatisticsService {
     /** GetMessagesStatistics returns message statistics grouped by platform and time intervals */
@@ -65,6 +66,11 @@ export interface StatisticsService {
     GetCampaignDeliveryTimeline: StatisticsService_GetCampaignDeliveryTimeline;
     /** GetActiveAudience returns active users and active devices groped by application and platform */
     GetActiveAudience: StatisticsService_GetActiveAudience;
+    /**
+     * GetEmailCategoryPerformance counts email sends, openers and clickers per category code.
+     * The caller names the categories; statistics only groups by the names it is given.
+     */
+    GetEmailCategoryPerformance: StatisticsService_GetEmailCategoryPerformance;
 }
 /** EmailEventType represents different types of email delivery events */
 export type EmailEventType = 
@@ -1106,3 +1112,42 @@ export type GetControlGroupAnalyticsResponse = {
     /** Per-event analytics rows */
     events: ControlGroupAnalyticsEvent[];
 };
+/** GetEmailCategoryPerformanceRequest asks for per-category counters over the period */
+export type GetEmailCategoryPerformanceRequest = {
+    /** Application Code */
+    application: string;
+    /** Period start */
+    dateFrom: Date;
+    /** Period end */
+    dateTo: Date;
+    /**
+     * Category code per campaign, for the email sends that have no message row of their own;
+     * a send with a message row is named by the message and ignores this map.
+     */
+    campaignCategories: Record<number, string>;
+};
+/** EmailCategoryCounters holds the counters of one category code */
+export type EmailCategoryCounters = {
+    /** Category code the sends were grouped by */
+    categoryCode: string;
+    /** Letters sent */
+    sends: number;
+    /** Recipients who opened at least one of them */
+    opens: number;
+    /** Recipients who clicked a link other than unsubscribe */
+    clicks: number;
+};
+/**
+ * GetEmailCategoryPerformanceResponse contains per-category counters and the unsubscribes
+ * the unsubscribe event reports, keyed by the category name it carries
+ */
+export type GetEmailCategoryPerformanceResponse = {
+    /** Categories something was sent to */
+    categories: EmailCategoryCounters[];
+    /** Unsubscribed recipients per category name */
+    unsubscribes: Record<string, number>;
+    /** Window actually read, clamped to retention */
+    windowFrom: Date;
+    /** Window actually read */
+    windowTo: Date;
+};