glitch-javascript-sdk 1.7.5 → 1.7.7

package/dist/index.d.ts

@@ -3010,15 +3010,46 @@ 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.
      * Optionally filter by platform/device_type/OS/version and group by one dimension.
      */
     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.5",
+  "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>
@@ -397,6 +397,80 @@ class Titles {
         );
     }
 
+    public static sessionsHistogram<T>(
+        title_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            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
+        );
+    }
+
+
 }
 
 export default Titles;

package/src/routes/TitlesRoute.ts

@@ -40,6 +40,37 @@ class TitlesRoute {
       url: '/titles/{title_id}/installs/sessions/average',
       method: HTTP_METHODS.GET
     },
+    sessionsHistogram: {
+      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,
+    },
+
   };
 
 }