Session Parameters

Session parameters summarize visitor session data.

session.event_count

Identifies the number of Events Received in the session.

Valid Value: numeric

Syntax

session . event_count = 14

session.page_view_count

Identifies the number of Pages Viewed in the session.

Valid Value: numeric

Syntax

session . page_view_count = 10

session.session_id

Identifies the unique session identifier.

  • If event contains the wt.vt_sid parameter, use value of wt.vt_sid after the last “.” in the full parameter value.
  • Otherwise, if event contains the wt.vtvs parameter, use value of wt.vtvs.
  • If both parameters are missing, use the datetime_UTC of the first hit of the session.
Valid Value: numeric

Syntax

session . session_id = 1363984310943

session.visitor_id

Identifies the unique visitor identifier.

If event contains the wt.vt_sid or doesn’t contain wt.vtid:

  • use wt.co_f if present
  • otherwise, use wt.co_d if present
  • otherwise, use WEBTRENDS_ID if present

Otherwise, if event contains wt.vtid, use value of wt.vtid.

Otherwise, if all parameters are missing, use “IP Address” + “UserAgent”.

Valid Value: numeric

Syntax

session . visitor_id = 98.250.174.27-2754457152.30285513

session.returning_visitor

Indicates whether the visitor is new or returning. Value is False, unless one of these is true:

  • Session contains wt.vt_f=1
  • Session contains wt.vt_f_tlv or wt.vt_tlv AND wt.vt_f_tlv / wt.vt_tlv value is less than Session Start Time
Valid Value: {true | false}

Syntax

session . returning_visitor = true

session.first_datetime_utc

Indicates the start time of the session.

Valid Value: alphanumeric

Syntax

session . first_datetime_utc = 2013-03-22T20:31:51.000Z

session.recent_datetime_utc

Indicates the time of the most recent or last event in the session.

Valid Value: alphanumeric

Syntax

session . recent_datetime_utc = 2013-03-22T20:34:27.000Z

session.time_on_site

Indicates the duration of the session in seconds.

Valid Value: numeric

Syntax

session . time_on_site = 157000

session.closed

Indicator for active or closed session. False = Active session. True = Closed session.

Valid Value: {true | false}

Syntax

session . closed = false

session.closed_reason

Indicates the reason for a closed session:

  • inactivity_limit = session is closed for idle timeout
  • duration_limit = session is closed for reaching the maximum session length
Valid Value: {inactivity_limit | duration_limit}

Syntax

session . closed_reason = inactivity_limit

session.time_inactive

Indicates the time in milliseconds since the last event from the visitor. This is only included in full_session messages, and messages where Closed=True.

Valid Value: numeric

Syntax

session . time_inactive = 30000

session.duration.limit

Indicates the maximum time in milliseconds for an active session until the session is closed.

Valid Value: numeric

Syntax

session . duration_limit = 1440000

first{}

In addition to session parameters, you can access all the parameters from the first event of the session. This is made available in the JSON output as the first{} block.

For example, the first event block is made available as first{} in an SAPI query such as select * where first.ext.source.name=’Google’

You can also leverage the first.* parameters in your Streams Lab queries.

  • Product View Parameters
    The product_view block of parameters appears only if a product page was viewed. This is determined by the existence of data.wt.pn_sku.
  • Purchase Parameters
    The purchase block of parameters appears only if a product was purchased. This is determined by the existence of data.wt.tx_e=’p’.
  • Shopping Cart Parameters
    The shopping_cart block of parameters appears only if a product was added to or removed from the cart. It depends on the existence of data.wt.tx_e=’a’ or data.wt.tx_e=’r’.
  • Add Parameters
    The add block of parameters appears only if at least one item was added to the shopping cart.
  • Remove Parameters
    The remove block of parameters appears only if at least one item was removed from the shopping cart.