---
title: "Sessions"
slug: "set-tracking-data-session"
updated: 2025-03-27T11:21:53Z
published: 2025-03-27T11:21:53Z
canonical: "docs.mapp.com/set-tracking-data-session"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sessions

## 

## 1 Overview

Session parameters refer to an entire visit (also known as a session). They are used when you want to persist a value throughout the entire visit rather than just a single page view or interaction.

A common example is the login status of a user. Initially, a session might be classified as "not logged-in". Once the login occurs, the value can be updated to reflect the new status. Depending on your configuration, only the first or last value passed during the session will be considered.

> [!NOTE]
> **Note:** A session in Mapp Intelligence corresponds to a *Visit* in the frontend. Technically, the terms "session" and "visit" are used interchangeably.

---

## 2 Configurable Properties

| Property | Description | Request Parameter |
| --- | --- | --- |
| loginStatus | Indicates whether a user is logged in during a session. This value can be passed once per visit. | `cs800` |
| parameter | Tracks additional custom data points for a session. More details below. | `cs[ID]` |

### 2.1 Parameters

Session parameters are additional attributes that can be configured to collect custom data relevant to the entire session. You must define these parameters in the system configuration (*Configuration > Custom Parameters > Session Parameter*), including the ID and the data type (text or number).

- Values can be analyzed in *Visitors > Session Parameters* if they are of type **text**, or as **metrics** if they are of type **number**.

> [!NOTE]
> **Note:** If a session parameter is passed multiple times during a visit, Mapp Intelligence will evaluate either the first or last value based on the system configuration.

For setup instructions: [How to Set Up Custom Parameters](/v1/docs/how-to-set-up-custom-parameters)

---

## 3 Implementation Examples

> [!NOTE]
> If you do not have [automatic page tracking](/v1/docs/installation-and-integration) enabled, invoke the [track](/v1/docs/send-tracking-data-track) method after adding all relevant tracking information.

```javascript
import { Component } from '@angular/core';
import { WebtrekkSmartPixelAngular } from '@webtrekk-smart-pixel/angular';

@Component({
    template: `<div>[ ... ]</div>`
})
export class ExampleComponent {
    constructor(private pixel: WebtrekkSmartPixelAngular) {
        this.pixel.session({
            loginStatus: "login",
            parameter: {5: "male"}
        });
    }
}
```

> [!NOTE]
> Please add `WebtrekkSmartPixelModule` to your root NgModule and configure the options before using directives.

> [!NOTE]
> If you do not have [automatic page tracking](/v1/docs/installation-and-integration) enabled, invoke the [track](/v1/docs/send-tracking-data-track) method after adding all relevant tracking information.

```javascript
import { Component } from '@angular/core';

@Component({
    template: `<div [wt-session-data]="webtrekkData"></div>`
})
export class ExampleComponent {
    webtrekkData = {
        loginStatus: 'logged in',
        parameter: {1: 'foo', 2: 'bar'}
    }
}
```