Overview

A product feed is a file that contains information about all products on your site. We will use this information to build the dynamic product banners.

Feed formats supported by Thunder

The Thunder platform can import CSV or JSON files.

EXAMPLE JSON DATA FEED

{
"id" : "531493",
"title" : "Sprocket 3000",
"description" : "The most advanced sprocket Spacely has ever produced.",
"link" : "https://www.example.com/products/sprocket-3000.html",
"image_link" : "https:// example.com/images/products/s3000.png",
“additional_image_link”: “https:// example.com/images/products/s3000-alt.png",
"brand" : "Spacely",
"condition" : "new",
"availability" : "in stock",
"price" : "310.47",
"sale_price" : "299.47",
"google_product_category" : "Business & Industrial > Heavy Machinery",
"gtin" : "3607342367987",
"mpn" : "3607342367987",
"product_type" : "commercial",
}
}

EXAMPLE CSV DATA FEED

The CSV will contain the same fields and values as the JSON above. As with JSON,

the field titles must be lowercase. i.e. “description” not “Description.”

The fields will be column headings and the values will be listed beneath.

Id

title

description

link

etc

531493

sprocket 3000

The most advanced

sprocket Spacely has

ever produced.

https://www.example.com/products/sprocket-3000.html

FIELDS

ID

This field is required for all products in the feed, and cannot be empty/blank.

The id is a unique product identifier that represents one, and only one, product. Once an id is assigned to a product and imported, the id may not be used for a different product, nor can the id for a particular product change. If you have item_group_id also

populated, populate id with the child ID/SKU.

Character Requirements: The id must only contain ASCII characters, and must not

contain quotation marks.

• Limit: 240

• Type: String

title

This field is required for all products in the feed, and cannot be empty/blank.

The title is the product’s name, typically as it is displayed on the product’s detail page.

This will be used as the main text descriptor in the banners for a given product.

Character Requirements: The name must start with a letter or number.

• Limit: 150

• Type: String

description

The description is a short piece of text that gives more information about a product in

addition to its name. Not all creative designs will include a description. Max

recommended description length is 50 characters.

Character Requirements: The description must start with a letter or number.

Remove all HTML tags from this field, including style, embed, object, and anchor

tags.

• Limit: 5000

• Type: String

google_product_category

Category level attributes indicate the category of the product being submitted, according to the Google product taxonomy. If your product can be linked to multiple categories, we only want the one that is the

most relevant.

Character Requirements: We accept both IDs and full category path

• Type: String

link

This field is required for all products in the feed, and cannot be empty/blank

The link is the product’s dedicated detail page. The link is usually, although not

necessarily unique to a given product. The product information on this URL should

match the corresponding information provided in your feed. Please specify the protocol (http:// or https://) for all URLs.

Character Requirements: The link must start with the protocol (http:// or https://)

followed by the full URL of the product detail page. All symbols must be encoded.

Eg. $ must be replaced with %24.

• Limit: 1024

• Type: String

image_link

This field is required for all products in the feed, and cannot be empty/blank

The image_link is a URL that specifies a file path to a given product’s image. The

image_link will be used to display the product’s image in the banners. Ideally, images

should be at least 800x800 pixels and weigh under 16MB. The image must have a

Content-Type header specified, either image/png, image/gif or image/jpeg.

Character Requirements: The image_link must start with http:// or https://

followed by the full URL of the product’s image. All symbols must be encoded.

Eg. $ must be replaced with %24.

• Limit: 2000

• Type: String

availability

The availability indicates if the product may be purchased on the site. You may populate availability with 3 possible values: preorder (item is not currently shipping, but still may be purchased), out of stock (item is not shipping and you are not accepting orders for this item), and in stock (item is shipping and orders may be placed for this item). Items marked as out of stock will be excluded from being shown in the banners.

Character Requirements: The availability must be populated with one of the

following three values: preorder, out of stock, in stock

• Limit: 16

• Type: String

price

The is the price the manufacturer recommends the product is to be sold for. If a given

product is “on sale”, the price field would be populated with the higher price. The price should be in the same currency as the site. Only populate price with the numeric value using a period (.) as the decimal separator and no thousands separator.

Character Requirements: The decimal separator must be a period (.) with no

thousands separator.

• Limit: 14

• Type: String

sale_price

The sale_price is the price at which the product is available for purchase on the site, if a given product is ‘on sale’, the sale_price would be populated with the lower price. The sale_price should be in the same currency as the site. Only populate sale_price with the numeric price using a period (.) as the decimal separator and no thousands separator.

Character Requirements: The decimal separator must be a period (.) with no

thousands separator.

• Limit: 14

• Type: String

gtn (upc, ean)

Global Trade Item Number (GTIN) is a unique product identifier used to identify a

product, a service, or an item in the global marketplace.

GTIN includes:

GTIN-12 (UPC-A): this is a 12-digit number used primarily in North America.

GTIN-8 (EAN/UCC-8): this is an 8-digit number used predominately outside of North

America.

GTIN-13 (EAN/UCC-13): this is a 13-digit number used predominately outside of North

America.

GTIN-14 (EAN/UCC-14 or ITF-14): this is a 14-digit number used to identify trade items

at various packaging levels.

Character Requirements: The value must be a 8-, 12-, 13-, or 14-digit number (UPC,

EAN, JAN, or ISBN).

• Limit: 50

• Type: String

mpn

MPN is the number that uniquely identifies the product to its manufacturer

• Limit: 70

• Type: String

brand

The brand indicates the product brand’s name. Some products don’t have a clear brand associated. In this case this info doesn’t need to be provided.

Character Requirements: The name must start with either a letter or number, and

can only contain ASCII characters. Remove all HTML tags from this field,

including style tags.

• Limit: 70

• Type: String

product_type

The product_type is a category (or list of categories) to which the product belongs. The product_type field lists your merchandising category, or set of merchandising categories for this product. It must match your website categories. Each level in the hierarchy needs to be delimited by " > ".

Character Requirements: The product_type must start with a letter or number,

and can only contain ASCII characters. The delimiter between categories must

be > (> for XML feeds). We only support the full category path. If a product is

available in multiple categories, please send the different categories as comma

(,) delimited with the primary category first. Thunder does not accept the

categories ID of the path. IDs must be filled in the product_type_key field.

• Limit: 500

• Type: String

Did this answer your question?