Skip to content

Area: User guide

How banners work

Releva shows on-site messages in two parts. A banner (under Marketing Channels › Banners) is the content and the audience: the design you build in the Releva builder (or your own HTML), the segment that sees it, and the show-until-click and date rules. A banner block (under Personalization › Banner Blocks) puts one banner on one Personalization page and decides how it appears: static in the page, pop-up, flyout or bar, with a trigger, a URL filter, locales, a session interval and styling. One banner can be used by several blocks on several pages. For the clicks, see Show a banner on your site and Choose who sees a banner.

A Personalization page is matched by its Token or by its URL Path when the Releva snippet on your shop pushes a page view. Pages are shared with product blocks and stories. Every block belongs to one page; create a page under New Page and set its path under Page Settings (the path, not the full URL, and without a trailing slash).

Blocks on a page are ordered by priority. Drag a card to reorder; a new block is added at the bottom. Max Banners Displayed in Page Settings caps how many matching blocks are served on one page load, taken from the top of the order. Leave it empty for no limit.

The audience is set on the banner’s Audience tab:

Setting What it does
Behavioral segment (required) The segment that defines the audience. Behavior segments are recalculated continuously and are not real time (How segments work).
Action: Show / Hide Show serves the banner to the segment’s members. Hide serves it to everyone except them.
Profile filter (optional) A second segment evaluated in real time from the profile’s current attributes.
And / Or Whether a visitor must match both segments or either one.
Show always / Show until click Whether the banner keeps coming back after a click or close (see below).
Show when A start and end date and time, in your local time. A banner past its end shows Expired on its card and on the cards of its blocks.

A page push returns a banner block only when all of these hold:

Rule Where you set it
The block is switched on. New blocks are saved switched off. Banner Blocks list
The block has a banner, and the visitor matches the banner’s audience. Banner Audience tab
The page URL passes the block’s URL filter, if it is on. URL contains keeps URLs that contain one of the pieces you entered (separate several with |); URL doesn’t contain drops URLs that contain one. Block Display Configuration tab
With Show until click: this device has not clicked or closed the banner yet, or the cooldown has passed. Banner Audience tab
Now is inside Show when, if set. Banner Audience tab
The shop language is in Locales to Display, or the list is empty. Block Display Configuration tab
Session Interval is empty, or the visitor’s session number divides by it (2 means every second session). Block Display Configuration tab
The visitor is not a bot, and is not in the control group of a running A/B test. automatic
If your page tag sends block tags, the block carries one of them. Block Tags on the Content tab

Then Max Banners Displayed is applied. Everything up to here happens on Releva’s side. The storefront receives the surviving blocks with their HTML already personalised (merge tags filled from the profile) and decides when to show each one from the block’s Trigger: Show immediately, On scrolling down N% of page, After N seconds on the page, On leave intent (optionally Also trigger on mobile Back button), Added to Wishlist or Added to Cart. A Static block has no trigger and shows at once.

Mode Where it appears Extra settings
Static Inserted into the page at the element you name in CSS Selector, with Insert strategy Before, Beginning of, End of, After or Replace. Always visible. Position on my site opens your shop to pick the selector visually (saved blocks only).
Pop-up A lightbox in the centre of the page over a dimmed background. Placement, overlay colour, card, close button
Flyout Slides into a corner. Placement, card, close button
Bar A full-width strip at the top or the bottom. Placement, card height, close button
Custom Your own integration places and styles it; Releva only sends the HTML and settings.

Styling on the Appearance tab (placement, offsets, card, close button, Custom css) is applied on your website. The mobile app SDKs draw the card themselves and ignore the close-button symbol, padding, font weight, line height and top/right position. Changing any styling field turns advanced styling on for the block; Reset to the standard look turns it off again and clears the custom CSS. Every saved block has an id selector of the form #rlv-banner-<token>-modal for custom CSS.

  • Show always: the banner is offered on every qualifying page load.
  • Show until click: once the visitor clicks a link in the banner or closes it, Releva remembers that for the device and stops serving the banner. With Never show again to this user the memory lasts 365 days. With Show again after cooldown it lasts the day(s) and hour(s) after last entry you enter, added together, and then the banner is offered again.

The memory is per device and per banner, not per profile or per block: the same person on another device sees the banner again, and a click on one block hides the banner in every block that uses it.

Links in the banner’s HTML are rewritten before they are sent: every trackable link gets an rlv_bid parameter with the block’s token, so that a visit that starts from the banner, and the cart adds and orders that follow, can be attributed to the block. Links to another host also get an rlv_u parameter so the visitor stays identified.

Visitor action Event Shown as
The banner is displayed bannerImpression Impressions
The visitor closes it bannerClose Closes
The visitor clicks a link in it bannerClick Clicks
A cart add after a click your shop’s cart-add action Conversions
An order after a click your shop’s purchase action Purchases, and its value as Revenue

Only a click attributes the visitor to the banner. Impressions and closes do not, so a banner nobody clicks has no conversions however many people see it. A click is reported twice by design, once from the page the banner was on and once by the landing on the rlv_bid link; Releva counts it once. A click or a close also sets the Show until click memory.

The numbers appear in three places:

  • The block card under Personalization › Banner Blocks (period button, last 7 days by default): Page Views of the page, then Impressions as a share of page views, Closes, Clicks as shares of impressions, Conversions as a share of clicks, Purchases as a share of conversions, and Revenue in the shop currency. The Statistics button opens the block’s Statistics page for the chosen period.
  • The banner card under Marketing Channels › Banners (last 30 days by default): the same metrics without page views, summed over every block that uses the banner.
  • Export on either list downloads the metrics as a file.
  • A banner block opens with Save, Save & Close, Delete and Make a copy on every tab. Make a copy asks for the target Page and creates “<name> Copy” there, switched off. Delete asks Are you sure? and removes the block; its past events stay in your event data.
  • A banner opens with Save, Delete and Make a copy. Make a copy opens a new banner named “Copy of <name>” that you edit and save. Deleting a banner also deletes every banner block that uses it.
  • A banner that holds an Order status block is saved as a post-purchase banner, for your order status page; any other banner is a standard banner. Post-purchase banners are a separate feature and are not covered here.
  • New banners open in the Releva builder. A banner made before it keeps its editor until you select Convert to Releva builder. Switch to HTML moves a banner to the HTML editor for good.