Product feed

  • Actualización

A product feed is a tool that is relevant only for online stores.

A product feed or an XML feed is a popular tool among publishers. It is an XML file that contains data about products from the advertiser’s catalog. Publishers use the product feed to create price comparison websites, affiliate online stores, and email newsletters with the description of products. Using their own or ready-to-use parsers and plugins, they alter the information from the XML file to the required format, upload it on their ad spaces, and form their own product catalogs.

Since the data is taken directly from the primary source, when the feed is updated (for example, if product prices have changed), changes are automatically made in the publisher’s catalog, too. In the Admitad Partner Network system feeds are updated every 6 hours. Thus, the publisher who uses the XML feed frees up a huge amount of time that was wasted before for manually adding products in the affiliate store or for monitoring changes on the seller’s website.

The feed is uploaded and set up by a specialist of the tracking department. You need to generate a file of the required structure with the necessary data, and provide our specialist with a link to it.

If required, you can add several feeds: in various languages, with various product and price categories. In this case, it is necessary to create a separate XML file for each feed. You can add as many feeds as you want.

The link will be specified in Product feed in General settings.



Requirements for an XML file

The links to product pages should not contain any parameters, because Admitad Partner Network parameters will automatically be added to it, which may lead to conflicts and/or violate the functionality of links on the publisher side.

The file structure should correspond to YML (Yandex Market Language) format: catalog update date, store information, currency information, category list, and description of each product.


Obligatory parameters

The product description (<offer> element) must contain the following parameters:

Parameter Description
<url> The URL address of a product page
<price> Product price
<oldprice> Parameter with an old price value, i.e. the price before a discount or a sale. Names <old_price>, <price_old> are also allowed.
<picture> Photo of a product. We advise adding several photos excluding the use of the array <pictures>.
<categoryId> Product category identifier (an integer up to 18 characters). A product can belong only to one category.
<currencyId> Product currency identifier (RUB, USD, UAH, KZT).
<name> Product name
<vendor> Product vendor

The order of parameters in the <offer> element does not matter.


Additional parameters

We recommend to add these parameters to the product feed:

Parameter Descripton
<description> Description of the product
<typePrefix> Group or category of products
<model> Model
<vendorCode> Product code, vendor code


Optional parameters

You can also use the following parameters:

Parameter Description
<param> Product features.
<store> Possibility to buy the product in the retail store.
<pickup> Possibility to reserve the product and pick it up.
<delivery> Possibility to deliver the product.
<local_delivery_cost> The cost of delivery in a local region.
<sales_notes> Information about the minimum order amount, a minimal batch of products or the requirement of a prepayment, as well as the description of deals, discounts and sales.
<adult> Indicates a product related to the satisfaction of sexual needs, or otherwise exploiting interest in sex.
<barcode> Barcode of the product specified by the vendor.


Example of a product feed

<?xml version="1.0" encoding="windows-1251"?>
<!DOCTYPE yml_catalog SYSTEM "shops.dtd">
<yml_catalog date="2016-11-21 11:01">
<category id="6">Jeans</category>
<category id="7">T-shorts</category>
<category id="27">Shoes</category>
<category id="25">Bags</category>
<offer id="12346" available="true">
<model>501 Original</model>
<description>The best jeans you've ever seen!
<param name="color">dark, blue </param>
<param name="size">36, 40, 44, 48</param>



Upload photos with the maximum available resolution, publishers will resize them themselves, if necessary.

The minimum resolution is 250x250 pixels.


Products categories

Firstly, every product must belong only to one category, i.e. the <categoryId> tag must have only one value.

Secondly, it is necessary to make the most detailed classification by categories. Ideally, it should match the categorization on the website.

Duplicate products


If you do not use retargeting, it is necessary to exclude duplicate products from the XML file, and combine the products with similar characteristics (for example, by color and/or size) by using <param name="Sizes">x, y, z</param> and <param name="Color">x, y, z</param> (see the example above).

If you use retargeting, mind that the ID of every product in the feed must be unique and comply with the product ID on the website, otherwise retargeting will operate incorrectly. In this case, duplicate products are permitted.


File completeness

It is extremely desirable for the feed to contain all products available in your catalog: the more complete the feed is, the more efficient the advertising will be.

¿Fue útil este artículo?