Step 2: Configuring and Activating the Web Push Plugin

Integrate the Web Push 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.
    

3. Select Web Push by clicking the appropriate button.

    

4. Now enter the following information:

   us_emc:

   Parameter	Description
   Engage
   Service URL	Provide your Service URL: eu_l3: jamie.g.shortest-route.com/charon eu_emc: jamie.h.shortest-route.com/charon us_emc: jamie.c.shortest-route.com/charon please see this page for more information on clusters.
   Script implemented	Enable if you already use Mapp Engage Web Push functionality. You do not need to provide the xKey or additional Firebase configurations in that case.
   Engage Intelligence user matching	Disable if you do not want to share user information between Mapp Engage and Mapp Intelligence. If disabled, segment exchange in between Engage and Intelligence based on user interactions on your website will not be possible.
   xKey provided by Mapp Engage	Provide the xKey as given in your Mapp Engage Account. Please note that you only need to provide it if you are not already using the Mapp Engage Web Push script. You can find this in your Engage account on Administration > Channels > Websites > Channel Info > SDK Key.
   Firebase
   Include necessary fire scripts	Please leave this enabled if you have not yet included the necessary firebase scripts on your website.
   URL to your service worker	Please add the URL to the service worker you use for your push notifications (see Step 1: Configuration Firebase and Service Worker).
   apiKey	Please include as specified in your firebase console in project settings > general > my app > configuration.
   authDomain
   projectId
   storageBucket
   messagingSenderId
   appId
   measurementId

   Watch the following video for more details:

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 WebPush plugin.
    

Since version 3.2.x of the Mapp tracking script, the use of plugins is supported. For more information see our information on the tracking page here. A plugin is all JavaScript functions that are transferred to the Mapp pixel.

For the integration of the Web Push plugin, you need the JavaScript file "pixel-webpush.min.js."

1. Download the JavaScript file pixel-webpush.min.js.

2. In the JavaScript file make the following adjustments:
   Example

   (function() {
       var wt_webpushConfig = window.wt_webpushConfig || {
           serviceURL: 'jamie.c.shortest-route.com/charon',
           webpushScriptIncluded: false,
           useUserMatching: true,
           xKey: '<<Engage xKey>>',
           serviceWorkerScript: '/js/firebase-messaging-sw.js',
           includeFirebaseScripts: true,
           firebaseConfig: {
               apiKey: '<<Firebase apiKey>>',
               authDomain: '<<Firebase authDomain>>',
               projectId: '<<Firebase projectId>>',
               storageBucket: '<<Firebase storageBucket>>',
               messagingSenderId: '<<Firebase messagingSenderId>>',
               appId: '<<Firebase appId>>',
               measurementId: '<<Firebase measurementId>>'
           }
       };
       
       /* ... */
   })();

   Parameter	Description
   serviceURL	Provide your Service URL: eu_l3: jamie.g.shortest-route.com/charon eu_emc: jamie.h.shortest-route.com/charon us_emc: jamie.c.shortest-route.com/charon
   webpushScriptIncluded	Enable if you already use Mapp Engage Web Push functionality. You do not need to provide the xKey or additional Firebase configurations in that case.
   useUserMatching	Disable if you do not want to share user information between Mapp Engage and Mapp Intelligence. If disabled, segment exchange in between Engage and Intelligence based on user interactions on your website will not be possible.
   xKey	Provide the xKey as given in your Mapp Engage account. Please note that you only need to provide it if you are not already using the Mapp Engage Web Push script. You can find this in your Engage account on Administration > Channels > Websites > Channel Info > SDK Key.
   serviceWorkerScript	Please add the URL to the service worker you use for your push notifications (see Step 1: Configuration Firebase and Service Worker).
   includeFirebaseScripts	Please leave this enabled if you have not yet included the necessary firebase scripts on your website.
   apiKey	Please include as specified in your firebase console in project settings > general > my app > configuration.
   authDomain
   projectId
   storageBucket
   messagingSenderId
   appId
   measurementId

   Watch the following video for more details:

3. Include the script file in your website before executing any other JavaScript code related to the Mapp Intelligence tracking pixel, so that it provides the method "wt_webpush" 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_webpush"
   };

5. Example page-specific configuration

   var wt = new webtrekkV3();
   wt.contentId = "en.home";
   wt.executePluginFunction = "wt_webpush";
   wt.sendinfo();

   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.