Skip to content

Commit c7aa25e

Browse files
authored
Merge pull request #6451 from umbraco/ums/getting-started
uMS Getting Started section
2 parents 86334b1 + f94e9fa commit c7aa25e

File tree

8 files changed

+153
-103
lines changed

8 files changed

+153
-103
lines changed
Lines changed: 29 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,53 +1,61 @@
1+
---
2+
description: The Cockpit is a tool to let you view data directly on the front end of the website.
3+
---
4+
15
# Cockpit
26

3-
To enable the uMarketingSuite cockpit add the following partial just above the body end.
7+
The cockpit gives you the option to check out all the stored data when browsing through the website. It is also a good way to verify your personalization setup.
8+
9+
To enable the uMS Cockpit add the following code above the `</body`> tag.
410

5-
@Html.Partial("uMarketingSuite/Cockpit")</body>
11+
```csharp
12+
@Html.Partial("uMarketingSuite/Cockpit")
13+
```
614

7-
If you reload the page it will show you the uMarketingSuite Cockpit on the left or right side of the screen:
15+
Once the code is added, reload the page to see the uMS Cockpit on the left or right side of the screen:
816

917
![]()
1018

11-
Click open to see all the features of the Cockpit:
19+
Click **Open** to see all the features of the Cockpit:
1220

1321
![]()
1422

15-
The cockpit gives you the option to check out all the data that is stored on the fly when browsing through the website. It's also a really easy way to verify your personalization setup.
16-
1723
## Access to the cockpit
1824

19-
When the uMarketingSuite cockpit partial has been added to the page you will see it when you are logged in to Umbraco (!). Visitors of your website won't see the cockpit. If you don't see the cockpit and Umbraco is running on a different domain please refer to the [loadbalancing / CM / CD environments](/installing-umarketingsuite/loadbalancing-and-cm-cd-environments/) section.
25+
When the uMS Cockpit code has been added to the page you can see it when you are logged in to Umbraco. Visitors of your website will not see the Cockpit.
26+
27+
If you do not see the Cockpit and Umbraco is running on a different domain please refer to the [load balancing / CM / CD environments](/installing-umarketingsuite/loadbalancing-and-cm-cd-environments/) section.
2028

2129
### Data reporting client side
2230

23-
If you've setup the [additional Analytics-script](/analytics/clientside-events-and-additional-javascript-files/additional-measurements-with-our-ums-analytics-scripts/) of the uMarketingSuite you'll find all tracked data in the cockpit.
31+
If you have setup the [additional Analytics-script](/analytics/clientside-events-and-additional-javascript-files/additional-measurements-with-our-ums-analytics-scripts/) of the uMS you can find all tracked data in the Cockpit.
2432

25-
We will track:
33+
The following is tracked:
2634

27-
- The time on page. This is defined betweened the time the page was loaded and the current time. So if you visit the website at 11:23:12 and it's now 11:25:30 you're time on page is 2 minutes and 18 seconds.
28-
- The engaged time on page. This is a far more important metric because it measures the time you were active on the page. When you scroll, move your mouse, type or select text on the website you're considered "engaged". As soon as you stop one of these actions and have no other interaction in the next five seconds this engaged timer will be stopped. This could happen when you're browsing in another window or tab of your browser or system, when you went to grab a cup of coffee, or when you're talking to a colleague. The time on page is still counting, but you're not engaged at that moment.
29-
- The script tracks the maximum scrolldepth that you have reached. Both in absolute pixels and as a percentage
30-
- We keep track off all [fired events](/analytics/clientside-events-and-additional-javascript-files/create-your-own-events/) within the uMarketingSuite
31-
- And finally we measure every outclick to another domain, a pdf-file or excel-file by default
35+
- The time on page. This is defined betweened the time the page was loaded and the current time. If you visit the website at 11:23:12 and it is now 11:25:30, your time on page is 2 minutes and 18 seconds.
36+
- The engaged time on page. This measures the time you were active on the page. When you scroll, move your mouse, type or select text on the website you are considered "engaged". As soon as you stop one of these actions and have no other interaction in the next five seconds this engaged timer will be stopped. This could happen when you are browsing in another window or tab of your browser or system or when you left your computer. The time on page is still counting, but you are not engaged at that moment.
37+
- The script tracks the maximum scrolldepth that you have reached. This counts in absolute pixels and as a percentage.
38+
- All [fired events](/analytics/clientside-events-and-additional-javascript-files/create-your-own-events/) are tracked.
39+
- Every outclick to other domains, a pdf-file or excel-file is measured by default.
3240

3341
![]()
3442

3543
### Data reporting server side
3644

37-
In this section you'll see all the data that is capture server side:
45+
In this section you can see all the data that is captured on the server side:
3846

3947
- The browser,
40-
- the type of device,
41-
- the IP address (anonymized or not; depending on your [settings](/installing-umarketingsuite/configuration-options-1-x/))
42-
- The total number of pages you've visited in this session
43-
- The total number of sessions you've had with this cookie
48+
- The type of device,
49+
- The IP address (anonymized or not; depending on your [settings](/installing-umarketingsuite/configuration-options-1-x/))
50+
- The total number of pages visited in this session
51+
- The total number of sessions with this cookie
4452

45-
Also you have the option to easily delete your uMarketingSuite cookie
53+
Also you have the option to delete your uMS cookie
4654

4755
![]()
4856

4957
### Segments
5058

51-
In the segments section you can easily see which segments are configured and which are applied to the current visitor.
59+
In the segments section you can see which segments are configured and which are applied to the current visitor.
5260

5361
![]()

13/umbraco-ums/getting-started/for-developers/configuration-options-1-x.md

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
# Configuration options 1.x
22

