# How banners work

> What a banner and a banner block are, how they are served on a page, who sees them, when they stop showing, and how impressions, clicks, conversions and purchases are counted.

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](https://releva.ai/documentation/guides/banner-blocks/show-a-banner-on-your-site/) and [Choose who sees a banner](https://releva.ai/documentation/guides/banner-blocks/choose-who-sees-a-banner/).

## Pages, blocks and priority

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.

## Who sees a banner

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](https://releva.ai/documentation/learn/segments/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.                                                |

## When a block is served

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.

## Display modes

| 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 versus Show until click

* **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.

## What is counted

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.

## Editing, copying and deleting

* 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.

## Next steps

* [Show a banner on your site](https://releva.ai/documentation/guides/banner-blocks/show-a-banner-on-your-site/): Place a banner on your shop, switch it on and read its numbers.
* [Choose who sees a banner](https://releva.ai/documentation/guides/banner-blocks/choose-who-sees-a-banner/): Show a banner to one segment until they click.
* [Banners in the SDK](https://releva.ai/documentation/reference/sdk/endpoints-the-releva-sdks-call/#banners-in-the-push-response): Render banners yourself from the page push response.
* [How stories work](https://releva.ai/documentation/learn/stories/how-stories-work/): Compare banners with tap-through stories on the same pages.