glitch-javascript-sdk 1.8.3 → 1.8.5

package/dist/esm/routes/FingerprintingRoute.d.ts

@@ -0,0 +1,7 @@
+import Route from "./interface";
+declare class FingerprintingRoute {
+    static routes: {
+        [key: string]: Route;
+    };
+}
+export default FingerprintingRoute;

package/dist/index.d.ts

@@ -2270,6 +2270,136 @@ declare class Events {
     static getStreamViewCounts<T>(event_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
 }
 
+declare class Fingerprinting {
+    /**
+     * List identified user fingerprints with filtering options
+     *
+     * @param params Filtering options:
+     *   - title_id?: string - Filter by title ID
+     *   - device_id?: string - Filter by device ID
+     *   - user_install_id?: string - Filter by user install ID
+     *   - browser_fingerprint?: string - Filter by browser fingerprint hash
+     *   - device_fingerprint?: string - Filter by device fingerprint hash
+     *   - is_bot?: boolean - Filter by bot status
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - sort?: 'first_seen_at'|'last_seen_at'|'match_confidence' - Sort field
+     *   - order?: 'asc'|'desc' - Sort order
+     *   - per_page?: number - Items per page (max 100)
+     * @returns Promise with paginated fingerprints data
+     */
+    static listFingerprints<T>(params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get cross-platform user journey reports
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - fingerprint_id?: string - Specific fingerprint ID to analyze
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - platform?: 'web'|'ios'|'android'|'steam'|'console' - Filter by platform
+     *   - event_type?: string - Filter by event type
+     *   - group_by?: 'day'|'week'|'month'|'year' - Grouping period
+     *   - include_paths?: boolean - Include journey paths in response
+     * @returns Promise with user journey report data
+     */
+    static userJourneyReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get cross-platform attribution reports
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - conversion_event?: 'game_install'|'game_purchase'|'web_event' - Conversion event to analyze
+     *   - attribution_model?: 'first_touch'|'last_touch'|'linear'|'time_decay'|'position_based' - Attribution model
+     * @returns Promise with attribution report data
+     */
+    static attributionReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get cross-device identity clusters
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - min_confidence?: number - Minimum match confidence score (0-100)
+     * @returns Promise with device cluster report data
+     */
+    static deviceClusterReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get combined identity clusters and user journey reports
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - min_confidence?: number - Minimum confidence score to include (0-100)
+     *   - platform?: string - Filter by platform
+     *   - include_journeys?: boolean - Include detailed journeys
+     * @returns Promise with identity cluster report data
+     */
+    static identityClusterReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get combined attribution paths and conversion funnels
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - conversion_event?: string - Conversion event type
+     *   - attribution_model?: string - Attribution model
+     *   - funnel_steps?: string - Comma-separated funnel steps
+     * @returns Promise with attribution and funnel report data
+     */
+    static attributionFunnelReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get device and environment breakdown reports
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - platform?: string - Filter by platform
+     *   - group_by?: 'device_type'|'os'|'browser'|'country_code' - Grouping field
+     * @returns Promise with device and environment report data
+     */
+    static deviceEnvironmentReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get unique vs returning user metrics
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - retention_period?: number - Days to consider for retention
+     * @returns Promise with retention metrics data
+     */
+    static uniqueReturningReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get fraud and bot detection metrics
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - min_confidence?: number - Minimum confidence score to flag (0-100)
+     * @returns Promise with fraud detection data
+     */
+    static fraudDetectionReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get geolocation distribution of users
+     *
+     * @param params Report options:
+     *   - title_id: string - Required title ID
+     *   - start_date?: string - Start date (YYYY-MM-DD)
+     *   - end_date?: string - End date (YYYY-MM-DD)
+     *   - group_by?: 'country'|'region'|'city' - Grouping level
+     * @returns Promise with geolocation report data
+     */
+    static geolocationReport<T>(params: Record<string, any>): AxiosPromise<Response<T>>;
+}
+
 declare class Teams {
     /**
      * List all the teams
@@ -3293,6 +3423,16 @@ declare class Titles {
      * @returns AxiosPromise
      */
     static getUtmAnalytics<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
+    /**
+     * Get the web tracking token used for websites.
+     *
+     * GET /titles/{title_id}/webTrackingToken
+     *
+     * @param title_id The UUID of the title
+     * @param params Optional query params:
+     * @returns AxiosPromise
+     */
+    static getWebTrackingToken<T>(title_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     /**
      * Analyze UTM data with optional group_by (source, campaign, medium, device_type, etc.)
      *
@@ -5500,6 +5640,7 @@ declare class Glitch {
         Funnel: typeof Funnel;
         SocialStats: typeof SocialStats;
         WebsiteAnalytics: typeof WebsiteAnalytics;
+        Fingerprinting: typeof Fingerprinting;
     };
     static util: {
         Requests: typeof Requests;

package/package.json

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

package/src/api/Fingerprinting.ts

@@ -0,0 +1,215 @@
+import FingerprintingRoute from "../routes/FingerprintingRoute";
+import Requests from "../util/Requests";
+import Response from "../util/Response";
+import { AxiosPromise } from "axios";
+
+class Fingerprinting {
+  /**
+   * List identified user fingerprints with filtering options
+   * 
+   * @param params Filtering options:
+   *   - title_id?: string - Filter by title ID
+   *   - device_id?: string - Filter by device ID
+   *   - user_install_id?: string - Filter by user install ID
+   *   - browser_fingerprint?: string - Filter by browser fingerprint hash
+   *   - device_fingerprint?: string - Filter by device fingerprint hash
+   *   - is_bot?: boolean - Filter by bot status
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - sort?: 'first_seen_at'|'last_seen_at'|'match_confidence' - Sort field
+   *   - order?: 'asc'|'desc' - Sort order
+   *   - per_page?: number - Items per page (max 100)
+   * @returns Promise with paginated fingerprints data
+   */
+  public static listFingerprints<T>(params?: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.listFingerprints,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get cross-platform user journey reports
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - fingerprint_id?: string - Specific fingerprint ID to analyze
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - platform?: 'web'|'ios'|'android'|'steam'|'console' - Filter by platform
+   *   - event_type?: string - Filter by event type
+   *   - group_by?: 'day'|'week'|'month'|'year' - Grouping period
+   *   - include_paths?: boolean - Include journey paths in response
+   * @returns Promise with user journey report data
+   */
+  public static userJourneyReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.userJourneyReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get cross-platform attribution reports
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - conversion_event?: 'game_install'|'game_purchase'|'web_event' - Conversion event to analyze
+   *   - attribution_model?: 'first_touch'|'last_touch'|'linear'|'time_decay'|'position_based' - Attribution model
+   * @returns Promise with attribution report data
+   */
+  public static attributionReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.attributionReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get cross-device identity clusters
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - min_confidence?: number - Minimum match confidence score (0-100)
+   * @returns Promise with device cluster report data
+   */
+  public static deviceClusterReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.deviceClusterReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get combined identity clusters and user journey reports
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - min_confidence?: number - Minimum confidence score to include (0-100)
+   *   - platform?: string - Filter by platform
+   *   - include_journeys?: boolean - Include detailed journeys
+   * @returns Promise with identity cluster report data
+   */
+  public static identityClusterReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.identityClusterReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get combined attribution paths and conversion funnels
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - conversion_event?: string - Conversion event type
+   *   - attribution_model?: string - Attribution model
+   *   - funnel_steps?: string - Comma-separated funnel steps
+   * @returns Promise with attribution and funnel report data
+   */
+  public static attributionFunnelReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.attributionFunnelReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get device and environment breakdown reports
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - platform?: string - Filter by platform
+   *   - group_by?: 'device_type'|'os'|'browser'|'country_code' - Grouping field
+   * @returns Promise with device and environment report data
+   */
+  public static deviceEnvironmentReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.deviceEnvironmentReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get unique vs returning user metrics
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - retention_period?: number - Days to consider for retention
+   * @returns Promise with retention metrics data
+   */
+  public static uniqueReturningReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.uniqueReturningReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get fraud and bot detection metrics
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - min_confidence?: number - Minimum confidence score to flag (0-100)
+   * @returns Promise with fraud detection data
+   */
+  public static fraudDetectionReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.fraudDetectionReport,
+      {},
+      undefined,
+      params
+    );
+  }
+
+  /**
+   * Get geolocation distribution of users
+   * 
+   * @param params Report options:
+   *   - title_id: string - Required title ID
+   *   - start_date?: string - Start date (YYYY-MM-DD)
+   *   - end_date?: string - End date (YYYY-MM-DD)
+   *   - group_by?: 'country'|'region'|'city' - Grouping level
+   * @returns Promise with geolocation report data
+   */
+  public static geolocationReport<T>(params: Record<string, any>): AxiosPromise<Response<T>> {
+    return Requests.processRoute(
+      FingerprintingRoute.routes.geolocationReport,
+      {},
+      undefined,
+      params
+    );
+  }
+}
+
+export default Fingerprinting;

package/src/api/Titles.ts

@@ -449,6 +449,27 @@ class Titles {
         );
     }
 
+    /**
+     * Get the web tracking token used for websites.
+     * 
+     * GET /titles/{title_id}/webTrackingToken
+     * 
+     * @param title_id The UUID of the title
+     * @param params Optional query params: 
+     * @returns AxiosPromise
+     */
+    public static getWebTrackingToken<T>(
+        title_id: string,
+        params?: Record<string, any>
+    ): AxiosPromise<Response<T>> {
+        return Requests.processRoute(
+            TitlesRoute.routes.getWebTrackingToken,
+            {},
+            { title_id },
+            params
+        );
+    }
+
     /**
      * Analyze UTM data with optional group_by (source, campaign, medium, device_type, etc.)
      * 

package/src/api/index.ts

@@ -4,6 +4,7 @@ import Competitions from "./Competitions";
 import Communities from "./Communities";
 import Users from "./Users";
 import Events from "./Events";
+import Fingerprinting from "./Fingerprinting";
 import Teams from "./Teams";
 import Waitlists from "./Waitlist";
 import Posts from "./Posts";
@@ -66,4 +67,5 @@ export {Scheduler};
 export {Funnel};
 export {SocialStats};
 export {Hashtags};
-export {WebsiteAnalytics};
+export {WebsiteAnalytics};
+export {Fingerprinting};

package/src/index.ts

@@ -36,6 +36,7 @@ import {Funnel} from "./api";
 import {SocialStats} from "./api";
 import {Hashtags} from "./api";
 import {WebsiteAnalytics} from "./api";
+import {Fingerprinting} from "./api";
 
 import Requests from "./util/Requests";
 import Parser from "./util/Parser";
@@ -100,7 +101,8 @@ class Glitch {
         Scheduler : Scheduler,
         Funnel: Funnel,
         SocialStats : SocialStats,
-        WebsiteAnalytics: WebsiteAnalytics
+        WebsiteAnalytics: WebsiteAnalytics,
+        Fingerprinting : Fingerprinting
     }
 
     public static util = {

package/src/routes/FingerprintingRoute.ts

@@ -0,0 +1,49 @@
+import Route from "./interface";
+import HTTP_METHODS from "../constants/HttpMethods";
+
+class FingerprintingRoute {
+  public static routes: { [key: string]: Route } = {
+    listFingerprints: {
+      url: '/reports/fingerprinting/fingerprints',
+      method: HTTP_METHODS.GET
+    },
+    userJourneyReport: {
+      url: '/reports/fingerprinting/user-journeys',
+      method: HTTP_METHODS.GET
+    },
+    attributionReport: {
+      url: '/reports/fingerprinting/attribution',
+      method: HTTP_METHODS.GET
+    },
+    deviceClusterReport: {
+      url: '/reports/fingerprinting/device-clusters',
+      method: HTTP_METHODS.GET
+    },
+    identityClusterReport: {
+      url: '/reports/fingerprinting/identity-clusters',
+      method: HTTP_METHODS.GET
+    },
+    attributionFunnelReport: {
+      url: '/reports/fingerprinting/attribution-funnel',
+      method: HTTP_METHODS.GET
+    },
+    deviceEnvironmentReport: {
+      url: '/reports/fingerprinting/device-environment',
+      method: HTTP_METHODS.GET
+    },
+    uniqueReturningReport: {
+      url: '/reports/fingerprinting/unique-returning',
+      method: HTTP_METHODS.GET
+    },
+    fraudDetectionReport: {
+      url: '/reports/fingerprinting/fraud-detection',
+      method: HTTP_METHODS.GET
+    },
+    geolocationReport: {
+      url: '/reports/fingerprinting/geolocation',
+      method: HTTP_METHODS.GET
+    }
+  };
+}
+
+export default FingerprintingRoute;

package/src/routes/TitlesRoute.ts

@@ -62,6 +62,11 @@ class TitlesRoute {
       method: HTTP_METHODS.GET,
     },
 
+    getWebTrackingToken: {
+      url: "/titles/{title_id}/webTrackingToken",
+      method: HTTP_METHODS.GET,
+    },
+
     /**
      * 3) Analyze UTM data with optional group_by / dimension-based aggregates
      *    GET /titles/{title_id}/utm/analysis