3-
There are quite some configuration options within the uMarketingSuite. Most of these settings are stored in the configuration file of the uMarketingSuite. For uMarketingSuite 1.x, this configuration file can be found in /config/uMarketingSuite/umarketingsuite.config. For uMarketingSuite 2.x we have adopted the new standard for .NET Core applications, in which we make use of the appsettings.json (and environment variable support). See [Configuration options 2.x](../../../../installing-umarketingsuite/configuration-options-2-x/) if you are using uMarketingSuite version 2.
3+
Most of the uMS configuration options are stored in the configuration file. For uMarketingSuite 1.x, the configuration file can be found in `/config/uMarketingSuite/umarketingsuite.config`. For uMS 2.x we have adopted the new standard for .NET Core applications, in which we make use of the `appsettings.json` (and environment variable support). See [Configuration options 2.x](../../../../installing-umarketingsuite/configuration-options-2-x/) if you are using uMS version 2.
44

5-
If you open this file with your favourite texteditor you've all kinds of options that you can set. If you afterwards save the file you should touch the web.config (which restarts your website!) in order to make sure these new settings are used.
5+
If you open the configuration file with your prefered texteditor, you can see all the options you can configure. If you make changes to the file you should touch the `web.config` in order to make sure these new settings are used. Making changes to the `web.config` file will restart the website.
66

77
The configuration file will look like this:
88

9-
```
9+
```xml
1010
<Configuration>
1111
<Settings>
1212
<DatabaseConnectionStringName>umbracoDbDSN</DatabaseConnectionStringName>
@@ -73,22 +73,22 @@ The configuration file will look like this:
7373
</Configuration>
7474
```
7575

76-
All these settings are also visualized in the uMarketingSuite. This overview can be found in the section 'Marketing' -> Settings -> Configuration
76+
All the configuration options are also visualized in the uMS. This overview can be found in the section 'Marketing' -> Settings -> Configuration.
7777

7878
![]()
7979

80-
You cannot change any of the settings over here which is by design. To use the new settings the website must be restarted (by touching the web.config) and that is not something that we wanted to make possible via the Umbraco backoffice.
81-
82-
### All settings
80+
{% hint style="warning" %}
81+
You cannot change any of the settings in the backoffice. To use the new settings the website must be restarted and that is not something that we wanted to make possible via the Umbraco backoffice.
82+
{% endhint %}
8383

84-
#### Section 'Settings'
84+
## Settings
8585

8686
| **Key** | **Label** | **Type / possible options** | **Default value** | **Helptext** | **Additional information** |
8787
| ---------------------------- | ------------------------- | --------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
8888
| DatabaseConnectionStringName | Database connectionstring | Text | umbracoDbDSN | In this database the data of the uMarketingSuite will be stored. By default this is the same database as Umbraco is stored, but this could be set to another database instance | |
8989
| Enabled | Enabled | True / False | True | If you want to disable the uMarketingSuite you can set this setting to False. Possible options: true and false. | The killswitch of the uMarketingSuite. By setting this property to 'False' the uMarketingSuite will not do anything with regards to storing and processing. |
9090

91-
#### Section 'Analytics'
91+
## Analytics
9292

9393
| **Key** | **Label** | **Type / possible options** | **Default value** | **Helptext** | **Additional information** |
9494
| ------------------------- | -------------------------------------- | --------------------------- | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
@@ -111,7 +111,7 @@ You cannot change any of the settings over here which is by design. To use the n
111111
| DeleteDataAfterDays | Delete data after (in days) | <p>Integer<br>> 0</p> | 1460 | After this number of days the data will be deleted from the database | |
112112
| IsProcessingServer | Is a processing server? | True / False | True | Indicates whether this server is the processing server. For performance optimization the processing of the data could be outsourced to another server. Processing is done on the raw data. Possible options: true and false. | _Note: If you are using_ [_Umbraco in a load balanced configuration_](https://docs.umbraco.com/umbraco-cms/fundamentals/setup/server-setup/load-balancing#how-umbraco-load-balancing-works)_, then ensure the front end servers have the configuration setting for **IsProcessingServer** set to false and that the back end (Umbraco backoffice) server should only have this setting enabled._ |
113113

114-
#### Section 'A/B Testing'
114+
## A/B Testing
115115

116116
| Key | Label | Type / possible options | Default value | Help text | Additional information |
117117
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | ----------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------- |
@@ -122,7 +122,7 @@ You cannot change any of the settings over here which is by design. To use the n
122122
| <p><br><br></p> | | | | | |
123123
| <p>None: No data is shared<br>Minimum: The number of tests and the number of variants is shared<br>Medium: The number of tests, the number of variants, and screenshots of the variants are shared to inspirate other people in the community.</p> | This option is not in use at this moment! | | | | |
124124

125-
#### Section 'Profiles'
125+
## Profiles
126126

127127
| Key | Label | Type / possible options | Default value | Help text | Additional information |
128128
| ------------------------------------------ | ----- | ----------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------- |
@@ -133,7 +133,7 @@ You cannot change any of the settings over here which is by design. To use the n
133133
| Identification/Abbreviation | | Text | \{{name\[0]\}} | Template for the abbreviation of a member in the profile section. This is an AngularJS template expression that can use custom member properties. | |
134134
| Identification/ImagePropertyAlias | | Text | avatar | The property alias of the member property containing an avatar image of the member. | |
135135

136-
#### Section 'Reporting'
136+
## Reporting
137137

138138
| **Key** | **Label** | **Type / possible options** | **Default value** | **Helptext** | **Additional information** |
139139
| --------------------- | ----------------------- | --------------------------- | ----------------- | --------------------------------------------------------------------------------------------------------------- | -------------------------- |

0 commit comments

Comments
 (0)