Constructors

Methods

  • Single ingestion endpoint for sessions, pageviews and events

    Type Parameters

    • T

    Parameters

    • data: object

      Analytics data payload with type property:

      • type: 'session'|'pageview'|'event' - Type of analytics data
      • title_id: string - Title ID
      • tracking_token: string - HMAC token for verification
      • plus type-specific fields

    Returns AxiosPromise<default<T>>

    Promise with acceptance response

  • Get device type breakdown

    Type Parameters

    • T

    Parameters

    • Optional params: Record<string, any>

      Filtering options:

      • title_id?: string - Filter by title ID
      • start_date?: string - Start date (YYYY-MM-DD)
      • end_date?: string - End date (YYYY-MM-DD)

    Returns AxiosPromise<default<T>>

    Promise with device breakdown data

  • Get summary of events

    Type Parameters

    • T

    Parameters

    • Optional params: Record<string, any>

      Filtering options:

      • title_id?: string - Filter by title ID
      • start_date?: string - Start date (YYYY-MM-DD)
      • end_date?: string - End date (YYYY-MM-DD)
      • event_category?: string - Filter by event category

    Returns AxiosPromise<default<T>>

    Promise with events summary data

  • Get geographic distribution of visitors

    Type Parameters

    • T

    Parameters

    • Optional params: Record<string, any>

      Filtering options:

      • title_id?: string - Filter by title ID
      • start_date?: string - Start date (YYYY-MM-DD)
      • end_date?: string - End date (YYYY-MM-DD)
      • limit?: number - Number of countries to return

    Returns AxiosPromise<default<T>>

    Promise with geo distribution data

  • Get a paginated list of events with filtering options

    Type Parameters

    • T

    Parameters

    • Optional params: Record<string, any>

      Filtering options:

      • title_id?: string - Filter by title ID
      • analytics_session_id?: string - Filter by session ID
      • event_name?: string - Filter by event name
      • event_category?: string - Filter by event category
      • start_date?: string - Start date (YYYY-MM-DD)
      • end_date?: string - End date (YYYY-MM-DD)
      • sort?: 'occurred_at'|'event_name' - Sort field
      • order?: 'asc'|'desc' - Sort order
      • per_page?: number - Items per page (max 100)

    Returns AxiosPromise<default<T>>

    Promise with paginated events data

  • Get a paginated list of pageviews with filtering options

    Type Parameters

    • T

    Parameters

    • Optional params: Record<string, any>

      Filtering options:

      • title_id?: string - Filter by title ID
      • analytics_session_id?: string - Filter by session ID
      • start_date?: string - Start date (YYYY-MM-DD)
      • end_date?: string - End date (YYYY-MM-DD)
      • is_exit?: boolean - Filter by exit pageviews
      • sort?: 'occurred_at'|'load_time_ms'|'dom_complete_ms' - Sort field
      • order?: 'asc'|'desc' - Sort order
      • per_page?: number - Items per page (max 100)

    Returns AxiosPromise<default<T>>

    Promise with paginated pageviews data

  • List website analytics sessions with comprehensive filtering

    Type Parameters

    • T

    Parameters

    • Optional params: Record<string, any>

      Filtering options:

      • title_id?: string - Filter by title ID
      • start_date?: string - Start date (YYYY-MM-DD)
      • end_date?: string - End date (YYYY-MM-DD)
      • device_type?: 'desktop'|'mobile'|'tablet'|'bot'|'other'
      • country_code?: string - 2-letter country code
      • is_bot?: boolean - Filter by bot status
      • sort?: 'started_at'|'total_duration'|'pageview_count' - Sort field
      • order?: 'asc'|'desc' - Sort order
      • per_page?: number - Items per page (max 100)

    Returns AxiosPromise<default<T>>

    Promise with paginated sessions data

  • Get an analytics overview with summarized metrics

    Type Parameters

    • T

    Parameters

    • params: Record<string, any>

      Overview 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?: 'day'|'week'|'month'|'year' - Grouping period
      • include_breakdowns?: boolean - Include detailed breakdowns

    Returns AxiosPromise<default<T>>

    Promise with overview data

  • Get pageviews over time with optional grouping

    Type Parameters

    • T

    Parameters

    • Optional params: Record<string, any>

      Filtering options:

      • title_id?: string - Filter by title ID
      • start_date?: string - Start date (YYYY-MM-DD)
      • end_date?: string - End date (YYYY-MM-DD)
      • group_by?: 'hour'|'day'|'week'|'month' - Grouping period
      • path?: string - Filter by specific path

    Returns AxiosPromise<default<T>>

    Promise with pageviews over time data

  • Get most popular events

    Type Parameters

    • T

    Parameters

    • Optional params: Record<string, any>

      Filtering options:

      • title_id?: string - Filter by title ID
      • start_date?: string - Start date (YYYY-MM-DD)
      • end_date?: string - End date (YYYY-MM-DD)
      • limit?: number - Number of events to return

    Returns AxiosPromise<default<T>>

    Promise with popular events data

  • Get top referrers

    Type Parameters

    • T

    Parameters

    • Optional params: Record<string, any>

      Filtering options:

      • title_id?: string - Filter by title ID
      • start_date?: string - Start date (YYYY-MM-DD)
      • end_date?: string - End date (YYYY-MM-DD)
      • limit?: number - Number of referrers to return

    Returns AxiosPromise<default<T>>

    Promise with referrers data

  • Get average session length data with optional grouping

    Type Parameters

    • T

    Parameters

    • Optional params: Record<string, any>

      Filtering options:

      • title_id?: string - Filter by title ID
      • start_date?: string - Start date (YYYY-MM-DD)
      • end_date?: string - End date (YYYY-MM-DD)
      • group_by?: 'day'|'week'|'month' - Grouping period
      • device_type?: string - Filter by device type
      • country_code?: string - Filter by country

    Returns AxiosPromise<default<T>>

    Promise with average session data

  • Get session duration histogram data

    Type Parameters

    • T

    Parameters

    • Optional params: Record<string, any>

      Filtering options:

      • title_id?: string - Filter by title ID
      • start_date?: string - Start date (YYYY-MM-DD)
      • end_date?: string - End date (YYYY-MM-DD)
      • bucket_size?: number - Duration bucket size in seconds

    Returns AxiosPromise<default<T>>

    Promise with histogram data

  • Get top pages by views

    Type Parameters

    • T

    Parameters

    • Optional params: Record<string, any>

      Filtering options:

      • title_id?: string - Filter by title ID
      • start_date?: string - Start date (YYYY-MM-DD)
      • end_date?: string - End date (YYYY-MM-DD)
      • limit?: number - Number of top pages to return

    Returns AxiosPromise<default<T>>

    Promise with top pages data

  • Get UTM campaign performance

    Type Parameters

    • T

    Parameters

    • Optional params: Record<string, any>

      Filtering options:

      • title_id?: string - Filter by title ID
      • start_date?: string - Start date (YYYY-MM-DD)
      • end_date?: string - End date (YYYY-MM-DD)
      • group_by?: 'source'|'medium'|'campaign' - Grouping field

    Returns AxiosPromise<default<T>>

    Promise with UTM performance data

Generated using TypeDoc