Table of Contents


What is the Product Feed and where is it used?

One of the first things you should do when integrating your online store with edrone is generating a Product Feed.

The Product Feed is an XML file containing all the most important information about your inventory – things like product name, product URL, product price, whether or not it is in the sale, product category, images, and so on.

Without the Product Feed, our platform wouldn't be able to track key information such as which products your customers are buying and what categories those products are in (a crucial data point for Cross-Selling and many other scenarios and product recommendation methods).

Now that we know why it's so important, let's see how you can make your Product Feed and connect it with your edrone account!

How to generate a Product Feed?

It is your responsibility to create and manage your Product Feed. Most eCommerce platforms have the ability to generate Product Feeds, either using native features or with the help of a plugin. If you do not know how to set up this file in your store, ask the technical support of your shop platform or your developer.

If your platform does not have this ability, or you use a custom platform, there are specialized tools available on the internet. Please check the requirements below and onto make sure the tool you choose is adequate.

Product Feed Requirements

  • We support only the following feed formats: Google Merchant Centre, IAI and CENEO;

<rss version="2.0">
<title>My feed</title>
<link rel="self" href="www.my-shop.com"/>
<updated>2019-08-01T09:30:01Z</updated>
<author>
<name>myShop</name>
</author>
<id>/googleshopping.xml</id>
<channel>
<item>
<g:id>ABC2151</g:id>
<title>This is my product name</title>
<description>Very nice product</description>
<g:google_product_category>Another category</g:google_product_category>
<g:product_type>We > take > category from > here</g:product_type>
<g:brand>This is producer brand</g:brand>
<g:mpn>07920</g:mpn>
<g:gtin>7898920068216</g:gtin>
<link>https://www.my-shop.com/product-url-30ml/p?idsku=215196140</link>
<g:image_link>https://my-shop.com./image/ids/496848_2.jpg</g:image_link>
<g:price>49,90 USD</g:price>
<g:sale_price>39,90 USD</g:sale_price>
<g:sale_price_effective_date>2016-02-24T13:00-0800/2016-02-29T15:30-0800</g:sale_price_effective_date>
<g:availability_date>2016-11-25T13:00-0800</g:availability_date>
<g:expiration_date>2016-02-24</g:expiration_date>
<g:availability>in stock</g:availability>
<g:condition>new</g:condition>
<g:complementary_product_ids>DEF3151~GHI4151~JKL5151</g:complementary_product_ids>
</item>
...

CENEO sample:

<offers version="1">
<group name="other">
<o id="ISC6020000613" url="https://www.my-shop.com/product-url-30ml/p?idsku=215196140" price="39,02 PLN" weight="0.0300" stock="1" avail="1">
<cat>We/take/category from/here</cat>
<name>This is my product name</name>
<desc>What a lovely product</desc>
<imgs>
<main url="https://my-shop.com./image/ids/496848_2.jpg"/>
<i url="https://my-shop.com./another-image/ids/496848_2.jpg"/>
</imgs>
<attrs>
<a name="Producent">This is producer brand</a>
<a name="Kod_producenta">ISC6020000613</a>
<a name="Pojemnosc">30 ml</a>
<a name="namePl">Some other attribute</a>
<a name="sale_price">29,02 PLN</a>
<a name="sale_price_effective_date">2016-02-24T13:00-0800/2016-02-29T15:30-0800</a>
<a name="availability_date">2016-11-25T13:00-0800</a>
<a name="expiration_date">2016-02-24</a>
<a name="complementary_product_ids">ABC7020000613~DEF8020000613~GHI9020000613</a>
</attrs>
</o>
...

IAI sample:

