Managing Banners, Assets, and Campaigns

Merchandising banners, assets and campaigns

You can display banners/assets on search results pages. For example, Lydia is a shopper at an apparel site. She enters a search for a rockabilly style dress. Her search results include a banner at the top of the page for the brand, Rockabilly Grace.

To display banners/assets, you need to define some rules. These rules define when to display a banner or asset, which banner or asset to display, and the banner's or asset's hotspot links.  

At a high-level, there are a few steps for displaying a banner/asset:

  1. Create a banner/asset.
  2. Create a campaign for the banner/asset.

You use a campaign to trigger your banner/asset. A campaign is associated with a banner/asset and runs for a specific time period. You configure the campaign to display the banner/asset when triggered by keyword searches or category browse.

Create an Asset

A banner consists of an image and has hotspots associated with it. A hotspot link is a link embedded in the banner that opens to particular URL when your customer clicks that spot.

To create an asset,

  1. Open the Merchandising page, then click the Campaigns & Assets tab.


Need help? 

Merchandising → Campaigns & Assets

  • Merchandising is in the top menu bar.
  • Campaigns & Assets is in the left menu.
  1. Click on Assets.

  2. Click on the Add Asset button.

  3. Upload your banner or asset and select the Asset Type in the dropdown menu. You can upload an image file, an image URL, plain text or rich text HTML.

Once you save your asset, you will see a preview of your banner so you can make sure it looks the way you want it.


Please note that your team must consume the API response for each Asset Type you'd like to use. For ease of accessibility, we recommend your team to consume all three Asset Type responses (Image, Plain Text and HTML).

  1. Give your asset a name in the Asset Name text field. 

  2. To add hotspots (note: you can only add hotspots to images).

  3. Click part of the image in the Preview section, and draw a box with your mouse (you must drag from top left to bottom right).
    This area is for your first hotspot link.

  4. Enter values in the following fields to define your hotspot link:

  • ID (default) — The unique identifier for the hotspot.
  • URL — The URL to open to when a site visitor clicks the hotspot area.
  • Title — The name of the hot link.
  • Alt — The text to display when a site visitor hovers over the hotspot.
  1. Continue creating hotspot links until you're finished.

What are the image size requirements for a banner?

There is no image size requirement. We return the image as uploaded. Your web development team renders the image on your site. Typically, organizations have a particular size or set of sizes that work with their page templates. You can ask your web development team or a similar group for this information, but this information is generally not useful after Bloomreach is integrated on your site.

If you're testing banners/assets for the first time, then we recommend that you run your test in a staging environment. These tests are usually done during the integration process. Your integration team can upload various image sizes to see what works best for your site before you, as a business user, configure banners/assets and campaigns in the Bloomreach dashboard.

What types of image files can I use for a banner?

You can use any of the following types of image files:

  • GIF
  • Animated GIF
  • JPG
  • PNG
  • BMP

Create a Campaign

To create a campaign,

1. Open the Merchandising page, then click the Campaigns & Assets tab. By default, the Campaigns tab is already open.


Need help? 

Merchandising  Campaigns & Assets

  • Merchandising is in the top menu bar.
  • Campaigns & Assets is in the left menu.

2. Click the Add New Campaign button.


3. Give your campaign a name in the Campaign Name text field. 

4. Select the asset that you want to use from the Select Asset dropdown menu.


5. Set Campaign Details by entering the following:

  • Specify if the campaign is for a Category or a Site Search term by selecting the radio dial.
  • Enter the Category or Site Search term in the text field.
  • Select the Audience you would like to target for this Campaign.
  • Set the time period that this campaign is active in the Duration field.


Creating multiple keyword or category values per campaign

To trigger an asset for multiple keywords, click on the Site Search radio dial and type in one keyword, hit Return and then type another keyword. 
You can trigger a multi-value campaign for categories as well. Click on the Category radio dial, type in the category, hit Return and then type another category name.

For example, you can enter dress and rockabilly dress in the Keyword field.

  1. Click the Save button to finish creating or modifying your campaign. 

Can multiple campaigns be associated with the same Search term ?

Exact term match does not allow a rule to be saved. However, if the overlap of search terms is not complete between 2 rules, they can be saved. We allow saving the campaigns on scope basis. Scope is defined as Queries + Audience + Duration.

For example:

When you try saving 2 campaigns with some sets in common.

Campaign 1 (C1): Tuthill & Fill-Rite Brand - Carousel - Banner - SRC

Campaign 2 (C2): Fill-Rite Brand - Carousel - Banner - SRC

Here, C1 and C2 have different scope because the query set is not the same.

Actually C2 is a subset of C1. Ideally one shouldn't be creating campaign 2 as its search terms are already present in Campaign 1. Hence, we always recommend planning your campaign set-up first.

For overlap search term, which is 'Fill-Rite' in above scenario , which Campaign will be returned and take effect?

There is always one campaign returned in api call as we don't have multi campaigns support for the same search term. Hence, on the API we should see the last updated campaign rule so the last updated rule will get applied.