ePrivacy and GPDR Cookie Consent by Cookie Consent Skip to main content

Tab: Personalization/ Web banners

Personalization/ Web Banners tab enables creating and setting rules to display web banners on the website. 

The web banners feature allows you to create popup banners and display them to the users of your website.

Prerequisites to work with web banners are:

  • The Meiro Events SDK is enabled on the website and the Meiro Events instance is connected to Meiro Business Explorer.
  • The feature is enabled in Meiro Business Explorer by your administrator.

Both are usually set by the Meiro team. 

 

To display web banners on the web site, it is possible to set up conditionsrules under which the banners are displayed. Currently these are conditions which can be evaluated locally in the user’s browser—e.g. the specific page the user is on, the time of day, or the content of cookies.

Name web banner

(required)

The name under which the banner will be displayed in the list of banners. This name is only visible within Personalizaiton tab/ Web banners tab.

 

Warning: depending on the reporting set for measuring web banners performance, changing of the name my influence the report  e.g. reporting may be set to track various version of web banners under various names. Since reporting is customized for each client, please contact Meiro team to check it ou

 

Conditions

(optional)

Conditions are optional rules definedthat must be fulfilled in order for whom,the whenbanner ato webbe considered for display (whether the banner will actually be displayed.displayed is then dependent on the frequency cap and priority).

 

If no conditions are set, the banner will always be considered for display and will only be limited by frequency cap and priority settings.

 

The conditions can be nested and the operators at each level of nesting set to either “and” (all conditions must be fulfilled) or “or” (at least one of the conditions must be fulfilled).

 

Browser language (all languages form a drop down list):

Possible to set: equals/ doesn’t equal/ equals any of/ doesn’t equal any of.of for all languages form a drop down list.

 

The language of the user’s browser (retrieved from window.navigator.language).

Only the first part of the language code (the two letter code as defined in ISO 639-1) is considered e.g. if the condition is set to equal “en”, the condition will be fulfilled by values “en”, “en-US”, “en-GB”.

 

 

Browser(

Possible to set: equals/ doesn’t equal/ equals for Chrome, Edge, Firefox, Safari, Opera, other): equals/ doesn’t equal/ equals. other.

 

The user’s browser as detected from the user-agent string.

 

 

Cookie:Cookie cookie

Possible to set: cookie name, date type (boolean, datetime, number, string) and/ or operator (is set/ is not set and operators relevant for data type). 

 

This condition compares the value with the contents of a cookie set in the browser under the specified cookie name.

 

Date type can be taken from SDK javascript date constructor e.g. new Date(whatever_is_the_cookie_value).

 

Note for developers: the cookie must be accessible to JavaScript code, i.e. it must not be set as “http-only”. See developers documentation for a note about data types and operators.

 

 

Datetime

(yyyy-mm-dd,

Possible hh:mm):to set: since, until, since-until.until for date in format yyyy-mm-dd, hh:mm.

 

This condition compares the time of the pageview with an absolute point in time. The evaluation doesn’t take into account the user’s timezone. At any given moment, it will evaluate the same for all users around the world.

 

In Meiro Business Explorer, input the datetime value in your own timezone.

 

Example: You have a campaign that ends on a particular day at noon of US eastern time (ET). You want to stop showing a banner when the campaign ends. You are currently using Meiro Business Explorer from Prague (CET). You select the operator “until” and input the datetime in your timezone 6 PM (which equals noon in ET). On the given day, at noon ET (6 PM your time), users all around the world will stop seeing the banner at the same time, regardless of their timezone.

 

 

Day of the weekweek 

(Monday

Possible -to Sunday),set: equals/ doesn’t equal/ equals. equals for Monday - Sunday.

This condition takes the user’s timezone into account—i.e. which day of the week it is for the user.

 

Device:Device

(

Possible to set: equals/ doesn’t equal/ equals for console, desktop, embedded, mobile, smart tv, tablet, wearable);wearable.

equals/

The doesn’tuser’s equal/device equals. as detected from the user-agent string.

 

