Setting up Category Specific Recommendations for Specific Pages

First, go into the Inactive Campaigns section within Bunting and create a new set of Product Recommendations by going to Create New Campaign. Then, select From Scratch which will take you to the visitor targeting step.

From here you can target a specific URL, for example, a specific promotion you are running on a type of product.

This can be done by opening up the visitor targeting and selecting current URL. Then you can paste the URL.

Ensure that the rule for this is set to Equal To. In addition to this, you can add any other visitor targeting metrics to this.

Once this has been done, select On To Next Step button on the right-hand side under your targeting rules.

For adding the product recommendations, using Bunting’s built-in templates you can select Product Recommendations. You’ll then get sent to Bunting’s visual editor and will be prompted to place them within the page.

Click the navigation prompt at the top to change the page displayed, “Click here to change web address in editor” and enter your URL and the visual editor will load that page.

You are now ready to place the recommendations.

In this instance, we will choose to place the recommendations below the campaign information but the position they are placed on the page is entirely up to you. Ideally, they should be placed as high up the fold of the page as possible.

Now they have been inserted, click on the Settings cog on the top right-hand corner of the visual editor and select Settings for Recommendations. From here, as well as being able to style your recommendations, you can filter what recommendations are shown.

To do this, Go to Content of Recommendations then Filters. From here you can filter the products shown in the recommendations by Category.

You can search through this list and add as many or as few categories to the filter as you require.

This guide can easily be applied to display recommendations of products of the same category of the page being viewed. This is great for scenarios where you have a large catalog of products and want to show the user alternatives to the product they are viewing.
All you have to do is change the URL visitor targeting rule to be Is Viewing a Product page and on the filters section, change it to use our special filtering rule of Category of the product / category page being viewed.

This could easily be transferred to other scenarios that require filtering of product recommendations for specific pages. That is all you need to show category-specific recommendations on specific URLs to help your campaigns.

How to create email widgets to integrate with your mailing platform campaigns

Want to add personalized recommendations to your existing mail application? Not a problem. This step-by-step guide will give you everything that you need to know to add recommendations to your campaign.

To get to the email widget tool we will start from the website monitor dashboard which is underneath where you would usually go to set up your campaigns. Select Email Widgets. This will then take you to a screen where you can check if your email marketing tool is listed on the featured integrations. If not, don’t worry! Bunting integrates seamlessly with many email marketing tools to provide personalized recommendations to your marketing campaigns with ease. Next click Create Widget to get started.


Above is a step by step guide of what to do to set up your advanced email widgets with everything from Click Through Parameters to an optional setting of Stripping all other parameters from the URL.

However, if you want to keep it simple with just adding the recommendation widget content that’s fine, too! Just select the option that you want to be sent to your audience and select your Email Marketing Tool.

Next, you can style your recommendations using the Widget Designer and the preview of your recommendations at the bottom of the page.

Once you are happy with the styling of your recommendations click Save Changes. On the next screen you will see the recommendation widget code; all you need to do is select all of the code and copy it. Find the relevant email campaign within your email tool and paste it into a code or html editor.


In the example above we are using MailChimp, but the implementation is similar across most email platforms. Save this within your email editor and you are done. You now have an email campaign from your provider with added personalized recommendations!


How to setup visitor targeting?

Do you have an idea for a Campaign that requires specific targeting constraints? 👨‍👩‍👦‍👦

Why not check out the Visitor Targeting section for your campaign. Here there are an extensive amount of conditions which can be added together to create rules. These rules are a criteria of statements that must be true in order for Campaign to be shown.

Let’s go through a few examples. There a few common scenarios which we will walk you through below:

– Such as only show the Campaign in question on the product page. This is very simple, to do all you have to is click the drop-down, then click More under Current Visitor Metrics then select Is Viewing a Product Page. 🛍️

Target campaign only on product page

– Target by device 📱 – An example of this would be a campaign that only targets mobile or maybe if it is not equal to desktop (displays on tablets and mobiles).

Targeting non desktop visitors

– A campaign based on time of day 🕔

Content based on time of day

– Show content depending on the category of product being viewed – An example of this could be if you know a visitors favourite category is Jeans, show them that shiny new hero banner with your best-selling Jeans! 👖

Favourite category gif

– If they are not currently subscribed to email, show a campaign to the user – This can be used to prompt the user to enter their email address for use in marketing campaigns.

