The plugin is available in Tag Integration. Alternatively, you can integrate it in the standard pixel as a separate JavaScript file.

Integrate the Scroll Position plugin into the container in which the webpage to be measured is located.

To add plugins the desired container, proceed as follows:

  1. In the container overview, select the required container by clicking the corresponding entry.
  2. Click Add Plugin. You will be forwarded to the overview of all available plugins.
  3. Select Scroll position plugin by clicking the appropriate button. The plugin configuration dialog opens.
  4. Now enter the following information:

    ParameterDescription
    Scroll position (Figure)

    By default, the scroll position is sent with a predefined event parameter. This parameter is configured as 'text' and cannot be changed (see chapter Creating Event Parameters.)

    To use further analyses, you can additionally send the scroll position in a parameter configured as 'figure' (custom event parameter).

    Page heightEnter the parameter ID of the custom event parameter with which you want to send the absolute height of the webpage.
    Round up scroll positionActivate this option to round up the percentage scroll position to full fives.
  5. In the Assign rules area, you define the page areas on which the measurement is to be carried out.
  6. Click Add plugin.
  7. Finally, click Publish to publish your container including the newly added Scroll Position plugin.

Since version 3.2.x of the Mapp Intelligence tracking script, the use of plugins is supported. A plugin is all JavaScript functions that are transferred to the Mapp Intelligence pixel.

For the integration of the Scroll Position plugin, you need the JavaScript file webtrekk_scrollposition.min.js.

  1. Download the JavaScript file webtrekk_scrollposition.min.js from the download area.
  2. In the JavaScript file webtrekk_scrollposition.min.js, make the following adjustments:
    Example

    window.wt_scrollposition = function(conf) {
    	if (conf.mode === "page" && conf.type === "after" && conf.requestCounter === 1) {
    		var scrollPositionConfig = {
    			parameterConfiguration: {
        			sendAsFigure: "6",
        			pageHeight: "7"
       			},
       			roundResult: true
      		};
      		// ...
     	}
    };
    JS
    ParametersDescription
    sendAsFigure

    By default, the scroll position is sent with a predefined event parameter. This parameter is configured as 'text' and cannot be changed (see chapter Creating Event Parameters.)

    To use further analyses, you can additionally send the scroll position in a parameter configured as 'figure' (custom event parameter).

    pageHeightEnter the parameter ID of the custom event parameter with which you want to send the absolute height of the webpage.
    roundResult

    true = The percentage scroll position is rounded up to full fives.

    false = To get more accurate results, deselect this option.

  3. Store the function wt_scrollposition or the script file globally so that it can be found under the object "window".

  4. The parameter executePluginFunction is used for the activation itself. This can be set either in the configuration variable (webtrekkConfig) in the global pixel file ("webtrekk_v3.js") or as a parameter of a page-specific pixel object.

    Example Global Configuration

    var wt = new webtrekkV3();
    wt.contentId = "de.startseite";
    wt.executePluginFunction = "wt_scrollposition";
    wt.sendinfo();
    JS


    Example page-specific Confguration

    var webtrekkConfig = {
     	trackId: "111111111111111",
     	trackDomain: "track.webtrekk.net",
     	domain: "www.website.com",
     	executePluginFunction: "wt_scrollposition"
    };
    JS


    If you want to measure the data on all your pages, we recommend the global integration. The page-specific configuration is used for the measurement of individual pages.