--- title: "Step 2: Configuring and Activating the Web Push Plugin" slug: "step-2-configuring-and-activating-the-web-push-plugin" updated: 2025-05-12T11:23:14Z published: 2025-05-12T11:23:14Z canonical: "docs.mapp.com/step-2-configuring-and-activating-the-web-push-plugin" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.mapp.com/llms.txt > Use this file to discover all available pages before exploring further. # Step 2: Configuring and Activating the Web Push Plugin ## 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 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**. ![image2021-5-21_11-35-0.png](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/4beb0a40-622a-47e5-b6ba-b1715143e742.png) 3. Select **Web Push** by clicking the appropriate button. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/2c049a70-fa9a-4c3e-a699-f600068b6a45.png) 4. Now enter the following information: | Parameter | Description | | --- | --- | | **Engage** | | | Service URL | Provide your Service URL: - **eu_nbg:** jamie.g.shortest-route.com/charon - **eu_muc:** jamie.h.shortest-route.com/charon - **us_muc:** jamie.c.shortest-route.com/charon please see [this page](/v1/docs/mapp-engage-clusters-and-time-zones) 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](/v1/docs/web-push-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: [webpush1-ti.mp4](https://player.vimeo.com/video/637812682?h=ead854b2ae&badge=0&autopause=0&player_id=0&app_id=58479) 5. Click **Next**. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/0980cfb3-3580-4713-a364-e9f8814b5d32.png) 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. ![](https://cdn.document360.io/554b9b98-6720-4d8b-9919-c7b203d72648/Images/Documentation/04da814d-5332-46a0-8210-d21ea17bc36b.png) 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](/v1/docs/tracking-integration). 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](/v1/docs/web-push-technical-requirements-and-download). 2. In the JavaScript file make the following adjustments: **Example** ```javascript (function() {    var wt_webpushConfig = window.wt_webpushConfig || {        serviceURL: 'jamie.c.shortest-route.com/charon',        webpushScriptIncluded: false,        useUserMatching: true,        xKey: '<>',        serviceWorkerScript: '/js/firebase-messaging-sw.js',        includeFirebaseScripts: true,        firebaseConfig: {            apiKey: '<>',            authDomain: '<>',            projectId: '<>',            storageBucket: '<>',            messagingSenderId: '<>',            appId: '<>',            measurementId: '<>'        }    };        /* ... */ })(); ``` | Parameter | Description | | --- | --- | | serviceURL | Provide your Service URL: - **eu_nbg:** jamie.g.shortest-route.com/charon - **eu_muc:** jamie.h.shortest-route.com/charon - **us_muc:** 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](/v1/docs/web-push-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: [webpush1](https://player.vimeo.com/video/637767117?h=038e4af0d9&badge=0&autopause=0&player_id=0&app_id=58479) 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** ```javascript var webtrekkConfig = { trackId: "111111111111111", trackDomain: "track.webtrekk.net", domain: "www.website.com", executePluginFunction: "wt_webpush" }; ``` 5. **Example page-specific configuration** ```javascript 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.