Target users for email input

– If the user is not browsing in the local Country of the store then show different delivery information. 🚚🌎 – A common use case for this is a store offers free delivery in its own country and it isn’t to ship to other countries.

Targeting via Location

Have a great idea in mind? Want to see a list of all our targeting metrics? 🤓

There are so many metrics to setup niche and wonderful campaigns. We hope this was enough to get you started on your journey.

Visitor Metrics List

If you want to know more about chaining conditions, then click here:


How can I preview my content on mobile? 📱

Whether you have been sent a preview link from the Bunting team or previewing a variation that you have set up for mobile you might immediately wonder why the content looks out of place. This is because it defaults to open in desktop mode if you are not using a phone. Don’t worry though there is a simple solution.

Right Click anywhere on the webpage and click inspect or use the internet browsers keyboard shortcut. In Chrome  this is (Cmd + Shift + I). This will bring up the inspector and developer tools. Once this window appears click the mobile and tablet symbol at the top left and you can now view your content as it would appear on the device shown at the top on the screen.

Note: Sometimes the page may need refreshing to display the mobile version of the website.

How to whitelist Bunting?

Do you have any services that are blocking Bunting, maybe due to a firewall or security protocol?

Not a problem!

We now have fixed NAT gateways for each availability zone in AWS, and the following should work as static IPs for outbound traffic going forward.

The following are IP addresses of our outbound traffic to our servers:

All you have to do is whitelist all of these IP’s and Bunting will now be whitelisted.

We ask that that you to whitelist all of them in case any traffic needs to be redirected at any point.
These are fixed and static forever, and more will be added as Bunting adds more local availability zones in various continents.

Feature List

Features List 🔥

Bunting contains a variety of features, many of which you can find detailed on the main Bunting website. A more exhaustive list can be seen below. Last updated: 26/7/2018

Content Creation Tools 

  • Product Recommendations Intelligent, data-driven product recommendations, which appear seamlessly as part of your website’s content. Drag-and-drop integration makes plugging them in a one-minute task.
  • Lightbox A popup you show to visitors containing information. Useful for preventing shopper exits, welcoming visitors to your site, and making important prompts. Your website is normally darkened in the background when a lightbox is being displayed.
  • Message Box A box that appears at one corner of visitors’ screens, containing text or images. Less obtrusive than a lightbox. Great for offering special offers, reassuring visitors, or prompting an action.
  • Message Bar A horizontal bar that appears a the top or bottom of visitors’ screens, containing a single line of text.
  • Targeted Email Sends a personalised email to individual visitors, or to your support staff, which can contain product recommendations, abandoned cart products and text.
  • Feedback Form A feedback form that appears within a Bunting lightbox. You can download the responses from your Bunting account into a spreadsheet.
  • Redirect Visitors Send visitors to other pages on your website when appropriate. A useful common example is redirecting an international visitor to a version of your website that is written in their language.
  • Exit Message Show visitors a message that only appears when they try to close their browser. When combined with a special offer, this can produce an effective method of preventing visitor exits.
  • Shopping Cart Email A lightbox that appears to visitors, offering to send the contents of their shopping cart to their email. Bunting handles the form and the email sending, allowing you to easily collect more email addresses for later targeting.
  • Webhook Bunting can send visitor data to any URL of your choice with a webhook, allowing you to easily integrate with your CRM, website, or any other tool of your choice.
  • Javascript Execution Have Bunting execute a piece of Javascript that you give it.


XML Schema Guide

Bunting can learn about your product inventory to drive our product recommendation system, as well as using this data to enable social proofing & urgency messaging.

This document discusses the XML format required by Bunting.

Example Complete Feed

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
  <!DOCTYPE feed SYSTEM "">
        <kw>black 250Gb</kw>
        <cv2>Extended Warranty</cv2>
          <ENG>Revolving iPad Case in Pink</ENG>
        <c>iPad Accessories</c>
        <b>FAB Cases</b>
        <kw>leather casual</kw>
        <cv1>Free Screen Cover!</cv1>


Please note For products with variations, you should only include the main product, which represents all variations. For example if “Men’s Pique Polo Shirt” is available in red and blue, you should only include the product once within the feed, using the title “Men’s Pique Polo Shirt”. Do not include the product multiple times for each variation.

Unique Product Code

