glitch-javascript-sdk 1.7.6 → 1.7.7

package/dist/index.d.ts

@@ -3010,9 +3010,9 @@ declare class Titles {
     static retentionAnalysis<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     static distinctDimensions<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
- * List sessions for a specific title, with optional filters and pagination.
- * Returns a paginated list of sessions with start/end times, session_length, user info, etc.
- */
+     * List sessions for a specific title, with optional filters and pagination.
+     * Returns a paginated list of sessions with start/end times, session_length, user info, etc.
+     */
     static listSessions<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
      * Get aggregated average session length data (daily/weekly/monthly) for a title.
@@ -3020,6 +3020,36 @@ declare class Titles {
      */
     static sessionsAverage<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     static sessionsHistogram<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Upload a CSV/Excel file containing daily UTM analytics for a specific title.
+     *
+     * @param title_id The UUID of the title
+     * @param file The CSV or Excel file
+     * @param data Optional form fields (if needed)
+     * @param params Optional query parameters
+     * @returns AxiosPromise
+     */
+    static importUtmAnalytics<T>(title_id: string, file: File | Blob, data?: Record<string, any>, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Retrieve the UTM analytics data for a title (paginated, filterable, sortable).
+     *
+     * GET /titles/{title_id}/utm
+     *
+     * @param title_id The UUID of the title
+     * @param params Optional query params: start_date, end_date, source, device_type, sort_by, etc.
+     * @returns AxiosPromise
+     */
+    static getUtmAnalytics<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Analyze UTM data with optional group_by (source, campaign, medium, device_type, etc.)
+     *
+     * GET /titles/{title_id}/utm/analysis
+     *
+     * @param title_id The UUID of the title
+     * @param params e.g. ?group_by=source&start_date=YYYY-MM-DD
+     * @returns AxiosPromise
+     */
+    static analyzeUtmAnalytics<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
 }
 
 declare class Campaigns {

package/package.json

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

package/src/api/Titles.ts

@@ -366,9 +366,9 @@ class Titles {
     }
 
     /**
- * List sessions for a specific title, with optional filters and pagination.
- * Returns a paginated list of sessions with start/end times, session_length, user info, etc.
- */
+     * List sessions for a specific title, with optional filters and pagination.
+     * Returns a paginated list of sessions with start/end times, session_length, user info, etc.
+     */
     public static listSessions<T>(
         title_id: string,
         params?: Record<string, any>
@@ -400,15 +400,76 @@ class Titles {
     public static sessionsHistogram<T>(
         title_id: string,
         params?: Record<string, any>
-      ): AxiosPromise<Response<T>> {
+    ): AxiosPromise<Response<T>> {
         return Requests.processRoute(
-          TitlesRoute.routes.sessionsHistogram,
-          {},
-          { title_id },
-          params
+            TitlesRoute.routes.sessionsHistogram,
+            {},
+            { title_id },
+            params
         );
-      }
-      
+    }
+
+  /**
+   * Upload a CSV/Excel file containing daily UTM analytics for a specific title.
+   * 
+   * @param title_id The UUID of the title
+   * @param file The CSV or Excel file
+   * @param data Optional form fields (if needed)
+   * @param params Optional query parameters
+   * @returns AxiosPromise
+   */
+    public static importUtmAnalytics<T>(
+        title_id: string,
+        file: File | Blob,
+        data?: Record<string, any>,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        const url = TitlesRoute.routes.importUtmAnalytics.url.replace("{title_id}", title_id);
+        return Requests.uploadFile<T>(url, "file", file, data, params);
+    }
+
+    /**
+     * Retrieve the UTM analytics data for a title (paginated, filterable, sortable).
+     * 
+     * GET /titles/{title_id}/utm
+     * 
+     * @param title_id The UUID of the title
+     * @param params Optional query params: start_date, end_date, source, device_type, sort_by, etc.
+     * @returns AxiosPromise
+     */
+    public static getUtmAnalytics<T>(
+        title_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            TitlesRoute.routes.getUtmAnalytics,
+            {},
+            { title_id },
+            params
+        );
+    }
+
+    /**
+     * Analyze UTM data with optional group_by (source, campaign, medium, device_type, etc.)
+     * 
+     * GET /titles/{title_id}/utm/analysis
+     * 
+     * @param title_id The UUID of the title
+     * @param params e.g. ?group_by=source&start_date=YYYY-MM-DD
+     * @returns AxiosPromise
+     */
+    public static analyzeUtmAnalytics<T>(
+        title_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            TitlesRoute.routes.analyzeUtmAnalytics,
+            {},
+            { title_id },
+            params
+        );
+    }
+
 
 }
 

package/src/routes/TitlesRoute.ts

@@ -44,6 +44,33 @@ class TitlesRoute {
       url: '/titles/{title_id}/sessions/histogram',
       method: HTTP_METHODS.GET
     },
+    /**
+     * 1) Import a CSV/Excel file containing daily UTM analytics data for a Title
+     *    POST /titles/{title_id}/utm/import
+     */
+    importUtmAnalytics: {
+      url: "/titles/{title_id}/utm/import",
+      method: HTTP_METHODS.POST,
+    },
+
+    /**
+     * 2) Retrieve paginated/filterable UTM analytics data for a Title
+     *    GET /titles/{title_id}/utm
+     */
+    getUtmAnalytics: {
+      url: "/titles/{title_id}/utm",
+      method: HTTP_METHODS.GET,
+    },
+
+    /**
+     * 3) Analyze UTM data with optional group_by / dimension-based aggregates
+     *    GET /titles/{title_id}/utm/analysis
+     */
+    analyzeUtmAnalytics: {
+      url: "/titles/{title_id}/utm/analysis",
+      method: HTTP_METHODS.GET,
+    },
+
   };
 
 }