PBI Product Integration Specs - Rumble

PBI product integration specs

This document provides guidelines for the creation of an Rumble XML product data feed in the RSS 2.0 format.

If you are interested in learning more about RSS 2.0 standard, we suggest looking over this specification at http://blogs.law.harvard.edu/tech/rss.

Feed Structure

Product Items

Mandatory Elements

Each <item> within a feed represents a single product. At a minimum, the <item> must include the following elements:

  • <rumble id>: The String that uniquely identifies the item (Product SKU preferred)
  • <link>: The canonical URL for the product.
  • <title>: The product’s title
  • <description>: The product’s description
  • <rumble:image_link>: The product’s image

Optional (recommended) Elements

  • <rumble:brand>: The product’s brand
  • <rumble:price>: The product’s price
  • <rumble:gender>: The product’s target gender
  • <rumble:color>: The product’s color
  • <rumble:product_category>: The product relative category

Important notes

When using “rumble:” element prefix, the namespace xmlns:rumble=”http://base.rumble.me/ns/1.0″ must be added

Feed example with one item:
<?xml version="1.0"?>
<rss xmlns:rumble="http://base.rumble.me/ns/1.0" version="2.0">
  <channel>
    <title>Example - Online Computers Store</title>
    <link>http://www.example.com</link>
    <description>This is a sample feed containing the required and recommended attributes for a variety of different products</description>
    <item>
      <!-- The following attributes are always required -->
      <rumble:id>DELL-0564738</rumble:id> 
      <rumble:title><![CDATA[Dell Inspiron One 23'']]></rumble:title>
      <rumble:description><![CDATA[This 58 cm (23'')-All-in-One PC with Full HD, Windows 8 and powerful Intel ® Core ™ processor third generation allows practical interaction with a touch screen.]]></rumble:description>
      <rumble:link><![CDATA[http://pbi-demo-store-qa.azurewebsites.net/dell-inspiron-one-23]]></rumble:link>
      <rumble:image_link><![CDATA[http://pbi-demo-store-qa.azurewebsites.net/Media/Thumbs/0000/0000049-dell-inspiron-one-23-70.png]]></rumble:image_link>
      
      <!-- The following attributes are not required for this item, but supplying them is recommended -->
      <rumble:price>399.99 USD</rumble:price>
      <rumble:brand>Dell</rumble:brand>
      <rumble:gender>Female</rumble:gender>
      <rumble:color>Blue</rumble:color>
      <rumble:product_category><![CDATA[Computers > Desktops]]></rumble:product_type>
    </item>
  </channel>
</rss>