Product Feed XML

The first thing you need is to provide us with a product XML feed that we will use to synchronize your client's product information with our ad server. The feed must be accessible over HTTP(S) and will be fetched periodically by our system. We support feeds built following our specifications and to some extent also basic Google's product data feeds, both Google's RSS 2.0 and Atom 1.0 feed specifications.

Make sure the following requirements are met

  • The document must be encoded using UTF-8, except for <link>.
  • Make sure to properly encode HTML tags you with to use inside the product feed nodes, e.g. <title><![CDATA[My <i>title</i>]]></title> not <title>My <i>title</i></title>

Sample XML feed

<rss version="2.0">
  <channel>
    <title>starwars</title>
    <item>
      <id>r2d2</id>
      <title>Nice robot</title>
      <description><![CDATA[R2D2 is...]]></description>
      <link><![CDATA[http://www.example.org/r2d2?utm_source=delta&utm_medium=banner&utm_campaign=delta]]></link>
      <image_link><![CDATA[http://example.org/r2d2.jpg]]></image_link>
      <availability>out of stock</availability>
      <price>29.50 USD</price>
    </item>
    <item>
      <id>stormtrooper</id>
      <title>Bad man</title>
      <description><![CDATA[A stormtrooper is...]]></description>
      <link><![CDATA[http://www.example.org/stormtrooper?utm_source=delta&utm_medium=banner&utm_campaign=delta]]></link>
      <image_link><![CDATA[http://example.org/stormtrooper.jpg]]></image_link>
      <availability>in stock</availability>
      <price>29.50 USD</price>
    </item>
  </channel>
</rss>

<rss>

ParameterTypeRequiredDescription
<channel>YesA collection of items to synchronize

<channel>

ParameterTypeRequiredDescription
<title>stringNoThe title of the feed
<item>YesNodes used to specify items to synchronize

<item>

ParameterTypeSizeRequiredDescription
<id>string255YesA unique identifier of a specific item. Preferably the SKU of a product
<title>string2048NoThe title of the item
<description>string2048NoA description of the item
<link>string2048NoA URL linking to the item's page on the website
<image_link>string2048NoA URL to an image of the item. Max allowed image file size is 4MB
<condition>"new","used" or "refurbished"128NoThe condition of the item
<availability>"in stock" or "out of stock"128NoThe availability of the item
<price>string64NoThe price of the item
<extras>string2048NoAdditional data wrapper