The XML product feed must contain all the products available in your shop – even those currently out of stock, together with their attributes. This information allows Boomtrain to determine each visitors’ preferences in relation to product characteristics such as brand, category, price, and other attributes.

The Catalog Sync Mechanism

Boomtrain syncs with your product catalog by importing the XML feed from a predefined URL at regular intervals. The frequency of the imports is adjustable depending on the frequency of your catalog changes (daily, hourly, etc). The Boomtrain client service team will assist you in the process of configuring the import mechanism and will establish, along with you, the frequency of the imports. The default catalog sync frequency is 1 hour.

The Feed Structure

Mandatory and Optional Product Attributes
Please find below the mandatory and optional product attributes to be included in the XML feed.

Mandatory product attributes:
<productid>  Unique product identifier (ID or SKU)
<title>  Product title
<url>  Product URL
<img>  Product image that will be used in widgets (preferably in thumbnail or small format rather than full size image)
<price>  Product price
<stock>  Stock availability
Optional additional/recommended product attributes:
<description>      The product description
<oldprice>      The old price of the product (numeric format)
<discount>      The discount of the product (as percent)
<rating>        The rating of the product (if available) 
<priority>     Has the product priority in recommendations? (1/0)
<isonsale>      Is the product on sale? (1/0)
<isnew>        Is the product recently added to the catalog? (1/0)
<cat1>        The title of the main category in which the product can be found
<cat1url>      The URL of the main category in which the product can be found
<cat2>        The title of the second category in which the product can be found
<cat2url>        The URL of the second category in which the product can be found
<cat3>      The title of the most detailed category in which the product can be found
<cat3url>      The URL of the most detailed category in which the product can be found
<delivery>      The method of delivery (if available)
<color>        The color specific to the product (if available)
<brand>        The brand of the product (if available)
<gender>        The gender specific to the product (if available)
<otherattr>      Other relevant attribute of the product (if available)

XML Feed Format

Please find below an example of an XML product feed. The demo variables will be replaced with actual data.

<?xml version="1.0" encoding="UTF-8" ?>
  <products>
    <product>
        <productid>903360000100</productid>
        <title><![CDATA[ The title of the product.]]></title>
        <url><![CDATA[ The URL of the product.]]></url>
        <img><![CDATA[ The image URL source of the product.]]></img>
        <price>199.99</price>
        <stock>1/0</stock>
        <description><![CDATA[ The product description.]]></description>
        <oldprice>399.98</oldprice>
        <discount>-50%</discount>
        <brand><![CDATA[ The brand of the product.]]></brand>
        <color><![CDATA[ The color specific to the product.]]></color>
        <cat1><![CDATA[ The title of the main product category.]]></cat1>
        <cat1url><![CDATA[ The URL of the main product category.]]></cat1url>
        <cat2><![CDATA[ The title of the 2nd level product category.]]></cat2>
        <cat2url><![CDATA[The URL of the 2nd level product category.]]></cat2url>
        <cat3><![CDATA[The title of 3rd level product category.]]></cat3>
        <cat3url><![CDATA[The URL of the 3rd level product category.]]></cat3url>
        <gender><![CDATA[The gender specific to the product.]]></gender>
    </product>
  ...
  </products>

Notes:

  1. The <url> tag must contain the URL of the product as it is used on-site.
  2. For the <url> tag please provide URLs that do not redirect. This will affect the reporting as well as the functioning of the widgets.
  3. All the URLs must use the same HTTP/HTTPS protocol.
Shares
Share This