1 Overview
This page provides a comprehensive guide on how to track and analyze page-related data in Mapp Intelligence. It details the configurable properties, analysis locations, and request parameters.
1.1 Individual Setup
Only name and search are automatically available when data is transmitted. All other properties—whether Page Parameters, Categories, or Goals—require individual setup. While most customers receive a predefined configuration, all these elements can be fully customized based on tracking requirements.
Before defining new parameters, categories, or goals, check your existing setup to determine which elements are already available and which need to be configured manually.
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 page. By default, the page URL is used. Parameters and hash in the URL are excluded. This property is automatically available. The value is analyzed in Navigation > Pages > Pages. | String |
|
search | Contains terms entered in the internal search of the website or app. This property is automatically available. The value is analyzed in Marketing > Search Phrases > Internal Search Phrases. | String |
|
numberSearchResults | The number of results returned in an internal search query. This is a Page Parameter and requires setup. The value is analyzed as a metric. | Number |
|
errorMessages | Tracks error messages on the page, such as system errors or missing content warnings. This is a Page Parameter and requires setup. The value is analyzed in Navigation > Page Parameters. | String |
|
paywall | Indicates whether an article is behind a paywall. This is a Page Parameter and requires setup. The value is analyzed in Navigation > Page Parameters. | Boolean |
|
articleTitle | Captures the specific title of an article in addition to the general page name. This is a Page Parameter and requires setup. The value is analyzed in Navigation > Page Parameters. | String |
|
contentTags | Allows tagging articles with multiple categories or keywords for analysis. This is a Page Parameter and requires setup. The value is analyzed in Navigation > Page Parameters. | String |
|
title | Stores a readable version of the page title for improved reporting and analysis. This is a Page Parameter and requires setup. The value is analyzed in Navigation > Page Parameters. | String |
|
type | Defines the type of page (e.g., "overview"). This is a Page Parameterand requires setup. The value is analyzed in Navigation > Page Parameters. | String |
|
length | Specifies the length classification of the page (e.g., "large"). This is a Page Parameter and requires setup. The value is analyzed in Navigation > Page Parameters. | String |
|
daysSincePublication | Tracks how many days have passed since an article was published. This is a Page Parameter and requires setup. The value is analyzed in Navigation > Page Parameters. | Number |
|
testVariant | Stores the name of a test variant for A/B testing. This is a Page Parameter and requires setup. The value is analyzed in Navigation > Page Parameters. | String |
|
testExperiment | Captures the name of an experiment in A/B testing. This is a Page Parameter and requires setup. The value is analyzed in Navigation > Page Parameters. | String |
|
parameter | Tracks additional custom data points for a page. More details below. | Object |
|
category | Groups pages into structured content categories. More details below. | Object |
|
goal | Defines and tracks key website goals. More details below. | Object |
|
2.1 Page Parameters
Page parameters refer to individual pages and are used to track additional details such as error messages, content tags, and test experiments.
Mapp Intelligence provides a set of predefined Page Parameters, including those listed in the table above (e.g.,
paywall,title,type). These predefined parameters can be enabled as needed.Additionally, users can create completely custom Page Parameters if their tracking requirements go beyond the predefined options. Custom parameters allow you to track any additional data relevant to your website.
Values can be analyzed in Navigation > Page Parameters if they are of type text, or as metrics if they are of type number.
For setup instructions: How to Set Up Custom Parameters
2.2 Categories (Content Groups)
Categories define fixed classifications for pages, typically used to group content into structured areas.
Categories are assigned once to a page, in the first-ever request of that page, and do not change unless imported manually.
The ID and data type (text/number) are defined during setup.
Categories are useful for defining structural groupings, such as:
Main Section of a website (e.g., "News," "Sports," "Lifestyle")
Subsections within a main section (e.g., under "News": "Politics," "Technology," "Economy")
It is recommended to implement page and content group tracking in parallel.
Values can be analyzed in Navigation > Content Groups if they are of type text, or as metrics if they are of type number.
For setup instructions: How to Set Up Categories
Content groups are assigned one time to a page. If a page is tracked together with a content group, all subsequent page calls of the page will also be assigned to this content group. Only the first-ever tracked value will be shown.
We, therefore, recommend implementing content IDs and content groups while embedding the pixel.
See also How can I replace missing values ("-") in categories?
2.3 Goal Tracking
Goal tracking allows you to measure when a specific action has been completed on a page. This is essential for evaluating user behavior and performance.
Goals can be used to track specific actions completed on a page, such as a newsletter signup or user registration.
They are crucial for campaign success analysis, enabling attributed campaign evaluation. Ideally, users interacting with a campaign complete a goal, which must be tracked.
If a goal should be tracked when a page loads, it needs to be explicitly passed.
The Order goal is predefined for e-commerce tracking and does not need to be manually set on a page.
Goals can be analyzed in Marketing > Website Goals.
For setup instructions: How to define website goals
3 Implementation Example
If you do not have automatic page tracking enabled, invoke the track method after adding all relevant tracking information.
<template>
<div>Example</div>
</template>
<script>
export default {
name: "example",
mounted() {
this.$webtrekk.page("name of the page", {
search: "search term",
numberSearchResults: 7,
errorMessages: "error: ...",
paywall: false,
articleTitle: "article title",
contentTags: "content tags",
title: "page title",
type: "page type",
length: "medium",
daysSincePublication: 5,
testVariant: "test variant",
testExperiment: "test experiment",
parameter: { 5: "parameter value 5" },
category: { 8: "category value 8" },
goal: { 2: "goal value 2" }
});
}
};
</script>Value | Description | Data type | Default value | Required |
|---|---|---|---|---|
track | If you want to track all current added information, add the |
|
| - |
If you do not have automatic page tracking or the additional property
trackenabled, invoke the track method after adding all relevant tracking information.
<template>
<div
v-webtrekk="{
page: {
name: 'name of the page',
search: 'search term',
numberSearchResults: 7,
errorMessages: 'error: ...',
paywall: false,
articleTitle: 'article title',
contentTags: 'content tags',
title: 'page title',
type: 'page type',
length: 'medium',
daysSincePublication: 5,
testVariant: 'test variant',
testExperiment: 'test experiment',
parameter: { 5: 'parameter value 5' },
category: { 8: 'category value 8' },
goal: { 2: 'goal value 2' }
},
track: false
}"
>
Example
</div>
</template>Tracking via data property only works when automatic page tracking is set to
true.
<template>
<div>Example</div>
</template>
<script>
export default {
name: "example",
data() {
return {
webtrekk: {
page: {
name: "name of the page",
search: "search term",
numberSearchResults: 7,
errorMessages: "error: ...",
paywall: false,
articleTitle: "article title",
contentTags: "content tags",
title: "page title",
type: "page type",
length: "medium",
daysSincePublication: 5,
testVariant: "test variant",
testExperiment: "test experiment",
parameter: { 5: "parameter value 5" },
category: { 8: "category value 8" },
goal: { 2: "goal value 2" }
}
}
};
},
mounted() {
}
};
</script>