<offer file_format="IOF" version="3.0" generated_by="IdoSell Shop" generated="2019-08-01 11:01:19" expires="2019-08-02 11:01:19" extensions="yes">
<products language="pol" currency="PLN">
<product type="regular" id="7002" vat="23.0" producer_code_standard="GTIN12" code_on_card="FUND-001 / 375833-010" site="6" currency="PLN">
<producer id="24" name="Brand of product"/>
<category id="1236067664" name="We > take > category from > here"/>
<unit id="0" name="szt."/>
<card url="https://www.my-shop.com/product-url-30ml/p?idsku=215196140"/>
<description>
<name type="name" xml:lang="pol">This is product name</name>
<short_desc xml:lang="pol">What a lovely product</short_desc>
<long_desc xml:lang="pol">What a lovely product. What a lovely product. What a lovely product. </long_desc>
</description>
<iaiext:delivery_time unit="day" value="1"></iaiext:delivery_time>
<iaiext:visibility></iaiext:visibility>
<price gross="64.99" net="52.84"/>
<srp gross="0" net="0"/>
<strikethrough_retail_price gross="119.99" net="97.55"/>
<strikethrough_wholesale_price gross="119.99" net="97.55"/>
<iaiext:price_retail>
<iaiext:site id="6" size_id="0" gross="64.99" net="52.84"/>
</iaiext:price_retail>
<iaiext:price_wholesale>
<iaiext:site id="6" size_id="0" gross="64.99" net="52.84"/>
</iaiext:price_wholesale>
<iaiext:price_minimal>
<iaiext:site id="6" size_id="0" gross="0.01" net="0.01"/>
</iaiext:price_minimal>
<promotion name=""/>
<iaiext:hotspots></iaiext:hotspots>
<sizes></sizes>
<images>
<large>
<image url="https://my-shop.com./image/ids/496848_2.jpg" changed="2013-01-02 00:00:00" hash="2dbbdb78f4f5f42bb65d4ffa96f53501" width="800" height="800"/>
</large>
</images>
</product>
...

  • The Product Feed must be an XML file supplied as a URL (e.g. https://yourshop.com/gmc-feed.xml);

  • The encoding must be UTF-8;

  • The file must be hosted by your store.

  • You must not block access to the file from specific locations (e.g. selected countries);

  • You must not block access to the file from various IP’s within some time margin.

  • The following fields are mandatory:

    • product_id

    • product_url

    • product_image_url

    • product_title

    • product_price

    • availability

The following fields are optional, but can be essential if you plan to use specific scenarios in edrone:

  • For cross-selling scenario:

    • product_category_ids

    • product_category_names

    • product_brand_ids (if relevant)

    • product_brand_names (if relevant)

    • product_counts

  • For the Marketing Machine:

    • Product_image_link (essential)

    • Product_availibility (essential)

    • Product_price (essential)

    • product_sale_price

    • product_type

    • product_category

    • product_complementary_product_ids

Please note that our system will not accept files that:

  • Are not in XML format;

  • Are not in the form of a URL;

  • Are not encoded in UTF-8;

  • Are not in one of the defined standards mentioned previously;

  • Are an URL that requires authorization to open or is password protected;

  • Are an URL that is not available to download worldwide;

  • Are an URL with mechanisms that block downloading the file for several hours from different IPs;

Importing Product Feed in edrone

  1. To import your feed please go to DASHBOARD > SETTINGS > IMPORT PRODUCT FEED and click Import new feed.

  2. Paste the Feed URL according to all mentioned requirements above.

  3. Once you click Add, edrone will be processing your feed.

  4. After your feed is processed, you will receive an email with the completion status.

After correct processing, the status of the feed will be changed to "Verified".

If an error occurs, please check again our feed requirements and our FAQ section below.

You can have only one active feed at a time. In case you download a new feed, your current one will be automatically replaced.

NOTE: edrone updates your product feed once every 24 hours. If you would like to update it more frequently, please contact our support team athello@edrone.me


Frequently Asked Questions

Below you can find answers to the most frequently asked questions regarding Product Feed Import:

1. Why couldn’t edrone import the feed if it has done this previously?

If you are sure that your feed is working properly and edrone can not import it, the problem can be related to the change of IP which is used by edrone to upload the feed. Such situations relate to IAI feed type. In those cases, you should manually indicate IP by entering 255.255.255.254/0

2. What is the best way to define product variants in a feed?

If you would like each product to be treated as an individual product without dividing it by size or colour, then you need to add a general product to the feed (one main ID without adding variants). The product ID is constructed on the trace page, no matter what size variant you choose, we treat the product as the same ID. This way of adding a product to the feed is the most popular. Such process of labelling products does not generate duplicate variants of one product in dynamic bestseller elements. If a product goes out of state, it will be the entire product, not a specific variant.

If you want the edrone to treat each variant of a product separately (e.g., size or colour), you need to add variants in the feed as separate product IDs. Then edrone will treat each specific size or colour of a product as a separate product. We do not identify variants written as id: 12345-1, because, after the detection of an identical product ID, edrone combines the trace data from the store's website and the data from the product feed.

While choosing this approach, you should take into account that if a given product is a bestseller, then each size would also be a bestseller. Thus, we can display the same product, only in a different size in a dynamic element (which contains products from the most popular categories).

If you want the feed to contain a breakdown of the colour variants of products without size variants, it is enough to include each colour variant of the product with separate individual ID (just like on the store's website). You should not include the size with a separate ID.

3. What can contribute to mistakes in feed?

An example of an error that is quite difficult to notice is placing a space between the notation of a parameter (its name) and the parameter value, for example: product url or graphics url.

4. Is the <description> parameter required in edrone?

It is not required in edrone, however, it will be very beneficial to add it if you plan to use Voice Commerce.

5. I want to edit categories that are visible in edrone, what can I do?

In edrone, the categories can be found in the dynamic element Bestsellers, in the selection of the audience of the Newsletter Categories scenario, in the Customize section in the Cross-selling scenario, or in the Marketing Machine recommendation frame settings panel.

If you want to extend the category names to the three positions: main category> subcategory> product or you want to add a category, categorize a product by brand, or edit categories, you should adjust them in the product feed. Saving a category extension requires the use of the ">" sign, which shows the dependency between the main category and the subcategory.

If you mark a new category next to a given product in the feed, categories from the feed will be assigned to existing products.

The parameters that are responsible for the assigned category depend on the type of the feed (which are mentioned above).

6. How to mark availability in a feed?

Marking of availability depends on the feed format.

For Google Merchant Center

<g:availability>in stock</g:availability>
<g:availability>out of stock</g:availability>

For IAI (IdoSell)

Parameter is described as:

avail="1" / “0”

For CENEO

Parameter is described as:

avail="1”/”3”/ itd.

CENEO accepts the following values for the ‘avail’ field:

  • 1: Available, the store will send the product within 24 hours

  • 3: The store will send the product within 3 days

  • 7: The store will send the product within a week

  • 14: The store will send the product within 14 days

  • 90: Products to order

  • 99: No information about availability - status "check in store"

  • 110: Presale

All the above values return information that the product is available.

7. Which parameters does edrone support in RSS2 feed?

Here is the list of supported parameters in RSS2.0

  • g: id - id

  • g: title - title

  • g: link - url

  • g: image_link - image link

  • g: brand - category

  • g: price- price

  • g: sale_price - promotional price

  • g: description - description

  • g: avilability - availability (supported value is in stock / out of stock)

8. Which feed attribute is needed for edrone to ges links to products?

Example of IAI (IdoSell):

<images>

<large>

<image url="https://my-shop.com./image/ids/496848_2.jpg" changed="2013-01-02 00:00:00" hash="2dbbdb78f4f5f42bb65d4ffa96f53501" width="800" height="800"/>

</large>

</images>

Example of GMC:

<g:image_link>https://www.sklep.pl/data/gfx/pictures/3/1/1_3.jpg</g:image_link>

<g:additional_image_link>https://www.sklep.pl/data/gfx/pictures/3/1/1_4.jpg</g:additional_image_link> <g:additional_image_link>https://www.sklep.pl/data/gfx/pictures/3/1/1_5.jpg</g:additional_image_link>

<g:additional_image_link>https://www.sklep.pl/data/gfx/pictures/3/1/1_4.jpg</g:additional_image_link>

<g:additional_image_link>https://www.sklep.pl/data/gfx/pictures/3/1/1_6.jpg</g:additional_image_link> <g:additional_image_link>https://www.sklep.pl/data/gfx/pictures/3/1/1_1.jpg</g:additional_image_link>

In attribute <image url=... / <g:image_link> can be found a couple of graphics of products. edrone gets the graphic from the first URL.

9. I received a notification from the edrone system that my feed was disactivated, what can be the cause?

Usually, the feed is unplugged during the processing stage when it is no longer available due to reasons:

  • The mechanism blocks the download of a file for several hours from different IPs;

  • Feed is not available for download from a given country (edrone's servers are located in Ireland);

  • Feed is protected by a password;

  • Made changes to the feed that affect its format, content or size;

  • Too many errors in the feed during its processing. One error relates to the processing of a single product.

  • A lot of feeds processing at one time.

10. What influences the feed size and processing time, but is not required in edrone?

Particularly extensive product descriptions, which extend files to very large sizes (> 100 MB). Also, it is possible to place inaccessible products with the appropriate flag in a product feed. It extends the processing time of the feed.

11. How does edrone connect the information about product from a feed and from a platform?

For our system, product IDs are important. The product ID is sent from the platform after the integration (trace) should be marked in the same way as in the product feed.

12. Why do we show differently written product names in the dynamic element during creation (e.g. the size of the letters in the product name or the graphics that do not match the ones linked in the feed)?

Edrone gathers information about products from users' actions on the store's website (trace) and from the feed. It depends on whether the last information about the product is obtained from the processing of the feed or from the trace.

If the product name in the feed is different than in trace, or if the feed contains a different graphic, than the one whose link is passed to edrone after integration (trace on the page), this will result in mixing information in dynamically downloaded elements.

13. I want to use regular and promotional prices in the dynamic elements. Do I need to use product feed for this?

Yes, the product feed is required if dynamic elements should contain product prices.


Need more help?

If you have any further questions about the Product Feed, please do not hesitate to contact us at hello@edrone.me


Not exactly what you’re looking for? Try one of these:

Did this answer your question?