The identifier for each product has to be unique within your account, and cannot be re-used. You can use any sequence of letters and digits for the product ID.

Requirement Tag Type Character Limit Example Value XML Example
Mandatory <upc> Text 250 Characters Max abc123 <upc>abc123</upc>

Product Name

This is the name of your product, which is required. Within the <ns>...</ns> node should be the name, in each relevant language accepted by your site, as demonstrated below. It is highly recommended that you wrap your values in a CDATA section to avoid invalid XML.

The default language is required for all products. Secondary languages are highly recommended, but not mandatory.

Requirement Tag Type Character Limit Example Value XML Example
Mandatory <ns> Text 250 Characters Max iPad <ns><ENG><![CDATA[iPad]]></ENG></ns>

Product Price

The price of the product. Within the <ps>...</ps> node should be the price, in each relevant currency accepted by your site, as demonstrated below.

The default currency is required for all products. Secondary currencies are highly recommended, but not mandatory.

Important: If the product is on offer, then the price should be after the reduction, not before. So, for example, if a product was 300 reduced to 250, then the price should be 250

Requirement Tag Type Character Limit Example Value XML Example
Mandatory <ps> Number 250 Characters Max 399.99 <ps><GBP>399.99</GBP></ps>

Product URL

This is the web address of the product on your website. It must be an absolute URL, including the http:// protocol. Please do not include any tracking parameters. It is highly recommended that you wrap your values in a CDATA section to avoid invalid XML.

Requirement Tag Type Character Limit Example Value XML Example
Mandatory <u> Text (include protocol) 250 Characters Max <u><![CDATA[]]></u>

Product Image URL

This is the URL of the main image for a product and is the first image that users see on product detail pages. It must be an absolute URL, including the http:// protocol.

If you have multiple different images of the product, submit the main image using this attribute and include a secondary image in the ‘Image 2 URL’ attribute. For best performance, images should ideally be around 700px by 700px.

It is highly recommended that you wrap your values in a CDATA section to avoid invalid XML.

Required for all products.

Requirement Tag Type Character Limit Example Value XML Example
Mandatory <iu> Text (include protocol) 250 Characters Max <iu><![CDATA[]]></iu>

Image 2 URL

If you have an additional image for this product, include its URL in this attribute, including the http:// protocol. For example, if you have an image that shows the product from a different angle than the main image or if you have images of the packaging or the product in various settings. For best performance, images should ideally be around 700px by 700px.

It is highly recommended that you wrap your values in a CDATA section to avoid invalid XML.

Required for all products.

Requirement Tag Type Character Limit Example Value XML Example
Optional <i2u> Text (include protocol) 250 Characters Max <i2u><![CDATA[]]></i2u>


This attribute is the category path used by your system that contains the product. Nested categories should be separated by > symbols.

It is highly recommended that you wrap your values in a CDATA section to avoid invalid XML.

Required for all products.

Requirement Tag Type Character Limit Example Value XML Example
Optional <c> Text 250 Characters Max >Electronics > Computers > Tablets< <c><![CDATA[Electronics > Computers > Tablets]]></c>


The name of the brand that manufactures the product. It is highly recommended that you wrap your values in a CDATA section to avoid invalid XML

Requirement Tag Type Character Limit Example Value XML Example
Optional <b> Text 250 Characters Max Apple <b><![CDATA[Apple]]></b>

Offer Saving

Offer saving if this product is on offer (number). For example, if price is 250, but used to be 300 when not on offer, then this value should be 50

Within the <oss>…</oss> node should be the offer saving, in each relevant currency accepted by your site, as demonstrated below.

Requirement Tag Type Character Limit Example Value XML Example
Optional <oss> Text 250 Characters Max 59.50 <oss><GBP>59.50</GBP></oss>

Offer Expiry

If the product is on offer, then this attribute should be set to the expiry date. Dates can be submitted as Unix Timestamps only (timestamp info). If the product isn’t on offer, or if the offer doesn’t have an end date then simply enter 0.

Requirement Tag Type Example Value XML Example
Optional <oe> 10 digit number 1541078733 <oe>1541078733</oe>

Product Rating

If this product has been rated then enter the rating here. Rating values should be between 0 and 5. If your rating uses a different scale, then this should be converted. For example, a product rated 9 / 10 should be halved to make 4.5. Decimal places accepted.