Google Tag Manager:Manager

Possible to set: name of GTM DL object, GTM DL key, datatype (boolean, datetime, number, string), operator (is set/ is not set).

 

This condition compares the value with the contents of an entry in the GTM data layer. 

Name of GTM DL object: type in the name of the data layer object as it is instantiated in the website e.g. if your data layer object is accessed under window.dataLayer, input “dataLayer”.

 

GTM DL key: type in the key of the data entry whose value you want to compare against.

See section for developer for a note about data types and operators.

 

 

Hostname:

Possible to set: equals/ don’t equal/ equals equals. 

 

The hostname of the page, as retrieved from window.location.hostname i.e. the part of the URL address excluding the protocol prefix (“https://”) and excluding the path (the “/” after the top-level domain and any following text).

 

Hour of the day

(from

Possible 0-23):to set: equal/ doesn’t equal, until, since, since-until.until, for hours from 0-23.

This condition takes the user’s timezone into account—i.e. which hour of the day it is for the user e.g. if set to “equals 16”, this condition will pass if it’s between 16:00:00 and 16:59:59 for the user.

 

HTTP request:request 

This condition makes a request to URLthe templateprovided thatURL. returnsIf the response from the server has an OK status code (insert>= 200 and < 400), this condition passes.

 

Use values from cookiecookies orand local storage,storage cookie:in the HTTP request by including placeholders in the URL in the format {{cookie:some_cookie_name}my_cookie_name}}, storage:for cookie values and {{ls:some_storage_key}my_ls_key}} for local storage.

 

Note for developers: The values from cookies/local storage are encoded using the JavaScript function encodeURIComponent() before being inserted into the URL.

 

Example: On the page you have a cookie with the name “last_order_id” and value “123”, and local storage item with the key “user_email” and value “user@example.com”. Type in the URL “https://my-api.com/orders/{{cookie:last_order_id}}?email={{ls:user_email}}”. The Meiro Events SDK will make a request to https://my-api.com/orders/123?email=user%40example.com. If the response returns OK, this condition will pass.

 

Local storage:storage

Possbile to set: local storage key, data type (boolean, string, number, datetime), operator (is set/ is not set). 

 

This condition compares the value with the contents of a local storage item set in the browser under the specified key.

 

Date type can be taken from SDK javascript date constructor e.g. new Date(whatever_is_the_cookie_value).

 

See section for developers for a note about data types and operators.

 

Operating system (

Possible to set: equals/ doesn’t equal/ equals for Android, iOS, MacOS, Windows, others): equals/ doesn’t equal/ equals.others.  

The user’s operating system as detected from the user-agent string.

 

Page title:title

Possible to set: is set, is not set, equals/ doesn’t equal/ equals any of / doesn’t equal any of, contain/ doesn’t contain.

The page title (retrieved from document.title).

  

Pathname

The pathname of the page, as retrieved from window.location.pathname i.e. the part of the URL address including the “/” after the top-level domain and any following text, but excluding the query, the part of the URL starting with “?”, if there is any.

 

Referrer

Possible to set: is set, is not set, equals/ doesn’t equal/ equals any of / doesn’t equal any of, contain/ doesn’t contain.

The value of the “referrer” part of the query in the URL address.

 

URL

Possible to set: is set, is not set, equals/ doesn’t equal/ equals any of / doesn’t equal any of, contain/ doesn’t contain.

The entire URL address of the page the user is on (retrieved from window.location.href).

 

 

UTM campaign, UTM medium, UTM source

Possible to set: is set, is not set, equals/ doesn’t equal/ equals any of / doesn’t equal any of, contain/ doesn’t contain.

 

Pathname,The Referrer, URL, UTM campaign, UTM medium, UTM source :  is set, is not set, equals/ doesn’t equal/ equals anyvalue of the “utm_campaign”/ doesn’t“utm_medium”/ equal“utm_source” anypart of,of contain/the doesn’tquery contain.in the URL address.

 

