Full Product Feed - Bloomreach Experience - Open Source CMS

Full Product Feed

What's a product feed?

The contents of your product catalog constitute your product feed. Your product feed provides critical information that Bloomreach technology needs to act on your content. You can deliver your feed to a Bloomreach FTP site or you can send Bloomreach to your own FTP site.

It's important that you include all of your products when you generate your product feed. If your product doesn't exist in your feed, then Bloomreach can't act on it. 

Is this step required?

Yes! All Bloomreach products require a daily product feed.

Format and delivery

Bloomreach supports CSV, TSV and XML feeds encoded as UTF-8. You can also use your Google Base feed. Most of Google's fields overlap with Bloomreach's fields, making alignment quick and easy.

You can deliver your product feed daily to ftp.bloomreach.com using the credentials that your Bloomreach representative gives you with your integration package. Your representative can help you if you prefer other delivery mechanisms such as the following:

  • FTP from your FTP server or from Bloomreach's FTP server
  • SFTP from your FTP server or from Bloomreach's FTP server
  • HTTP from your URL

Frequency

Generate your product feed daily to keep your data fresh and reflective of your current inventory.

Requirements

  • Use CSV, TSV or XML format.
  • Use UTF-8 encoding.
  • Use gzip compression.
  • Name the file ProductCatalog_YYYYMMDD.xml.gz or ProductCatalog_YYYYMMDD.tsv.gz.
  • Update the value of  YYYYMMDD  in the filename.
  • Deliver the feed to ftp.bloomreach.com or through another pre-arranged delivery mechanism.

XML feeds

If your product feed is in XML, then you need to decide if it's a flat feed or a variant feed. A flat feed is composed of products that don't have SKUs inside. A variant feed is composed of products with individual SKUs nested inside. 

XML feeds cannot have both variants and products that don't have SKUs inside. That is, you cannot combine the flat feed and variant feed formats. However, you can nest SKU fields in your products in a flat feed.

Some fields accept multiple values, such as crumbs. If your feed is in XML, then we recommend that you use separators, and send these values all in a single path.

Single view and Multi-view

The feed differs depending on whether you have a single view or a multi-view feed. Multi-view feeds use a view ID field to filter the catalog to only show specific products that you want a particular site visitor or subsite within your account to see, while a single view feed does not use the view ID field. You can read more about multi-view feeds here.

XML feed templates

Single view templates:

Multi-view templates:

Do Bloomreach Dashboard changes affect the product feed?

No, changes made in the Bloomreach Dashboard do not also change your product feed.

Your product feed is based on your product catalog. We don't alter that content.

Instead, we store the rules that your business users create when they use the Bloomreach Dashboard. We apply these rules for each request independently without overwriting your feed.

Examples

XML product-based feed

<?xml version="1.0" encoding="utf-8"?>
<feed>
  <products>
    <product>
      <title>Three-Pocket Straight Leg Jeans</title>
      <pid>435898</pid>
      <skuid>435-92-jj-202</skuid>
      <price>70.00</price>
      <sale_price>60.00</sale_price>
      <description>For the most flattering fit, these gorgeous straight leg jeans have a great mid-rise.</description>
      <keywords>straight leg, mid-rise, back pockets, three pocket</keywords>
      <url>http://www.example.com/435898-Three-Pocket-Straight-Leg-Jeans.aspx</url>
      <thumb_image>http://www.images.example.com/three-pocket-straight-leg-jeans-435898-thumbnail.jpg</thumb_image>
      <large_image>http://www.images.example.com/435898/435-92-jj-202.jpg|three-pocket-straight-leg-jeans-435898.jpg</large_image>
      <crumb>Apparel/Petites/Pants/Denim</crumb>
      <availability>In stock</availability>
      <launch_date>20170629</launch_date>
      <brand>Calliope</brand>
      <size>0</size>
      <reviews>3.5</reviews>
      <review_count>3</review_count>
    </product>
    <product>
      <title>Ruffle Front V-Neck Top</title>
      <pid>84324</pid>
      <skuid>843-11-rt-999</skuid>
      <price>80.00</price>
      <sale_price>65.00</sale_price>
      <description>A basic sleeveless top is updated with a feminine ruffle detail, making this gorgeous piece a wardrobe necessity.</description>
      <keywords>sleeveless, ruffle, ruffle front, v-neck</keywords>
      <url>http://www.example.com/84324-Ruffle-Front-V-Neck-Top.aspx</url>
      <thumb_image>http://www.images.example.com/ruffle-front-v-neck-84324-thumbnail.jpg</thumb_image>
      <large_image>http://www.images.example.com/84324/843-11-rt-999.jpg|http://www.images.example.com/ruffle-front-v-neck-84324.jpg</large_image>
      <crumb>Apparel/Blouses &amp; Tops/Tops</crumb>
      <availability>In stock</availability>
      <launch_date>20170627</launch_date>
      <brand>Lyre</brand>
      <reviews>5</reviews>
      <review_count>8</review_count>
    </product>
  </products>
</feed>

Did you find this page helpful?
How could this documentation serve you better?
On this page
    Did you find this page helpful?
    How could this documentation serve you better?