Requirement Tag Type Example Value XML Example
Optional <oe> Number between 0 and 5 4.5 <rt>4.5</rt>

Stock Level

Is product in stock? Passing a number means: “yes, 14 units are remaining”. Passing the value y means units are remaining, but the number is unspecified. Passing n or 0 mean out of stock.

Requirement Tag Type Example Value XML Example
Optional <s> Alpha-numeric value 14 <s>14</s>


Use the ‘GTIN’ attribute to submit Global Trade Item Numbers (GTINs) in one of the following formats:

  • UPC (in North America): 12-digit number such as 3234567890126
  • EAN (in Europe): 13-digit number such as 3001234567892
  • JAN (in Japan): 8- or 13-digit number such as 49123456 or 4901234567894
  • ISBN (for books): 10- or 13-digit number such as 0451524233. If you have both, only include the 13-digit number.

For products with multiple variations and, consequently, multiple GTIN numbers, you can separate each number with a comma. For example, a jumper in red, blue and yellow could have the following GTINs: <gtin>3001234567892,4001234567892,5001234567892</gtin>

Requirement Tag Type Character Limit: Example Value XML Example
Optional <gtin> 8-, 12- or 13-digit number (UPC, EAN, JAN or ISBN) 20 3001234567892 <gtin>3001234567892</gtin>


Part of Bunting’s product recommendation algorithm involves matching keywords found in each product’s name to find similarities. However, if your product names are short or keyword-poor then we recommend including additional keywords in this field to compensate. These could be, for example, the name of a range that each product is part of, or a characteristic that plays in important role in visitor’s buying decisions, such as colour or size.

Well chosen keywords can notably improve product recommendations while supportive order data is being collected. However, conversely, poorly chosen keywords can damage them. Therefore we recommend including keywords only if you have good ones available.

Keywords can be separated by commas or spaces. It is highly recommended that you wrap your values in a CDATA section to avoid invalid XML.

Requirement Tag Type Character Limit: Example Value XML Example
Optional <kw> Text 250 black 250Gb <kw><![CDATA[black 250Gb]]></kw>


Does product have a target gender, such as a lady’s jumper, or a man’s watch? If so, enter male or female. If the product is unisex (applicable to both genders) then leave this field blank. Any other value, including blank, will default to unisex.

Requirement Tag Format Example Value XML Example
Optional <g> ‘male’,’female’, or any other value including blank for unisex female <g>female</g>

Custom Values 1 – 5

Within the product recommendations that Bunting delivers to your website you may wish to have unique features or benefits displayed against some products but not others. To achieve this you can use Custom Values. Up to 5 values are accepted per product.

Values can contain HTML such as an <img />, they can be text strings that can be styled within your recommendation widgets, or be simple flag values to be caught by a recommendation widget IF statement. Anything within 250 characters length.

It is highly recommended that you wrap your values in a CDATA section to avoid invalid XML.

Optional for all products.

Requirement Tag Type Example Value XML Example
Optional <cv1> - <cv5> Text Free Carry Case
3 Year Extended Warranty
<cv1><![CDATA[Free Carry Case]]></cv1>
<cv2><![CDATA[3 Year Extended Warranty]]></cv2>


Is the product active and available to buy on the website? If not then pass the value no. Any other value, including blank, will default to yes.

Requirement Tag Format Example Value XML Example
Optional <a> ‘yes’ or ‘no’. Any value other than ‘no’, including blank, is taken as ‘yes’ yes <a>yes</a>

Installation checklist

The purpose of this checklist is to give you assurance that every component of Bunting was installed correctly. This will give you troubleshooting advice about how to double-check and resolve any issues that might crop up.  It’s useful to do this immediately after completing the install to give peace of mind that you’re ready to begin using Bunting.

At a high level, the following should be checked:

  1. Conversions are being tracked by Bunting.
  2. Abandoned Carts are being tracked.
  3. Products in your XML feed match those on your website.
  4. Page specific Visitor Targeting will work correctly.
  5. On the Homepage.
  6. On the Category pages.
  7. On the Product Pages.
  8. On the Cart page.

Firstly, let’s deal with conversions. 💰

If you have installed the Conversion Complete Page script. Go ahead and do the following test:


Adding Recommendations – Quick Guide

Product Recommendations are powerful. Not only can they increase conversions, and bump up each user’s average order volume, they excel in keeping users engaged and committed to browsing through your website.

