Using the wrapper, virtual page views can be measured even without explicitly calling up a web page. In this way, single page applications (SPAs) can also be measured in a differentiated manner, i.e. websites that load a single HTML page and update it dynamically without reloading it.
Installing the wrapper
<script>
function testCall(){
if(typeof(_etracker) === 'object') {
et_eC_Wrapper({et_et: 'ACCOUNTKEY', et_pagename: 'pagename', et_areas: 'area1/area2/area3', et_seg1: 'own segment 1'});
}
}
</script>
To avoid that the call of the wrapper function by possibly blocked etracker code (e.g. by excluding it from the count) leads to a JavaScript error, the presence of the etracker object is first checked with typeof.
Parameters of the wrapper
The first parameter ‘et_et’ for the account key is a mandatory parameter. All other parameters are optional:
Variable | Type | Importance | Description |
---|---|---|---|
et_pagename | String | Page name | Unique name of the page. |
et_areas | String | Area name | Designation of the page area. |
et_tval | Float | Total order value | Order status for sales targets: 0 = Lead 1 = Sale 2 = Full reversal |
et_tonr | String | Order number | Distinct order number (without commas or semicolons) |
et_tsale | Integer | Order status | Order status for sales targets: 0 = Lead 1 = Sale 2 = Full reversal |
et_basket | String | Shopping basket | Parameter provided by the shop system for assigning basket items (ArtNr,ArtName,ArtGroup,Number,Price) |
cc_attributes | String | Campaign attributes | Attribute name and attribute value for campaigns |
et_seg1 | String | Own segment | Content of the own segment |
If the optional parameters are not explicitly set, the values that were transmitted to etracker during the last page load are used. The values can be transmitted via the standard tracking code when the page is called up in the browser or via the wrapper when the page is loaded dynamically.
The following call generates the same data as the original call via the standard tracking code:
<script>
if(typeof(_etracker) === 'object') {
et_eC_Wrapper({et_et: 'ACCOUNTKEY'});
}
</script>
Example of a complete call:
<script>
if(typeof(_etracker) === 'object') {
et_eC_Wrapper(
{
et_et: 'ACCOUNTKEY',
et_pagename:'search results',
et_areas: 'EN/search',
cc_attributes:{etcc_cu:'onsite',etcc_med_onsite:'Internal search',etcc_cmp_onsite:'With result',etcc_st_onsite:'Boots'},
et_seg1: 'logged in',
et_seg2: 'B2B'
}
);
}
</script>
General notes on the wrapper function
Capture of events in interaction with the wrapper:
If events are transmitted to etracker as part of etracker event tracking, they are assigned to the page name that was last transmitted to etracker before the event was triggered. If, for example, a page request was first triggered using the wrapper and an event was tracked thereafter, the event is assigned in the evaluation to the page name that was transmitted to etracker with the wrapper.
Capture of URLs in interaction with the wrapper:
No URL can be transmitted to etracker by using the wrapper function. When using the wrapper function etracker always assigns the page views to the URL that is stored in the document.location.href property.
Notes for the use of the wrapper with Single Page Applications (SPAs)
A unique URL is not available for the evaluation of SPAs. In order to nevertheless ensure a clear evaluation of the individual contents, special care should be taken to make sure that each virtual page is given a unique page name that can be easily traced in the evaluation.
If this is not possible due to the large amount of content or for other reasons, we recommend that you do not use speaking page names, but instead transmit virtual page paths to etracker via et_pagename.