Remember: strings are  converted to lowercase.  When evaluating conditions which compare strings of text, all strings are compared as case insensitive.

Enter datetime in your local timezone. It will be automatically converted to the customer's timezone. 

 

Frequency cap (optional)

The maximum number of times the banner will be shown to a particular user per a rolling 24 hour period. If the banner has been shown to this user this number of times in the past 24 hours, the banner will not be selected as a candidate for display.. 

 

Coming soon:

  • frequency cap per user for choosen hour/ day/ session,
  • frequency cap per user in total,
  • frequency cap per web banner in total to all users. 
Position (required)

The position where the banner will be located on the page: top left, top right, middle, bottom left, bottom right. 

 

For the position “middle”, the page will be covered with a semi-transparent overlay and the banner will be displayed on top of the overlay. If the user clicks anywhere outside of the banner, this will close the banner.

 

For the other positions, the banner will be displayed without an overlay and can only be closed by clicking the close button in the banner. These banners will be offset from the edge of the window by a 20-pixel gap.

 

 

Frequency cap (optional)

Define how many times per 24 hours, per user web banner will be displayed. 

 

Coming soon:

  • frequency cap per user for choosen hour/ day/ session,
  • frequency cap per user in total,
  • frequency cap per web banner in total to all users. 

Priority (required)

It is a number that defines priority for a display of a web bannerbanner. (fromPriority 0-can be set to a whole number between -10 and +10, where -10 is the lowest priority and +10 is the highest. 0 is the default priority.

 

The Meiro will only show one banner at a time to a user.

 

If there are multiple banners for which the display conditions are fulfilled, the banner with the highest priority). 

Higher priority web banners will be displayed first, displayed.


 

If 2 webmultiple banners have their conditions fulfilled and have the same conditions, same priority, both did not reach frequency cap, then the onebanner withwhich ahas lowerbeen shown to this user the least number of impressionstimes in the past 24 hours will be shownselected.

first

 

(if the number of impressions is the same, then the choice is random).

 

HTML/ Image

(required)

InsertThere htmlare fortwo types of banners: image banners and HTML banners.

 

Image 

Image banners consist entirely of the specified image. After clicking on the web banners the user is directed to the specified destination URL (the new page will open in the same window as the current page).

The banner has a webclose button in the top right corner automatically included.

The dimensions of the image banner orare the same as the dimensions of the specified image, but they are scaled down if the window is too small:

-On mobile phones, the image is scaled down to fit the window, leaving a 20-pixel gap from each edge.

-On other devices, the image is scaled down so that the width is at most 50 % of the window width and the height at most 50 % of the window height.

-Aspect ratio is always preserved.

 

Image URL: The URL toof the image that will make up the banner.

Destination URL: The URL that the user will be showntaken asto aafter webclicking on the banner.

 

Image

Image URL: URL of an image that will be displayed (remember web banner add automatically close button.

Destination URL: that customer will be directed to when clicking on the web banner image.

Size of the web banner in this case will be as image size, but maximum ½ of a website. 

 

HtmlHTML

ItFor isHTML possiblebanners, tocontent insertof customerthe html,banner withand height,the width e.g. it is possible to set Mailchimp html, or custom html (for which custom Meiro Event eventdimensions needs to be set)specified manually (see the section for developers for technical details about how the banners are included into the page).

 

 

RememberHtml:: The source code for the webbanner. The maximum length of the HTML code is 100 000 characters.

See the section for developers for technical details about how the banners are included into the page. 

 

Width in pixels and height in pixels

The dimensions of the banner. If the window is too small, the banner willis includeautomatically scaled down to fit the window leaving at least a 20-pixel gap from each edge (aspect ratio is not preserved).

 

Enable close button

(x

When enabled, the banner is displayed including the default close button in the top right corner).corner. ItIf isdisabled, visiblethis onenables the previewdeveloper ofto include their own close button. The Meiro SDK provides a method that can be called by this close button to close the webbanner banner.(see the section for developers for more details)