On-site Messaging

Introduction to On-site Messaging:

On-site Messaging enables MoEngage end users to show PopUps, Banners and other such messages on your website. With MoEngage On-site Messaging, create highly contextual campaigns for your website visitors (both Anonymous and Logged In users)

Integration Essentials for On-site Messaging:

We have launched this product in closed beta on 19th Nov '18. To signup for On-site Messaging, you need to get it enabled for your MoEngage account. To do so, reach out to your customer success manager or send an email to support@moengage.com with your account name.

Ensure that you are on default billing plan of MoEngage so that you can target all your website visitors (ones who subscribed for push and ones who did not)  

Where to find On-site Messaging on MoEngage Dashboard:

Once On-site Messaging is enabled for your MoEngage account, you would be able to see this module on the dashboard -

Campaign Creation

From left side menu bar, Navigate to:  Campaign -> Create Campaign -> Onsite Messaging -> Create On-site Messaging Campaign




Campaign Listing:

Navigate to: Campaigns -> All Campaigns Page 

On the All Campaigns Page, search for campaign type - "On-site Messaging" 


How to create an On-site Messaging Campaign?

After you click the CREATE button for On-site Messaging (Create Campaign -> Onsite Messaging -> On-site Messaging -> CREATE), follow the below steps -

Template Selection

Before you start configuring the campaign, select the type of template you want to use which you can customize completely using our HTML Editor (available on Step-2 of campaign creation).

As of now, we have 3 basic pre-defined templates available - 

1. Simple Image PopUp

2. Image PopUp with CTA (Single Button)

3. Top Banner 

These templates can be customized using our editor on Step-2 of campaign creation.

In addition to the above templates, you can also upload your own templates and configure those further during campaign creation.


Step-1: Segmentation

On the first step, you need to define the below fields -

Campaign Name:

Specify a unique campaign name which has a length between 5-50 characters. 


Specify the platforms between web and mobile web which you want to target for this on-site messaging campaign.



Select Trigger Action:

Select the trigger action based on which the campaign will be triggered for your users.

  • Page Load: There are 3 additional options here - 
     - As soon as possible : Choose this option if you want to trigger the message as soon as the user has completed page load on your website
     - With a delay of __ sec : Choose this option if you want to trigger the message, 30 seconds after the user has completed page load on your website
     - After scrolling the page by __ % : Choose this option if you want to trigger the message
    after the user has scrolled a page on your website by 40%.

  • Custom Event: Choose this option if you want to trigger the message when the user executes a custom event you have tracked on MoEngage. Select a custom event which the user executes on your website. You can also specify additional attribute checks for trigger a message when user executes an event.
    For example. Trigger a message after the user has executed Purchase where "Brand" is "Brand1"


  • Exit Intent (Web Platform only): Choose this option if you want to trigger a message when the user is trying to exit your website. We detect exit intent by monitoring the pointer on the website. As soon as the pointer moves out of the browser window, we detect this action as an exit intent and show the campaigns which are created with Trigger Action : Exit Intent. 

Select Audience:

Select the users who should be included in this segment. There are 2 ways to go about it  

  • All Users: Select this option if you want to target all users of your website via this campaign. This option also needs to be selected in case you want to deliver content to first time visitors.
  • Custom Filters: Select this option if you want to target specific visitors. You can choose custom filters to define your audience based on User Behavior, User Properties or Custom Segments (pre-defined segments)


Once you have defined the above fields on Step-1 of campaign creation, please click NEXT to move to Step-2


Step-2: Create View

On the second step, you need to configure the Template or upload you own template (based on the selection on Template Selection Screen before Step-1)

Customize Template Template:

We have used standard HTML editor to support Template customization in our campaign creation.


Few things to note while creating campaigns or using your own HTML templates - 

- For close button: Add this CSS class in your templates:   moe-inapp-close
Adding this class is very essential if you want the user to be able to close the template. MoEngage SDK will only close the template if this class is found.

Please note that the template will be closed only basis the moe-inapp-close CSS class. Please do not use custom Javascript functions for closing the templates as it will result in an inconsistent behavior.

- For tracking clicks : Add this CSS class in your template:  moe-inapp-click
Adding this class is very essential for MoEngage to be able to track clicks and attribute this to a particular campaign.

- For closing the template when the user clicks on a CTA or a link, add both the classes: moe-inapp-close and moe-inapp-click to the HTML template. This will ensure that the template is closed after the user is redirected to the URL.

Display Settings

If you have a requirement to show the message only on certain web pages, you can define this in the Display Settings.

For example, you want to show a particular campaign only on the product pages, you can make a similar selection like below -


Test Campaign

To test how the message will be rendered on your website, enter the destination URL where you have already integrated the 

We recommend you to test every new campaign on your destination URL so that you can ensure the look and feed of the template. By default test campaigns override Display Settings and Delivery Controls.



Step-3: Scheduling

On the third step of campaign creation, you need to define the campaign scheduling, conversion goals, priority and delivery controls which will be useful for campaign sending. Here is how to configure these fields-

Campaign Timing:

Define the campaign Start and End time of this campaign. Outside these bounds, the campaign will be inactive and will not be served to your website users.



Conversion Goals:

Define the conversion goal for your campaigns which will help evaluate the performance of your campaigns. Conversion Tracking works in the same way as other campaign types on MoEngage dashboard.
You can define up to 5 different conversion goals for a single campaign.

Campaign Priority:

Define the priority of your campaign. This priority will be used in case there are multiple campaigns eligible for the same user.

Campaign priority can be useful when you want to overwrite existing campaigns with more high priority campaigns (during sale time or for important announcements etc.)



Delivery Controls:

Delivery Controls are used to control the delivery of messages. It is important that restrictions are put while delivery on-site messaging so as to avoid spammy behavior which results in the same message being shown constantly to the same users.

We have below 4 controls in place to handle this -

Maximum times to show the message ever- Define the maximum number of times, the user can see a message from this campaign in case 

Minimum delay between 2 messages of this campaign - Define the minimum time within which the user will not be shown this message even if the user qualifies for the campaign segment and executes the trigger action.

Ignore global delay between 2 On-site Messaging campaigns - Chose this option if you want this campaign to override the global delay restriction.

Global Delay: This is a global settings which is enforced on all On-site Messaging campaigns. If you have defined Global Delay as 15 minutes then it means that only 1 On-site Messaging campaign can be shown within 15 minutes. You can define time for the Global Delay here

Auto dismiss message after - Choose this option if you want the message to disappear automatically after 60 seconds.


Turning OFF Delivery Controls will ensure that this campaign is shown every time the user is eligible for the campaign - falls in the segment, satisfies the display settings and executes the trigger action.

Was this article helpful?
8 out of 8 found this helpful