Nextopia accepts Google Shopping Feeds in either XML or CSV (tab delimited) formats. In most cases, your Google shopping feed will suit your needs perfectly. In cases where you require parent-child relationships, color swatches, additional attributes, and other such requirements not supported by Google format, please see the Nextopia format specifications (which is really the Google format but with small additions).
Example Data Files:
If you would like your data feed to be automatically imported on a schedule, you will need to ensure it is available through one of the following methods;
- A web-accessible URL.
At minimum, we require the following fields:
In some cases you will need to add more information to your feed to optimize your shoppers’ eCommerce experience, you may add or remove fields to suit your needs.
Nextopia Recommends the following fields:
|id||This should be your product SKU and must be unique across all items in the data feed.||ABC-123|
|title||The name of the item as you would like it to appear in the search results.
It is best not to include any references to an item’s attributes.
e.g. A Cool Shirt (XL – Red) would be better off as simply A Cool Shirt.
|A Cool Shirt|
|description||A short, non-formatted description of the item. This field should not contain any HTML.||Made out of 100% cotton, this shirt is the most comfortable shirt you’ll ever wear!|
|price||Price of the item. This field should not contain any currency symbols or acronyms. (ie. USD, CAD)
This value will be rounded to 2 decimal places when displayed in your results.
|sale_price||Sale Price of the item. This field should not contain any currency symbols or acronyms. (ie. USD, CAD) This value will be rounded to 2 decimal places when displayed in your results.||10.00|
|link||An absolute URL pointing to the item’s detail page on your website.
If possible, specify the URL without a protocol
e.g. //yourdomain.com/product.html instead of http://mysite.com/product.html
|image_link||An absolute URL pointing to the image to display for the item in your search results.
It is best to reference an image which has the suitable dimensions to display in the search.If possible, specify the URL without a protocol
e.g.//yourdomain.com/product.html instead of http://mysite.com/product.html
|product_type||This is the category breadcrumb path to your product.
If a product exists in more than one category, you can include multiple ‘product type’.
Home > Electronics > Blu-Ray Players,Home > Brands > Sony > Blu-Ray Players
<g:product_type>Home > Electronics > Blu-Ray Players</g:product_type>
<g:product_type>Home > Brands > Sony > Blu-Ray Players</g:product_type>
|availability||Available status of the item
Accepted values are: in stock or out of stock or preorder
|gender||Gender of the item Accepted values are: Male,Female or Unisex||Male|
|color||Color of the item||Black|
|size||Size of item||XL|
If you have a field with multiple values, separate the values with two pipes. (example: | | )
Product Variants are configurable options for a given product. For example, a T-shirt may come in multiple colors, multiple sizes, and multiple genders. Each possible combination of these options is a product variant.
When we are importing your feed, our system merges all of the variant data down into one result listing. That means only one product will show up in your results, but the product will be indexed with all of the data from the variants.
Google format does not distinguish which of these variants is the parent product. When choosing which product image and name to display, we pick the first variant listed in your feed. We use the same logic to determine which URL to redirect to as well. The price, image, and description will also use this row. If you do not want to use the first product in your feed for all attributes, make a field called “IsParent” in your feed, and enter a value of 1 in this field for the product you want to use as the primary information in the results.
Take extra-special note of the attribute item_group_id The value of this attribute determines which product variants will be grouped together into a single search result. If a product is not part of a variant group, you can leave this field blank.
All variants with the same item_group_id value will be grouped together, regardless of their position in your data feed. Take special care to be sure every variant group has a unique value for item_group_id.
Sample Feed Format
Here’s an example of what full data may look like in Tab-Delmited format: Download feed-sample.txt
Here’s an example file of what full data may look like in XML: Download google-rss.xml
|abc-123||Cotton T-shirt||Made out of 100% cotton, this shirt is the most comfortable shirt you’ll ever wear!||9.99||//mysite.com/cotton-tshirt.html||//mysite.com/images/cotton-tshirt.jpg||Home > Shirts > Mens,Home > Shirts > Womens||in stock||Red||Small||Women’s||16|
|xyx-987||Long Sleeved Shirt||Made out of 100% cotton, this long sleeve shirt can be used indoors or outdoors!||14.99||in stock||Black||Medium||Women’s||27|
Take extra-special note of the value of the attribute item_group_id This determines which product variants will be grouped together in to a single search result. If a product is not part of a variant group, you can leave this field blank.
All variants with the same item_group_id value will be grouped together, regardless of their position in your data feed. Take special care to make sure every variant group has a unique value for item_group_id.