A data feed is a file made up from a grouping of attributes that
define each one of your products in a unique way that allows customers
to search and find your items.
Attributes are broken into two categories; required and recommended.
While you only need required attributes for your item to get successfully processed,
we highly encourage that you include all the recommended attributes
whenever they are available. For example, Product ID is a required field for products in all categories.
Required Attributes
These attributes must be included in any data feed and any items
missing these attributes will not be processed. For more detailed
instructions for each attribute click on them.
Product ID
[product_id ]
A unique alphanumeric identifier for each item- e.g. your internal ID code.
IMPORTANT:
- Once an item is submitted the unique id cannot change when you update your data feed.
- Item identifiers must be unique within your account. If you have multiple feeds, items within different feeds must still have a unique identifier.
Type |
Alphanumeric characters |
Text/Tab delimited |
230987 |
XML |
<product_id>230987</product_id> |
Product Model [product_model]
The manufacturer product number (the number which uniquely identifies the product
to it's manufacturer). It is required to provide product model for all products
except for those under the apparel and custom made goods categories. Please
read more about providing strong identifiers.
Type |
Alphanumeric characters |
Text/Tab delimited |
NQ128PA |
XML |
<product_model>NQ128PA</product_model> |
Product
Name [product_name ]
The name of the item should be placed here and as described in our editorial guidelines
please don't include any promotional text. In addition, all symbols
should adhere to their true meaning, for example, do not use the @
symbol to replace the letter "a".
Type |
Text, that should be not longer than 70 characters |
Text/Tab delimited |
HP Pavilion DV7-1211TX NQ128PA C2D T9550 2.66GHz, CHIPSET PM45, 4GB,
800GB,GF9600M GT WITH 512MB, 17", Wi-Fi, W7HP,1Yr |
XML |
<product_name>HP Pavilion DV7-1211TX NQ128PA C2D T9550
2.66GHz, CHIPSET PM45, 4GB, 800GB,GF9600M GT WITH 512MB, 17", Wi-Fi,
W7HP,1Yr</product_name> |
Product URL[product_url]
This attribute is a direct link to your product URL. As our policies
state that it is your responsibility to maintain the website associated
with your account at all times. All your URLs must link directly to
webpages about your products without pop ups or redirects to other
pages. This includes landing pages requiring sign ups, passwords, or
direct links to files/email addresses. Links should not contain raw ip
addresses.
Product Price
[product_price]
Only items with fixed prices are allowed in Product Search; items with variable
prices such as plane tickets or auctions are not valid. For items sold in
bulk quantities the price for the lowest purchasable number of items must
be defined in this attribute (not the per unit price) as described in our
policies. All submitted prices must
exactly match the price displayed on your website and include all applicable
taxes and charges except shipping. Please do not provide any currency with
the price (e.g. 15.00 $), As an South Africa Site, we assume that the currency
is $ (South Africa Dollar).
Type |
Number |
Text/Tab delimited |
315.75 |
XML |
<product_price>315.75</product_price> |
Recommended Attributes
Product
Description [product_description]
This text describes each item. As laid out in our policies you may not use promotional or boiler plate text, such as "Free Shipping" or "Click Here Now".
Type |
Text. Include as much text as is necessary to accurately describe
the item. You can submit up to 10,000 characters. The description can
be in HTML too. |
Text/Tab delimited |
This teddy bear is fuzzy and cuddly. The bear is yellow with with
white paws and stuffed with high quality hypoallergenic synthetic
cotton. |
XML |
<product_description>This
teddy bear is fuzzy and cuddly. The bear is yellow with with white paws
and stuffed with high quality hypoallergenic synthetic cotton.</product_description> |
Manufacturer Name [manufacturer_name]
The brand / manufacturer company name of the product. It is required to provide
for all products except for those under the apparel and custom made goods
categories.
Type |
Text |
Text/Tab delimited |
Toshiba |
XML |
<manufacturer_name>Toshiba</manufacturer_name> |
Category Name [category_name]
This describes the overall category of the product. For example, if your item
is a laptop / notebookit might be in the category of "Laptops". Ideally, please
match the product to our own taxonomy shown here.
Type |
Text. You may include multiple product types if its appropriate for
your item. Separate by a comma for tab-delimited; Include multiple <product_type>
attributes for XML. |
Text/Tab delimited |
Laptops |
XML |
<category_name>Laptops</category_name> |
Image URL [image_url]
This is the URL of an associated image for a product. Please use full size
images (250x250 pixels or larger), not thumbnails. Please do not include logos
in images. Including valid images is important for users and merchants, we
strongly recommend you include this attribute if you have an image for your
products. If you do not have an image for your product leave this attribute
blank.
Type |
URL. (Must include the http:// portion.) |
Text/Tab delimited |
http://www.example.com/images/product23873.jpg |
XML |
<image_url>http://www.example.com/images/product23873.jpg</image_url> |
|