Product Feed Requirements
On this page, you will find more information about the different advertising feeds supported by the platform and how to prepare your files according to our requirements. Use the links to go directly to the section you need:
- File format
- Static and dynamic feed
- Refresh rate
- Image specifics
- WooCommerce plugin recommendations
- Product feed attributes
- Article feed attributes
File Format
The accepted file formats are XML or CSV, and you must follow the specific structure of the product information as described below in the sections "Product Feed Attributes" and "Article Feed Attributes".Static and Dynamic Feed
Our system works with both local files, which are refreshed manually each time the file is uploaded to the system, and dynamically updated feeds that we fetch from a provided URL on your site. To enable daily crawling and refreshing of the product content (especially the current price), we recommend using a dynamic feed.Dynamic Feed Crawling Frequency
When using a dynamic feed, it is processed regularly by our system. By default, crawling occurs once a day. We can increase the frequency and crawl your feed more often. The maximum refresh rate is 24 times per day – once every hour. If your business specifics require more frequent feed crawling, contact our team so we can assist you in achieving optimal regularity and speed.Image Specifics
Images in your feed are crawled by our system each time the feed is refreshed and are stored as optimized resources on our servers to ensure instant serving afterward. It is important that all images in your feed have equal to or higher resolution than the minimum required, namely 250x250 pixels. If the images are too small, the system will not be able to validate the product, and it will not be saved or crawled. Our system optimizes the image size to ensure they are as easy as possible to download and display on user devices. The supported formats for crawling are .jpg, .jpeg, .png, and .webp.WooCommerce (WordPress) Feed Plugin Recommendations
WooCommerce is one of the most popular platforms, and the easiest way to work with it is by using a plugin that generates a product list and creates a link with a dynamic feed. Our system will crawl this link daily to update prices and other product information. We recommend Product Feed PRO for WooCommerce by AdTribes or CTX Feed – WooCommerce Product Feed Manager by Webappick.Feed Types by Content
Feeds are divided into two types based on their content and purpose – product feeds (for online stores) and article feeds (for blog and news advertising). Depending on the type, there are different structural requirements for the feed:1) Product Feed Attributes
Type: string
Product ID
A unique content ID for the item. Use the item's SKU if possible. Each content ID must appear only once in your catalog. If there are multiple instances of the same ID, we ignore all duplicates.
Use only numbers, latin letters, underscores and dashes. White spaces are not allowed. The tag is not case-sensitive.
Example: "123ABC" and "123abc" are the same IDs. "123_abc" or "123-abc" are allowed, "123 abc" is not allowed.
Type: url address
Product URL
The URL to the specific product page for the item on your business's website where people can learn more about or buy that exact item. Links must begin with http:// or https://, be valid and be hosted on your business’s website domain.
Example: https://yourdomain.com/product_page.html
Type: string
Product Title
A specific, relevant title for the item.
Character limit: 200, but we recommend a maximum of 65 to avoid longer titles being cut off.
Example: White Sneakers
Type: string
Product Description
A specific, relevant description for the item.
Type: url address
Product Image URL
The URL should lead to an image in jpeg, png or webp format.
Type: url address
Product Additional Image URL
The URL should lead to an image in jpeg, png or webp format.
Type: number
Product Price
Use only number without currency. Since each product feed has a fixed country setting and a currency, the price number will be saved automatically in the currency of your target country.
For example: use 15.00 instead of 15.00 BGN
Type: number
Product Sale Price
If the product is on sale you should list the sale price among with the original (old) price to show the discount. Meet the same requirements as those for showing price via the price attribute
Type: string
Product Category
If you have multiple levels (category path), then use > to separate them. Also, include a space before and after the > symbol.
For example: Clothes > Women > Bags. We will take only the last category level, in this case: Bags.
Type: string
Product Brand
Only provide a brand if you are sure that it's correct. When in doubt, don't provide a brand (e.g. do not guess or make up a value like N.A. or similar).
Type: string
Product Stock Status
Allowed values: in_stock, out_of_stock and preorder. Any other values will be ignored.
Type: string
Product Condition
Allowed values: new, used. Any other values will be ignored.
Type: string
Global Trade or Manifacturer Number
Used to uniquely identify a specific and unique product from the same manufacturer. Use this attribute to submit any of the following types of numbers: MPN, UPC, EAN, ISBN
Example Product Feed:
<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:g="http://base.google.com/ns/1.0" version="2">
<channel>
<title>Feed Title</title>
<link>https://domain.com/</link>
<description></description>
<item>
<g:id>112397</g:id>
<g:gtin>Product GTIN</g:gtin>
<g:title>Product Title</g:title>
<g:description>Product Description</g:description>
<g:link>https://youreshop.com/</g:link>
<g:image_link>https://youreshop.com/01.jpg</g:image_link>
<g:additional_image_link>https://youreshop.com/01-2.jpg</g:additional_image_link>
<g:availability>in stock</g:availability>
<g:product_type>Product Category</g:product_type>
<g:brand>Product Brand</g:brand>
<g:price>16.50</g:price>
<g:sale_price>12.99</g:sale_price>
</item>
</channel>
</rss>
Download sample CSV product feed »
2) Article feed attributes
Type: string
Article ID
A unique article ID. Each Article ID must appear only once in your feed. If there are multiple instances of the same ID, we ignore all duplicates.
Only numbers and latin letters
Example: 123AFE
Type: url address
Article URL
The URL to the specific article page. Links must begin with http:// or https://, be valid and be hosted on your business’s website domain.
Example: https://yourdomain.com/article_page.html
Type: string
Article Title
A specific, relevant title for the Article.
We recommend a maximum of 200 characters to avoid longer titles being cut off.
Type: url address
Article Image URL
The URL should lead to an image in jpeg, png or webp format.
Type: string
Article Category
Type: string
Author
Type: date
Article Publish Date
Example Article Feed:
<?xml version="1.0" encoding="UTF-8"?>
<rss xmlns:g="http://base.google.com/ns/1.0" version="2">
<channel>
<title>Feed Title</title>
<link>https://domain.com/</link>
<description></description>
<item>
<guid>112397</guid>
<title>Article title</title>
<link>https://domain.com/article-name</link>
<enclosure url="https://domain.com/image_name.jpg" />
<pubDate>Mon, 24 Jun 2024 06:11:18 +0000</pubDate>
<category>Product category</category>
<g:author>Ivan Ivanov</author>
</item>
</channel>
</rss>
Download a sample CSV feed with articles »