Full Product Feed - Bloomreach Experience - The Headless Digital Experience Platform Built for Commerce

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 a Bloomreach-provided SFTP location, using ftp.bloomreach.com and the credentials that your Bloomreach representative gives you with your integration package. 

Frequency

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

Feed Attribute Sync Time
When you add new attributes/categories to the feed, it takes around 1.5 hours for them to reflect on the dashboard. You can add customisations to the new attributes/categories after this sync time.

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?