Implementation Methods

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

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

To add plugins to 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 "Optimizely Tracking" by clicking the appropriate button. The plugin configuration dialog opens.



  4. Now enter the following information:

    Parameter

    Description

    Event parameter for the variants

    Enter the parameter ID of the respective event parameter you created in Mapp Q3, for example "7".

    Event parameter for campaigns

    Enter the parameter ID of the respective event parameter you created in Mapp Q3, for example "9".

    Event parameter for audiences

    Enter the parameter ID of the respective event parameter you created in Mapp Q3, for example "8".

    Text for the control group

    Choose a text, which will be used to track the control group of an active campaign.

    Use event name for test and variant

    To better filter results if a visitor sees both versions in one visit, you can save the test and variant name as event name instead of parameters.

  5. Click [Next].



  6. In the "Assign rules" area, you define the page areas on which the measurement is to be carried out.

  7. Then click [Add plugin].

  8. Finally, click [Publish] to publish your container including the newly added Optimizely plugin.

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

For the integration of the Optimizely plugin, you need the JavaScript file "pixel-optimizely.min.js."

  1. Download the JavaScript file "pixel-optimizely.min.js".

  2. In the JavaScript file "pixel-optimizely.min.js," make the following adjustments:

    Example

    (function (window) {
        var wt_optimizelyConfig = window.wt_optimizelyConfig || {
            parameterIdCampaign: "9",
            parameterIdAudience: "8",
            parameterIdVariation: "7",
            holdbackValue: "control group",
            useVariationInActionName: false
        };
        
        /* ... */
    })(window);
    JS

    Parameter

    Description

    parameterIdVariation

    Enter the parameter ID of the respective event parameter you created in Mapp Q3, for example, "7."

    As a predefined action name the plugin automatically uses "optimizely_<<Experiment Name>>_<<Experiment ID>>."

    parameterIdCampaignEnter the parameter ID of the respective event parameter you created in Mapp Q3.
    parameterIdAudienceEnter the parameter ID of the respective event parameter you created in Mapp Q3.
    holdbackValueChoose a text, which will be used to track the control group of an active campaign.
    useVariationInActionNameTo better filter results if a visitor sees both versions in one visit, you can save the test and variant name as event name instead of parameters ("optimizly_<<Experiment Name>>_<<Experiment ID>>_<<Variation Name>>").
  3. Include the script file in your website in advance so that it provides the method "wt_optimizely" 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 (for example, "webtrekk_v4.js") or as a parameter of a page-specific pixel object.

    Example global configuration

    var webtrekkConfig = {
    	trackId: "111111111111111",
    	trackDomain: "track.webtrekk.net",
    	domain: "www.website.com",
    	executePluginFunction: "wt_optimizely"
    };
    JS
  5. Example page-specific configuration

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

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