In this tutorial, we’ll be running through each and every step needed to set up powerful recommendations that do their job from day one, but also get smarter all the time!

Step One – Setting Up Visitor Targeting

Go to your Bunting Dashboard.

Select Inactive Content under Personalization Cloud.

Choose the Create New Campaign button, then From Scratch.

Visitor Targeting is the first essential piece in performing a good test. This is a way of defining who exactly will see your content.

Once the targeting rules have been setup click On To The Next Step to continue.

Step Two – Creation

Let Bunting do the hard work for you, and use the in-built recommendations in the content section. To do this, select it from the content list.

Selecting Product Recommendations

Adding Buntings powerful pre-made Product Recommendations

Our Visual Editor will appear, and it will ask you where you would like to place your product recommendations. If you move your mouse over your website’s elements, you’ll see a blue marquee appear.

Click on one of the elements on your website.

There will be options asking where you would like the product recommendations to appear.

Here you have various options. Select the option most suited to where you would like your recommendations to be positioned.

If you need more information on placing content within the Visual Editor, this guide will be a great help!

There you go! Your recommendations have been added and are ready to be styled for your website!

Step Three – The Look and Feel

Why have something that looks out-of-place on your website, when you can match the look-and-feel of the Product Recommendations exactly to your branding?!

Moving straight on from the last stage, click Preview and Edit. This will again bring up the Visual Editor where you can see the recommendations.

From here click the Cog  symbol in the top right of the screen and select Setting for Recommendations. Click okay if you are ready to proceed on the alert prompt.

We’re now in the underlying configuration for the Product Recommendations, which define both how they operate and look. For now, scroll down to the Widget Designer – Wizard.

Here you can change the variables which define your font and colours to suit your brand guidelines.

Widget Designer

Using the Widget Designer to style recommendations

Step Four – Setting up Split Tests

Split tests are a bedrock in gaining a solid insight into what your users really want. This can be done in the measure impact tab.

To start running the split test for the campaign, turn the Google Analytics Event Tracking to ON and the Run a split-test to measure impact dropdown to yes.

Finally, Save and Finish. Now you have Product Recommendations that have been styled to match the look of your site in a few minutes!

Step Five – Publishing Live

You are now ready to get product recommendations on your site!

All you have to do is head to Inactive Campaigns and, in the manage column, select the drop-down for your New Product Recommendations and click Activate. 

Publishing Content

Call to action to publish content within Bunting

How to set up a split test and measure the results!

When you create a piece of content with Bunting, you run through a 3 step process, Visitor targeting > Content > Measure Impact.

To set up split testing, all you have to do is change the drop-down under “Run a split test to measure impact?” on the Measure Impact page to Yes and let Bunting do all the hard work for you. Once you have done this click Save Changes and you are ready to start collecting Results when your Campaign is Activated.

Running a split test demonstration

Running a split test within the Bunting platform.

Where can I see the Results?

In the campaign lists within Bunting when a split test has been set up for the campaign you can see the results on the right-hand site similar to the image below.

If the Split test has not yet reached its confidence target within Bunting then it will still display that the split test between variations is still active.

If you click on one of these split test result figures it will take you to the Split Test Results page for that campaign and will display all the available metrics:

  • Converted Visitors
  • Revenue
  • Cart Products per Visitor
  • Visits per Visitor
  • Average Visit Duration
  • Bounce Rate
  • Product Views per Visit
  • Page Views per Visit
Split Test Results Page

Image showing split test results page within Bunting.

You can even select a specific variation to see the results for that variation at a much more granular level. Showing a graph of results as well as a history of the variation’s performance.

There is an advanced option to alter the amount of traffic that is able to view the split tests. The default for this is 50/50, but this can be catered to the specific campaign you are testing.

Advanced Split Test Screen

Advanced Split Test Results Screen


In addition to this, the confidence target can be changed. This is the metric that is calculated by Bunting as the probability for that variation to be the most effective. Once this target is reached it will deactivate the other variations.

All of the traffic is then routed to the winning variation from the deactivated variations and the control group.

To ensure there are no false positives Bunting will only automatically end the split test and show this campaign to all visitors when the confidence target is reached with more than 200 conversions.

Note: Google analytics has been turned on for this Campaign to further measure the impact. If you want to read more about Google analytics event tracking and what information Bunting passes to it click here.

1 2