glitch-javascript-sdk 1.7.6 → 1.7.8

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/api/index.ts

@@ -1,4 +1,5 @@
 import Auth from "./Auth";
+import Ads from "./Ads";
 import Competitions from "./Competitions";
 import Communities from "./Communities";
 import Users from "./Users";
@@ -31,6 +32,7 @@ import Funnel from "./Funnel";
 import SocialStats from "./SocialStats";
 import Hashtags from "./Hashtags";
 
+export {Ads};
 export {Auth};
 export {Competitions};
 export {Communities};

package/src/index.ts

@@ -6,6 +6,7 @@ import { Config } from "./config";
 import Auth  from "./api/Auth";
 import Competitions  from "./api/Competitions";
 import {Communities, Social} from "./api";
+import { Ads } from "./api";
 import { Users } from "./api";
 import { Events } from "./api";
 import { Teams } from "./api";
@@ -35,8 +36,6 @@ import {Funnel} from "./api";
 import {SocialStats} from "./api";
 import {Hashtags} from "./api";
 
-
-
 import Requests from "./util/Requests";
 import Parser from "./util/Parser";
 import Session from "./util/Session";
@@ -67,6 +66,7 @@ class Glitch {
     };
 
     public static api = {
+        Ads: Ads,
         Auth: Auth,
         Campaigns : Campaigns,
         Competitions: Competitions,

package/src/routes/AdsRoute.ts

@@ -0,0 +1,127 @@
+import Route from "./interface";
+import HTTP_METHODS from "../constants/HttpMethods";
+
+/**
+ * AdsRoute holds all the endpoint definitions for:
+ * - Ad Campaigns
+ * - Ad Groups (Ad Sets)
+ * - Ads (Creatives)
+ * - Ad Group Triggers
+ */
+class AdsRoute {
+  public static routes: { [key: string]: Route } = {
+    // ----------------------------------------------------------------
+    // AD CAMPAIGNS
+    // ----------------------------------------------------------------
+    getCampaigns: {
+      url: "/ads/campaigns",
+      method: HTTP_METHODS.GET,
+    },
+
+    createCampaign: {
+      url: "/ads/campaigns",
+      method: HTTP_METHODS.POST,
+    },
+
+    retrieveCampaign: {
+      url: "/ads/campaigns/{campaign_id}",
+      method: HTTP_METHODS.GET,
+    },
+
+    updateCampaign: {
+      url: "/ads/campaigns/{campaign_id}",
+      method: HTTP_METHODS.PUT,
+    },
+
+    deleteCampaign: {
+      url: "/ads/campaigns/{campaign_id}",
+      method: HTTP_METHODS.DELETE,
+    },
+
+    // ----------------------------------------------------------------
+    // AD GROUPS (AKA AD SETS)
+    // ----------------------------------------------------------------
+    getGroups: {
+      url: "/ads/campaigns/{campaign_id}/groups",
+      method: HTTP_METHODS.GET,
+    },
+
+    createGroup: {
+      url: "/ads/campaigns/{campaign_id}/groups",
+      method: HTTP_METHODS.POST,
+    },
+
+    retrieveGroup: {
+      url: "/ads/campaigns/{campaign_id}/groups/{group_id}",
+      method: HTTP_METHODS.GET,
+    },
+
+    updateGroup: {
+      url: "/ads/campaigns/{campaign_id}/groups/{group_id}",
+      method: HTTP_METHODS.PUT,
+    },
+
+    deleteGroup: {
+      url: "/ads/campaigns/{campaign_id}/groups/{group_id}",
+      method: HTTP_METHODS.DELETE,
+    },
+
+    // ----------------------------------------------------------------
+    // ADS (CREATIVES)
+    // ----------------------------------------------------------------
+    getAds: {
+      url: "/ads/creatives",
+      method: HTTP_METHODS.GET,
+    },
+
+    createAd: {
+      url: "/ads/creatives",
+      method: HTTP_METHODS.POST,
+    },
+
+    retrieveAd: {
+      url: "/ads/creatives/{ad_id}",
+      method: HTTP_METHODS.GET,
+    },
+
+    updateAd: {
+      url: "/ads/creatives/{ad_id}",
+      method: HTTP_METHODS.PUT,
+    },
+
+    deleteAd: {
+      url: "/ads/creatives/{ad_id}",
+      method: HTTP_METHODS.DELETE,
+    },
+
+    // ----------------------------------------------------------------
+    // AD GROUP TRIGGERS
+    // ----------------------------------------------------------------
+    getTriggers: {
+      url: "/ads/campaigns/{campaign_id}/groups/{group_id}/triggers",
+      method: HTTP_METHODS.GET,
+    },
+
+    createTrigger: {
+      url: "/ads/campaigns/{campaign_id}/groups/{group_id}/triggers",
+      method: HTTP_METHODS.POST,
+    },
+
+    retrieveTrigger: {
+      url: "/ads/campaigns/{campaign_id}/groups/{group_id}/triggers/{trigger_id}",
+      method: HTTP_METHODS.GET,
+    },
+
+    updateTrigger: {
+      url: "/ads/campaigns/{campaign_id}/groups/{group_id}/triggers/{trigger_id}",
+      method: HTTP_METHODS.PUT,
+    },
+
+    deleteTrigger: {
+      url: "/ads/campaigns/{campaign_id}/groups/{group_id}/triggers/{trigger_id}",
+      method: HTTP_METHODS.DELETE,
+    },
+  };
+}
+
+export default AdsRoute;

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,
+    },
+
   };
 
 }