Skip to content

Commit be70451

Browse files
cornehoskamgitbook-bot
authored andcommitted
GITBOOK-14: Request Tracking V16
1 parent 8adb09e commit be70451

File tree

2 files changed

+22
-10
lines changed

2 files changed

+22
-10
lines changed

16/umbraco-engage/developers/analytics/what-is-measured-by-default.md

Lines changed: 19 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -4,20 +4,32 @@ description: Learn what Umbraco Engage tracks before any additional configuratio
44

55
# Request tracking
66

7-
If you install Umbraco Engage we will automatically collect a lot of data for you.
7+
When installing Umbraco Engage, a lot of data is automatically collected for you.
88

9-
Serverside the following data is tracked:
9+
Server-side, the following data is tracked:
1010

11-
* The URL of the visited page (`/foobar/`)
11+
* The URL of the visited page (`/this-page/`)
1212
* The query string of the visited page (`?filtering=on&parameter1=2`)
1313
* The variant of the page that we serve. This could be a personalized version of the page or one of the A/B-test variants.
1414
* The time that the page was visited (`31 august 2021, 16:04:22`)
1515
* Where the visitor came from before this visit (the so-called referrer). This could be an internal webpage (`/my-contentpage/`) or an external URL (`www.umbraco.com/the-umbraco-engage-rocks/`)
16-
* The browser being used (Firefox), the Operating System used (Windows), and the type of device being used (Desktop). These data points are based on the user-agent string that any browser is sending.
16+
* The browser being used (Firefox), the Operating System used (Windows), and the type of device being used (Desktop). These data points are based on the user-agent string that any browser sends.
1717
* The IP address (`213.62.44.123`) or anonymized IP address (`213.62.44.0`), depending on your configuration.
1818

19-
Only GET requests which return a 2XX HTTP OK will be tracked in Umbraco Engage.
19+
For a request to be considered a valid pageview, the following conditions have to apply:
2020

21-
With the data collected, the Analytics reports in Umbraco Engage can be visualized. It also allows us to calculate other metrics, such as conversion rates, bounce rates, and landing & exit pages.
21+
* Umbraco Engage is Enabled.
22+
* The request is a `GET` request that returns a 2XX HTTP OK.
23+
* The request's domain is part of the Engage license.
24+
* The request is not:
25+
* A `POST/PUT/DELETE` request.
26+
* A `XHR` Request.
27+
* A SignalR or WebSocket request.
28+
* A 3XX Redirect.
29+
* Targeting an `/umbraco` path.
30+
* Previewing an A/B test or Personalization.
31+
* Originating from an excluded IP address as configured in the backoffice.
2232

23-
If you [include the clientside collection script](client-side-events-and-additional-javascript-files/additional-measurements-with-the-analytics-scripts.md) as well, you can also capture behavioural data of your visitors.
33+
With the collected data, the Analytics reports in Umbraco Engage can be visualized. It also allows us to calculate other metrics, such as conversion rates, bounce rates, and landing & exit pages.
34+
35+
If you [include the client-side collection script](client-side-events-and-additional-javascript-files/additional-measurements-with-the-analytics-scripts.md) as well, you can also capture behavioural data of your visitors.

16/umbraco-engage/developers/settings/custom-goals-scoring.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -41,11 +41,11 @@ public class YourService
4141

4242
### Triggering Outside of HttpContext
4343

44-
The method automatically determines the current page view, linking the goal to a session and visitor. This means the **HttpContext** should be available.
44+
The method automatically determines the current page view, linking the goal to a session and visitor. This means the `HttpContext` should be available and `triggerGoal` should be called from within a valid pageview. See [what-is-measured-by-default.md](../analytics/what-is-measured-by-default.md "mention") for what is considered a valid pageview.
4545

46-
To trigger a goal outside of an HTTP request, use the overload of **TriggerGoal** that takes the GUID of the pageview.
46+
To trigger a goal outside of an HTTP request or a valid pageview, use the overload of `TriggerGoal` that takes the GUID of the pageview.
4747

48-
Retrieve the pageview GUID in the original request using **Umbraco.Engage.Infrastructure.Analytics.Common.IPageviewGuidManager**. You will need to store this pageview GUID for later use when invoking:
48+
Retrieve the pageview GUID in the original request using `Umbraco.Engage.Infrastructure.Analytics.Common.IPageviewGuidManagerr.GetPageviewGuid()`. You will need to store this pageview GUID for later use when invoking:
4949

5050
```cs
5151
_goalService.TriggerGoal(pageviewGuid, goalId, value);

0 commit comments

Comments
 (0)