---
title: "Events"
slug: "set-tracking-data-action"
updated: 2025-03-27T11:17:35Z
published: 2025-03-27T11:17:35Z
canonical: "docs.mapp.com/set-tracking-data-action"
---

> ## 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.

# Events

## 1 Overview

This page provides a comprehensive guide on how to track and analyze event-related data in Mapp Intelligence. Events complement page tracking by offering detailed insights into user interactions, such as clicks on links or buttons, navigation through specific page elements, and other actions users perform on your website.

Event tracking requires JavaScript to be enabled in the visitor's browser.

---

## 2 Configurable Properties

The following table outlines all supported properties, their descriptions, and request parameters.

| Property | Description | Data Type | Request Parameter |
| --- | --- | --- | --- |
| name | Unique identifier of your event. This property must be explicitly set. The value is analyzed in *Navigation > Events*. | String | `ct` |
| parameter | Tracks additional custom data points for an event. More details below. | Object | `ck[ID]` |
| goal | Defines and tracks key website goals related to events. More details below. | Object | `cb[ID]` |

### 2.1 Event Parameters

Event parameters allow tracking of additional details about specific user interactions, such as link types (internal/external), click areas (text, image, header), Scroll Depth, or errors.

- Mapp Intelligence provides predefined parameters and also allows the creation of custom event parameters for specific tracking needs.
- Event parameters must be set up under *Configuration > Custom Parameters > Event Parameter* before use.
- Text parameters are analyzed in *Navigation > Event Parameter*, numeric parameters are analyzed as metrics.

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

### 2.2 Goals

Goals measure specific user actions linked to your events, such as newsletter signups, registrations, or downloads. They are essential for evaluating user behavior and performance.

- Goals track meaningful actions that users complete after interacting with an event.
- Goals enable campaign evaluations by tracking attributed conversions.
- Once tracked, goals are marked as achieved. Track positive achievements (e.g., "Newsletter Signup: yes").

Goals can be analyzed in *Marketing > Website Goals*.

For setup instructions, see: How to Define Website Goals.

---

## 3 Implementation Examples

**WebtrekkSmartPixelAngular**

> [!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.action({
            name: "en.click.on.some.link",
            parameter: {1: "en"},
            goal: {2: "goal value 2"}
        });
    }
}
```

A **Request Parameter** displays the name of the parameter included in a tracking request. This information is crucial for debugging purposes (e.g., via **Mapp Cloud Debugger**), allowing you to verify the data transmitted to Mapp and understand how it is recorded.

Scroll depth measures how far users scroll down a webpage, typically expressed as a percentage of the total page length viewed. This metric helps content-driven websites analyze user engagement and content effectiveness. Mapp provides a plugin to easily track and analyze scroll behavior across various tracking implementations.