startNewSession

Use startNewSession() when you want the next thing you track (for example a screen view or event) to count as a new session (instead of waiting for session timeout).

There are two forms:

• Default: starts a new session and drops visit-level data you had set on the tracker (for example visit custom variables).
• With preserve turned on: still starts a new session, but keeps that visit-level data.

Nothing is sent to the server until you track something again; the new session starts when you do.

Syntax

Clear visit-level data (typical):

PiwikTracker.sharedInstance()?.startNewSession()

[[PiwikTracker sharedInstance] startNewSession];

Keep visit-level data:

PiwikTracker.sharedInstance()?.startNewSession(preserveSessionParameters: true)

[[PiwikTracker sharedInstance] startNewSession:YES];

Related methods

• sessionTimeout()
• sessionHash()