glitch-javascript-sdk 1.9.4 → 1.9.5

package/dist/index.d.ts

@@ -1016,6 +1016,49 @@ declare class Ads {
     * @returns           Fully-hydrated AdCampaign resource
     */
     static syncSchedulerCampaigns<T>(scheduler_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get campaign performance summary.
+     */
+    static getPerformanceSummary<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get spend and delivery metrics over time.
+     */
+    static getSpendDeliveryReport<T>(params: {
+        start_date: string;
+        end_date: string;
+        group_by?: 'day' | 'week' | 'month';
+        community_id?: string;
+        platform?: string;
+    }): AxiosPromise<Response<T>>;
+    /**
+     * Compare performance across platforms.
+     */
+    static getPlatformComparisonReport<T>(params?: {
+        start_date?: string;
+        end_date?: string;
+        community_id?: string;
+    }): AxiosPromise<Response<T>>;
+    /**
+     * Get performance metrics for individual ad creatives.
+     */
+    static getCreativePerformanceReport<T>(params?: {
+        community_id?: string;
+        platform?: string;
+        start_date?: string;
+        end_date?: string;
+        limit?: number;
+        sort?: 'spend' | 'impressions' | 'clicks' | 'ctr' | 'cpm' | 'cpc';
+        order?: 'asc' | 'desc';
+    }): AxiosPromise<Response<T>>;
+    /**
+     * Get time-based performance metrics by hour and day of week.
+     */
+    static getTimePerformanceReport<T>(params: {
+        start_date: string;
+        end_date: string;
+        community_id?: string;
+        platform?: string;
+    }): AxiosPromise<Response<T>>;
 }
 
 declare class Communities {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glitch-javascript-sdk",
-  "version": "1.9.4",
+  "version": "1.9.5",
   "description": "Javascript SDK for Glitch",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",

package/src/api/Ads.ts

@@ -1028,6 +1028,69 @@ class Ads {
         );
     }
 
+    // ----------------------------------------------------------------------
+    // AD REPORTS
+    // ----------------------------------------------------------------------
+
+    /**
+     * Get campaign performance summary.
+     */
+    public static getPerformanceSummary<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+        return Requests.processRoute(AdsRoute.routes.getPerformanceSummary, undefined, undefined, params);
+    }
+
+    /**
+     * Get spend and delivery metrics over time.
+     */
+    public static getSpendDeliveryReport<T>(params: {
+        start_date: string;
+        end_date: string;
+        group_by?: 'day' | 'week' | 'month';
+        community_id?: string;
+        platform?: string;
+    }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(AdsRoute.routes.getSpendDeliveryReport, undefined, undefined, params);
+    }
+
+    /**
+     * Compare performance across platforms.
+     */
+    public static getPlatformComparisonReport<T>(params?: {
+        start_date?: string;
+        end_date?: string;
+        community_id?: string;
+    }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(AdsRoute.routes.getPlatformComparisonReport, undefined, undefined, params);
+    }
+
+    /**
+     * Get performance metrics for individual ad creatives.
+     */
+    public static getCreativePerformanceReport<T>(params?: {
+        community_id?: string;
+        platform?: string;
+        start_date?: string;
+        end_date?: string;
+        limit?: number;
+        sort?: 'spend' | 'impressions' | 'clicks' | 'ctr' | 'cpm' | 'cpc';
+        order?: 'asc' | 'desc';
+    }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(AdsRoute.routes.getCreativePerformanceReport, undefined, undefined, params);
+    }
+
+    /**
+     * Get time-based performance metrics by hour and day of week.
+     */
+    public static getTimePerformanceReport<T>(params: {
+        start_date: string;
+        end_date: string;
+        community_id?: string;
+        platform?: string;
+    }): AxiosPromise<Response<T>> {
+        return Requests.processRoute(AdsRoute.routes.getTimePerformanceReport, undefined, undefined, params);
+    }
+
+
 
 }
 

package/src/routes/AdsRoute.ts

@@ -373,6 +373,34 @@ class AdsRoute {
             url: "/ads/campaigns/scheduler/{scheduler_id}/syncAll",
             method: HTTP_METHODS.POST,
         },
+
+        // ----------------------------------------------------------------
+        // AD REPORTS
+        // ----------------------------------------------------------------
+        getPerformanceSummary: {
+            url: "/ads/reports/summary",
+            method: HTTP_METHODS.GET,
+        },
+
+        getSpendDeliveryReport: {
+            url: "/ads/reports/spend-delivery",
+            method: HTTP_METHODS.GET,
+        },
+
+        getPlatformComparisonReport: {
+            url: "/ads/reports/platform-comparison",
+            method: HTTP_METHODS.GET,
+        },
+
+        getCreativePerformanceReport: {
+            url: "/ads/reports/creative-performance",
+            method: HTTP_METHODS.GET,
+        },
+
+        getTimePerformanceReport: {
+            url: "/ads/reports/time-performance",
+            method: HTTP_METHODS.GET,
+        },
         
     };
 }